O'z tizimlaringizdagi jonli ma'lumotlar bilan javob bering
Vositalarni chaqirish chatbotga suhbat davomida API'ingizga murojaat qilish, qaytgan ma'lumotni o'qish va javobida ishlatish imkonini beradi. Mijoz buyurtmasi haqida so'raydi va bot umumiy emas, balki aniq javob beradi.
Trening chatbotga o'zgarmas narsalarni o'rgatadi. Vositalarni chaqirish esa daqiqada o'zgaradigan narsalarni qamrab oladi: buyurtma holati, kuzatuv raqami, bron. Bu ilg'or xususiyat bo'lib, serveringizda maxsus kod yozishni talab qiladi, shuning uchun tizimlaringizni boshqaradigan kishi bilan rejalashtiring.
Bosqichma-bosqich
Qidiruv qayerda bo'lishini aniqlang
Vositalarni chaqirish Q&A va Flows tomonidan ishlatiladi. Bitta savolga jonli javob kerak bo'lsa, uni Q&A ga qo'ying; qidiruv uzoqroq suhbat yo'lining bir qadami bo'lsa, flow ga qo'ying.
Uni endpoint'ingizga yo'naltiring
URL ga so'rovga javob beradigan API endpoint manzilini kiriting. Headers ga endpoint'ingiz kerak bo'lgan kalit:qiymat juftliklarini qo'shing. Q&A da header'lar vergul bilan ajratiladi; flow'larda ularni birma-bir qo'shasiz.
Mijoz nimani taqdim etishi kerakligini belgilang
Properties - bu chatbot sizga qo'ng'iroq qilishdan oldin to'plashi kerak bo'lgan qiymatlar, masalan shahar yoki kuzatuv raqami. Agar mumkin bo'lgan qiymatlar oldindan ma'lum bo'lsa, ularni Allowed values ostida ro'yxatlang, shunda bot shu to'plam ichida qoladi.
Serveringizda so'rovni o'qing
Serveringizga quyidagi shaklni yuboramiz: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — POST uchun JSON body, GET uchun header sifatida. Har bir argument kaliti property nomining kebab case'idir, shuning uchun "Order Number" order-number sifatida keladi. Shuningdek, qiymatni to'g'ridan-to'g'ri URL ga merge field bilan joylashtirishingiz mumkin, masalan {order-number}.
Chatbot foydalanishi mumkin bo'lgan JSON qaytaring
Serveringiz chatbot aytishi kerak boʻlgan qiymatlarni JSON formatida qaytarishi kerak, masalan: {"order_status":"2 soat 25 daqiqa oldin yetkazilgan","success":true}. "success": true ni faqat soʻrov haqiqatan muvaffaqiyatli boʻlganda qoʻshing.
Sozlamalar maʼlumotnomasi
| Sozlama | Nima qiladi |
|---|---|
| URL | Chatbot chaqiradigan API endpoint manzili. |
| Headers | Soʻrov bilan yuboriladigan kalit:qiymat juftliklari. Savol-javobda vergul bilan ajratiladi, flows da esa birma-bir qoʻshiladi. |
| Properties | Foydalanuvchi soʻrovni amalga oshirishdan oldin taqdim etishi kerak boʻlgan qiymatlar, masalan, shahar yoki kuzatuv raqami. |
| Allowed values | Xususiyatni erkin matn oʻrniga maʼlum variantlar toʻplami bilan cheklaydi. |
Bilish foydali
"success": true — rasmiyatchilik emas, balki vaʼda
Uni faqat soʻrov haqiqatan ishlaganda qaytaring. Agar buyurtma raqami notoʻgʻri boʻlsa yoki hech narsa topilmasa, uni qoʻshmang, aks holda chatbot muvaffaqiyatsizlikni javob sifatida koʻrsatadi.
Argument nomlari shakl oʻzgartiradi
Xususiyat nomlari kebab-case da keladi, shuning uchun "Order Number" order-number ga aylanadi. Kodda va URL ga qoʻygan merge field larda shu imloga mos keling.
GET va POST maʼlumotlarni turlicha qabul qiladi
POST da yuklama JSON body sifatida keladi. GET da esa header sifatida keladi. Soʻrovni oʻqishni boshlashdan oldin endpoint qaysi metodni ishlatishini tekshiring.
Har bir chaqiruvda sizga kontekst beriladi
Soʻrovda user_id, conversation_id va user_language mavjud boʻlib, sizning endpointingiz kim soʻrayotganini va qaysi tilda ekanligini biladi.
Buning uchun dasturchi kerak.
Tools calling — bu ilgʻor xususiyat. Panel qismi qisqa, ammo serveringizda soʻrovni qabul qilib, JSON qaytaradigan narsa boʻlishi kerak.
Tez-tez soʻraladigan savollar
Tools calling qayerda ishlatiladi?
Serverimga aynan nima yuborasiz?
Mijozning qiymatini URL ga qanday kiritaman?
Serverim nima qaytarishi kerak?
Agar mijoz mavjud boʻlmagan raqam bersa nima boʻladi?
Mijozning kiritishiga cheklov qoʻyish mumkinmi?
Tartibsizlikka barham berishga tayyormisiz?
Xabarlaringizni birlashtiring, takrorlanadigan savollarni avtomatlashtiring va suhbatlarni daromadga aylantiring — bugundan boshlab.
Boshlash