Documentação
Conexão WhatsApp

Conectar pela API não oficial

Parear um número de WhatsApp por QR code com Z-API ou D-API, sem passar pelo cadastro da Meta.

O número entra no ar em poucos minutos, sem precisar do WhatsApp Business e sem custo por mensagem. Antes de seguir, confira em Oficial ou não oficial o que esse canal não faz e o risco de restrição do número.

Antes de começar

  • Ser administrador da empresa na plataforma. Usuário comum não vê o botão de conectar.
  • Ter o plano com canal não oficial liberado. Se não tiver, a tela mostra Não incluído e um botão para solicitar.
  • Estar com o celular em mãos, com o WhatsApp aberto e conectado à internet.

Passo a passo

Em Integrações, acesse WhatsApp, clique em Gerenciar e depois em + Conectar.

Na seção Não oficial, clique em Conectar no Z-API ou no D-API. A etiqueta ao lado do nome (por exemplo, 1 de 2 canais) mostra quantos canais daquele fornecedor o seu plano ainda comporta.

No celular, abra o WhatsApp, vá em Dispositivos conectados, toque em Conectar dispositivo e leia o QR code da tela. Ele se renova a cada 15 segundos; se expirar, leia o próximo.

Clique no lápis ao lado do nome provisório (Canal 1) e troque por algo que identifique o número, como Comercial ou Suporte.

O canal recém-conectado ainda não recebe conversas sozinho. Vincule-o a uma equipe para as mensagens caírem na fila certa. Veja Distribuição de leads.

Se o canal se desconectar

O pareamento funciona como o do WhatsApp Web e não exige o celular ligado no dia a dia. O que encerra a sessão é remover o canal da lista de Dispositivos conectados no WhatsApp do aparelho.

Se isso acontecer, abra o canal em Integrações e veja o aviso acima do QR code, que diz o que fazer:

O que apareceO que fazer
O canal caiu, com data e horaA sessão perdeu a conexão e costuma voltar sozinha. Para não esperar, leia o QR code de novo.
O aparelho foi removido no WhatsAppLeia o QR code para parear outra vez.
Botão Reconectar no lugar do QR codeAcontece nos canais Z-API que perderam a instância. Clique em Reconectar e o QR code volta.

O botão Ver histórico, no rodapé do painel, lista quedas e reconexões daquele canal com data e hora.

O que não funciona neste canal

Mensagens de grupo são ignoradas e não abrem conversa no CRM. No D-API, dá para ligar pelo WhatsApp para o cliente direto da conversa. As demais limitações (templates, campanhas, importação do celular) estão em Oficial ou não oficial.

Excluir um canal apaga o acesso às conversas dos clientes que estavam vinculados a ele, e a mensalidade do mês já cobrada pelo fornecedor não é devolvida.

Nesta página