--- title: "Conexiones de API" description: "Convierte cualquier API HTTP en una función que tu agente puede llamar durante la conversación: pega un comando cURL y el asistente crea la definición de la herramienta, los parámetros y la autenticación." --- Las conexiones de API son funciones HTTP personalizadas que tus agentes pueden invocar durante una conversación: consultar un pedido, crear un ticket u 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 podrán 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 El cuadro de 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 Zod** en el cuadro. ThunderPhone infiere toda la conexión a partir de lo que pegaste: URL, método, 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. 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 invocar la función: la descripción es lo que lee el modelo. Al guardar, primero se ejecuta una solicitud de prueba en tiempo real 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 **Validado**. 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** de la solicitud, el **método** (`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. Los valores de los encabezados son de solo escritura. Una vez guardados, se cifran y nunca se vuelven a mostrar, ni en el panel ni en la API. Al editar una conexión, un encabezado guardado muestra su nombre con puntos en lugar del valor y una nota de **Guardado**: déjalo como está para conservar el valor guardado o escribe uno nuevo para reemplazarlo. Las solicitudes de prueba y las llamadas en vivo usan el valor guardado. **Clonar** copia los valores guardados a la nueva conexión. Asigna a los parámetros descripciones en lenguaje sencillo ("Dirección de correo electrónico del cliente, p. ej., jane@example.com"). El agente elige 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: **Validado**, **Sin probar** o **Error**; el nombre de su 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 pertenezcas. Al moverla, se elimina de aquí; es posible que los agentes que la usaban necesiten una reconfiguración. - **Eliminar**: es permanente; los agentes que usan la conexión deberán reconfigurarse. ## Adjuntarla a un agente Agrega la conexión a un agente en la sección de conexiones de API del creador ([Crear un agente](/es/guides/build-an-agent)). La lista muestra qué agentes usan cada conexión, para que puedas ver de un vistazo a qué afecta un cambio. ## Próximos pasos Crea y administra las mismas conexiones mediante programación. Conexiones prediseñadas para Google, Slack, HubSpot, Salesforce y Cal.com. Expón un servidor de herramientas completo a tus agentes. Todos los campos del recurso de integración.