Webhook Notifier
Invia notifiche webhook in uscita quando il contenuto cambia in EmDash CMS.
Estensione
Webhook Notifier
Invia notifiche webhook in uscita quando il contenuto cambia in EmDash CMS.
Dettagli prodotto
- Categoria
- Automazione
- Stato
- Disponibile
- Versione
- Incluso nella beta
Webhook Notifier consente a EmDash di inviare segnali ai sistemi a valle quando il contenuto cambia — indicizzazione, notifiche chat, pipeline CI o strumenti di review personalizzati. L’implementazione è in packages/plugins/webhook-notifier.
Installazione
- Scegli endpoint di ricezione HTTPS che autentichino le richieste (secret condiviso, firme HMAC o mTLS — in linea con quanto supporta la tua versione del plugin).
- Abilita il plugin in admin e registra la prima URL endpoint in un progetto non di produzione.
- Genera un evento di test (ad es. salva una bozza) e verifica che il ricevente registri il payload atteso.
Configurazione
Impostazioni comuni:
- Filtri evento — quali collezioni o transizioni innescano webhook (create, update, publish, delete).
- Forma del payload — i JSON spesso includono id, slug, timestamp e attore; confronta con lo schema documentato della versione.
- Politica di retry — backoff esponenziale vs dead letter quando il ricevente è giù.
Esempio (concettuale): il tuo indicizzatore potrebbe attendere un POST JSON come:
{
"event": "publish",
"collection": "posts",
"slug": "launch-notes",
"url": "https://example.com/blog/launch-notes",
"occurredAt": "2026-04-04T12:00:00.000Z"
}
Sostituisci chiavi e URL con ciò che la tua release emette — verifica sui log live prima di affidarci la produzione.
Scenari d’uso
- Ricerca — notificare Algolia, Typesense o un indicizzatore interno per rifetchare URL cambiate.
- Slack o Teams — alert leggeri per editor quando pagine ad alta visibilità si aggiornano.
- Hook di deploy — innescare rebuild statici o purge cache in edge alla pubblicazione.
Suggerimenti operativi
- Registra i fallimenti di consegna e avvisa su tassi di errore persistenti.
- Ruota i secret condivisi come le altre credenziali di integrazione.
- Evita loop infiniti — non far riscrivere l’handler webhook in EmDash in modo da riattivarsi senza chiavi di idempotenza.