For the complete documentation index, see llms.txt. This page is also available as Markdown.

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"

Última actualización