POST
/chat/template
API Token
ارسال پیام به بات
پیام کاربر را به بات فعال ارسال میکند و پاسخ هوشمند JSON دریافت میکنید.
این endpoint اصلی یکپارچهسازی REST است. با ارسال متن پیام، شناسه بات و کلید API، پاسخ بات را دریافت میکنید. برای ادامه مکالمه مهمان، فیلد guest_key را در درخواستهای بعدی ارسال کنید.
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| text | string | بله | متن پیام کاربر (حداکثر ۵۰۰۰ کاراکتر) |
| bot_uid | uuid | بله | شناسه یکتای بات فعال در پنل |
| api_key | string | بله | توکن API از بخش پروفایل پنل |
| guest_key | uuid | خیر | شناسه مهمان برای ادامه مکالمه (در پاسخ اول برگردانده میشود) |
Request Body
{
"text": "وضعیت سفارش #8823 چیه؟",
"bot_uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"api_key": "your_api_token_here",
"guest_key": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}Response 200
{
"status": "success",
"result": "سفارش 8823 در وضعیت «آماده ارسال» است.",
"q": [],
"base_message": "وضعیت سفارش #8823 چیه؟",
"total_token": 142,
"time_response": 1.24,
"suggest": [
"بله، لینک رهگیری بفرست"
],
"guest_key": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}خطاهای رایج
- 401 کلید API نامعتبر است.
- 403 این کلید API به این بات دسترسی ندارد.
- 404 بات فعال یافت نشد.
- 422 خطای اعتبارسنجی پارامترها.
