Vai al contenuto
AchaduDevelopers
API operativaVai al sito web ↗
Cruscotto →
Achadu/Developers/Webhook

Eventi affidabili, firmati e tracciabili.

Ricevi modifiche alla tua operazione senza polling. Ogni consegna passa attraverso la coda dedicata, salva i tentativi e porta una firma verificabile.

28 eventi di dominio

Firmali tutti con * oppure scegli solo gli eventi che effettivamente consuma la tua applicazione.

offer.createdoffer.updatedoffer.archivedoffer.publishedsegment.createdsegment.updatedsegment.deletedcoupon.createdcoupon.updatedcoupon.archivedtemplate.createdtemplate.updatedtemplate.deletedschedule.createdschedule.updatedschedule.deletedschedule.executedmonitor.createdmonitor.updatedmonitor.deletedstore.updatedjourney.createdjourney.updatedjourney.deletedconversation.updatedconversation.closedconversation.repliedwebhook.test

Schemi con versione evento

Ogni busta accetta api_version. Il catalogo fornisce l'URL dello schema e fornisce un esempio per convalidare i consumatori prima di pubblicare una modifica.

json
{
  "id": "evt_...",
  "type": "offer.updated",
  "api_version": "2026-08-31",
  "created_at": "2026-08-31T12:00:00.000Z",
  "data": { "offer_id": "off_..." }
}

Convalidare prima dell'elaborazione

Il segreto appare solo una volta. Calcola HMAC-SHA256 sul timestamp e sul corpo grezzo e confronta in tempo costante.

javascript
import { createHmac, timingSafeEqual } from "node:crypto";

const signed = `${timestamp}.${rawBody}`;
const expected = createHmac("sha256", process.env.ACHADU_WEBHOOK_SECRET)
  .update(signed)
  .digest("hex");
const received = signature.replace("sha256=", "");

if (!timingSafeEqual(Buffer.from(expected), Buffer.from(received))) {
  throw new Error("Invalid signature");
}

Consegna durevole

Coda indipendente dal processo web.
Fino a sei tentativi per guasti temporanei.
Timeout di 12 secondi per tentativo.
Cronologia con stato HTTP, errore e ora.
Le destinazioni interne e gli indirizzi privati sono bloccati.

Webhook Inspector

Nell'area Sviluppatori, apri una consegna per verificare il payload, la risposta di destinazione, lo stato HTTP, la durata, i tentativi e il prossimo tentativo. Lo stesso pannello consente di copiare l'evento e metterne in coda un nuovo invio.

Corpo grezzo conservato per il debug.
Risposta limitata e nessun segreto.
Durata misurata per tentativo.
Reinvia crea una nuova consegna collegata allo stesso event_id.