وبهوک (Webhook)

برای دریافت رویدادهای لحظه‌ای مانند پیام‌های دایرکت، کامنت‌ها و پاسخ اکشن‌های آسنکرون (مانند follow_status و list_posts)، باید یک آدرس Webhook در بخش «تنظیمات API» پنل کاربری خود ثبت کنید.

آدرس Webhook می‌تواند متعلق به سرویس اختصاصی شما، وبهوک n8n یا هر نرم‌افزار اتوماسیون دیگری باشد.
متد ارسال درخواست به Webhook می‌تواند POST یا GET باشد.

راهنما: مقدار data.messaging[].sender.id همان recipient_id است که در اندپوینت ارسال پیام (send_message) استفاده می‌شود.

سرویس Webhook قابلیت Retry دارد و تا دریافت موفق رویداد توسط شما، تا ۳ بار با فاصله زمانی ۶۰ ثانیه، رویداد را به لینک Webhook ثبت شده شما ارسال می‌کند.

[
  {
    "headers": {
      "host": "https://YOURWEBSITE.COM",
      "x-real-ip": "1.1.1.1",
      "content-type": "application/json"
    },
    "params": {},
    "query": {},
    "body": {
      "event_id": "client_ig_111111111_1111111116",
      "event_type": "messaging",
      "account_id": "00000000-0000-0000-0000-000000000000",
      "data": {
        "time": 1785081317446,
        "id": "1234567890",
        "messaging": [
          {
            "sender": { "id": "1234567890" },
            "recipient": { "id": "1234567890" },
            "timestamp": 1785081317081,
            "message": {
              "mid": "abcxyz",
              "text": "سلام"
            }
          }
        ]
      }
    },
    "webhookUrl": "https://YOURWEBSITE.COM/webhook/zzzzzzzz",
    "executionMode": "test"
  }
]