דילוג לתוכן
מפתחים

וובהוקים

PostNimbo שולח לכתובת שלכם ברגע שפוסט עולה לאוויר, כך ש-Zapier, Make, n8n או השרת שלכם יכולים לפעול בהתאם.

הגדרת וובהוק

  1. 1פתחו את הגדרות > וובהוקים והוסיפו שם וכתובת 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 שניות לענות על אירוע של תהליך. אירוע של תהליך נשלח שוב עוד פעמיים אחרי timeout, תשובת 429 או תשובת 5xx; פוסט שפורסם לא נשלח שוב. ענו מהר ובצעו את העבודה אחר כך.
  • מתקבלות רק כתובות https ציבוריות, וגם הפניה חייבת להוביל לכתובת ציבורית.
  • כל משלוח חתום עם ה-secret שמוצג בהגדרות הוובהוק, בכותרות X-PostNimbo-Timestamp, X-PostNimbo-Signature.

לוודא שמשלוח הגיע מאיתנו

חשבו HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי עם ה-secret שלכם, השוו אותו לכותרת החתימה בזמן קבוע, ודחו חותמת זמן ישנה מ-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.

תוכן (Payload)
[
  {
    "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.

תוכן (Payload)
[
  {
    "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.

תוכן (Payload)
[
  {
    "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.

תוכן (Payload)
{
  "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.

תוכן (Payload)
{
  "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, בודקים אפליקציות עבור הספרייה ומוסיפים את נקודות הקצה שאינטגרציות צריכות.