REST API orqali qo‘ng‘iroqlar: saytdan lid yuborish va natijani qaytarib olish
Sado AI jamoasi · · 3 daqiqada o‘qiladi
Qisqacha
REST API — dasturlar internet orqali bir-biriga so‘rov yuboradigan oddiy yo‘l. Qo‘ng‘iroqlarda u shunday ishlaydi: saytingiz, ilovangiz yoki ichki dasturingiz yangi lidni Sado’ga yuboradi, AI operator unga darhol qo‘ng‘iroq qiladi, natija esa — qisqa xulosa va keyingi qadam — webhook orqali tizimingizga qaytadi. Har bir lid bilan telefon, ism, mavzu, qo‘ng‘iroq qilish asosi va o‘zingizning ID’ingizni yuboring. Bitrix24 yoki boshqa tayyor ulanish bo‘lsa, API shart emas.
REST API oddiy tilda
API — bir dastur ikkinchisiga «mana bu lid, unga qo‘ng‘iroq qiling» deb yuboradigan kelishilgan til. REST API’da so‘rov oddiy internet manziliga yuboriladi, ma’lumot JSON ko‘rinishida bo‘ladi, kim yuborgani esa maxfiy kalit bilan tekshiriladi.
Masalan, saytdagi formada «Yuborish» bosilganda serveringiz Sado’ga bitta so‘rov yuboradi: telefon, ism va mavzu. Biznes egasi uchun ma’nosi oddiy: lid saytdan tushdi — hech kim hech narsani ko‘chirmaydi, qo‘ng‘iroq o‘zi boshlanadi.
Qo‘ng‘iroqlar uchun API nima beradi
- Sayt formasi to‘ldirildi — operator mijozga darhol qo‘ng‘iroq qiladi, u hali saytdan ketmasdan.
- Mobil ilovada «Menga qo‘ng‘iroq qiling» tugmasi bosildi — xuddi shunday.
- Ichki dasturingizdagi ro‘yxat, masalan ertangi yetkazishlar, qo‘ng‘iroqqa yuboriladi.
- Instagram yoki reklama formasidan kelgan lid ham shu yo‘l bilan: lidni yig‘adigan xizmat uni API’ga yuboradi.
- Natijalar o‘z hisobotingiz yoki CRM’ingizga qaytadi: kim qiziqdi, kim yozildi, keyingi qadam nima.
Lid bilan nima yuboriladi
| Ma’lumot | Misol | Nega kerak |
|---|---|---|
| Telefon | +998 XX XXX XX XX | Qo‘ng‘iroq uchun |
| Ism | Aziz | Mijoz bilan ismi bilan gaplashish |
| Mavzu | 2 xonali kvartira | Operator suhbatni nimadan boshlashni biladi |
| Qo‘ng‘iroq asosi | Saytdagi ariza | Faqat qo‘ng‘iroq qilish mumkin bo‘lgan odamlarga qo‘ng‘iroq qilinadi |
| O‘zingizning ID | site-form-1042 | Bir lid ikki marta yuborilsa ham, ikkinchisi ochilmaydi |
Maydonlarning aniq nomlari va to‘liq hujjat — dasturchilar sahifasida.
Dasturchi uchun qadamlar
- Dasturchilar sahifasini o‘qing: so‘rov namunalari va to‘liq hujjat o‘sha yerda.
- API kalitini oling va faqat serverda saqlang. Uni sayt kodiga, brauzerga yoki chatga qo‘ymang.
- Formadan lid kelganda so‘rovni serveringizdan yuboring.
- Javobni tekshiring: xato bo‘lsa, jurnalga yozing va keyinroq xuddi shu ID bilan qayta yuboring.
- Natijani olish uchun webhook manzilini ulang. Bu qanday ishlashi haqida: webhook qanday ishlaydi.
- O‘z raqamingiz bilan test lid yuboring, qo‘ng‘iroqni qabul qiling va natija tizimingizga qaytganini tekshiring.
Xavfsizlik va qoidalar
- API kaliti — parol: kimdir ko‘rib qolsa, uni darhol yangisiga almashtiring.
- Faqat qo‘ng‘iroq qilish mumkin bo‘lgan odamlarni yuboring: ariza qoldirgan, rozilik bergan yoki mijozingiz bo‘lganlar.
- «Menga qo‘ng‘iroq qilmang» degan raqamga boshqa qo‘ng‘iroq qilinmaydi.
- Qo‘ng‘iroq soatlari, kunlik limit va to‘xtatish tugmasi portalda — ularni API’dan oldin sozlang.
- Keraksiz ma’lumot yubormang: telefon, ism va mavzu yetadi.
API kerakmi yoki dasturchisiz ham bo‘ladimi
Ko‘p hollarda API shart emas. Bitrix24 bilan tayyor ulanish bor: lid siz tanlagan bosqichga tushishi bilan operator qo‘ng‘iroq qiladi. amoCRM, Google Sheets, 1C, BILLZ va MoySklad’ni jamoamiz siz bilan birga ulaydi. Ro‘yxat Excel’da bo‘lsa, uni «Avtoqo‘ng‘iroqlar» bo‘limiga yuklash kifoya.
To‘lov hamma yo‘lda bir xil: faqat gaplashilgan daqiqa, daqiqasi 800 so‘m. Batafsil: avto qo‘ng‘iroq xizmati, Bitrix24 bilan AI qo‘ng‘iroqlar va narxlar. Jonli sinab ko‘ring yoki 78 778 01 23 ga qo‘ng‘iroq qiling.
Savollar
API orqali qo‘ng‘iroq qilish uchun nima kerak?
Dasturchi, Sado API kaliti va lidni yuboradigan server. To‘liq hujjat va so‘rov namunalari dasturchilar sahifasida.
Operator API’dan kelgan lidga qachon qo‘ng‘iroq qiladi?
Darhol, siz belgilagan qo‘ng‘iroq soatlari ichida. Soatlar va kunlik limitni portalda o‘zingiz belgilaysiz.
API orqali butun ro‘yxatni yuborsa bo‘ladimi?
Ha. Ro‘yxatni API orqali yuborsangiz, operator har biriga qo‘ng‘iroq qiladi. Qo‘ng‘iroq soatlari va kunlik limit portalda belgilanadi.
API orqali qo‘ng‘iroq qancha turadi?
Sado’da faqat gaplashilgan daqiqa uchun to‘lanadi: daqiqasi 800 so‘m, oylik va ulash to‘lovi yo‘q. Javob bermagan raqam uchun to‘lov yo‘q.