التخطي إلى المحتوى
المطوّرون

Webhooks

يرسل PostNimbo طلبًا إلى عنوانك لحظة نشر أي منشور، ليتمكن Zapier أو Make أو n8n أو خادمك الخاص من التصرف بناءً عليه.

أعدّ واحدًا

  1. 1افتح Settings > Webhooks وأضف اسمًا وعنوان https عامًا.
  2. 2اختر القنوات التي يخصّها، أو لا تختر أيًّا ليشمل كل القنوات.
  3. 3اختر أحداثه: المنشورات المنشورة، والعملاء المحتملون الذين يجمعهم مسار، والمسارات المكتملة.
  4. 4انقر على Send test event لإرسال نموذج لحدث إلى عنوانك.

في Zapier وMake وn8n

تشترك تطبيقات PostNimbo لـ Zapier وMake وn8n نيابةً عنك: تفعيل المشغّل يستدعي POST /public/v1/webhooks مع العنوان الذي تستمع عليه الأداة، وإيقافه يستدعي DELETE /public/v1/webhooks/:id. يمكن لشيفرتك فعل الشيء نفسه باستخدام مفتاح API.

أعدّ Zapier أو Make أو n8n

كيف يتم التسليم

  • طلب POST بمحتوى JSON، واسم الحدث في الترويسة X-PostNimbo-Event.
  • لدى خادمك 10 ثوانٍ للرد على منشور منشور و5 ثوانٍ للرد على حدث مسار. يُعاد إرسال حدث المسار مرتين إضافيتين بعد انتهاء المهلة أو رد 429 أو 5xx؛ أما المنشور المنشور فلا تُعاد محاولته. ردّ بسرعة وأنجز العمل بعد ذلك.
  • لا تُقبل إلا عناوين https العامة، ويجب أن تؤدي أي إعادة توجيه أيضًا إلى عنوان عام.
  • كل تسليم موقّع بالسر الظاهر في إعدادات الـ webhook، في الترويسات X-PostNimbo-Timestamp, X-PostNimbo-Signature.

تحقّق من أن التسليم صادر منا

احسب HMAC-SHA256 للطابع الزمني ونقطة والمحتوى الخام باستخدام سرّك، وقارنه بترويسة التوقيع في زمن ثابت، وارفض أي طابع زمني مضى عليه أكثر من 5 دقائق.

Node.js
const crypto = require('crypto');

// rawBody: the request body exactly as received, before JSON parsing
function fromPostNimbo(rawBody, headers, secret) {
  const timestamp = headers['x-postnimbo-timestamp'];
  const signature = headers['x-postnimbo-signature'] || '';
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected =
    'sha256=' +
    crypto
      .createHmac('sha256', secret)
      .update(timestamp + '.' + rawBody)
      .digest('hex');
  return (
    signature.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
  );
}

الأحداث

القائمة نفسها متاحة عبر GET /public/v1/webhooks/events، لتتمكن أي أداة من عرض المشغّلات والبيانات النموذجية.

post.published

A post went live on a channel. Sent once per channel, after the network accepted it, with the post in the array.

Webhooks with no channels get it for every channel; the others only for the channels they list.

الحمولة
[
  {
    "id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
    "content": "<p>Our autumn menu is here.</p>",
    "publishDate": "2026-10-26T09:30:00.000Z",
    "releaseURL": "https://www.linkedin.com/feed/update/urn:li:share:7000000000000000000",
    "state": "PUBLISHED",
    "integration": {
      "id": "c1d2e3f4-0000-4a00-8000-000000000001",
      "name": "Example Bakery",
      "providerIdentifier": "linkedin-page",
      "picture": "https://example.com/avatar.png",
      "type": "social"
    }
  }
]
post.scheduled

A post was queued to publish: scheduled (or published now), rescheduled, approved, or edited while scheduled. Sent once per channel, with the same fields as post.published. The next posts of a repeating post do not send it.

Webhooks with no channels get it for every channel; the others only for the channels they list.

الحمولة
[
  {
    "id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
    "content": "<p>Our autumn menu is here.</p>",
    "publishDate": "2026-10-26T09:30:00.000Z",
    "releaseURL": null,
    "state": "QUEUE",
    "integration": {
      "id": "c1d2e3f4-0000-4a00-8000-000000000001",
      "name": "Example Bakery",
      "providerIdentifier": "linkedin-page",
      "picture": "https://example.com/avatar.png",
      "type": "social"
    }
  }
]
post.failed

A post could not be published, or its publishing could not be confirmed, and is marked as failed. Sent once per channel, with the same fields as post.published (the reason is shown in PostNimbo).

Webhooks with no channels get it for every channel; the others only for the channels they list.

الحمولة
[
  {
    "id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
    "content": "<p>Our autumn menu is here.</p>",
    "publishDate": "2026-10-26T09:30:00.000Z",
    "releaseURL": null,
    "state": "ERROR",
    "integration": {
      "id": "c1d2e3f4-0000-4a00-8000-000000000001",
      "name": "Example Bakery",
      "providerIdentifier": "linkedin-page",
      "picture": "https://example.com/avatar.png",
      "type": "social"
    }
  }
]
lead.captured

An automation flow saved an email or phone number someone typed in answer to a question. Sent once per answer.

Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.

الحمولة
{
  "event": "lead.captured",
  "timestamp": "2026-10-26T09:30:00.000Z",
  "runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
  "flow": {
    "id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
    "name": "Autumn menu giveaway"
  },
  "channel": {
    "id": "c1d2e3f4-0000-4a00-8000-000000000001",
    "network": "instagram",
    "name": "Example Bakery"
  },
  "contact": {
    "id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
    "name": "Sam Taylor",
    "username": "samtaylor",
    "email": "sam@example.com",
    "phone": "+447700900123",
    "tags": [
      "giveaway"
    ],
    "fields": {
      "postcode": "SW1A 1AA"
    }
  }
}
flow.completed

Someone reached the end of an automation flow. Sent once per run, with the same fields as lead.captured (email and phone are null when not collected).

Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.

الحمولة
{
  "event": "flow.completed",
  "timestamp": "2026-10-26T09:31:00.000Z",
  "runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
  "flow": {
    "id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
    "name": "Autumn menu giveaway"
  },
  "channel": {
    "id": "c1d2e3f4-0000-4a00-8000-000000000001",
    "network": "instagram",
    "name": "Example Bakery"
  },
  "contact": {
    "id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
    "name": "Sam Taylor",
    "username": "samtaylor",
    "email": "sam@example.com",
    "phone": null,
    "tags": [
      "giveaway"
    ],
    "fields": {}
  }
}

هل تبني شيئًا باستخدام PostNimbo؟

أخبرنا بما تعمل عليه. نساعدك في الـ API، ونراجع التطبيقات لإدراجها في الدليل، ونضيف نقاط النهاية التي تحتاجها عمليات التكامل.