HTTP personalizado

Construye herramientas HTTP personalizadas para conectar tu agente de canal de texto 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 texto (SMS, WhatsApp, Instagram, Gmail). 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

Información básica

Configuración HTTP

Parámetros de solicitud

Cada parámetro de solicitud tiene:

Autenticación

Almacena credenciales de forma segura que se pueden usar en encabezados y cuerpo de solicitud:

Modos de parámetro

Modo dinámico

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

Ejemplo: first_name con descripción “El nombre del cliente mencionado en la conversación”

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 automáticamente.

Ejemplo: Herramienta de actualización de CRM

Nombre de herramienta: Actualizar contacto de CRM
Descripción: Actualiza información de contacto en el sistema CRM
URL de API: https://api.yourcrm.com/contacts/update
Método: POST
Encabezados:
  - Authorization: Bearer {api_token}
Parámetros de solicitud:
  - first_name (Variable): {{first_name}}
  - last_name (Variable): {{last_name}}
  - email (Dinámico): El correo electrónico del cliente si se menciona
  - notes (Dinámico): Resumen de la conversación
Autenticación:
  - api_token: your-secret-api-key

Mejores prácticas

• Usa nombres descriptivos de herramienta — La IA usa el nombre para entender el propósito de la herramienta
• Proporciona descripciones claras — Las descripciones ambiguas llevan a un uso incorrecto de la herramienta
• Usa el modo Variable cuando sea posible — Los datos prellenados son más confiables que la extracción dinámica
• Prueba exhaustivamente — Verifica que la herramienta funcione antes de implementar en producción
• Maneja errores con elegancia — Asegúrate de que tu API devuelva mensajes de error significativos