Ganchos de eventos

Los ganchos de eventos son webhooks de salida que se disparan cuando ocurre algo en tu proyecto, como la publicación de una entrada o una transición de flujo de trabajo. Cada gancho ejecuta una acción que envía una solicitud HTTP a una URL que tú indicas o publica un mensaje en un canal de Slack.

Usa los ganchos de eventos para integrar Contismo con sistemas externos: invalidar cachés, sincronizar datos con otras plataformas, disparar compilaciones o avisar a tu equipo en Slack.

Crear un gancho de eventos

1. Ve a Configuración → Ganchos de eventos.
2. Haz clic en Crear hook de eventos.
3. Ingresa un nombre que identifique qué hace el gancho.
4. Elige un Disparador (consulta la tabla de abajo).
5. De forma opcional, limita el gancho a modelos de contenido específicos.
6. Elige una Acción: HTTP o Slack.
7. Configura los detalles de la acción y guarda.

Crear y administrar ganchos de eventos requiere los permisos de webhook correspondientes en tu rol.

Disparadores

Disparador	Se dispara cuando
Entrada creada	Se crea una entrada nueva.
Entrada actualizada	Se guarda una entrada existente.
Entrada publicada	Una entrada se publica.
Entrada despublicada	Una entrada publicada se retira.
Entrada movida a la papelera	Una entrada se elimina (se mueve a la papelera).
Entrada restaurada	Una entrada de la papelera se restaura.
Entrada eliminada de forma permanente	Una entrada se elimina de forma permanente de la papelera.
Transición de flujo de trabajo	Una entrada pasa a un estado nuevo del flujo de trabajo.

Puedes restringir un gancho a uno o más modelos de contenido para que solo se dispare con las entradas que coincidan.

Acciones HTTP

Una acción HTTP envía una solicitud a una URL que tú indicas cuando se activa el disparador.

Configura:

• URL: el extremo que recibe la solicitud.
• Método: POST, PUT o PATCH.
• Encabezados: encabezados personalizados que se envían con la solicitud. Marca los valores sensibles como secreto para almacenarlos cifrados.
• Secreto de firma (opcional): cuando está definido, las solicitudes incluyen un encabezado X-EventHook-Signature con una firma HMAC-SHA256 que tu extremo puede verificar.

Tu extremo debe responder con un código de estado de éxito. Las entregas fallidas quedan registradas en el registro de entregas del gancho.

Acciones de Slack

Una acción de Slack publica un mensaje con formato en un canal de Slack cuando se activa el disparador.

Antes de usar una acción de Slack:

1. Conecta Slack para el proyecto. Consulta Slack.
2. Al crear el gancho de eventos, elige Slack como acción y selecciona un canal.

Canales privados

En los canales privados, invita a la aplicación de Contismo al canal en Slack antes de seleccionarlo en el gancho de eventos. La aplicación debe ser miembro del canal para ver y publicar mensajes allí.

Registros de entrega

Cada gancho de eventos tiene un registro de entregas con los intentos recientes, hayan tenido éxito o hayan fallado. En la lista de ganchos de eventos, haz clic en Ver registros de un gancho para inspeccionar entregas individuales.

Usa los registros para depurar problemas de integración, como URL incorrectas, fallos de autenticación o canales de Slack que ya no están disponibles.

Permisos

Los ganchos de eventos se administran en Configuración → Desarrolladores. Los miembros del equipo necesitan capacidades de webhook para listar, crear, actualizar o eliminar ganchos. Las acciones de Slack además requieren que Slack esté conectado por alguien con el permiso Administrar integraciones.

Relacionado

• Slack: conecta un espacio de trabajo de Slack para las acciones de Slack.