सीधे कॉन्टेंट पर जाएं
डेवलपर

वेबहुक

पोस्ट लाइव होते ही PostNimbo आपके पते पर भेज देता है, ताकि Zapier, Make, n8n या आपका अपना सर्वर उस पर काम कर सके।

एक सेट अप करें

  1. 1Settings > Webhooks खोलें और एक नाम और सार्वजनिक https पता जोड़ें।
  2. 2जिन चैनलों के लिए यह है उन्हें चुनें, या हर चैनल के लिए कोई न चुनें।
  3. 3इसके इवेंट चुनें: पब्लिश हुई पोस्ट, फ़्लो से मिली लीड, पूरे हुए फ़्लो।
  4. 4अपने पते पर किसी इवेंट का सैंपल भेजने के लिए Send test event पर क्लिक करें।

Zapier, Make और n8n में

Zapier, Make और n8n के लिए PostNimbo ऐप आपकी ओर से सब्सक्राइब करते हैं: ट्रिगर चालू करने पर उस पते के साथ POST /public/v1/webhooks कॉल होता है जिस पर टूल सुनता है, और बंद करने पर DELETE /public/v1/webhooks/:id कॉल होता है। आपका अपना कोड API key से यही कर सकता है।

Zapier, Make या n8n सेट अप करें

यह कैसे पहुंचता है

  • JSON बॉडी वाला एक POST, और हेडर में इवेंट का नाम X-PostNimbo-Event.
  • आपके सर्वर के पास पब्लिश हुई पोस्ट का जवाब देने के लिए 10 सेकंड और फ़्लो इवेंट का जवाब देने के लिए 5 सेकंड हैं। टाइमआउट, 429 या 5xx जवाब के बाद फ़्लो इवेंट दो बार और भेजा जाता है; पब्लिश हुई पोस्ट दोबारा नहीं भेजी जाती। जल्दी जवाब दें और काम बाद में करें।
  • सिर्फ़ सार्वजनिक https पते स्वीकार किए जाते हैं, और रीडायरेक्ट भी किसी सार्वजनिक पते पर ही ले जाना चाहिए।
  • हर डिलीवरी वेबहुक सेटिंग्स में दिखाए गए सीक्रेट से साइन होती है, इन हेडर में X-PostNimbo-Timestamp, X-PostNimbo-Signature.

जांचें कि डिलीवरी हमसे आई है

अपने सीक्रेट से timestamp, एक फ़ुल स्टॉप और रॉ बॉडी का HMAC-SHA256 निकालें, उसे constant time में सिग्नेचर हेडर से मिलाएं, और 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.

पेलोड
[
  {
    "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 में मदद करते हैं, डायरेक्टरी के लिए ऐप रिव्यू करते हैं और इंटीग्रेशन के लिए ज़रूरी एंडपॉइंट जोड़ते हैं।