Conexão do WhatsApp 3 min de leitura • Também disponível em: EN ES

Conectar pela WhatsApp Cloud API oficial (Meta)

Como conectar um número usando a API oficial da Meta no Zapini, com credenciais e PIN de registro, e quando usar a Coexistência.

Atualizado em 13 jun 2026

O que é a conexão Cloud API

A WhatsApp Cloud API é a conexão oficial da Meta. Em vez de ler um QR Code, você usa credenciais geradas no painel da Meta. É a opção recomendada para empresas que querem estabilidade oficial, verificação e maior volume de mensagens.

Para usar esse método você precisa de uma conta na Meta for Developers com o produto WhatsApp configurado.

O que você vai precisar

O Phone Number ID do número na Meta.
O WhatsApp Business Account ID (WABA ID).
Um token de acesso válido.
O PIN de registro de 6 dígitos do número.

Passo a passo

No menu, abra Instâncias e clique em Nova instância.
Em tipo de conexão, escolha WhatsApp Cloud API (Meta).
Cole o Phone Number ID, o WABA ID e o token de acesso nos campos correspondentes.
Informe o PIN de registro de 6 dígitos. O Zapini usa esse PIN para registrar oficialmente o número junto à Meta.
Salve. O Zapini valida as credenciais automaticamente.

📷 Imagem: formulário do Zapini com os campos de Cloud API e o campo de PIN

Se as credenciais estiverem corretas e o registro for concluído, o status muda para connected e o número fica pronto para enviar e receber mensagens.

💡 Dica: guarde o PIN de registro em local seguro. Você pode precisar dele novamente se mudar o número de provedor ou refazer o registro.

Modo Coexistência (app + Cloud API)

A Coexistência permite usar o mesmo número no aplicativo do WhatsApp Business e na Cloud API ao mesmo tempo. É útil quando a equipe ainda atende pelo celular, mas você quer que a IA e a automação do Zapini também trabalhem nesse número.

Na Coexistência, a ativação acontece durante o cadastro embutido da Meta (Embedded Signup) com a opção de app habilitada — nesse modo não é necessário informar o PIN de registro. As mensagens enviadas pelo celular também aparecem no histórico do Zapini.

📷 Imagem: opção de Coexistência destacada na tela de conexão

Verificando a conexão

O status deve aparecer como connected.
O número entra no seletor global de instâncias, ao lado de qualquer número QR Code.
Envie uma mensagem de teste em Mensagens para confirmar o fluxo.

Se a validação falhar, revise as credenciais e o PIN — a maioria dos erros vem de token expirado ou de Phone Number ID incorreto.

Perguntas frequentes

Não. A Cloud API usa credenciais da Meta (Phone Number ID, WABA ID, token e PIN de registro) em vez de QR Code.

A Cloud API oficial usa o número apenas pela API; a Coexistência permite usar o mesmo número no app do WhatsApp Business e na Cloud API ao mesmo tempo, sem PIN de registro.

O PIN de 6 dígitos é definido no painel da Meta ao configurar o número. Ele é usado pelo Zapini para registrar oficialmente o número.

Obrigado pelo seu feedback!