change_listing_status
ChatGPTİstifadəçinin öz elanının vəziyyətini dəyişir: deactivate — müvəqqəti gizlət, reactivate — yenidən aktiv et, mark_sold — satıldı kimi qeyd et, renew — müddəti bitmiş elanı yenilə. Elanın actions siyahısında olmayan əməliyyatı təklif etmə. Əvvəl açıq təsdiq al.
create_listing
ChatGPTİstifadəçi elan məlumatlarını nəzərdən keçirib dərc etməyə açıq razılıq verdikdən SONRA elan yaradır. sellerName və phone verilməsə, qoşulmuş hesabın profilindən götürülür. Lazımi məlumat və şəkillər yoxdursa əvvəl soruş. Elan əvvəlcə moderasiyaya göndərilir; birbaşa aktiv olmur. termsAccepted yalnız istifadəçi qaydaları qəbul etdikdə true olsun.
delete_listing
ChatGPTİstifadəçinin öz elanını birdəfəlik silir. Geri qaytarıla bilməz — müvəqqəti gizlətmək üçün change_listing_status (deactivate) təklif et. Yalnız istifadəçi silməyi açıq təsdiqlədikdə çağır.
get_category_fields
ChatGPTKateqoriyaya məxsus tələb olunan texniki sahələri qaytarır. create_listing çağırışından əvvəl istifadə et.
get_listing
ChatGPTAktiv elanın tam məlumatını qaytarır: təsvir, qiymət, xüsusiyyətlər (otaq, sahə, il və s.), yer, şəkillər, satıcının adı və elanın linki. Hesab tələb etmir. Telefon nömrəsi verilmir — əlaqə üçün url-i göstər.
get_my_listing
ChatGPTİstifadəçinin öz elanının bütün redaktə edilə bilən sahələrini, vəziyyətini, rədd səbəbini və bu gün qalan redaktə limitini (editQuota) qaytarır. update_listing-dən əvvəl cari dəyərləri buradan götür.
get_my_profile
ChatGPTQoşulmuş ALAL.AZ hesabının adını, e-poçtunu və əlaqə telefonunu qaytarır. Elan yaratmazdan əvvəl satıcı adı və telefonu buradan götür, istifadəçidən təkrar soruşma; telefon boşdursa, yalnız onda soruş.
list_categories
ChatGPTALAL.AZ saytının aktiv elan kateqoriyalarını, adlarını və ID-lərini qaytarır. Elan kateqoriyasını təxmin etmə.
list_locations
ChatGPTALAL.AZ saytında mövcud şəhərləri və rayonları qaytarır. cityId dəyərini buradan seç.
list_my_listings
ChatGPTİstifadəçinin öz elanlarını vəziyyəti ilə qaytarır: Aktiv, Yoxlamada, Dərc olunmayıb (rədd səbəbi ilə), Deaktiv, Satılıb, Müddəti bitib. Hər elanda baxış sayı və mümkün əməliyyatlar (actions) var. «Elanım niyə dərc olunmayıb?» kimi suallarda rejectionReason-u izah et.
search_listings
ChatGPTALAL.AZ-da aktiv elanları axtarır — mənzil, ev, avtomobil, telefon, iş və s. Hesab tələb etmir. İstifadəçinin istəyini filtrlərə çevir: məs. «Yasamalda 3 otaqlı mənzil, 120 min-ə qədər» → category «Daşınmaz əmlak», estate «flat», detail «3», district «Yasamal», maxPrice 120000. Almaq istəyənə dealType «sale», kirayə axtarana «rent» göndər — yoxsa kirayə və satış qarışır. Maşın axtaranda kind «car». Əsas şərtlər (şəhər, büdcə, otaq sayı) bəlli deyilsə, əvvəl qısa soruş. Nəticələri başlıq, qiymət, yer və url linki ilə göstər; heç vaxt nəticədə olmayan elan uydurma. Satıcının telefonu verilmir — əlaqə üçün istifadəçini elanın url-inə yönləndir.
update_listing
ChatGPTİstifadəçinin öz elanında dəyişiklik edir (qiymət, başlıq, təsvir, şəkillər və s.). Yalnız dəyişən sahələri göndər. Əvvəl dəyişikliyi istifadəçiyə göstər və açıq təsdiq al (confirmed). Redaktədən sonra elan yenidən moderasiyadan keçir; gündəlik redaktə limiti var. Yeni şəkil üçün əvvəl upload_listing_file, sonra imageAssetIds-ə köhnə və yeni ID-ləri birlikdə yaz.
upload_listing_file
ChatGPTSöhbətdəki şəkli ALAL.AZ-a ötürür: istifadəçinin yüklədiyi foto və ya ChatGPT-nin bu söhbətdə yaratdığı şəkil. Şəkli həmişə bu alətin file parametri ilə ötür (base64-ə çevirmə). Hər şəkil üçün ayrıca çağır. Maksimum 8 MB, JPG/PNG/WEBP. Qayıdan assetId-ləri create_listing-in imageAssetIds sahəsinə yaz. Şəkil AI ilə yaradılıbsa, elan təsvirinə «Şəkil illüstrasiyadır» yaz.
upload_listing_photo
ChatGPTEhtiyat yol: şəkli base64 kimi yükləyir (maksimum 8 MB, PNG/JPEG/WEBP). Söhbətdə fayl kimi mövcud olan şəkillər üçün upload_listing_file işlət. AI ilə yaradılmış şəkil göndərilirsə, elan təsvirinə «Şəkil illüstrasiyadır» yaz. Qayıdan assetId-ni create_listing-ə ötür.
