Pular para o conteúdo principal

📲 Configurar API Oficial do WhatsApp — Meta

Neste tutorial, você aprenderá a configurar a API Oficial do WhatsApp, disponibilizada pela Meta, e integrá-la ao ZapChatPro.

aviso

Considerações importantes

Antes de iniciar a configuração, verifique os seguintes pontos:

  • É necessário utilizar a versão 15.0.7 ou superior do ZapChatPro.
  • A API Oficial do WhatsApp não oferece suporte a grupos.
  • O envio de templates deve ser configurado separadamente. Consulte o tutorial de templates.
  • A API Oficial não exibe a foto do contato.
  • Após o cliente enviar uma mensagem, você terá uma janela de 24 horas para responder normalmente pelo ZapChatPro.
  • Depois desse período, uma nova conversa somente poderá ser iniciada utilizando um template aprovado pela Meta.
  • Mesmo sendo uma API oficial, o número ainda pode sofrer restrições ou bloqueios caso as políticas da Meta não sejam cumpridas.
dica

Antes de iniciar, tenha em mãos uma conta do Facebook com acesso administrativo ao Gerenciador de Negócios da Meta e ao número de telefone que será utilizado.

📑 Etapa 1: Criar o aplicativo na Meta​

Acesse o painel de desenvolvedores da Meta:

Meta for Developers

Em seguida:

  1. Faça login utilizando sua conta do Facebook.
  2. Clique em Criar aplicativo.
  3. Selecione a opção Outro.
  4. Escolha o tipo de aplicativo Empresa.
  5. Preencha as informações solicitadas.
  6. Finalize a criação do aplicativo.

📲 Etapa 2: Adicionar o WhatsApp ao aplicativo​

Dentro do aplicativo criado:

  1. Acesse a área de Produtos.
  2. Localize o produto WhatsApp.
  3. Clique em Configurar.
  4. Selecione a empresa que será vinculada ao aplicativo.
  5. Clique em Começar a usar a API.

Caso ainda não exista uma empresa vinculada à sua conta, será necessário criá-la antes de continuar.

⚙️ Etapa 3: Configurar as informações básicas do aplicativo​

No menu lateral do aplicativo, acesse:

Configurações do App > Básico

Preencha os seguintes campos obrigatórios:

  • URL da Política de Privacidade: informe o endereço da página que contém a política de privacidade da sua empresa.
  • URL dos Termos de Serviço: informe o endereço da página que contém os termos de serviço da sua empresa.

Após preencher os campos:

  1. Clique em Salvar alterações.
  2. No topo da página, altere o status do aplicativo de Em desenvolvimento para Ativo.
aviso

O aplicativo precisa estar ativo para funcionar corretamente em produção.

📞 Etapa 4: Registrar o número de telefone​

No menu lateral, acesse:

WhatsApp > Configuração da Produção

Em seguida:

  1. Clique em Registrar seu número de telefone do WhatsApp.
  2. Informe os dados solicitados.
  3. Conclua a validação do número.
  4. Habilite a opção Assinar webhooks.

💳 Etapa 5: Adicionar as informações de pagamento​

Ainda em:

WhatsApp > Configuração da Produção

Adicione as informações de pagamento da conta.

aviso

Caso as informações de pagamento não sejam cadastradas, a API Oficial do WhatsApp poderá não funcionar corretamente.

👤 Etapa 6: Configurar o usuário do sistema​

Acesse as configurações empresariais da Meta:

Configurações do negócio

No menu lateral:

  1. Acesse Usuários > Usuários do sistema.
  2. Selecione o usuário do sistema que será utilizado.
  3. Clique em Atribuir ativos.

Na tela de atribuição de ativos, configure os seguintes acessos.

Aplicativo​

  1. Selecione o aplicativo criado anteriormente.
  2. Ative a permissão Gerenciar aplicativo em Controle total.

Conta do WhatsApp​

  1. Selecione sua conta do WhatsApp.
  2. Ative a permissão Gerenciar contas do WhatsApp Business em Controle total.

Após concluir, clique em Atribuir ativos.

🔑 Etapa 7: Gerar o token​

Ainda na tela do usuário do sistema:

  1. Clique em Gerar token.
  2. Selecione o aplicativo criado.
  3. Escolha a duração disponível para o token.
  4. Adicione as seguintes permissões:
business_management
whatsapp_business_messaging
whatsapp_business_management
  1. Clique em Gerar token.
  2. Copie o token gerado.
  3. Guarde-o em um local seguro.
aviso

O token permite acesso à sua conta do WhatsApp Business. Não compartilhe essa informação com pessoas não autorizadas.

🔗 Etapa 8: Criar a conexão no ZapChatPro​

No ZapChatPro, acesse:

Conexões > Nova conexão > WhatsApp API Oficial

Campos da conexão​

  • Nome: informe um nome para identificar a conexão dentro do ZapChatPro.

  • Phone Number ID: acesse seu aplicativo na Meta e vá em WhatsApp > Configuração da Produção. Copie o valor do campo Identificação do número de telefone.

  • Business ID: acesse seu aplicativo na Meta e vá em WhatsApp > Configuração da Produção. Copie o valor do campo Identificação da conta do WhatsApp Business.

  • WABA ID: na mesma tela do app na meta, no topo veja o campo Identificação do App.

  • Send Token: cole o token gerado anteriormente no usuário do sistema da Meta.

  • Phone Number: informe o número de telefone conectado à API Oficial, utilizando apenas números.

Exemplo:

5511999999999
aviso

Não utilize espaços, parênteses, traços ou o símbolo + no campo Phone Number.

Após preencher todos os campos, clique em Salvar.

🌐 Etapa 9: Copiar o Callback URL e o token​

Após salvar a conexão, o ZapChatPro gerará as informações necessárias para configurar o webhook.

  1. Localize a conexão criada.
  2. Clique em Editar.
  3. Copie o Callback URL.
  4. Copie o Token da conexão.
informação

Essas duas informações serão utilizadas para validar a comunicação entre a Meta e o ZapChatPro.

🔔 Etapa 10: Configurar o webhook na Meta​

Retorne ao aplicativo no painel da Meta.

No menu lateral, acesse:

WhatsApp > Configuração da Produção

Na área de configuração do webhook:

  1. Cole o Callback URL gerado pelo ZapChatPro.
  2. Cole o Token da conexão gerado pelo ZapChatPro.
  3. Clique em Verificar e salvar.
aviso

O Callback URL e o token devem ser copiados exatamente como aparecem no ZapChatPro. Espaços extras ou informações incorretas podem impedir a validação.

🧪 Etapa 11: Testar a conexão​

Após concluir a configuração:

  1. Envie uma mensagem de outro número para o WhatsApp conectado.
  2. Acesse o ZapChatPro.
  3. Verifique se a nova conversa foi recebida.
  4. Responda à mensagem para confirmar o envio e o recebimento.
dica

Faça o primeiro teste dentro da janela de 24 horas iniciada pela mensagem do cliente. Fora dessa janela, poderá ser necessário utilizar um template aprovado.

✅ Finalização​

Pronto! A API Oficial do WhatsApp foi configurada e integrada ao ZapChatPro.

A partir de agora, as mensagens recebidas pelo número cadastrado poderão ser visualizadas e respondidas diretamente pela plataforma, respeitando as regras e políticas estabelecidas pela Meta.