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.