Skip to main content
Las conexiones API son funciones HTTP personalizadas que tus agentes pueden llamar durante una conversación: consultar un pedido, crear un ticket, obtener el estado de una cuenta desde tu propio backend. Defines el endpoint una vez en Conexiones → APIs (/dashboard/api-connections); los agentes que tengan la conexión adjunta pueden invocarla cuando la conversación lo requiera. Hay dos formas de crear una: pegar algo que el asistente pueda analizar o configurar la conexión manualmente.

La vía rápida: pegar y analizar

1

Haz clic en Nueva conexión API

El diálogo se abre en el asistente. Pega un comando cURL de ejemplo, una especificación OpenAPI/Swagger, una exportación de Postman, una interfaz de TypeScript o un esquema de Zod en el cuadro.
2

Haz clic en Analizar

ThunderPhone infiere toda la conexión a partir de lo que pegaste: la URL, el método, los encabezados y un esquema de parámetros derivado de los parámetros de consulta y el cuerpo de la solicitud que encontró. Los encabezados que pegaste (incluidos los de autenticación) se incorporan a la configuración del endpoint.
3

Confirma los campos resaltados

La configuración inferida se abre con los campos estimados resaltados para que los revises. Ajusta los nombres, las descripciones y los tipos de parámetros para que el agente entienda cuándo y cómo llamar a la función: la descripción es lo que lee el modelo.
4

Validar y guardar

Al guardar, primero se ejecuta una solicitud de prueba en vivo contra tu endpoint. Si la solicitud falla, la conexión no se guarda: corrige la URL, los encabezados de autenticación o el cuerpo e inténtalo de nuevo. Si tiene éxito, la conexión se almacena con una insignia de Validada.
Si el asistente no puede encontrar una URL de solicitud en lo que pegaste, te lo indicará: incluye un endpoint http(s) completo e inténtalo de nuevo.

Configuración manual

Haz clic en Configurar manualmente → en el asistente (o en ¿Quieres que la IA infiera esto? Prueba el asistente → para volver). El creador manual tiene dos editores:
  • Visual: campos de formulario para el nombre visible, el nombre de la función, la URL, el método de solicitud (POST, GET, PUT, PATCH, DELETE), los encabezados personalizados y el esquema de parámetros (Agregar propiedad para cada argumento que el agente pueda proporcionar).
  • JSON: la misma definición como JSON sin procesar, para pegar o ajustar directamente una especificación de herramienta.
Un panel de Solicitud de prueba (opcional) te permite enviar la solicitud configurada antes de guardar y muestra el estado, la latencia y una vista previa de la respuesta. Validar y guardar siempre ejecuta esta prueba y solo guarda si tiene éxito.
Proporciona a los parámetros descripciones en lenguaje claro (“Dirección de correo electrónico del cliente, p. ej., jane@example.com”). El agente elige los argumentos a partir de estas descripciones en tiempo real, durante la llamada.

Administra tus conexiones

Cada fila de conexión muestra su estado de validación: Validada, Sin probar o Error; su nombre de función y qué agentes la usan. Desde el menú de acciones de la fila puedes:
  • Editar: volver a abrir la configuración.
  • Clonar: duplicarla como punto de partida (la copia comienza sin probar).
  • Historial de revisiones: ver versiones anteriores y restaurar una en el editor.
  • Transferir: copiar o mover la conexión a otra organización a la que perteneces. Al moverla, se elimina de aquí; es posible que los agentes que la usaban necesiten volver a configurarse.
  • Eliminar: permanente; los agentes que usen la conexión deberán volver a configurarse.

Adjuntarla a un agente

Agrega la conexión a un agente en la sección de conexiones API del creador (Crear un agente). La lista muestra qué agentes usan cada conexión, para que puedas ver de un vistazo a qué afecta un cambio.

Próximos pasos

Integraciones de herramientas mediante API

Crea y administra las mismas conexiones de forma programática.

Conectar aplicaciones

Conexiones prediseñadas con Google, Slack, HubSpot, Salesforce y Cal.com.

Agregar un servidor MCP

Expón un servidor completo de herramientas a tus agentes.

Referencia de la API de integraciones

Todos los campos del recurso de integración.