این اندپوینت برای ارسال Generic Template بهصورت Carousel (کاروسل) در دایرکت اینستاگرام استفاده میشود. با استفاده از آن میتوانید چند کارت را در یک پیام ارسال کنید که هر کارت میتواند شامل تصویر، عنوان، توضیحات و دکمههای تعاملی باشد.
در هر درخواست میتوانید بین ۱ تا ۱۰ کارت ارسال کنید.
پارامترهای بدنه درخواست (Body)
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
recipient_id |
string | بله | شناسه کاربری دریافتکننده پیام در دایرکت. |
elements |
array | بله | آرایهای شامل ۱ تا ۱۰ کارت. هر کارت میتواند شامل عنوان، تصویر، توضیحات، لینک و دکمههای تعاملی باشد. |
account_id |
string | بله | شناسه پیج اینستاگرامی ارسالکننده پیام. |
ساختار هر کارت
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
title |
string | بله | عنوان کارت. |
image_url |
string | بله | آدرس تصویر کارت. |
subtitle |
string | خیر | توضیحات کوتاه کارت. |
default_action |
object | خیر | عملیاتی که با انتخاب یا کلیک روی کارت انجام میشود؛ معمولاً برای باز کردن یک لینک استفاده میشود. |
buttons |
array | خیر | دکمههای تعاملی کارت. دکمهها میتوانند از نوع web_url یا postback باشند. |
نمونه درخواست
{
"account_id": "00000000-0000-0000-0000-000000000000",
"recipient_id": "1111111111111111",
"elements": [
{
"title": "محصول اول",
"image_url": "/path/image-1.jpg",
"subtitle": "توضیحات محصول اول",
"default_action": {
"type": "web_url",
"url": "https://example.com/product-1"
},
"buttons": [
{
"type": "web_url",
"url": "/path/product-1",
"title": "مشاهده محصول"
},
{
"type": "postback",
"title": "اطلاعات بیشتر",
"payload": "PRODUCT_INFO"
}
]
},
{
"title": "محصول دوم",
"image_url": "/path/image-2.jpg",
"subtitle": "توضیحات محصول دوم",
"default_action": {
"type": "web_url",
"url": "/path/product-2"
},
"buttons": [
{
"type": "web_url",
"url": "/path/product-2",
"title": "مشاهده محصول"
},
{
"type": "postback",
"title": "اطلاعات بیشتر",
"payload": "PRODUCT_INFO"
}
]
}
]
}نکته: این ساختار برای نمایش چند گزینه در قالب یک پیام تعاملی مناسب است؛ برای مثال میتوانید محصولات، خدمات، دورهها یا پیشنهادهای مختلف را در قالب چند کارت به کاربر نمایش دهید.