Llamada a una API durante la conversación
Con la herramienta Sistema CRM, tu agente llama a tu sistema durante la llamada para registrar o consultar datos, por ejemplo un lead o el estado de un pedido.
Con la herramienta Sistema CRM, tu agente se conecta con tu sistema durante la conversación. Pregunta los datos que definas y los envía por HTTP a tu URL, por ejemplo para crear un lead, abrir un ticket o consultar el estado de un pedido. Si tu sistema responde con datos, el agente puede decírselos a quien llama.
Cuándo usar esta herramienta y cuándo otra
| Objetivo | Herramienta |
|---|---|
| Registrar o consultar datos durante la conversación | Sistema CRM en la pestaña Herramientas |
| Cargar contexto al sonar el teléfono | Incoming Webhook |
| Pasar los datos de la conversación después de la llamada | Ticket CRM en Automatización, consulta n8n |
Crear la herramienta
El asistente te guía por la configuración en cuatro pasos.
- Plantilla: abre Herramientas › Agregar › Sistema CRM. Elige un sector, por ejemplo oficios, inmobiliario o seguros, o empieza en blanco.
- Parámetros dinámicos: define qué datos pregunta el agente durante la conversación. Con Agente IA describes tu caso en una frase y dejas que te proponga los parámetros.
- Configurar endpoint: introduce el nombre de la herramienta, el texto de espera, la descripción para la IA y la URL. En Ajustes avanzados configuras el timeout y los headers.
- Copiar plantilla de prompt: bhomy genera una sección para tu prompt. Cópiala con Copiar prompt y pégala en el prompt de la pestaña Personalidad.
Parámetros
Para cada parámetro defines:
| Dato | Significado |
|---|---|
| Nombre | nombre del campo en el JSON enviado, por ejemplo first_name |
| Tipo | Texto, Número, E-mail, Teléfono, Fecha, Sí/No o Selección con opciones separadas por comas |
| Obligatorio | El agente solo llama a la herramienta cuando tiene todos los datos obligatorios |
| Pregunta | cómo lo pregunta el agente, por ejemplo «¿Cuál es su nombre completo?» |
| Descripción | qué debe ir en el campo |
Endpoint
| Campo | Significado |
|---|---|
| Nombre de la herramienta | nombre con el que el agente conoce la herramienta, por ejemplo «Crear lead» |
| Texto de espera | frase que dice el agente durante la llamada a la API, por ejemplo «Estoy registrando sus datos.» |
| Descripción (para la IA) | cuándo llama el agente a la herramienta, por ejemplo «Crea un lead nuevo. Llamar solo cuando estén todos los campos obligatorios.» |
| Endpoint Webhook | método POST o GET y la URL de tu sistema |
| Fire-and-Forget | activado: solo envía, la respuesta no se evalúa. Desactivado: el agente recibe la respuesta y puede usarla |
| Timeout (ms) | cuánto espera el agente la respuesta |
| Headers | por ejemplo Authorization: Bearer … o X-Api-Key |
La Vista previa del cuerpo de solicitud muestra lo que se envía. Con POST los parámetros van como JSON en el cuerpo; con GET, como parámetros de consulta.
{
"first_name": "Anna",
"last_name": "Berger",
"phone": "+491701234567",
"request": "Presupuesto para una bomba de calor"
}
La respuesta de tu sistema
Con Fire-and-Forget desactivado, bhomy pasa la respuesta de tu sistema al agente. Responde con un objeto JSON que se pueda leer en voz alta:
{ "status": "enviado", "delivery_date": "jueves", "carrier": "DHL" }
El agente formula con ello una respuesta, por ejemplo «Su pedido ya está enviado y llegará el jueves con DHL.» Si tu sistema responde con un error o demasiado tarde, el agente le dice a quien llama que ahora no ha funcionado y le ofrece otra vía. No menciona códigos de estado ni textos de error.
Seguridad y rapidez
| Punto | Recomendación |
|---|---|
| Autenticación | Comprueba un header secreto. No hay direcciones IP fijas |
| Rapidez | Responde en pocos segundos. Quien llama espera mientras tu sistema trabaja |
| Datos | Devuelve solo lo que el agente puede decir. Todo lo que haya en la respuesta puede comunicárselo a quien llama |
Lo que el agente envió y recibió aparece en el historial de llamadas en Main Logs.
¿Te ha sido útil esta página?