Instalación de Evolution API - Documentação do Evolution Foundation

Esta guía le ayudará a instalar y configurar Evolution API, nuestra API REST principal para integración con WhatsApp.

Requisitos previos

Antes de comenzar, configure los servicios de infraestructura necesarios:

Base de Datos

PostgreSQL o MySQL con Prisma ORM

Redis

Cache distribuido para alto rendimiento

Métodos de instalación

Elija el método más adecuado para su escenario:

Docker

Recomendado para producción. Incluye Docker Compose standalone y Docker Swarm con Traefik para alta disponibilidad.

NVM

Instalación local con Node Version Manager. Ideal para desarrollo o cuando necesita control total sobre el entorno.

Nginx y SSL

Configuración de proxy reverso con Nginx y certificado SSL vía Let’s Encrypt.

SetupOrion

Instalador automatizado con Traefik, Portainer y Docker Swarm. Ideal para VPS limpia.

Verificación rápida

Después de instalar con cualquier método, verifique que la API esté funcionando:

Prueba de salud

curl http://localhost:8080/

Cree su primera instancia WhatsApp

curl -X POST http://localhost:8080/instance/create \
  -H "Content-Type: application/json" \
  -H "apikey: su-clave-segura-aqui" \
  -d '{
    "instanceName": "mi-instancia",
    "integration": "WHATSAPP-BAILEYS",
    "qrcode": true
  }'

Obtenga el QR Code para conectar

curl http://localhost:8080/instance/connect/mi-instancia \
  -H "apikey: su-clave-segura-aqui"

Escanee el QR Code con el WhatsApp de su celular para conectar la instancia.

Verifique el estado de la conexión

curl http://localhost:8080/instance/connectionState/mi-instancia \
  -H "apikey: su-clave-segura-aqui"

Próximos pasos

Variables de Entorno

Referencia completa de todas las variables de configuración

Webhooks

Configure webhooks para recibir eventos en tiempo real

Integraciones

Conecte con Chatwoot, Typebot, OpenAI, Dify y más

Actualización

Mantenga su instancia siempre actualizada

​Requisitos previos