Conectores API para datos en vivo del Chatbot

Conectores API

Los Conectores API permiten que tu chatbot llame a API REST externas durante una conversación para obtener datos en tiempo real. Utilízalos para buscar pedidos, consultar inventario, verificar cuentas o extraer información de cualquier servicio que exponga una API. El chatbot recopila los datos necesarios del visitante, llama a tu API, valida la respuesta y presenta el resultado de forma conversacional.

Los Conectores API están disponibles en el plan Estándar y superiores. No están incluidos en los planes Gratis o Básico.

Añadir un conector API

Abre tu asistente en el Panel y ve a la pestaña Funciones. Elige Conectar otros sistemas en la lista, dentro de Saber más. En su tarjeta, cada conector API se llama conexión. La lista de funciones muestra Activa en cuanto el chatbot usa al menos una conexión. Haz clic en Añadir conexión.

En el diálogo se inicia directamente el Asistente de IA. Describe tu objetivo, por ejemplo consultar el estado de los pedidos de una tienda WooCommerce. El Asistente de IA te pregunta paso a paso, investiga la interfaz del sistema y rellena la configuración por sí mismo. El diálogo solo configura la conexión. Si el chatbot la usa, también en llamadas, lo decides en la lista de conexiones.

El formulario técnico con dirección (URL), método, encabezados, campos, validación de respuesta y prompt está plegado. Ábrelo con Mostrar detalles técnicos en la parte inferior del diálogo. Al crear una conexión nueva, ahí también encontrarás Seleccionar Plantilla con plantillas prediseñadas.

Para modificar una conexión existente, haz clic en el icono del lápiz. También en ese caso se inicia el Asistente de IA y te pregunta qué quieres cambiar. Las claves de acceso guardadas se mantienen y no se muestran al Asistente de IA.

En la lista de conexiones, cada conexión tiene dos interruptores:

  • La usa el chatbot: activado en una conexión nueva. Si lo desactivas, la conexión queda guardada, pero el chatbot ya no consulta nada a través de ella.
  • Usar también en llamadas: desactivado de forma predeterminada. Si está activado, el asistente telefónico también usa la conexión durante las llamadas. Mientras La usa el chatbot esté desactivado, este interruptor no se puede cambiar.

Por debajo del plan Estándar y fuera del periodo de prueba, la lista muestra un candado junto a la entrada y la tarjeta muestra un aviso para mejorar de plan en lugar de Añadir conexión. Las conexiones ya creadas siguen apareciendo en la lista.

Campos de configuración

Los siguientes campos se encuentran en Mostrar detalles técnicos. El Asistente de IA los rellena por ti y ahí puedes revisarlos y ajustarlos.

Configuración básica

CampoDescripciónObligatorio
NombreUn nombre descriptivo para este conector (por ejemplo, "Búsqueda de pedidos", "Consulta de inventario").Sí
URLLa URL del endpoint API (por ejemplo, https://api.example.com/orders).Sí
MétodoMétodo HTTP: GET, POST, PUT, PATCH o DELETE.Sí (predeterminado: GET)
Headers (JSON)Encabezados HTTP opcionales en formato JSON (por ejemplo, {"Authorization": "Bearer abc123", "Content-Type": "application/json"}). Debe ser un JSON válido.No

Cuerpo de la Solicitud (solo POST/PUT/PATCH)

CampoDescripción
Tipo de Contenido del CuerpoFormato del cuerpo de la solicitud: JSON o Form Data.
Plantilla del Cuerpo de la SolicitudPlantilla para el cuerpo de la solicitud. Utiliza marcadores de posición como {email}, {order_id} que correspondan a tus campos definidos.

Ejemplo de plantilla del cuerpo:

{
  "email": "{email}",
  "order_id": "{order_id}"
}

Campos

Los campos definen qué información necesita recopilar el chatbot del visitante antes de llamar a la API. Cada campo tiene:

PropiedadDescripciónObligatorio
Nombre del CampoEl identificador del campo (por ejemplo, order_id, email). Se utiliza como marcador de posición en el cuerpo de la solicitud.Sí
TipoTipo de datos: string, number, email o boolean.Sí (predeterminado: string)
Descripción (para la IA)Explica a la IA para qué sirve este campo y cómo solicitárselo al visitante.No
ObligatorioIndica si el visitante debe proporcionar este campo antes de que se llame a la API.No

Ejemplo de campos:

NombreTipoDescripciónObligatorio
order_idstringEl número de pedido del cliente, normalmente empieza por ORD-Sí
emailemailEl correo electrónico utilizado al realizar el pedidoSí

Reglas de Validación de Respuesta

Las reglas de validación verifican que la respuesta de la API coincida con los datos introducidos por el visitante. Esto evita devolver información a la persona equivocada o sobre un pedido incorrecto.

Cada regla tiene:

PropiedadDescripción
Campo de EntradaQué campo proporcionado por el visitante se debe validar (a partir de tus campos definidos).
Ruta de RespuestaRuta al valor en la respuesta de la API (por ejemplo, billing.email, data.order.status). Utiliza la notación por puntos para objetos anidados.
ComparaciónCómo comparar: equals, equals (ignore case), contains o not empty.
Mensaje de ErrorMensaje que se muestra al visitante cuando falla la validación (por ejemplo, "El correo electrónico no coincide con nuestros registros").

Ejemplo de validación:

Campo de EntradaRuta de RespuestaComparaciónMensaje de Error
emailbilling.emailequals (ignore case)El correo electrónico no coincide con el pedido. Por favor, compruébalo e inténtalo de nuevo.

Prompt

Instrucciones para la IA sobre cuándo y cómo utilizar este conector. Esto es fundamental para que el chatbot sepa cuándo activar la llamada a la API.

Ejemplo de prompt:

Use this connector when a customer asks about their order status, shipping 
information, or delivery date. Ask for their order ID and email address before 
making the API call. Present the order status, shipping method, and estimated 
delivery date in a friendly format.

Cómo funciona

  1. El visitante hace una pregunta que coincide con el prompt del conector (por ejemplo, "¿Dónde está mi pedido?")
  2. El chatbot solicita los campos obligatorios (por ejemplo, ID del pedido, correo electrónico)
  3. El visitante proporciona la información
  4. El chatbot llama a la API con los datos recopilados
  5. Se comprueban las reglas de validación con respecto a la respuesta
  6. Si la validación es correcta, el chatbot presenta los datos en un formato conversacional

Encadenar múltiples Conectores API

Puedes combinar múltiples conectores API para gestionar flujos de trabajo complejos. La IA los encadena automáticamente cuando es necesario.

Ejemplo: Autenticación y recuperación de datos

  1. Conector 1, "Autenticar Cliente": llama a un endpoint de inicio de sesión con el correo electrónico y la contraseña del visitante, y recibe un token de autenticación en la respuesta.
  2. Conector 2, "Obtener Detalles del Pedido": utiliza el token de la primera solicitud para llamar a un endpoint de API protegido y recuperar los datos del pedido.

La IA gestiona esto a la perfección: reconoce que el segundo conector requiere datos del primero, ejecuta las llamadas en el orden correcto y presenta el resultado final al visitante, todo dentro del mismo flujo de conversación.

Para configurarlo, define cada conector de forma independiente con su propio endpoint, campos y prompt. En el prompt del segundo conector, describe que depende de los datos del primero (por ejemplo, "Utiliza el token de autenticación del conector Autenticar Cliente para llamar a este endpoint"). La IA coordinará la secuencia automáticamente.

Prácticas recomendadas

  • Escribe prompts claros: el prompt es el campo más importante, ya que determina cuándo se activa el conector
  • Añade reglas de validación: valida siempre los datos confidenciales para evitar filtraciones de información
  • Utiliza descripciones de campo claras: ayuda a la IA a hacer las preguntas correctas de forma natural
  • Realiza pruebas con respuestas de API reales: asegúrate de que la ruta de respuesta coincida con la estructura real de tu API
  • Gestiona los errores adecuadamente: define mensajes de error claros para los fallos de validación
  • Utiliza encabezados de autenticación: protege siempre tus endpoints de API con la autenticación adecuada