API Oficial ou QR Code: qual escolher
As duas formas de conectar o WhatsApp, o que muda em risco, custo e recursos — e a recomendação honesta.
Existem dois caminhos para ligar um número de WhatsApp ao FireZAP. Eles não são equivalentes, e a escolha tem consequência.
API Oficial (WhatsApp Cloud API, da Meta)
- O número é homologado pela Meta. Não existe bloqueio surpresa por usar automação.
- Libera campanhas por template aprovado e ligações de voz.
- Exige cadastro na Meta: Business Manager, verificação da empresa e criação de um app. É burocrático na primeira vez.
- A Meta cobra as mensagens de modelo (template) que você envia. Responder quem escreveu para você é gratuito dentro da janela de 24 horas. Detalhes em Quanto a Meta cobra pela API Oficial.
QR Code (conexão não oficial)
- Conecta em minutos: você lê um QR Code no WhatsApp, como faz no WhatsApp Web.
- Não precisa de cadastro na Meta nem de aprovação.
- O número pode ser banido a qualquer momento, sem aviso e sem recurso — é um caminho que a Meta não autoriza.
- Não tem campanha por template nem ligação de voz.
Quando a Meta bane um número, vão junto o histórico das conversas e o contato que seus clientes já têm salvo. O risco cresce com disparo em massa, mensagem para quem nunca falou com você e bloqueios feitos pelos destinatários. Ao criar uma conexão por QR Code, o FireZAP pede que você marque que está ciente disso.
Quando a conexão por QR Code cai
A sessão do QR Code é a mesma coisa que o WhatsApp Web: ela cai sozinha se o celular ficar muito tempo sem internet, se o aparelho for desligado por um bom tempo ou se alguém desconectar o aparelho pelo próprio WhatsApp. Enquanto está caída, as mensagens não chegam ao FireZAP — quem escrever para o número não é atendido.
- O FireZAP confere sozinho a cada 5 minutos e corrige o estado na tela de Conexão. A bolinha fica vermelha e aparece o botão de reconectar.
- Se a queda passar de 10 minutos, o responsável pela conta recebe um e-mail avisando. Enquanto a conexão não voltar, não são enviados outros e-mails sobre a mesma queda.
- Para reconectar: Conexão → Configurar na conexão que caiu → Gerar novo QR Code. Leia o código pelo WhatsApp do aparelho, em Aparelhos conectados → Conectar um aparelho.
- O botão Verificar agora, ao lado, pergunta ao WhatsApp na hora — útil quando você acabou de reconectar e não quer esperar os 5 minutos.
Se a conexão estiver ativa de verdade, o botão Gerar novo QR Code recusa e avisa. É proposital: pedir um QR novo numa sessão boa pode derrubá-la, e ninguém espera que um botão de conferência desconecte o WhatsApp da empresa. Para trocar de aparelho de propósito, use Desconectar e depois Reconectar.
Canal oficial não tem sessão presa a um celular — não cai desse jeito, e por isso não tem esse bloco de verificação.
A recomendação
Para qualquer operação séria — a que vai crescer, disparar campanha ou depender do número — use a API Oficial. O QR Code serve para testar rápido ou para um número secundário que você aceita perder.
Se você vai pela oficial, comece por Criar a Business Manager na Meta.