Integração com WhatsApp

Pré-requisitos

• Uma conta do Facebook ou conta gerenciada da Meta.
• Registro como desenvolvedor.
  Se você ainda não está registrado, visite a página de registro de desenvolvedores e siga as instruções.
• Um dispositivo compatível com WhatsApp para enviar e receber mensagens de teste.

1. Criação de um novo aplicativo Meta com WhatsApp

1. Abra o painel de aplicativos da Meta para criar um novo aplicativo.
2. Clique em Create App (Criar aplicativo).
3. Insira o nome do seu aplicativo e seu endereço de e-mail.
4. Selecione o caso de uso Connect with customers through WhatsApp e clique em Next.
5. Selecione um portfólio de negócios existente ou crie um novo.
6. Uma lista de requisitos de publicação aparecerá na tela. Você pode não ter nenhum requisito nesta fase. Clique em Next.
7. Confirme seus detalhes, o caso de uso e o portfólio de negócios. Clique em Previous para fazer alterações ou em Create app para finalizar a criação do aplicativo.

2. Configuração do caso de uso (Use Case)

Configure os parâmetros do caso de uso e os direitos de acesso.

Etapa 1. Testes (Try it out)

Envie uma mensagem do seu número de teste para entender como a API do WhatsApp funciona:

1. Clique em Generate token para criar um token de acesso temporário para enviar uma mensagem de teste.
2. Selecione o número de telefone de teste do remetente no menu suspenso.
3. No campo Recipient, adicione o número de telefone para o qual a mensagem de teste será enviada.
4. Clique no botão Send message para enviar sua primeira mensagem.

Etapa 2. Configuração de produção (Production setup)

Crie uma ou mais contas para se comunicar com os clientes via API do WhatsApp:

1. Ignoraremos a seção Configure Webhooks por enquanto (a configuração de Webhooks é detalhada na Etapa 5).
2. Na seção Register your WhatsApp phone number, clique no botão Add new number e siga as instruções para adicionar e verificar seu número do WhatsApp Business.
   • Importante: Uma vez conectado, o painel de configurações exibirá o seu ID do seu número do WhatsApp Business. Copie e salve-o para uso em etapas posteriores.
3. Na seção Add payment to send business-initiated messages, vincule um método de pagamento para enviar mensagens iniciadas pela empresa. Vá para o Billing Hub, clique em Add payment method e siga as instruções.
4. Para enviar mensagens por meio da API, você precisa criar um token de acesso permanente (mais detalhes na Etapa 3).

Etapa 3. Verificação da empresa (Business verification)

Faça o upload de documentos para análise da Meta:

1. Saiba o que envolve a verificação do negócio (confirmar o registro da empresa para comprovar sua legitimidade) e quais benefícios adicionais do WhatsApp isso desbloqueia.
2. Clique no botão Start verification e conclua o procedimento de verificação da empresa seguindo as instruções na tela.

3. Criação de um usuário do sistema e geração de um token permanente

Você precisa criar um token permanente para uso em toda a plataforma do WhatsApp Business.

1. Vá para a seção Business Settings e clique em System users na barra lateral.
2. Clique no botão +Add no canto superior direito e siga as instruções para criar um novo usuário do sistema.
3. Selecione o usuário criado e clique em Assign Assets.
   • Na seção Apps, selecione seu aplicativo e ative a opção Manage app (no bloco Full control).
   • Na seção WhatsApp account, selecione sua conta do WhatsApp e ative a opção Everything (no bloco Full control).
   • Clique no botão Assign assets.
4. Clique em Generate token.
   • Siga as instruções para gerar o token.
   • Certifique-se de adicionar as seguintes permissões ao token (Assign permissions):
     • whatsapp_business_messaging
     • whatsapp_business_management
   • Copie o token gerado e guarde-o com segurança.

4. Configuração do Gincore

1. Abra seu aplicativo na Meta, vá para App settings > Basic. Copie o valor de App secret e salve-o.
2. No sistema Gincore, navegue até o menu: More > Settings > Integration with chats.
   • No bloco “Integration with chats”, clique no botão +Add.
   • Como “Source of chats”, escolha WhatsApp e insira os dados salvos anteriormente:
     • Marker of access — o token de usuário permanente (da Etapa 3).
     • App secret — App secret (do ponto 4.1).
     • ID phone number — o ID do número do WhatsApp Business (da Etapa 2, etapa 2).
3. Após salvar, a janela de configurações do Gincore exibirá o Webhook (URL) e o Webhook verification token. Certifique-se de copiá-los e salvá-los.

5. Configuração de Webhooks na Meta

Vamos voltar ao painel do aplicativo da Meta para concluir a configuração de Webhooks que pulamos anteriormente.

1. Abra a página Use cases > Connect with customers through WhatsApp > Customize e prossiga para Step 2. Production setup.
2. Na seção Configure Webhooks, insira os detalhes copiados do Gincore e clique no botão Verify and save:
   • Callback URL — cole o Webhook (URL).
   • Verify token — cole o Webhook verification token.
3. Após a verificação bem-sucedida, você deve configurar os Field Webhooks (inscrever-se em campos específicos). Certifique-se de selecionar:
   • user_preferences
   • messages

6. Finalização e publicação

• Na seção Publish, publique o aplicativo. Certifique-se de que todos os requisitos sejam atendidos e que os casos de uso sejam adicionados corretamente.
• Certifique-se de adicionar um link para sua política de privacidade. Para fazer isso, vá para App settings > Basic e preencha o campo Privacy policy URL. Além disso, preencha o restante das informações de contato da empresa.
• Verifique novamente as configurações do caso de uso Connect with customers through WhatsApp e os resultados da verificação do aplicativo (veja a Etapa 2).