> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braviloai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP Tools y Webhooks

## Dos herramientas diferentes

Bravilo tiene dos sistemas de integración distintos.

Es importante entender la diferencia: HTTP Tools El agente llama a tu API durante una conversación.

Ejemplo: buscar un precio, crear un ticket, generar un link de pago.

Agente → tu sistema Webhooks Bravilo notifica a tu sistema cuando pasa algo.

Ejemplo: nuevo lead capturado, conversación finalizada, mensaje recibido.

## HTTP Tools: El agente llama a tu API

Las HTTP Tools se crean desde las Habilidades del agente.

Son herramientas que el agente decide usar durante una conversación: - Andá a tu agente → "Habilidades"

* Buscá "Herramientas HTTP" o "Custom Tool"
* Hacé click en "Crear herramienta"
* Configurá: URL , Método (GET/POST), Headers y Body
* Describí en lenguaje natural cuándo debe usarla

## Webhooks: Notificaciones automáticas

Los Webhooks son notificaciones que Bravilo envía a tu sistema cuando ocurre un evento.

No dependen de una conversación — se disparan automáticamente.

\- Andá a tu agente → sección "Webhooks"

* Hacé click en "Crear webhook"
* Ingresá la URL de tu sistema que va a recibir las notificaciones
* Seleccioná los eventos que querés escuchar
* Opcionalmente, configurá filtros para ser más específico
* Bravilo te genera un Secret para verificar la autenticidad de cada request

## Seguridad y verificación

Cada webhook tiene un Secret único que Bravilo usa para firmar cada entrega.

Tu sistema puede verificar que la notificación viene realmente de Bravilo: // Verificá la firma con el Secret: const expected = crypto .createHmac('sha256', WEBHOOK\_SECRET) .update(rawBody) .digest('hex'); if (signature === expected) \`} Seguridad: Siempre verificá la firma en producción.

Sin esta verificación, cualquiera podría enviar requests falsos a tu endpoint.

## Historial de entregas

Cada webhook tiene un historial de entregas (deliveries) donde podés ver:

## Casos de uso

HTTP Tools (durante charla) ).
