Crea una herramienta webhook

Cuándo utilizar un webhook

Un webhook es apropiado cuando el agente debe notificar un evento a un sistema externo: crear un lead, abrir una tarea o iniciar una automatización. Se configura de forma similar a una herramienta HTTP y utiliza POST de manera predeterminada.

Configura el evento

1. Crea una herramienta de tipo Webhook.
2. Escribe la URL HTTPS que recibirá el evento.
3. Añade las cabeceras requeridas por el receptor.
4. Define los datos que el agente debe recopilar.
5. Añade al cuerpo los valores fijos que identifiquen el origen o tipo de evento.

{
  "event": "support_request_created",
  "source": "inceptiva"
}

Diseña una recepción segura

Protege el endpoint con una cabecera secreta, valida el contenido recibido y responde rápidamente con un código 2xx. Si el trabajo posterior es lento, el receptor debería procesarlo de forma asíncrona.

Evita duplicados

La red o el sistema receptor pueden repetir una solicitud. Si una acción no debe ejecutarse dos veces, implementa idempotencia en el servicio de destino y utiliza un identificador único para el evento.