მთავარ შინაარსზე გადასვლა
დეველოპერები

ვებჰუკები

PostNimbo თქვენს მისამართზე აგზავნის მონაცემებს იმ წამს, როცა პოსტი გამოქვეყნდება, რათა Zapier-მა, Make-მა, n8n-მა ან თქვენმა სერვერმა მოქმედება შეასრულოს.

დაყენება

  1. 1გახსენით პარამეტრები > ვებჰუკები და დაამატეთ სახელი და საჯარო https მისამართი.
  2. 2აირჩიეთ არხები, რომლებსაც ეხება, ან არცერთი – ყველა არხისთვის.
  3. 3აირჩიეთ მოვლენები: გამოქვეყნებული პოსტები, ნაკადის მიერ შეგროვებული ლიდები, დასრულებული ნაკადები.
  4. 4დააწკაპუნეთ „სატესტო მოვლენის გაგზავნა“-ზე, რომ თქვენს მისამართზე მოვლენის ნიმუში გაიგზავნოს.

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 მისამართები, და გადამისამართებაც საჯარო მისამართზე უნდა მიდიოდეს.
  • ყოველი მიწოდება ხელმოწერილია ვებჰუკის პარამეტრებში ნაჩვენები secret-ით, სათაურებში X-PostNimbo-Timestamp, X-PostNimbo-Signature.

შეამოწმეთ, რომ მიწოდება ჩვენგან მოვიდა

თქვენი secret-ით გამოთვალეთ HMAC-SHA256 timestamp-ის, წერტილისა და დაუმუშავებელი სხეულისთვის, შეადარეთ ხელმოწერის სათაურს მუდმივ დროში და უარყავით 5 წუთზე ძველი timestamp.

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-ში, ვამოწმებთ აპებს კატალოგისთვის და ვამატებთ endpoint-ებს, რომლებიც ინტეგრაციებს სჭირდება.