הגדרת וובהוק
- 1פתחו את הגדרות > וובהוקים והוסיפו שם וכתובת https ציבורית.
- 2בחרו את הערוצים שהוא מיועד להם, או אף אחד עבור כל הערוצים.
- 3בחרו את האירועים שלו: פוסטים שפורסמו, לידים שתהליך אוסף, תהליכים שהסתיימו.
- 4לחצו על Send test event כדי לשלוח דוגמה של אירוע לכתובת שלכם.
ב-Zapier, ב-Make וב-n8n
אפליקציות PostNimbo ל-Zapier, ל-Make ול-n8n נרשמות בשבילכם: הפעלת טריגר קוראת ל-POST /public/v1/webhooks עם הכתובת שהכלי מאזין לה, וכיבוי שלו קורא ל-DELETE /public/v1/webhooks/:id. הקוד שלכם יכול לעשות את אותו הדבר עם מפתח API.
איך זה נשלח
- בקשת POST עם גוף JSON, ושם האירוע בכותרת
X-PostNimbo-Event. - לשרת שלכם יש 10 שניות לענות על פוסט שפורסם ו-5 שניות לענות על אירוע של תהליך. אירוע של תהליך נשלח שוב עוד פעמיים אחרי timeout, תשובת 429 או תשובת 5xx; פוסט שפורסם לא נשלח שוב. ענו מהר ובצעו את העבודה אחר כך.
- מתקבלות רק כתובות https ציבוריות, וגם הפניה חייבת להוביל לכתובת ציבורית.
- כל משלוח חתום עם ה-secret שמוצג בהגדרות הוובהוק, בכותרות
X-PostNimbo-Timestamp,X-PostNimbo-Signature.
לוודא שמשלוח הגיע מאיתנו
חשבו HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי עם ה-secret שלכם, השוו אותו לכותרת החתימה בזמן קבוע, ודחו חותמת זמן ישנה מ-5 דקות.
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.publishedA 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.scheduledA 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.failedA 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.capturedAn 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.completedSomeone 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": {}
}
}