Перейти к содержимому
Разработчикам

Вебхуки

PostNimbo отправляет запрос на ваш адрес в момент выхода поста, чтобы Zapier, Make, n8n или ваш собственный сервер могли на это отреагировать.

Настройка

  1. 1Откройте Settings > Webhooks и укажите название и публичный 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 секунд на ответ о событии сценария. Событие сценария отправляется ещё дважды после тайм-аута, ответа 429 или 5xx; опубликованный пост повторно не отправляется. Отвечайте быстро, а обработку выполняйте потом.
  • Принимаются только публичные https-адреса, и перенаправление тоже должно вести на публичный адрес.
  • Каждая доставка подписывается секретом, указанным в настройках вебхука, в заголовках X-PostNimbo-Timestamp, X-PostNimbo-Signature.

Проверьте, что доставка пришла от нас

Вычислите HMAC-SHA256 от временной метки, точки и необработанного тела с помощью вашего секрета, сравните результат с заголовком подписи за постоянное время и отклоняйте временные метки старше 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.

Полезная нагрузка
[
  {
    "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, проверяем приложения для каталога и добавляем эндпоинты, которые нужны интеграциям.