Webhook Notifier
Envía notificaciones webhook salientes cuando cambia contenido dentro de EmDash CMS.
Extensión
Webhook Notifier
Envía notificaciones webhook salientes cuando cambia contenido dentro de EmDash CMS.
Webhook Notifier permite que EmDash envíe señales a sistemas aguas abajo cuando cambia el contenido: indexación de búsqueda, notificaciones en chat, pipelines de CI o herramientas de revisión personalizadas. La implementación está en packages/plugins/webhook-notifier.
Instalación
- Elige endpoints receptores que usen HTTPS y autentiquen solicitudes (secreto compartido, firmas HMAC o mTLS, según lo que soporte el plugin en tu versión).
- Habilita el plugin en el admin y registra tu primera URL de endpoint en un proyecto no productivo.
- Dispara un evento de prueba (por ejemplo, guardar un borrador) y confirma que el receptor registre el payload esperado.
Configuración
La configuración habitual incluye:
- Filtros de eventos — qué colecciones o tipos de transición disparan webhooks (create, update, publish, delete).
- Estructura del payload — los cuerpos JSON suelen incluir id, slug, marcas de tiempo y actor; confirma contra el esquema documentado del plugin.
- Política de reintentos — backoff exponencial frente a comportamiento de dead letter cuando el receptor no está disponible.
Ejemplo (conceptual): tu indexador podría esperar un POST con un cuerpo JSON como este:
{
"event": "publish",
"collection": "posts",
"slug": "launch-notes",
"url": "https://example.com/blog/launch-notes",
"occurredAt": "2026-04-04T12:00:00.000Z"
}Reemplaza claves y URLs con lo que realmente emita tu versión; valídalo con logs reales antes de depender de esto en producción.
Escenarios de uso
- Búsqueda — notifica a Algolia, Typesense o a un indexador interno para reindexar URLs modificadas.
- Slack o Teams — alertas ligeras para editores cuando se actualizan páginas de alta visibilidad.
- Hooks de despliegue — activa rebuilds estáticos o purgas de caché en redes edge cuando se publica contenido.
Consejos operativos
- Registra fallos de entrega y alerta ante tasas de error sostenidas.
- Rota secretos compartidos con la misma periodicidad que otras credenciales de integración.
- Evita bucles infinitos: no permitas que un handler de webhook escriba de vuelta en EmDash de forma que se vuelva a disparar, salvo que lo protejas con claves de idempotencia.