Resumo
Como empresa, é essencial ficar por dentro de quaisquer alterações em sua Conta de Negócios do WhatsApp (WABA), especialmente quando se trata de violações da Política do WhatsApp. Ao integrar com webhooks, você pode receber notificações em tempo real sobre alterações em sua WABA, permitindo que você ajuste rapidamente seu comportamento e evite avisos adicionais e/ou ações de aplicação.
Instruções
Antes de Começar
Para concluir este guia, você precisará:
Se registrar como Desenvolvedor do Meta
Configurar uma conta do Gerenciador de Negócios
Criar um aplicativo no Meta para Desenvolvedores com o tipo Negócios e vinculá-lo ao seu Gerenciador de Negócios
Adicionar o WhatsApp como um produto ao seu aplicativo
Certifique-se de que seu app tenha concluído a Revisão do App e solicitado a permissão
whatsapp_business_management. Para adicionar o WhatsApp como um produto ao seu aplicativo, siga estas etapas:Acesse o Portal de Desenvolvedores do Facebook e clique no seu app
No painel do aplicativo, encontre Produtos no painel esquerdo e clique em Adicionar Produto
Encontre WhatsApp e clique em Configurar
Passo 1: Configurar Ponta de Extremidade e Webhooks
Siga o nosso Guia de Introdução aos Webhooks para criar sua ponta de extremidade e configurar seus webhooks.
Passo 2: Inscrever Seu App em Sua WABA
Você precisa inscrever seu app para notificações de webhooks para sua WABA. Você pode fazer isso de duas maneiras:
Passo 3: Inscrever-se para Atualizações de Conta
Agora que seu app está inscrito em webhooks, você pode definir quais tipos de atualizações deseja receber. Para rastrear o status da sua WABA, selecione a opção account_update. Isso notificará você quando sua WABA violar as políticas do WhatsApp. Para selecionar essa opção:
Acesse o Painel do Seu App e encontre a opção Configurações
Clique em Webhooks e depois em Gerenciar
Uma caixa de diálogo aparecerá com todos os campos nos quais você pode se inscrever. Clique em Inscrever-se para
account_update. Você receberá uma notificação como esta quando sua WABA violar uma política:
json { "object": "whatsapp_business_account", "entry": [ { "id": "whatsapp-business-account-id", "time": 1604703058, "changes": [ { "field": "account_update", "value": { "phone_number": "16505551111", "event": "ACCOUNT_VIOLATION", "violation_info": { "violation_type": "ALCOHOL", } } } ] } ]}
Passo 4: Rastrear Restrições da WABA
Mantenha um olho em seus webhooks para verificar se sua WABA foi restrita devido a violações de política. Se uma restrição foi imposta, você receberá um webhook com o campo restriction_info, que lista todas as restrições impostas em sua conta e quando essas restrições expiram. Aqui estão alguns exemplos de webhooks que relatam restrições:
Restrição para adicionar novos números de telefone:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION", "expiration": TIMESTAMP }, ] }}
Restrição para enviar mensagens iniciadas pelo negócio:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [ { "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING", "expiration": TIMESTAMP }, ] }}
Restrição para responder a mensagens iniciadas pelo usuário:
json { "field": "account_update", "value": { "phone_number": "PHONE_NUMBER", "event": "ACCOUNT_RESTRICTION", "restriction_info": [{ "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING", "expiration": TIMESTAMP } ] }}
Seguindo estas etapas, você poderá configurar webhooks para sua WABA e receber notificações em tempo real sobre alterações em sua conta, ajudando a manter sua conformidade com as políticas do WhatsApp e evitar quaisquer problemas potenciais.
Perguntas Frequentes (FAQs)
Como Começar
O que preciso fazer antes de configurar webhooks para minha Conta de Negócios do WhatsApp? Você precisa se registrar como Desenvolvedor do Meta, configurar uma conta do Gerenciador de Negócios, criar um aplicativo no Meta para Desenvolvedores do tipo "Negócios" e vinculá-lo ao seu Gerenciador de Negócios. Além disso, você precisa adicionar o WhatsApp como um produto ao seu aplicativo e garantir que seu app tenha concluído a Revisão do App e solicitado a permissão
whatsapp_business_management.Como adiciono o WhatsApp como um produto ao meu aplicativo? Você pode adicionar o WhatsApp como um produto ao seu aplicativo acessando o site do Meta para Desenvolvedores, clicando no seu app e, em seguida, clicando em Adicionar Produto. A partir daí, você pode encontrar e configurar o WhatsApp.
Configurando Webhooks
Como configuro webhooks para minha Conta de Negócios do WhatsApp? Você pode configurar webhooks seguindo nosso Guia de Introdução aos Webhooks, que o guiará no processo de criação de uma ponta de extremidade e configuração de seus webhooks.
Que tipos de atualizações posso receber através de webhooks? Você pode receber atualizações sobre atualizações de conta, incluindo violações de política e restrições impostas em sua Conta de Negócios do WhatsApp.
Recebendo Notificações
Como receberei notificações quando minha Conta de Negócios do WhatsApp for restrita? Você receberá uma notificação de webhook com o campo
restriction_info, que lista todas as restrições impostas em sua conta e quando essas restrições expiram.Que informações receberei em uma notificação de webhook quando minha Conta de Negócios do WhatsApp violar uma política? Você receberá uma notificação com o campo
account_update, que inclui informações sobre a violação de política, como o tipo de violação e o número de telefone associado à conta.
Resolução de Problemas
O que devo fazer se não estiver recebendo notificações de webhooks? Verifique se seus webhooks estão configurados corretamente e se seu app possui as permissões necessárias. Você também pode verificar a documentação do Meta para Desenvolvedores para dicas de solução de problemas.
Como posso garantir que minha Conta de Negócios do WhatsApp esteja em conformidade com as políticas do WhatsApp? Você pode garantir a conformidade revisando regularmente as Políticas de Negócios e Comércio do WhatsApp e ajustando seu comportamento na plataforma conforme necessário. Você também pode usar webhooks para receber notificações quando sua conta tiver sido restrita ou violou uma política.