پاسخ با دادههای زنده از سیستمهای خودتان
فراخوانی ابزارها به چتبات اجازه میدهد در میانه مکالمه API شما را صدا بزند، پاسخ را بخواند و در پاسخ خود از آن استفاده کند. مشتری درباره سفارش خود میپرسد و ربات پاسخ واقعی میدهد، نه یک پاسخ کلی.
آموزش به چتبات چیزهایی را میآموزد که ثابت میمانند. فراخوانی ابزارها مواردی را پوشش میدهد که دقیقهبهدقیقه تغییر میکنند: وضعیت سفارش، کد رهگیری، یک رزرو. این یک ویژگی پیشرفته است و نیاز به کد سفارشی روی سرور شما دارد، پس با مسئول سیستمهای خود هماهنگ کنید.
گام به گام
تصمیم بگیرید که جستجو کجا انجام شود
فراخوانی ابزارها در پرسش و پاسخ و در فلوها استفاده میشود. زمانی که یک سوال واحد نیاز به پاسخ زنده دارد، آن را در پرسش و پاسخ قرار دهید، و زمانی که جستجو یکی از مراحل یک مسیر مکالمه طولانیتر است، در فلو قرار دهید.
آن را به سمت endpoint خود هدایت کنید
در URL، آدرس endpoint API که به درخواست پاسخ میدهد را وارد کنید. در Headers، هر جفت key:value که endpoint شما نیاز دارد اضافه کنید. در پرسش و پاسخ، هدرها با کاما جدا میشوند؛ در فلوها آنها را یکییکی اضافه میکنید.
مشخص کنید مشتری چه چیزی باید ارائه دهد
Properties مقادیری هستند که چتبات باید قبل از فراخوانی شما جمعآوری کند، مثلاً یک شهر یا کد رهگیری. اگر مقادیر ممکن از قبل مشخص هستند، آنها را زیر Allowed values لیست کنید تا ربات در آن محدوده باقی بماند.
درخواست را روی سرور خود بخوانید
ما این شکل را به سرور شما ارسال میکنیم: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — به عنوان بدنه JSON برای POST و به عنوان هدر برای GET. هر کلید argument نام property به صورت kebab-case است، بنابراین "Order Number" به صورت order-number میرسد. همچنین میتوانید یک مقدار را مستقیماً با یک فیلد ادغام در URL قرار دهید، مثلاً {order-number}.
JSON قابل استفاده برای چتبات را برگردانید
سرور شما باید پاسخی به صورت JSON حاوی مقادیری که میخواهید ربات بگوید برگرداند، مثلاً {"order_status":"تحویل داده شده ۲ ساعت و ۲۵ دقیقه پیش","success":true}. فقط زمانی "success": true را اضافه کنید که درخواست واقعاً موفقیتآمیز باشد.
راهنمای تنظیمات
| تنظیمات | کارکرد آن |
|---|---|
| URL | آدرس نقطه پایانی API شما که ربات چت با آن تماس میگیرد. |
| Headers | جفتهای کلید:مقدار که با درخواست ارسال میشوند، در پرسش و پاسخ با کاما جدا میشوند و در فلها یکی یکی اضافه میشوند. |
| Properties | مقادیری که کاربر باید قبل از برقراری تماس ارائه دهد، مانند یک شهر یا یک شماره پیگیری. |
| Allowed values | یک ویژگی را به مجموعهای از گزینههای مشخص محدود میکند به جای متن آزاد. |
خوب است بدانید
"success": true یک قول است، نه یک تشریفات
فقط زمانی آن را برگردانید که درخواست واقعاً کار کرده باشد. اگر شماره سفارش نامعتبر است یا چیزی پیدا نشد، آن را حذف کنید تا ربات چت یک شکست را به عنوان پاسخ ارائه ندهد.
نام آرگومانها تغییر شکل میدهند
نام ویژگیها به صورت kebab-case میرسند، بنابراین "Order Number" به order-number تبدیل میشود. این املاء را در کد خود و در هر فیلد ادغامی که در URL قرار میدهید مطابقت دهید.
GET و POST داده را متفاوت دریافت میکنند
برای POST، محموله به صورت بدنه JSON میرسد. برای GET، به صورت هدر میرسد. قبل از شروع به خواندن درخواست، بررسی کنید که نقطه پایانی شما از کدام روش استفاده میکند.
با هر تماس، زمینه (context) دریافت میکنید
درخواست شامل user_id، conversation_id و user_language است، بنابراین endpoint شما میداند چه کسی و به چه زبانی سوال میکند.
این مورد نیاز به یک توسعهدهنده دارد
ابزارهای فراخوانی یک ویژگی پیشرفته است. بخش پنل کوتاه است، اما چیزی روی سرور شما باید درخواست را دریافت کرده و JSON را برگرداند.
سوالات رایج
کجا میتوانم از ابزارهای فراخوانی استفاده کنم؟
دقیقاً چه چیزی به سرور من ارسال میشود؟
چگونه مقدار مشتری را در URL خود قرار دهم؟
سرور من چه چیزی باید برگرداند؟
اگر مشتری عددی بدهد که وجود ندارد چه اتفاقی میافتد؟
آیا میتوانم محدود کنم که مشتری چه چیزی مجاز به وارد کردن است؟
آماده پایان دادن به هرجومرج هستید؟
پیامهای خود را یکپارچه کنید، سوالات تکراری را خودکار کنید و مکالمات را به درآمد تبدیل کنید — از امروز شروع کنید.
شروع کنید