1. criar a instância
2. conectar o WhatsApp (QR Code)
3. enviar a mensagem

Se pular qualquer um deles, não funciona.

1️⃣ Confirmar dados básicos da instalação

Você precisa ter em mãos:

• Server URL
  Exemplo: https://api.seudominio.com
• API Key global (gerada pelo Orion na instalação)

Esses dois dados são usados em todas as chamadas.

2️⃣ Criar a instância (obrigatório)

Na Evolution API v2, não existe envio sem instância.

Endpoint

POST /instance/create

Exemplo com curl

curl -X POST https://api.seudominio.com/instance/create \
  -H "apikey: SUA_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "instanceName": "primeira-instancia"
  }'

Resposta esperada

Algo semelhante a:

{
  "instance": {
    "instanceName": "primeira-instancia",
    "status": "created"
  }
}

Se deu erro aqui, pare. O resto não vai funcionar.

3️⃣ Conectar o WhatsApp (QR Code)

Depois da instância criada, você precisa conectar o número.

Gerar QR Code

GET /instance/connect/{instanceName}

curl -X GET https://api.seudominio.com/instance/connect/primeira-instancia \
  -H "apikey: SUA_API_KEY_AQUI"

A resposta vem com o QR Code em base64 ou link.

Abra no navegador ou use o manager do Orion:

https://api.seudominio.com/manager

Escaneie com o WhatsApp do celular.

Verificar status da instância

Antes de enviar mensagem, confirme que está conectada.

GET /instance/connectionState/{instanceName}

curl -X GET https://api.seudominio.com/instance/connectionState/primeira-instancia \
  -H "apikey: SUA_API_KEY_AQUI"

Status esperado:

{
  "state": "open"
}

Se não estiver open, não adianta tentar enviar mensagem.

4️⃣ Primeiro disparo de mensagem (texto simples)

Agora sim.

Endpoint v2 para texto

POST /message/sendText/{instanceName}

Exemplo real

curl -X POST https://api.seudominio.com/message/sendText/primeira-instancia \
  -H "apikey: SUA_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "559999999999",
    "text": "Olá! Este é meu primeiro disparo pela Evolution API v2."
  }'

⚠️ Formato do número

• Sempre com DDI + DDD + número
• Sem +, sem espaço, sem traço

Exemplo válido:

5591999999999

5️⃣ O que acontece se não enviar?

Os erros mais comuns no primeiro disparo:

❌ Instância não conectada

Resposta típica:

instance not connected

❌ Número inválido

• faltou DDI
• tem +
• tem espaço

❌ API Key errada

Resposta:

Unauthorized

❌ Endpoint errado (v1 ≠ v2)

Na v2:

/message/sendText/{instance}

Na v1 era diferente. Não misture.

6️⃣ Teste rápido pelo Manager (opcional)

Se quiser validar sem curl:

1. Acesse: https://api.seudominio.com/manager
2. Escolha a instância
3. Vá em Send Message
4. Envie um texto simples

Se funciona no manager e não via API, o problema é payload ou headers.

7️⃣ Próximos disparos possíveis (depois do primeiro)

Depois que o texto simples funciona, você pode evoluir para:

• imagem
• vídeo
• áudio
• botão
• lista
• disparos em massa
• integração com Laravel, n8n, Notifish etc.

Mas sempre valide texto primeiro.

Resumo rápido (ordem correta)

1️⃣ criar instância
2️⃣ conectar WhatsApp
3️⃣ confirmar state = open
4️⃣ enviar sendText

Se seguir isso, funciona.

The post Como fazer o primeiro disparo na Evolution API appeared first on Leonardo Nascimento | Engenheiro de Software.

A ideia é ter:

• containers gerenciáveis via Portainer
• stack versionável via Docker Compose
• Evolution API pronta para uso em produção

Pré-requisitos que evitam dor de cabeça

1. Servidor limpo (zerado)
   O SetupOrion verifica se já existe painel/stack instalada e vai falhar se o servidor não estiver “limpo”.
2. Domínio e DNS
   A recomendação do guia é criar um subdomínio base (ex.: vps.seudominio.com) apontando para o IP do servidor e, a partir dele, criar CNAMEs para as apps (portainer, api etc.).

Passo a passo: instalar Docker + Traefik + Portainer + Evolution API via SetupOrion

1) Prepare o DNS (antes de rodar o instalador)

Crie o registro base:

• A: vps.seudominio.com → IP do seu servidor (proxy desligado, se usar Cloudflare)

Depois, crie os CNAMEs que você vai usar:

• CNAME: portainer → vps.seudominio.com (proxy desligado)
• CNAME: api → vps.seudominio.com (proxy desligado)

Se você não quiser usar vps.seudominio.com, pode apontar o CNAME direto para o IP, mas o modelo do “vps base” facilita troca de IP depois.

2) Conecte via SSH

Exemplo:

ssh root@SEU-IP

(ou ssh root@vps.seudominio.com)

3) Rode o SetupOrion (um comando)

bash <(curl -sSL setup.oriondesign.art.br)

Isso abre o menu do SetupOrion.

4) Instale Traefik + Portainer (primeiro)

No menu, a recomendação é começar pela opção de base Traefik + Portainer (no guia aparece como a “primeira instalação obrigatória”).

Durante o processo ele vai pedir:

• hostname do Portainer (ex.: portainer.seudominio.com)
• usuário e senha (o guia menciona evitar caracteres problemáticos e usar credenciais seguras)
• e-mail (usado para SSL/certificados)

Ao final, você acessa o Portainer em:

• https://portainer.seudominio.com

5) Instale a Evolution API pelo próprio menu do SetupOrion

Com o SetupOrion aberto, selecione a Evolution API.

• “03 – Evolution API” → digite 03

Depois ele vai pedir o domínio da Evolution API:

• informe: api.seudominio.com (garanta que o CNAME api já existe)

Ao final ele exibe algo como:

• Server URL: https://api.seudominio.com
• Global API Key: ... (salve isso)

6) Acesse o “manager” da Evolution API (Orion/gerenciador)

A URL indicada no guia:

• https://api.seudominio.com/manager

Você entra com:

• Server URL = https://api.seudominio.com
• Global API Key = a chave exibida ao final da instalação

7) Verifique no Portainer se está tudo rodando

No Portainer:

• Stacks → encontre a stack da Evolution API → status “Running”

O que esse método te entrega (sem gambiarra)

• Docker instalado automaticamente
• Traefik pronto (rotas + SSL)
• Portainer pronto (gestão)
• Evolution API instalada e acessível por domínio
  Tudo via menu, no padrão do SetupOrion.

The post Como instalar Docker, Portainer e Evolution API appeared first on Leonardo Nascimento | Engenheiro de Software.