Introducción a las APIs

​

Visión General

• Documentación completa de todas las APIs disponibles
• Especificaciones OpenAPI para cada servicio
• Ejemplos de uso e integración
• Guías de autenticación y autorización

​

APIs Disponibles

​

Servicios de Aplicación

• Gestión de agentes de IA
• Custom Tools y MCP (Model Context Protocol)
• Sincronización con bots Evolution
• Base URL: https://api.evoai.app

• Gestión de conversaciones y mensajes
• CRUD de contactos y agentes
• Configuración de inboxes y canales
• Base URL: https://api.evoai.app

• Autenticación y autorización
• Multi-Factor Authentication (MFA)
• Role-Based Access Control (RBAC)
• Base URL: https://api.evoai.app

• Creación y gestión de campañas
• Segmentación de contactos
• Automatizaciones y workflows
• Base URL: https://api.evoai.app

• Procesamiento asíncrono de agentes
• Ejecución de workflows de IA
• Gestión de colas
• Base URL: https://api.evoai.app

• Carga y gestión de documentos
• Búsqueda semántica
• RAG (Retrieval-Augmented Generation)
• Base URL: https://api.evoai.app

​

Servicios de Infraestructura Evolution

• Gestión de instancias WhatsApp
• Envío y recepción de mensajes
• Integraciones con chatbots
• Base URL: https://api.evoai.app

• Gateway de alto rendimiento
• Procesamiento concurrente
• Base URL: https://api.evoai.app

​

Base URL

• Base URL: https://api.evoai.app

​

OpenAPI / Swagger

​

Especificaciones Disponibles

​

Servicios de Aplicación

• Evo Auth Service - Autenticación, gestión de usuarios y cuentas
• EvoAI Core Service - Agentes de IA, herramientas MCP y procesamiento inteligente
• EvoAI CRM Service - Gestión de contactos, conversaciones, inboxes, etiquetas y macros
• EvoAI Processor Service - Procesamiento de IA, integraciones y sesiones
• EvoAI Knowledge Service - Base de conocimiento y gestión de memoria

​

Servicios de Infraestructura Evolution

• Evolution API - API principal de Evolution para WhatsApp
• Evolution Go - Implementación en Go de Evolution

​

Autenticación

curl -X GET https://api.evoai.app/api/v1/agents \
  -H "api_access_token: <TU_TOKEN_UUID>" \
  -H "Content-Type: application/json"

​

Cómo Usar Esta Documentación

​

Navegación

• Introducción (esta página) - Visión general de las APIs y cómo empezar
• Autenticación - Guía completa de API Access Token y multi-tenant
• Especificaciones OpenAPI - Documentación interactiva de cada servicio (ver sección arriba)

​

Especificaciones OpenAPI

• Importar en Postman, Insomnia u otras herramientas
• Generar clientes SDK automáticamente usando openapi-generator
• Visualizar interactivamente usando Swagger UI

​

Ejemplos de Solicitudes

• Códigos de estado HTTP esperados
• Estructura de payloads de solicitud
• Formato de respuestas JSON

​

Códigos de Estado HTTP

• 200 - OK (solicitud exitosa)
• 201 - Created (recurso creado exitosamente)

• 400 - Bad Request (datos inválidos)
• 401 - Unauthorized (token inválido o ausente)
• 403 - Forbidden (sin permiso)
• 404 - Not Found (recurso no encontrado)
• 500 - Internal Server Error (error del servidor)
• 522 - Connection Timed Out (timeout en la conexión)

​

Quick Start

​

Ejemplo: Listar Agentes IA

curl -X GET https://api.evoai.app/api/v1/agents \
  -H "api_access_token: <TU_TOKEN_UUID>" \
  -H "Content-Type: application/json"

​

Ejemplo: Crear un Agente IA

curl -X POST https://api.evoai.app/api/v1/agents \
  -H "api_access_token: <TU_TOKEN_UUID>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Agente IA",
    "type": "llm",
    "model": "gpt-4",
    "prompt": "Eres un asistente útil.",
    "temperature": 0.7
  }'

​

Convenciones

​

Formato de Fecha

2026-01-26T10:30:00Z

​

Paginación

GET /api/v1/agents?page=1&pageSize=10

​

Filtros y Búsqueda

GET /api/v1/agents?status=active&type=llm

​

Herramientas Recomendadas

• Postman - Colección de APIs y pruebas
• Insomnia - Cliente REST alternativo
• Swagger UI - Visualización interactiva de las APIs
• OpenAPI Generator - Generación automática de SDKs
• curl - Pruebas rápidas vía línea de comandos

​

Próximos Pasos

1. Elige la API que necesitas usar
2. Consulta la especificación OpenAPI correspondiente
3. Configura autenticación obteniendo tu API Access Token
4. Comienza a integrar usando los ejemplos proporcionados

​

FAQ

​

¿Cómo obtengo credenciales de API?

​

¿Puedo usar las APIs en producción?

​

¿Las APIs soportan rate limiting?

​

¿Cómo reporto problemas o sugiero mejoras?

1. Configura la autenticación para obtener tu API Access Token
2. Explora las especificaciones OpenAPI de cada servicio
3. Consulta los ejemplos de uso a continuación o en las guías específicas de integración