Setup da conta Z-API
- 1. Conta em z-api.io (3 dias grátis sem cartão)
- 2. Nova instância → ganha
Instance ID+Token - 3. Abre a instância → QR code → escaneia chip dedicado
- 4. Painel Z-API → instância → webhooks → cola URL do teu n8n
O erro nº1 aqui NÃO é timeout (a doc da Z-API não documenta limite de 5s — isso virou lenda). O que derruba de verdade é o header Client-Token: se a conta tem o "Account Security Token" ativado e você não manda esse header, a Z-API recusa com null not allowed. O prompt abaixo já manda sempre. (Responder o webhook rápido continua boa prática — o prompt também faz.)
Workflow n8n · Z-API → IA → resposta
Mesmo bot do Bloco 2, mas plugado na Z-API. O prompt já traz o payload real (text.message, fromMe, isGroup), o header Client-Token e o teste E2E.
# PROMPT — Workflow n8n do bot: Z-API → IA → resposta (FASEADO, à prova de erro) Você vai criar no meu n8n, via MCP, um workflow que recebe a mensagem do WhatsApp (pela Z-API), responde com IA e devolve pelo mesmo número. EM FASES, validando node a node. Tudo mapeado abaixo — siga à risca, gaste o MÍNIMO de chamadas.
Ou importa o template pronto (mesma arquitetura de produção, plugada na Z-API). No node Send Response você troca SEU_INSTANCE_ID, SEU_TOKEN e o Client-Token.
15 nós, só Postgres: buffer anti-fragmentação + memória nativa + agente. Envio via Z-API (Client-Token), filtro isGroup/fromMe. Zero Redis. RAG pelo Bloco 5.
Z-API vs Evolution · trade-off
- + Custo zero
- + Controle total
- − Você gerencia tudo
- − Risco ban médio-alto
- − Setup 30 min
- + Time BR mitiga ban
- + Setup 5 min
- + Suporte PT-BR
- − R$ 55-99/mês
- − Menos controle