ارسال پیام از ربات
به یک مشترک (یا همه) پیام یا رسانه میفرستد.
POST
scope: bot.sendhttps://api.irnoti.com/v1/botbuilder/bots/{id}/sendارسال همیشه ناهمزمان و در صف است. برای یک مخاطب، recipient در پاسخ میآید. ارسال به all فقط برای رباتهایی مجاز است که اشتراک فعال دارند.
**نکته:** مشترک باید قبلاً ربات را شروع کرده باشد.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| id * | مسیر | string | شناسهٔ ربات. |
| to * | بدنه | object | مخاطب؛ دقیقاً یکی از chatId، ref (برچسب لینک عضویت)، phone (شمارهٔ ثبتشده در ربات) یا all: true (همهٔ مشترکین). |
| message * | بدنه | object | { text?, parseMode?: HTML|Markdown, buttons?, media?: {type, url}, silent? }؛ متن یا رسانه الزامی است (متن ≤۴۰۰۰ نویسه، کپشن ≤۱۰۰۰). دکمهها آرایهای از ردیفها (هر ردیف ۱ تا ۴ دکمه با url یا callback)، و نشانی رسانه باید https باشد. |
| Idempotency-Key | هدر | string | کلید یکتا (حداکثر ۱۰۰ نویسه). ارسال دوباره با همان کلید، کار تکراری نمیسازد و نتیجهٔ قبلی را برمیگرداند. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 404 | not_found | ربات یا مشترک پیدا نشد یا متعلق به شما نیست. |
| 409 | conflict | اشتراک ربات منقضی شده است. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.