İçeriğe geç
Geliştiriciler

Webhook'lar

PostNimbo bir gönderi yayına girdiği anda adresinize istek gönderir; böylece Zapier, Make, n8n veya kendi sunucunuz buna göre işlem yapabilir.

Kurulum

  1. 1Settings > Webhooks bölümünü açın, bir ad ve herkese açık bir https adresi ekleyin.
  2. 2Hangi kanallar için olduğunu seçin veya tüm kanallar için hiçbirini seçmeyin.
  3. 3Olaylarını seçin: yayınlanan gönderiler, bir akışın topladığı talepler, tamamlanan akışlar.
  4. 4Adresinize bir olay örneği göndermek için Send test event'e tıklayın.

Zapier, Make ve n8n'de

Zapier, Make ve n8n için PostNimbo uygulamaları aboneliği sizin yerinize yapar: Bir tetikleyiciyi açmak, aracın dinlediği adresle POST /public/v1/webhooks çağrısı yapar, kapatmak ise DELETE /public/v1/webhooks/:id çağrısı yapar. Kendi kodunuz da bir API anahtarıyla aynısını yapabilir.

Zapier, Make veya n8n'i kurun

Nasıl iletilir

  • JSON gövdeli bir POST isteği, olay adı başlıkta X-PostNimbo-Event.
  • Sunucunuzun yayınlanan bir gönderiye yanıt vermek için 10 saniyesi, bir akış olayına yanıt vermek için 5 saniyesi vardır. Bir akış olayı zaman aşımı, 429 veya 5xx yanıtından sonra iki kez daha denenir; yayınlanan gönderi yeniden denenmez. Hızlıca yanıt verin, işi sonra yapın.
  • Yalnızca herkese açık https adresleri kabul edilir ve yönlendirmeler de herkese açık bir adrese gitmelidir.
  • Her iletim, webhook ayarlarında gösterilen secret ile şu başlıklarda imzalanır: X-PostNimbo-Timestamp, X-PostNimbo-Signature.

İletimin bizden geldiğini doğrulayın

Zaman damgası, bir nokta ve ham gövdenin secret'ınızla HMAC-SHA256 değerini hesaplayın, sabit sürede imza başlığıyla karşılaştırın ve 5 dakikadan eski zaman damgalarını reddedin.

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))
  );
}

Olaylar

Aynı liste GET /public/v1/webhooks/events adresinden de sunulur; böylece bir araç tetikleyicileri ve örnek verileri gösterebilir.

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.

Yük
[
  {
    "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.

Yük
[
  {
    "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.

Yük
[
  {
    "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.

Yük
{
  "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.

Yük
{
  "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 ile bir şey mi geliştiriyorsunuz?

Ne yaptığınızı bize anlatın. API konusunda yardımcı oluyor, dizin için uygulamaları inceliyor ve entegrasyonların ihtiyaç duyduğu uç noktaları ekliyoruz.