این اندپوینت برای ارسال یک پیام دایرکت به کاربری استفاده میشود که پیشتر با پیج شما هیچ دایرکتی نداشته، اما زیر یکی از پستها یا ریلزهای شما کامنت گذاشته است. با استفاده از comment_id همان کامنت، میتوانید یک پیام دایرکت (Private Reply) برای صاحب کامنت باز کنید.
محدودیت زمانی: ارسال Private Reply تنها تا ۷ روز پس از زمان ثبت کامنت امکانپذیر است. پس از گذشت این مهلت، امکان شروع مکالمه دایرکت از طریق این اندپوینت وجود ندارد.
پارامترهای بدنه درخواست (Body)
| نام | نوع | الزامی | توضیحات |
|---|---|---|---|
account_id |
string (UUID) | بله | آیدی پیج اینستاگرامی که کامنت روی پست آن قرار دارد |
comment_id |
string | بله | آیدی کامنتی که میخواهید بابت آن، پیام دایرکت (Private Reply) ارسال کنید؛ این مقدار از طریق Webhook دریافت میشود |
message |
string | بله | متن پیام دایرکت ارسالی |
quick_replies |
array | خیر | آرایهای از پاسخهای سریع برای نمایش زیر پیام (اختیاری) |
buttons |
array | خیر | آرایهای از دکمهها برای ارسال پیام تعاملی؛ ساختار مشابه buttons در اندپوینت send_message (اختیاری) |
نمونه درخواست ساده
{
"account_id": "00000000-0000-0000-0000-000000000000",
"comment_id": "1234567890",
"message": "Hello"
}نکته: این اندپوینت فقط برای شروع اولین پیام دایرکت با کاربرانی است که تا پیش از آن هیچ دایرکتی با پیج شما نداشتهاند اما کامنتی گذاشتهاند. برای ادامه مکالمه پس از این مرحله، از اندپوینت send_message به همراه recipient_id دریافتی از Webhook استفاده کنید. همچنین این اندپوینت امکان ارسال پیام دکمهدار، Quick Reply و… را دارد.