> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/es/tools/api-integration.md).

# Integración con API personalizadas

La herramienta de Llamada API le permite conectar Crew a cualquier servicio externo que tenga una API REST. Esta es la herramienta mas flexible de Crew — si un servicio tiene una API, puede conectarlo.

## Como Funciona

1. **Almacene sus credenciales de API** en Configuracion
2. **Pidale a Crew** que llame a la API en lenguaje natural
3. Crew construye la solicitud de API y devuelve los resultados

## Configurar Credenciales

Antes de usar una API externa, almacene su clave de API:

1. Vaya a **Configuracion**
2. Desplacese hasta **Credenciales de API** (o configurelas al instalar un skill del Marketplace que requiera una)
3. Agregue su credencial:
   * **Nombre de la clave**: Una etiqueta como `MI_SERVICIO_API_KEY`
   * **Valor**: Su clave de API real

Las credenciales se cifran y almacenan de forma segura. Cuando Crew hace llamadas API, inyecta la credencial usando un placeholder `{{NOMBRE_CLAVE}}` — la clave real nunca se expone en la conversacion.

## Hacer Llamadas API

### Solicitud GET Simple

> "Llama a la API de JSONPlaceholder para obtener los primeros 5 posts: GET <https://jsonplaceholder.typicode.com/posts?\\_limit=5>"

### Solicitud Autenticada

> "Revisa mi base de Airtable usando mi clave API: GET <https://api.airtable.com/v0/appXXXXX/Table1> con Authorization: Bearer {{AIRTABLE\_API\_KEY}}"

### Solicitud POST

> "Crea una nueva tarea en mi herramienta de gestion de proyectos: POST <https://api.ejemplo.com/tasks> con body { "title": "Revisar propuesta", "priority": "high" }"

## Metodos HTTP Soportados

* **GET** — Recuperar datos
* **POST** — Crear nuevos recursos
* **PUT** — Reemplazar recursos existentes
* **PATCH** — Actualizar parcialmente recursos
* **DELETE** — Eliminar recursos

## Tipos de Respuesta

* **JSON** — Datos estructurados (predeterminado)
* **Text** — Respuestas de texto plano
* **Binary** — Descargas de archivos

## Timeout

* Predeterminado: 30 segundos
* Maximo: 120 segundos

## Ejemplos Practicos

### Integracion con Airtable

> "Usa mi clave API de Airtable para listar todos los registros en la tabla 'Proyectos' y resume el estado de cada proyecto."

### Webhook de Slack

> "Envia un mensaje al canal de Slack de nuestro equipo usando esta URL de webhook: \[URL del webhook]. Mensaje: 'El reporte semanal esta listo.'"

### CRM Personalizado

> "Revisa nuestra API de CRM para los ultimos negocios: GET <https://api.nuestrocrm.com/deals?status=open> con mi clave API del CRM."

### Servicio de Clima

> "Usa la API de OpenWeatherMap para obtener el pronostico de 5 dias para Ciudad de Mexico."

### Combinar APIs

> "Revisa el precio de la accion usando la API financiera, luego publica el resultado en nuestro canal de Slack usando el webhook."

## Limites por Plan

| Plan  | Herramientas del Marketplace (incluyendo herramientas API) |
| ----- | ---------------------------------------------------------- |
| Free  | 1                                                          |
| Basic | 5                                                          |
| Plus  | 15                                                         |
| Pro   | Ilimitado                                                  |

## Seguridad

* Las credenciales se cifran en reposo (AES-256-GCM)
* Las claves API nunca se muestran en las respuestas de la conversacion
* El sistema de placeholders `{{NOMBRE_CLAVE}}` asegura que las claves solo se inyecten al momento de la ejecucion
* Puede eliminar credenciales almacenadas en cualquier momento desde Configuracion

## Consejos

* **Empiece simple**: Pruebe con una solicitud GET basica antes de construir flujos de trabajo complejos
* **Revise la documentacion de la API**: Asegurese de conocer el formato del endpoint y los headers requeridos
* **Use con tareas programadas**: Combine llamadas API con tareas programadas para monitoreo automatizado
* **Encadene solicitudes**: Puede pedirle a Crew que haga multiples llamadas API en secuencia — ej. "Obtiene datos de la API A, procesalos, luego envia el resultado a la API B"
