Integraciones

Un webhook avisa a otro sistema (tu ERP, n8n, Zapier…) cada vez que pasa algo en la plataforma: se envía un POST con los datos del evento a la dirección que indiques. Para que otro sistema consulte o cree datos en la plataforma, usa las claves de API de Seguridad. Solo el administrador entra.

Dónde está: menú lateral → Configuración → Integraciones (/integraciones).

Recorrido por la pantalla

Parte	Para qué sirve
Nuevo webhook	Abre el formulario.
Tarjeta del webhook	Nombre, Activo / Inactivo, dirección destino y eventos suscritos.
Desactivar / Activar	Pausa o reanuda los envíos sin borrar el webhook.
Editar	Cambia nombre, dirección o eventos.
Bote (Eliminar)	Borra el webhook: «El sistema externo deja de recibir avisos.».
Ver secret (firma HMAC-SHA256)	Muestra la clave con que se firma cada envío.

Cómo crear un webhook

1. Clic en Nuevo webhook.
2. Escribe el Nombre * y la URL destino * (por ejemplo https://tu-sistema.com/webhook).
3. En Eventos *, marca los eventos que quieres recibir.
4. Clic en Crear.

El webhook nace activo y con su secret generado.

Eventos que se envían

Evento	Cuándo
ticket.creado	Se crea un ticket.
ticket.respondido	Un agente responde un ticket.
ticket.estado_cambiado	El ticket cambia de estado.
ticket.resuelto	El ticket pasa a resuelto.
ticket.cerrado	El ticket pasa a cerrado.
tarea.completada	Se completa una tarea de campo.
visita.checkin / visita.checkout	El técnico hace check-in / check-out.
visita.salida / visita.regreso	El técnico sale de la zona del cliente durante la visita / regresa.
evidencia.creada	Se captura una evidencia.
evidencia.aprobada / evidencia.rechazada	Se revisa una evidencia.

La lista del formulario también ofrece ticket.asignado, ticket.sla_vencido, ticket.csat_recibido, proyecto.creado y proyecto.completado, pero en esta versión no generan envíos.

Cómo verificar los envíos en tu sistema

Cada envío es un POST con cuerpo JSON {"evento": "…", "data": {…}} y estas cabeceras:

• X-EXM-Event: el nombre del evento.
• X-EXM-Signature: sha256= seguido del HMAC-SHA256 del cuerpo, calculado con el secret del webhook.

Calcula el HMAC del cuerpo recibido con el secret (en Ver secret (firma HMAC-SHA256)) y compáralo con la cabecera para confirmar que el aviso viene de la plataforma.

Reglas que conviene conocer

• Solo los webhooks activos reciben envíos, y solo de los eventos marcados.
• Cada envío espera la respuesta hasta 10 segundos. Si tu sistema falla o no responde, ese aviso no se reintenta y la pantalla no muestra un historial de entregas.
• Los datos de un ticket incluyen id, folio, título, estado, prioridad, canal, área, usuario y agente asignado.

Errores frecuentes

• El botón Crear no se activa: falta el nombre, la dirección o al menos un evento.
• «Eventos no soportados: …»: el evento no existe en la lista; vuelve a elegirlo del formulario.
• «No se pudo cambiar el estado del webhook.» / «No se pudo eliminar el webhook.»: falló la operación; recarga e intenta de nuevo.