HTTP personalizado

Construye herramientas HTTP personalizadas para conectar tu agente de voz a cualquier API o servicio externo.

Visión general

Las herramientas HTTP personalizadas te permiten definir llamadas API que tu agente puede ejecutar durante conversaciones de voz. Esto es útil para integrar con sistemas internos o APIs no disponibles en el marketplace.

Crear una herramienta personalizada

Navega a la pestaña Herramientas de tu agente, haz clic en Agregar herramienta y selecciona HTTP personalizado.

Campos de configuración

Parámetros del cuerpo

Cada parámetro del cuerpo tiene:

Modo dinámico

Cuando se establece en Dinámico, el LLM determina el valor según el contexto de la conversación. Agrega una descripción para ayudar a la IA a entender qué valor extraer.

Modo variable

Cuando se establece en Variable, selecciona de tus variables predefinidas (por ejemplo, {{first_name}}, {{last_name}}). El valor se extraerá de los datos del prospecto.

Ejemplo: Herramienta de actualización de CRM

Nombre de herramienta: Actualizar contacto de CRM
Cuándo ejecutar: Cuando el llamante proporciona información de contacto actualizada
Endpoint de API: https://api.yourcrm.com/contacts/update
Método: POST
Encabezados:
  - Authorization: Bearer {api_token}
Parámetros del cuerpo:
  - first_name (Variable): {{first_name}}
  - last_name (Variable): {{last_name}}
  - phone (Dinámico): El número de teléfono del llamante
  - notes (Dinámico): Resumen de la llamada

Mejores prácticas

• Usa nombres descriptivos de herramienta — La IA usa el nombre para entender el propósito de la herramienta
• Proporciona condiciones de ejecución claras — Las condiciones ambiguas llevan a un uso incorrecto de la herramienta
• Prueba con llamadas de muestra — Verifica que la herramienta funcione antes de implementar en producción
• Maneja errores con elegancia — Configura mensajes de respaldo si falla la llamada API