Neste tutorial, você aprenderá a configurar a API Oficial do WhatsApp, disponibilizada pela Meta, e integrá-la ao Intrazap.
📌Aviso
Considerações importantes
Antes de iniciar a configuração, verifique os seguintes pontos:
• 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 Intrazap.
• 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:
Em seguida:
- Faça login utilizando sua conta do Facebook.
- Clique em Criar aplicativo.
- Selecione a opção Outro.
- Escolha o tipo de aplicativo Empresa.
- Preencha as informações solicitadas.
- Finalize a criação do aplicativo.
📲 Etapa 2: Adicionar o WhatsApp ao aplicativo
Dentro do aplicativo criado:
- Acesse a área de Produtos.
- Localize o produto WhatsApp.
- Clique em Configurar.
- Selecione a empresa que será vinculada ao aplicativo.
- 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:
- Clique em Salvar alterações.
- 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:
- Clique em Registrar seu número de telefone do WhatsApp.
- Informe os dados solicitados.
- Conclua a validação do número.
- 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:
No menu lateral:
- Acesse Usuários > Usuários do sistema.
- Selecione o usuário do sistema que será utilizado.
- Clique em Atribuir ativos.
Na tela de atribuição de ativos, configure os seguintes acessos.
Aplicativo
- Selecione o aplicativo criado anteriormente.
- Ative a permissão Gerenciar aplicativo em Controle total.
Conta do WhatsApp
- Selecione sua conta do WhatsApp.
- 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:
- Clique em Gerar token.
- Selecione o aplicativo criado.
- Escolha a duração disponível para o token.
- Adicione as seguintes permissões:
business_management
whatsapp_business_messaging
whatsapp_business_management- Clique em Gerar token.
- Copie o token gerado.
- 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 Intrazap
No Intrazap, acesse:
Conexões > Nova conexão > WhatsApp API Oficial
Campos da conexão
- Nome: informe um nome para identificar a conexão dentro do Intrazap.
- 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 Intrazap gerará as informações necessárias para configurar o webhook.
- Localize a conexão criada.
- Clique em Editar.
- Copie o Callback URL.
- 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 Intrazap.
🔔 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:
- Cole o Callback URL gerado pelo Intrazap.
- Cole o Token da conexão gerado pelo Intrazap.
- Clique em Verificar e salvar.
📌Aviso
O Callback URL e o token devem ser copiados exatamente como aparecem no Intrazap. Espaços extras ou informações incorretas podem impedir a validação.
🧪 Etapa 11: Testar a conexão
Após concluir a configuração:
- Envie uma mensagem de outro número para o WhatsApp conectado.
- Acesse o Intrazap.
- Verifique se a nova conversa foi recebida.
- 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 Intrazap.
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.
