Vai al contenuto
Sviluppatori

Webhook

PostNimbo invia una richiesta al tuo indirizzo nel momento in cui un post va online, così Zapier, Make, n8n o il tuo server possono agire di conseguenza.

Configurane uno

  1. 1Apri Settings > Webhooks e aggiungi un nome e un indirizzo https pubblico.
  2. 2Scegli i canali a cui si applica, oppure nessuno per tutti i canali.
  3. 3Scegli i suoi eventi: post pubblicati, contatti raccolti da un flusso, flussi completati.
  4. 4Fai clic su Send test event per inviare un esempio di evento al tuo indirizzo.

In Zapier, Make e n8n

Le app PostNimbo per Zapier, Make e n8n effettuano l'iscrizione per te: attivare un trigger chiama POST /public/v1/webhooks con l'indirizzo su cui lo strumento è in ascolto, e disattivarlo chiama DELETE /public/v1/webhooks/:id. Il tuo codice può fare lo stesso con una chiave API.

Configura Zapier, Make o n8n

Come viene consegnato

  • Una POST con un body JSON e il nome dell'evento nell'header X-PostNimbo-Event.
  • Il tuo server ha 10 secondi per rispondere a un post pubblicato e 5 secondi per rispondere a un evento di flusso. Un evento di flusso viene ritentato altre due volte dopo un timeout, una risposta 429 o 5xx; un post pubblicato non viene ritentato. Rispondi subito ed esegui il lavoro dopo.
  • Sono accettati solo indirizzi https pubblici, e anche un reindirizzamento deve portare a un indirizzo pubblico.
  • Ogni consegna è firmata con il secret mostrato nelle impostazioni del webhook, negli header X-PostNimbo-Timestamp, X-PostNimbo-Signature.

Verifica che una consegna provenga da noi

Calcola un HMAC-SHA256 del timestamp, di un punto e del body grezzo con il tuo secret, confrontalo con l'header della firma in tempo costante e rifiuta un timestamp più vecchio di 5 minuti.

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

Eventi

Lo stesso elenco è disponibile su GET /public/v1/webhooks/events, così uno strumento può mostrare i trigger e i dati di esempio.

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": {}
  }
}

Stai creando qualcosa con PostNimbo?

Raccontaci cosa stai realizzando. Ti aiutiamo con l'API, esaminiamo le app per la directory e aggiungiamo gli endpoint di cui le integrazioni hanno bisogno.