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][11]. - 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
esubscription_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.
Se você estiver usando a navegação mais antiga, poderá encontrar essa página em Usuários > Pesquisa de usuários.
- 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 endpoint Listar status de grupos de inscrições do usuário usando a REST API da Braze.
Processo de aceitação e recusa do WhatsApp
Atualmente, os usuários podem se inscrever e 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" } ] } ] }
As atualizações do status da inscrição de um usuário podem levar até 60 segundos.
Daqui a [11]: https://js.appboycdn.com/web-sdk/latest/doc/classes/braze.user.html#addtosubscriptiongroup