Grupos de inscrições do WhatsApp

Os grupos de inscrições do WhatsApp são criados ao integrar o WhatsApp com seu app por meio do Technology Partner Portal.

Estados de inscrição do WhatsApp

Existem dois estados de inscrição para usuários do WhatsApp: subscribed e unsubscribed.

Configurando os grupos de inscrições do WhatsApp dos usuários

• REST API: os perfis de usuário podem ser definidos programaticamente pelo endpoint /subscription/status/set usando a REST API da Braze.
• SDK Web: os usuários podem ser adicionados a um grupo de inscrições de e-mail, SMS ou WhatsApp usando o método addToSubscriptionGroup para Android, iOS ou Web.
• Importação de usuários: os usuários podem ser adicionados a grupos de inscrições de e-mail ou SMS por meio de Importar usuários. Ao atualizar o status do grupo de inscrições, você deve ter estas duas colunas no seu CSV: subscription_group_id e subscription_state. Consulte Importação de usuários para saber mais.

Verificando o grupo de inscrições do WhatsApp de um usuário

• Perfil de usuário: perfis de usuário individuais podem ser acessados pelo dashboard da Braze em Audience > Search Users. Aqui, você pode pesquisar perfis de usuário por endereço de e-mail, número de telefone ou ID de usuário externo. Dentro de um perfil de usuário, na guia Engagement, você pode visualizar o grupo de inscrições do WhatsApp de um usuário e seu status.

• REST API: o grupo de inscrições de perfis de usuário individuais pode ser visualizado pelo endpoint Listar grupos de inscrições do usuário ou pelo endpoint Listar status do grupo de inscrições do usuário usando a REST API da Braze.

Processo de opt-in e descadastramento do WhatsApp

Atualmente, os usuários podem se inscrever e fazer opt-in e descadastramento do envio de mensagens do WhatsApp de várias maneiras, incluindo SMS, por meio de um site, uma conversa no WhatsApp, telefone ou pessoalmente. Observe que os opt-ins são obrigatórios.

Palavras-chave de opt-in não são suportadas atualmente para o canal do WhatsApp, então caberá a você manter uma lista de usuários. O WhatsApp tem uma abordagem retrospectiva para opt-ins e limites de taxa. Se os usuários começarem a denunciar ou bloquear você, seu limite de taxa será reduzido.

Atualizando o status de inscrição de um usuário para um Canvas do WhatsApp

Independentemente dos métodos de opt-in e descadastramento que você utiliza, é possível atualizar o status de inscrição dos perfis de usuário com um dos seguintes métodos de atualização:

• Crie um webhook Braze-to-Braze que atualize o status de inscrição via REST API, como no exemplo a seguir:

Para evitar condições de corrida, qualquer envio de mensagens subsequente após o webhook deve estar contido em um segundo Canvas que seja disparado por resultados do primeiro Canvas (como um usuário ter entrado em uma variação do Canvas e estar em um grupo de inscrições do WhatsApp).

• Use o editor JSON avançado para atualizar o perfil de usuário com o seguinte modelo:

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
    {
      "attributes": [
      {
      	"subscription_groups": [{
      	  "subscription_group_id": "subscription_group_identifier_1",
      	  "subscription_state": "unsubscribed"
      	   },
      	   {
      	     "subscription_group_id": "subscription_group_identifier_2",
      	     "subscription_state": "subscribed"
      	     },
      	     {
      	       "subscription_group_id": "subscription_group_identifier_3",
      	       "subscription_state": "subscribed"
      	    }
      	  ]
      	}
      ]
    }