Instalación de Evolution Go

Esta guía le ayudará a instalar y configurar Evolution Go, nuestra API WhatsApp de alto rendimiento escrita en Go.

Requisitos previos

Antes de comenzar, asegúrese de tener los siguientes requisitos cumplidos:

Docker 20.10 o superior
Docker Compose v2.x (opcional)
Mínimo de 512MB de RAM disponible

Instalación con Docker

La forma más rápida de comenzar a usar Evolution Go.

Paso 1: Clone el repositorio

git clone https://git.evoai.app/Evolution/evolution-go.git
cd evolution-go

Paso 2: Configure las variables de entorno

cp .env.example .env

Edite el archivo .env con sus configuraciones:

# Puerto del servidor
SERVER_PORT=8080

# Nombre del cliente
CLIENT_NAME=evolution

# Clave de API global (¡cámbiela por una clave segura!)
GLOBAL_API_KEY=su-clave-segura-aqui

# Base de datos (PostgreSQL)
POSTGRES_AUTH_DB=postgresql://postgres:password@postgres:5432/evogo_auth?sslmode=disable
POSTGRES_USERS_DB=postgresql://postgres:password@postgres:5432/evogo_users?sslmode=disable
DATABASE_SAVE_MESSAGES=false

# Logs
WADEBUG=INFO
LOGTYPE=console

Nunca utilice la clave de API predeterminada del .env.example en producción. Genere una clave segura y única.

Paso 3: Build y ejecución

# Build de la imagen Docker
make docker-build

# Ejecutar el contenedor
make docker-run

El servicio estará disponible en http://localhost:8080.

Alternativa: Docker Compose

También puede usar un docker-compose.yml para ejecutar Evolution Go junto con PostgreSQL:

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

  evolution-go:
    image: evoapicloud/evolution-go:latest
    ports:
      - "8080:8080"
    environment:
      SERVER_PORT: 8080
      CLIENT_NAME: evolution
      GLOBAL_API_KEY: su-clave-segura-aqui
      POSTGRES_AUTH_DB: postgresql://postgres:password@postgres:5432/evogo_auth?sslmode=disable
      POSTGRES_USERS_DB: postgresql://postgres:password@postgres:5432/evogo_users?sslmode=disable
      DATABASE_SAVE_MESSAGES: "false"
      WADEBUG: INFO
      LOGTYPE: console
    depends_on:
      - postgres
    restart: unless-stopped

volumes:
  postgres_data:

Ejecute con:

docker compose up -d

Verificando la instalación

Después de iniciar el servicio, verifique que esté funcionando correctamente:

Prueba de salud

curl http://localhost:8080/

Acceda a la documentación Swagger

Abra en su navegador:

http://localhost:8080/swagger/index.html

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"
  }'

Obtenga el QR Code para conectar

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

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

Variables de entorno

Tabla completa de las variables de configuración disponibles:

Variable	Descripción	Predeterminado
`SERVER_PORT`	Puerto del servidor HTTP	`8080`
`CLIENT_NAME`	Identificador del cliente	`evolution`
`GLOBAL_API_KEY`	Clave de autenticación de la API	Obligatorio
`POSTGRES_AUTH_DB`	Cadena de conexión de la base de datos de autenticación	-
`POSTGRES_USERS_DB`	Cadena de conexión de la base de datos de usuarios	-
`DATABASE_SAVE_MESSAGES`	Habilitar persistencia de mensajes	`false`
`WADEBUG`	Nivel de log de WhatsApp (`DEBUG`, `INFO`, `WARN`, `ERROR`)	`INFO`
`LOGTYPE`	Tipo de salida de log (`console`, `json`)	`console`
`CONNECT_ON_STARTUP`	Reconectar instancias al iniciar	`true`
`WEBHOOKFILES`	Incluir archivos en los webhooks	`true`
`WEBHOOK_URL`	URL para recibir webhooks	-
`AMQP_URL`	URL de conexión de RabbitMQ	-
`AMQP_GLOBAL_ENABLED`	Habilitar RabbitMQ globalmente	`false`
`MINIO_ENABLED`	Habilitar almacenamiento MinIO/S3	`false`
`MINIO_ENDPOINT`	Endpoint de MinIO	-
`MINIO_ACCESS_KEY`	Clave de acceso de MinIO	-
`MINIO_SECRET_KEY`	Clave secreta de MinIO	-
`MINIO_BUCKET`	Nombre del bucket de MinIO	`evolution-media`
`MINIO_USE_SSL`	Usar SSL en la conexión MinIO	`false`

Comandos útiles (Docker)

# Build de la imagen Docker
make docker-build

# Ejecutar contenedor Docker
make docker-run

Próximos pasos

Después de la instalación, puede:

Consultar la Referencia API para conocer todos los endpoints disponibles
Configurar webhooks para recibir notificaciones en tiempo real
Integrar con RabbitMQ para procesamiento asíncrono de mensajes

Primeros Pasos

Configuración

Integraciones

Requisitos previos

Instalación con Docker

Paso 1: Clone el repositorio

Paso 2: Configure las variables de entorno

Paso 3: Build y ejecución

Alternativa: Docker Compose

Verificando la instalación

Prueba de salud

Acceda a la documentación Swagger

Cree su primera instancia WhatsApp

Obtenga el QR Code para conectar

Variables de entorno

Comandos útiles (Docker)

Próximos pasos

​Requisitos previos

​Instalación con Docker

​Paso 1: Clone el repositorio

​Paso 2: Configure las variables de entorno

​Paso 3: Build y ejecución

​Alternativa: Docker Compose

​Verificando la instalación

​Prueba de salud

​Acceda a la documentación Swagger

​Cree su primera instancia WhatsApp

​Obtenga el QR Code para conectar

​Variables de entorno

​Comandos útiles (Docker)

​Próximos pasos

Requisitos previos

Instalación con Docker

Paso 1: Clone el repositorio

Paso 2: Configure las variables de entorno

Paso 3: Build y ejecución

Alternativa: Docker Compose

Verificando la instalación

Prueba de salud

Acceda a la documentación Swagger

Cree su primera instancia WhatsApp

Obtenga el QR Code para conectar

Variables de entorno

Comandos útiles (Docker)

Próximos pasos