[ajuda] dia a dia
WhatsApp no AFK: API oficial da Meta ou conexão por QR Code?
para o número principal do negócio, use a API oficial da Meta, com um chip só para o atendimento. A conexão por QR Code é mais fácil, mas não é oficial: ela vai contra os termos do WhatsApp e o número pode ser bloqueado, sem recurso. Use QR Code só com um número secundário, que você aceita perder.
Para começar, diga na conversa "quero atendente no WhatsApp". O AFK conduz uma etapa por vez e pergunta qual caminho você quer antes de qualquer cadastro.
As opções que o AFK oferece
| Caminho | Como liga | Funciona quando | Risco para o número | Custo |
|---|---|---|---|---|
| API oficial da Meta (recomendado) | Cadastro no site de desenvolvedores da Meta, guiado no painel | 24 horas, pelo robô na sua conta da Cloudflare, com o computador desligado | Baixo. A Meta só restringe quem desrespeita as regras dela, como mandar spam | A Meta cobra por mensagem. Veja abaixo |
| QR Code no painel | Escaneia o QR Code no celular, como no WhatsApp Web | Só com o computador ligado e o painel aberto | Alto: conexão não oficial | Grátis |
| QR Code pela Evolution | Você instala a Evolution num servidor ou no PC ligado direto | 24 horas, se o servidor ficar ligado | Alto: conexão não oficial | Grátis no PC; servidor é pago à parte |
| QR Code pela Z-API | Serviço pago que hospeda a conexão | 24 horas | Alto: conexão não oficial | Mensalidade por número |
Por que o QR Code arrisca o número
Os termos do WhatsApp proíbem mensagem automática e uso por meios automatizados não autorizados. Quem viola os termos pode ter a conta suspensa ou desativada, e o WhatsApp pede que a pessoa não crie outra conta sem autorização. Por isso, no AFK, o QR Code só liga depois que você marca o aceite do risco.
Como a API oficial cobra
- A Meta cobra por mensagem, pela categoria (marketing, utilidade, autenticação ou serviço) e pelo país de quem recebe.
- Respostas a quem escreveu para você são mensagens de serviço. Cada número tem 1.000 delas grátis por mês, sem acumular. Da resposta de número 1.001 em diante, cada uma é cobrada.
- Você só pode mandar mensagem livre dentro de 24 horas depois da última mensagem do cliente. Fora disso, só modelos aprovados pela Meta. O atendente do AFK não inicia conversa.
- Quem chega por anúncio de clique para o WhatsApp abre uma janela grátis de até 7 dias.
- O valor atual por mensagem aparece no painel, na Central de Conexões, no cartão WhatsApp — API oficial da Meta.
Passo a passo da API oficial
- Separe um número. O número da API oficial não pode ficar ao mesmo tempo no app comum do WhatsApp, a não ser pela coexistência oficial da Meta. Um chip novo só para o atendimento evita esse problema.
- Peça na conversa "quero atendente no WhatsApp" e escolha a API oficial.
- Siga o painel em Respostas automáticas > Ligar canais. Ele mostra o passo da vez: conta da Cloudflare, publicar o robô, cadastro na Meta e ativar o recebimento.
- Coloque o app da Meta no modo Ao vivo. Em modo de desenvolvimento, cliente de verdade não recebe resposta.
- Teste com um celular de fora, que não seja administrador nem testador do app. Mande um "oi" e veja a resposta chegar.
Chave e token nunca vão no chat. Cole na Central de Conexões do painel.
Erros e soluções
| O que aparece | O que fazer |
|---|---|
| O cliente manda mensagem e nada chega | Confira se o app da Meta está no modo Ao vivo e se o recebimento foi ativado em Ligar canais. |
| As respostas pararam depois de muitas mensagens no mês | Passou das 1.000 grátis e não há forma de pagamento na conta da Meta. Cadastre uma no Billing Hub da Meta. |
| O número do QR Code foi bloqueado | É o risco da conexão não oficial. Não há recurso pelo AFK. Para o número principal, use a API oficial. |
| A resposta pelo QR Code parou quando desliguei o computador | A conexão pelo painel só funciona com o computador ligado e o painel aberto. Para 24 horas, use a API oficial. |
| A Meta pediu verificação da empresa | Siga o pedido da Meta. O prazo é dela, de horas a dias. |
Se nada funcionar
Tire print da tela Ligar canais e do passo em que parou, sem chave nem token visível, e siga Travou ou quero sugerir uma melhoria: o que mandar.
Fontes oficiais (conferido em 28/10/2026): developers.facebook.com/documentation/business-messaging/whatsapp/pricing (cobrança por mensagem, 1.000 mensagens de serviço grátis, janela de 24 horas, janela grátis de até 7 dias) · developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement (restrições da API oficial) · whatsapp.com/legal/terms-of-service (uso automatizado proibido, suspensão de conta).
Uso do dia a dia
Não resolveu?
Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.