Se o webhook não estiver apontando para o LinkZap, o bot não responde — mesmo com o QR conectado.
No painel você vê um nome fácil (ex.: teste). Na Evolution o nome técnico é outro (ex.: teste-mrrbyy6e).
oi ou menu para o número conectado.| Cliente digita | O que acontece |
|---|---|
oi, olá, menu, inicio | Mostra o menu |
1, 2, 3… | Resposta da opção do menu |
oi, alo, bom dia… (modo automático) | Abre o menu |
número da opção (ex.: 1) | Executa aquela opção do menu |
palavra de transferência (ex.: humano) ou opção “Transfere para humano” | Pausa o bot e vai para o Inbox |
bot (no modo humano) | Reativa o atendimento automático |
| qualquer outra mensagem no modo humano (ex.: boa noite, ok, menu) | Aparece no Inbox para o atendente |
| qualquer outro texto | IA (se ligada) ou o menu de novo |
Na aba Conectar → bloco Testar API:
5521999999999Base: URL da Evolution (ex.: https://linkzapapi.seusite.com.br)
Header obrigatório (sem espaço no nome):
apikey: SUA_EVOLUTION_API_KEY
Enviar texto — use o ID Evolution completo na URL:
POST /message/sendText/{id-evolution}
Content-Type: application/json
{
"number": "5521999999999",
"text": "Olá, teste"
}
Erros comuns:
teste) em vez do ID completoapikeyapikey :)A Evolution deve chamar:
POST {APP_URL}/api/webhook/evolution?secret={EVOLUTION_WEBHOOK_SECRET}
Eventos: MESSAGES_UPSERT, CONNECTION_UPDATE, QRCODE_UPDATED.
Health check (deve retornar ok: true):
GET {APP_URL}/api/webhook/evolution
APP_URL precisa ser a URL pública do LinkZap (HTTPS), nunca localhost em produção.
| Método | Rota | Descrição |
|---|---|---|
| POST | /api/auth/login | Login (retorna JWT) |
| GET | /api/instances | Listar números |
| POST | /api/instances | Criar + gerar QR |
| POST | /api/instances/:id/qr | Atualizar QR |
| GET | /api/instances/:id/status | Status da conexão |
| POST | /api/instances/:id/test-message | Enviar mensagem de teste |
| POST | /api/instances/:id/webhook | Regravar webhook na Evolution |
| PUT | /api/bots/:id | Salvar menu / IA |
| GET | /api/integrations/erplink | Status da integração ERPLink |
| PUT | /api/integrations/erplink | Conectar ERPLink (CNPJ) |
| POST | /api/integrations/erplink/test | Retestar Baselink / OrcLink |
| DELETE | /api/integrations/erplink | Desconectar ERPLink |
| POST | /api/webhook/evolution | Recebe eventos da Evolution |
Rotas autenticadas usam header Authorization: Bearer SEU_JWT.
oi ou menu?