Skip to main content

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.

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) ).