Como vincular um número à API Oficial do WhatsApp (Meta)

💡 Este passo a passo é bastante detalhado. Para uma experiência mais visual e intuitiva, com imagens de cada etapa, você também pode ACESSAR MATERIAL EM PDF💡

Este guia mostra o passo a passo para conectar um número de telefone à API Oficial do WhatsApp (Meta Cloud API) usando o aplicativo Meta dentro da ZAPISP. O processo é executado pelo responsável da empresa, com a conta do Facebook que administra o Portfólio Empresarial no Meta Business, e leva de 10 a 20 minutos, desde que os pré-requisitos estejam atendidos.

Antes de começar: pré-requisitos

• Acesso à ZAPISP: usuário com perfil administrador e o aplicativo Meta já adquirido e liberado na conta. Se o app aparecer sem o selo "Adquirido", fale com o time comercial ou com o suporte ZAPISP.

• Conta do Facebook: conta pessoal do Facebook que seja administradora do Portfólio Empresarial da empresa. Confira em business.facebook.com > Configurações do negócio > Usuários > Pessoas.

• Portfólio Empresarial: criado no Meta Business Suite, com nome e dados da empresa preenchidos. Recomendado: Verificação de Negócio concluída, pois libera limites maiores de envio.

• Número de telefone: número válido que possa receber SMS ou ligação para o código de verificação. Pode ser móvel ou fixo — nesse caso, a verificação é por ligação. O número não pode estar vinculado a outra conta da API oficial.

• Situação do número no WhatsApp: se o número já usa o WhatsApp comum (pessoal), a conta precisa ser apagada antes. Se usa o WhatsApp Business (app), é possível manter o app com a opção de coexistência.

• Nome de exibição: nome que aparecerá para o cliente final. Deve ter relação clara com a marca e seguir as políticas da Meta. Evite termos genéricos como "Atendimento" ou "Suporte" isolados.

• Meio de pagamento: cartão de crédito cadastrado no Meta Business para o faturamento das mensagens da API, que são cobradas pela Meta.

• Somente para coexistência: app WhatsApp Business instalado no celular, na versão 2.24.17 ou superior, número já em uso real há algumas semanas e celular com câmera para leitura do QR Code.

Atenção: ao concluir a vinculação sem coexistência, o número deixa de funcionar no aplicativo do celular. Certifique-se de que o número escolhido é realmente o desejado para o atendimento oficial.

Dica: use o Google Chrome ou o Microsoft Edge em uma janela normal (não anônima) e desative o bloqueador de pop-ups — o fluxo da Meta abre em uma janela pop-up. Feche também outras contas do Facebook conectadas no navegador.

Passo a passo

1. Acessar o menu de Aplicativos na ZAPISP: no menu lateral esquerdo, localize o bloco Ferramentas e clique em Aplicativos.

   

2. Localizar o aplicativo Meta: na vitrine de aplicativos, procure o card Meta, identificado pelo ícone verde do WhatsApp. Clique no card para abri-lo. Se o selo "Adquirido" não aparecer, o aplicativo ainda não está habilitado para a conta.

   

3. Abrir Configurações e clicar em Novo Número: dentro do aplicativo Meta, acesse a aba Configurações, onde é exibido o total de números já vinculados. Clique no botão Novo Número para iniciar a vinculação.

   

4. Escolher a opção "Entrar com Facebook": na tela "Configure sua conta da META", selecione Entrar com Facebook — o caminho recomendado, que usa o fluxo oficial da Meta e configura tudo automaticamente. A opção "Configuração manual" é apenas para cenários específicos, sob orientação do suporte ZAPISP.

   

5. Autorizar a conexão com a ZAPISP: ao clicar em Entrar com Facebook, abre-se uma janela da Meta. Faça login — ou confirme que já está logado — com a conta que administra o portfólio da empresa e clique em Continuar. A conta logada precisa ter acesso de administrador ao Portfólio Empresarial; se a janela abrir com outra conta, troque antes de continuar.

   

6. Selecionar o Portfólio Empresarial e a Conta do WhatsApp Business: no campo Portfólio empresarial, selecione o portfólio da empresa e, em seguida, abra o campo Conta do WhatsApp Business. Se a empresa ainda não tiver um portfólio, é possível criá-lo pelo próprio fluxo, informando nome do negócio, site e e-mail corporativo.

   

7. Escolher entre criar uma conta nova ou conectar o app existente: ao abrir o campo Conta do WhatsApp Business, aparecem duas opções. "Criar uma conta do WhatsApp Business" cria uma conta nova, integrada diretamente à Meta — o número passa a operar somente pela API, sem o aplicativo no celular. "Conectar um app do WhatsApp Business" ativa o modo coexistência, em que o número continua funcionando no aplicativo do celular e, ao mesmo tempo, na API. Trocar de modalidade depois exige refazer parte do processo — escolha com calma.

   

8. Cadastrar o número e validar: informe o nome de exibição, categoria e descrição do negócio, o número de telefone (com código do país +55 e DDD, sem o nono dígito duplicado ou espaços) e o método de verificação (SMS ou chamada de voz). Em seguida, informe o código de 6 dígitos recebido. Na modalidade coexistência, a Meta exibe um QR Code: no celular, abra o WhatsApp Business > menu > Dispositivos conectados > Conectar dispositivo e leia o código. O código de verificação é pessoal e intransferível — nunca o compartilhe, nem com atendentes da ZAPISP.

   
   

9. Concluir o fluxo da Meta: revise o resumo apresentado e clique em Concluir ou Finalizar. Aguarde a mensagem de conclusão antes de fechar a janela — encerrá-la no meio do fluxo deixa o vínculo incompleto e exige reiniciar o processo a partir do passo 4.

10. Voltar à ZAPISP e sincronizar: de volta ao aplicativo Meta na ZAPISP, acesse novamente a aba Configurações e clique em Sincronizar Telefones. O contador de Total de Números deve ser atualizado e o novo número passará a aparecer na listagem, pronto para uso.

O que muda depois da integração

• Janela de 24 horas: depois que o cliente envia uma mensagem, a empresa tem 24 horas para responder livremente. Fora dessa janela, só é possível iniciar conversa com template aprovado pela Meta.

• Cobrança das mensagens: a Meta passa a cobrar pelo uso da API, no cartão cadastrado no Meta Business. A cobrança é da Meta, não da ZAPISP, e aparece na fatura do portfólio empresarial.

• App no celular: na modalidade conta nova, o número deixa de funcionar no aplicativo do celular. Na coexistência, o app continua funcionando em paralelo à API.

• Nome de exibição: passa a ser gerenciado pelo Meta Business. Qualquer alteração é submetida à análise da Meta antes de entrar no ar.

Validação final

Percorra os quatro testes abaixo para confirmar que a vinculação foi concluída com sucesso.

1. Abra a aba Configurações do aplicativo Meta e confirme que o novo número aparece na listagem.

2. Envie uma mensagem de teste a partir da ZAPISP para um número conhecido.

3. Responda a partir desse número e confirme que a resposta chega na plataforma.

4. Se a mensagem sair e a resposta chegar, a vinculação está concluída com sucesso.

Erros comuns e como resolver

• O portfólio não aparece na lista: a conta do Facebook logada não é administradora do Portfólio Empresarial. Saia da conta na janela da Meta e entre com a conta correta, ou peça acesso de administrador no Meta Business.

• A janela da Meta não abre: bloqueador de pop-ups ativo ou navegação anônima. Libere os pop-ups do domínio da ZAPISP, use uma janela normal do Chrome ou Edge e tente novamente.

• O número é recusado no cadastro: número já vinculado a outra conta de API oficial ou ainda ativo no WhatsApp comum. Apague a conta do WhatsApp no celular ou desvincule o número da API anterior antes de repetir o passo 8.

• O código de 6 dígitos não chega: operadora bloqueando o SMS ou número digitado com o nono dígito duplicado. Confira o formato (+55 + DDD + número), aguarde alguns minutos e solicite a verificação por chamada de voz.

• O número não aparece após concluir: a lista da ZAPISP ainda não foi atualizada. Clique em Sincronizar Telefones na aba Configurações. Se persistir, acione o suporte ZAPISP.

• O nome de exibição foi reprovado: nome genérico ou sem relação com a marca, contrariando as políticas da Meta. Ajuste o nome de exibição no Meta Business para algo alinhado à marca e solicite nova análise.

Precisa de ajuda?

Se você travar em algum passo, fale com o nosso time de suporte pelo pop-up de ajuda no site ou pelo WhatsApp: +55 84 3190-3931 (wa.me/558431903931).