Resumo

Como empresa, é essencial estar por dentro de quaisquer alterações na 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 na sua WABA, permitindo que você ajuste rapidamente seu comportamento e evite advertências adicionais e/ou ações de aplicação.

Instruções

Antes de começar

Para concluir este guia, você precisará:

Registrar-se como um Desenvolvedor da Meta
Configurar uma conta Gerenciador de Negócios
Criar um Aplicativo 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
Certificar-se de que seu aplicativo tenha concluído a Revisão do Aplicativo 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 em seu aplicativo
No painel de controle do aplicativo, encontre Produtos no painel lateral esquerdo e clique em Adicionar Produto
Encontre WhatsApp e clique em Configurar

Etapa 1: Configurar Endpoint e Configurar Webhooks

Siga nosso guia Introdução aos Webhooks para criar seu endpoint e configurar seus webhooks.

Etapa 2: Inscrever seu Aplicativo na sua WABA

Você precisa inscrever seu aplicativo em notificações de webhooks para sua WABA. Você pode fazer isso de duas maneiras:

Etapa 3: Registrar-se para Atualizações de Conta

Agora que seu aplicativo 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 o notificará quando sua WABA tiver violado as políticas do WhatsApp. Para selecionar essa opção:

Acesse o Painel de Controle do Aplicativo e encontre a opção Configurações
Clique em Webhooks e, em seguida, em Gerenciar
Uma caixa de diálogo aparecerá com todos os campos que você pode se inscrever. Clique em Inscrever-se para account_update Você receberá uma notificação como esta quando sua WABA tiver violado uma política:

{
  "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"
            }
          }
        }
      ]
    }
  ]
}

Etapa 4: Rastrear Restrições da WABA

Mantenha um olho em seus webhooks para verificar se sua WABA foi restringida devido a violações de políticas. Se uma restrição foi imposta, você receberá um webhook com o campo restriction_info, que lista todas as restrições impostas à sua conta e quando essas restrições expiram. Aqui estão alguns exemplos de webhooks que relatam restrições:

Restrição ao adicionar novos números de telefone:

{
  "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 ao enviar mensagens iniciadas pelo negócio:

{
  "field": "account_update",
  "value": {
    "phone_number": "PHONE_NUMBER",
    "event": "ACCOUNT_RESTRICTION",
    "restriction_info": [
      {
        "restriction_type": "RESTRICTED_BIZ_INITIATED_MESSAGING",
        "expiration": TIMESTAMP
      }
    ]
  }
}

Restrição ao responder a mensagens iniciadas pelo usuário:

{
  "field": "account_update",
  "value": {
    "phone_number": "PHONE_NUMBER",
    "event": "ACCOUNT_RESTRICTION",
    "restriction_info": [
      {
        "restriction_type": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING",
        "expiration": TIMESTAMP
      }
    ]
  }
}

Ao seguir essas etapas, você poderá configurar webhooks para sua WABA e receber notificações em tempo real sobre alterações na sua conta, ajudando a manter a conformidade com as políticas do WhatsApp e evitar problemas potenciais.

Perguntas frequentes (FAQs)

Introdução

1. O que eu preciso antes de configurar webhooks para minha WABA?

Você precisa se registrar como um Desenvolvedor da Meta, configurar uma conta Gerenciador de Negócios, criar um Aplicativo Meta para Desenvolvedores com o tipo Negócios, vinculá-lo ao seu Gerenciador de Negócios e adicionar o WhatsApp como um produto. Seu aplicativo também deve concluir a Revisão do Aplicativo e solicitar a permissão whatsapp_business_management.

2. Como eu adiciono o WhatsApp como um produto ao meu aplicativo?

Você pode adicionar o WhatsApp acessando o Portal de Desenvolvedores do Facebook, abrindo seu aplicativo, selecionando Adicionar Produto, encontrando o WhatsApp e clicando em Configurar.

Configurando webhooks

3. Como eu configuro um endpoint e configuro webhooks?

Você pode seguir o guia Introdução aos Webhooks para criar seu endpoint e configurar as configurações de webhook.

4. Como eu inscrevo meu aplicativo para receber notificações de webhooks da WABA?

Você pode inscrever seu aplicativo usando chamadas de API ou por meio do Explorador de API do Graph.

5. Quais tipos de atualizações eu posso me inscrever?

Para rastrear o status da WABA, você deve se inscrever no campo account_update, que o notifica sobre violações de políticas e eventos relacionados à conta.

Notificações de violação de política

6. Como eu saberei se minha WABA violou uma política?

Você receberá uma notificação de webhook com o campo event definido como ACCOUNT_VIOLATION, juntamente com detalhes sobre o tipo de violação.

7. Quais informações são incluídas em uma notificação de violação de política?

Uma notificação de violação inclui o número de telefone, tipo de evento e um campo violation_info que mostra a violação de política específica.

Rastreando restrições

8. Como eu posso rastrear restrições impostas à minha WABA?

Você receberá notificações de webhooks que contêm o campo restriction_info, que lista todas as restrições e seus tempos de expiração.

9. Quais tipos de restrições eu posso ser notificado?

Você pode receber notificações sobre restrições ao adicionar novos números de telefone, enviar mensagens iniciadas pelo negócio ou responder a mensagens iniciadas pelo usuário.

10. O que eu devo fazer após receber uma notificação de restrição?

Monitore seus webhooks para atualizações e ajuste seu comportamento de mensagens para permanecer em conformidade com as políticas do WhatsApp e evitar ações de aplicação adicionais.

Como configurar webhooks para notificações da Conta de Negócios do WhatsApp (WABA)