> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexiones API

> Convierte cualquier API HTTP en una función que tu agente puede llamar durante una conversación — pega un comando cURL y deja que el asistente haga el resto.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

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.

<Tip>
  Proporciona a los parámetros descripciones en lenguaje claro ("Dirección de correo electrónico del cliente,
  p. ej., [jane@example.com](mailto:jane@example.com)"). El agente elige los argumentos a partir de estas
  descripciones en tiempo real, durante la llamada.
</Tip>

## 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](/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

<CardGroup cols={2}>
  <Card title="Integraciones de herramientas mediante API" icon="code" href="/es/guides/build-tool-integration">
    Crea y administra las mismas conexiones de forma programática.
  </Card>

  <Card title="Conectar aplicaciones" icon="cable" href="/es/guides/connect-apps">
    Conexiones prediseñadas con Google, Slack, HubSpot, Salesforce y Cal.com.
  </Card>

  <Card title="Agregar un servidor MCP" icon="server" href="/es/guides/mcp-servers">
    Expón un servidor completo de herramientas a tus agentes.
  </Card>

  <Card title="Referencia de la API de integraciones" icon="book" href="/api-reference/integrations">
    Todos los campos del recurso de integración.
  </Card>
</CardGroup>