# Conectar APIs (herramientas HTTP)

> Permite que el agente consulte información de otro sistema mientras conversa: un precio, el stock, una cotización o el estado de un pedido. Así responde con el dato…

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

## ¿Para qué sirve?

Permite que el agente consulte información de otro sistema mientras conversa: un precio, el stock, una cotización o el estado de un pedido. Así responde con el dato real en vez de decir «no sé».

> Para conectarlo necesitás una **API**: es la puerta que tiene un sistema para que otros programas le pidan datos. Si no sabés si tu sistema tiene una, preguntale a quien lo administra.

### Ejemplos de uso

- Consultar precios o stock en tu sistema.
- Consultar el estado de un pedido.
- Crear un ticket de soporte.
- Generar un link de pago.

¿Querés que Bravilo le avise a otro sistema cuando pasa algo, sin que nadie se lo pida? Eso son los [Webhooks](https://help.braviloai.com/a/webhooks).

## Cómo configurarlo

1. Entrá al agente y abrí **Integraciones**.
2. En la tarjeta **Conectar APIs**, hacé clic en **Conectar** y después en **Agregar una herramienta**.
3. Elegí cómo empezar:
   - **Contame qué querés:** describís con tus palabras qué tiene que consultar.
   - **Desde una plantilla:** usás una ya armada (por ejemplo, la cotización del dólar).
   - **Pegá un cURL:** si quien administra tu sistema te pasó un ejemplo de consulta (un cURL), lo pegás y Bravilo completa el resto.
   - **A mano:** cargás cada dato vos.
4. Completá:
   - **Cómo se llama** la herramienta.
   - **Cuándo usarla:** explicá en qué situación tiene que consultarla. De esto depende que el agente la use en el momento justo.
   - **Método y dirección:** la dirección web a la que el agente hace la consulta. Si una parte cambia según la conversación (por ejemplo, el número de pedido), escribila como `:nombre` y el agente la completa.
   - **Autenticación** (la clave de acceso, si el sistema pide una) y **opciones avanzadas**, solo si hacen falta.
5. Recomendado: hacé clic en **Probar** y después en **Mandar la prueba** para ver si responde bien. Si dice **Contestó bien**, debajo ves la respuesta del otro sistema con el código **200** (quiere decir que salió todo bien).

   ![Probar la herramienta: la dirección consultada, el aviso Contestó bien. Ya podés volver y guardarla, y La respuesta con el código 200](https://help.braviloai.com/capturas/conectar-apis-02-probar.png?v=eb69442fc6)

6. Hacé clic en **Guardar la herramienta** y después en **Listo**.

En este video ves cómo se carga una herramienta desde una plantilla (la cotización del dólar) y cómo la usa el agente en el chat de prueba:

[Video: Video: conectar una API desde una plantilla, desde la pestaña Integraciones hasta la respuesta del agente con la cotización del dólar](https://help.braviloai.com/capturas/conectar-apis-01-plantilla.mp4?v=2fef489a60)

> En el video, **«Claudio»** es un agente de prueba que armamos para estas guías. En tu cuenta vas a ver el nombre de tu propio agente.

## Cómo comprobar que funciona

En el chat de prueba, hacé una pregunta que necesite ese dato (por ejemplo, «¿cómo viene mi pedido 1234?») y fijate que el agente responda con la información del otro sistema.

## Preguntas frecuentes

**¿Cómo sé si funciona antes de guardarla?**
Con **Probar** y después **Mandar la prueba** ves lo que responde el otro sistema. Si dice «Contestó bien», ya la podés guardar.

**¿Cómo sabe el agente cuándo usarla?**
Por lo que escribiste en **Cuándo usarla**. Cuanto más clara la explicación, mejor. Por ejemplo: «Cuando el cliente pregunte por el estado de su pedido y te dé el número».

## Guías relacionadas

- [Webhooks](https://help.braviloai.com/a/webhooks.md)