Grupos de inscrições

Os grupos de inscrições do WhatsApp são criados após a integração do WhatsApp com seu app por meio do Technology Partner Portal.

Estados da inscrição no WhatsApp

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

Status	Definição
Inscreveu-se	O usuário confirmou explicitamente que deseja receber mensagens do WhatsApp de uma empresa específica. Os usuários podem se inscrever tendo seu estado de inscrição atualizado por meio da API de inscrição do Braze ou implantando uma estratégia de aceitação, de acordo com as diretrizes do WhatsApp.
Cancelou inscrição	O usuário não deu consentimento explícito para aceitação ou seu status de aceitação foi explicitamente removido. Os usuários que cancelarem a inscrição em um grupo de inscrições do WhatsApp não receberão mais mensagens do WhatsApp do envio de números de telefone que pertencem ao grupo de inscrições.

Configuração dos grupos de inscrições do WhatsApp dos usuários

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

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

• Perfil do usuário: Os perfis de usuários individuais podem ser acessados no dashboard do Braze em Público > Pesquisar usuários. Aqui, é possível procurar perfis de usuários por endereço de e-mail, número de telefone ou ID de usuário externo. Quando estiver dentro de um perfil de usuário, na guia Engajamento, você poderá ver o grupo de inscrições do WhatsApp de um usuário e seu status.

• API de descanso: O grupo de inscrições de perfis de usuários 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 API REST do Braze.

Processo de aceitação e recusa do WhatsApp

Atualmente, os usuários podem se inscrever e optar pela aceitação e recusa ao envio de mensagens do WhatsApp de várias maneiras, incluindo SMS, através de um site, um thread do WhatsApp, telefone ou pessoalmente. Observe que a aceitação é obrigatória.

No momento, não há suporte para palavras-chave de aceitação para o canal do WhatsApp, portanto, caberá a você manter uma lista de usuários. O WhatsApp tem uma abordagem retrospectiva para aceitação e limites de frequência, ou seja, se os usuários começarem a denunciar ou bloquear você, seu limite de frequência será reduzido.

Atualização do status da inscrição de um usuário em um WhatsApp Canva

Independentemente dos métodos de aceitação e de exclusão usados, é possível atualizar o status da 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 da inscrição via API REST, como no exemplo a seguir:

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

• Use o editor JSON avançado para atualizar o perfil do 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"
      	    }
      	  ]
      	}
      ]
    }