Conectar tu Número de WhatsApp

Crea una instancia y vincula tu número escaneando el código QR.

1. Obtener tu API Key

Tu API Key está en el archivo .env de tu deployment:

API_KEY=tu-api-key-aqui

Todas las peticiones requieren el header:

apikey: tu-api-key-aqui

2. Crear una instancia

Una instancia = un número de WhatsApp.

Petición

curl -X POST "https://tu-evolution.deployalo.com/instance/create" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceName": "mi-negocio",
    "qrcode": true
  }'

Respuesta

{
  "instance": {
    "instanceName": "mi-negocio",
    "status": "created"
  },
  "qrcode": {
    "base64": "data:image/png;base64,..."
  }
}

3. Escanear código QR

Opción A: Desde la API

1. Decodifica el base64 de la respuesta
2. Muestra la imagen QR
3. Escanea con WhatsApp

Opción B: Endpoint de QR

GET https://tu-evolution.deployalo.com/instance/qrcode/mi-negocio

Retorna la imagen PNG directamente.

En WhatsApp

1. Abre WhatsApp en tu teléfono
2. Ve a Configuración → Dispositivos vinculados
3. Toca Vincular un dispositivo
4. Escanea el código QR

4. Verificar conexión

curl "https://tu-evolution.deployalo.com/instance/connectionState/mi-negocio" \
  -H "apikey: TU_API_KEY"

Respuesta exitosa:

{
  "instance": {
    "state": "open"
  }
}

Estados de conexión

Estado	Significado
open	Conectado y listo
close	Desconectado
connecting	Intentando conectar

Multi-instancia

Puedes tener múltiples números:

# Crear segunda instancia
curl -X POST ".../instance/create" \
  -d '{"instanceName": "ventas"}'

# Crear tercera instancia
curl -X POST ".../instance/create" \
  -d '{"instanceName": "soporte"}'

Cada instancia es independiente y tiene su propio QR.

Importante

⚠️ No oficial: Evolution API no es una API oficial de Meta/WhatsApp. Úsala responsablemente.

⚠️ Rate limits: WhatsApp puede bloquear números que envíen muchos mensajes. Respeta los límites.

⚠️ Términos de uso: Lee los términos de WhatsApp antes de usar para negocios.