این اندپوینت برای ارسال پیام متنی در دایرکت اینستاگرام استفاده میشود؛ که از ساختار پیام دکمهدار (Buttons) و Quick Reply هم پشتیبانی میکند.
پارامترهای بدنه درخواست (Body)
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
account_id |
string (UUID) | بله | آیدی پیج اینستاگرامی که پیام از طریق آن ارسال میشود (از خروجی /service/accounts) |
recipient_id |
string | بله | آیدی گیرنده پیام. این مقدار از فیلد sender.id در Webhook دریافت میشود |
message |
string | بله | متن پیام ارسالی |
buttons |
array | خیر | آرایهای از دکمهها برای ارسال پیام تعاملی (اختیاری) |
ساختار هر آیتم در آرایه buttons
| نام | نوع | توضیحات |
|---|---|---|
type |
string | نوع دکمه؛ مقادیر مجاز: postback یا web_url |
title |
string | عنوان نمایشی دکمه |
payload |
string | مقدار بازگشتی هنگام کلیک (فقط برای نوع postback) |
url |
string | آدرس مقصد (فقط برای نوع web_url) |
نمونه Body ارسال پیام
{
"account_id": "00000000-0000-0000-0000-000000000000",
"recipient_id": "1234567890",
"message": "Hello"
}نمونه Body ارسال پیام دکمهدار
{
"account_id": "00000000-0000-0000-0000-000000000000",
"recipient_id": "1234567890",
"message": "سلام! لطفاً یکی از گزینههای زیر را انتخاب کنید:",
"buttons": [
{
"type": "postback",
"title": "مشاهده محصولات",
"payload": "VIEW_PRODUCTS"
},
{
"type": "web_url",
"title": "ورود به سایت",
"url": "https://example.com"
}
]
}نمونه Body ارسال پیام با Quick Replies
{
"account_id": "00000000-0000-0000-0000-000000000000",
"recipient_id": "1111111111111111",
"message": "سلام",
"quick_replies": [
{
"content_type": "text",
"title": "شروع",
"payload": "START"
},
{
"content_type": "text",
"title": "راهنما",
"payload": "HELP"
}
]
}