# Webhooks

> Los webhooks permiten que Bravilo envíe automáticamente información a otro sistema cuando ocurre un evento en una conversación, por ejemplo, cuando se crea una…

Guía del Centro de ayuda de Bravilo · Tema: Integraciones · Fuente: https://help.braviloai.com/a/webhooks

## ¿Para qué sirve?

Los webhooks permiten que Bravilo envíe automáticamente información a otro sistema cuando ocurre un evento en una conversación, por ejemplo, cuando se crea una conversación o se recibe un mensaje.

> Sirve, por ejemplo, para que tu CRM o tu sistema de gestión se entere al instante de un lead nuevo, sin que nadie tenga que copiar los datos a mano. Normalmente lo configura quien administra ese otro sistema.

### ¿Webhooks o Conectar APIs?

Son dos cosas distintas y a veces se confunden:

| | **Webhooks** | **[Conectar APIs](https://help.braviloai.com/a/conectar-apis)** |
|---|---|---|
| Quién empieza | Bravilo, cuando pasa algo | El agente, durante una conversación |
| Para qué | Avisarle a otro sistema | Pedirle un dato a otro sistema |
| Ejemplo | Mandar cada lead nuevo a tu CRM | Consultar el estado de un pedido |

### Ejemplos de uso

- Sumar cada lead nuevo a tu CRM.
- Avisarle a tu equipo por correo o por Slack.
- Actualizar un tablero de métricas propio.
- Guardar las conversaciones en tu propia base de datos.

## Cómo configurarlo

1. Entrá al agente y abrí **Integraciones**.
2. En la tarjeta **Webhooks**, hacé clic en **Conectar** y después en **Agregar destino**.
3. Ingresá la URL del sistema que va a recibir los avisos (la dirección web que te da ese sistema para recibirlos).
4. Seleccioná los eventos que querés recibir:
   - **Empieza una conversación** (`conversation.created`).
   - **Hay un mensaje nuevo** (`conversation.message.created`).
   - **Se captura un lead** (`lead.captured`).
   - **Cambia el estado** de una conversación (`conversation.status.changed`).
   - **Cambia la prioridad** de una conversación (`conversation.priority.changed`).

   Tenés que elegir al menos uno.

   ![Formulario de Webhooks: La URL que recibe el POST y la lista de eventos (Empieza una conversación, Hay un mensaje nuevo, Se captura un lead, Cambia el estado), cada uno con su interruptor](https://help.braviloai.com/capturas/webhooks-01-destino.png?v=e0869618f4)

5. Si lo necesitás, en **Cuándo, y no siempre** configurá filtros por palabras, canales, datos de contacto, prioridad u horario, para recibir solo los avisos que te interesan. Si no prendés ninguno, el destino recibe todos los eventos que elegiste arriba.

   ![Filtros Cuándo, y no siempre: Ciertas palabras, Ciertos canales, Con datos de contacto, Cierta prioridad y Sólo en un horario, cada uno con su interruptor](https://help.braviloai.com/capturas/webhooks-02-filtros.png?v=dd5c94da5e)

6. Hacé clic en **Crear destino**.

Al crear el destino, Bravilo muestra una **firma** que permite verificar que los avisos provienen de Bravilo. Esta firma se envía en la cabecera `X-Bravilo-Signature` (un dato que viaja junto con cada aviso). Con **Copiar** la copiás para pegarla en tu sistema.

![El destino creado: su dirección, el evento elegido, la Firma con el botón Copiar y la aclaración de que viene en la cabecera X-Bravilo-Signature](https://help.braviloai.com/capturas/webhooks-03-firma.png?v=37a246aec0)

## Preguntas frecuentes

**¿Qué información recibo cuando se crea un mensaje?**
Con el evento `conversation.message.created`, se reciben los campos `id`, `role`, `content`, `createdAt` y `conversationId`. Incluye tanto los mensajes del cliente como las respuestas del agente.

**¿Cómo sé cuántos avisos se enviaron?**
En la ventana del destino hay un contador de envíos. Se actualiza cuando volvés a abrir la ventana.

**¿Cómo puedo probar la integración sin tener un servidor propio?**
Podés usar [webhook.site](https://webhook.site/) para obtener una URL de prueba. Ingresala como destino en Bravilo y revisá allí las solicitudes que recibas.

## Cómo eliminar un destino

Eliminar un destino borra su configuración: Bravilo deja de enviarle avisos a esa URL.

1. Abrí el destino y hacé clic en **Sacar este destino**.
2. Bravilo te pide confirmar: hacé clic en **Sacar el destino**.

## Guías relacionadas

- [Conectar APIs (herramientas HTTP)](https://help.braviloai.com/a/conectar-apis.md)
- [CRM, comercio, correo y comunicación](https://help.braviloai.com/a/crm-y-otras.md)