Grupos de inscrições de SMS, MMS e RCS

Os grupos de inscrições são a base para o envio de mensagens SMS, MMS e RCS pela Braze. Um grupo de inscrições é uma coleção de entidades de envio — como remetentes verificados por RCS, códigos curtos de SMS, códigos longos de SMS ou IDs de remetente alfanuméricos de SMS — usadas para um tipo específico de envio de mensagens (por exemplo, transacional versus promocional). Para uma visão geral de grupos de inscrições entre canais, consulte Grupos de inscrições.

Nota

Você pode adicionar até 450 grupos de inscrições por espaço de trabalho.

Estados do grupo de inscrições

Existem dois estados de inscrição para usuários de SMS e RCS: subscribed e unsubscribed. O estado de inscrição de um usuário reside no nível do grupo de inscrições e não é compartilhado entre grupos de inscrições, o que significa que um usuário pode estar subscribed em um grupo de inscrições transacional, mas unsubscribed em um grupo promocional. Para as marcas, essa separação de estados garante que possam continuar enviando mensagens SMS e RCS relevantes para seus usuários.

Definir o estado de um usuário

Quando um número de telefone é atualizado em um perfil de usuário, o novo número herda o status do grupo de inscrições do usuário. Se o número de telefone for atualizado para um número que já existe na Braze, o status de inscrição desse número de telefone existente é herdado.

Por exemplo, se o Usuário A tem um número de telefone que está inscrito em vários grupos de inscrições e esse número é adicionado ao Usuário B, o Usuário B fica inscrito nos mesmos grupos de inscrições. Para evitar que um usuário herde as inscrições existentes, você pode redefinir os grupos de inscrições do número antigo pela REST API da Braze sempre que um usuário alterar seu número. Se vários usuários compartilham esse número de telefone, todos terão suas inscrições canceladas.

Para definir o estado do grupo de inscrições de um usuário, use um dos seguintes métodos:

• REST API: Use o endpoint /subscription/status/set para definir programaticamente perfis de usuário com a REST API da Braze. Cada solicitação pode incluir de 1 a 25 grupos de inscrições.
• Integração SDK: Os usuários podem ser adicionados ou removidos de um grupo de inscrições de e-mail ou SMS e RCS usando addToSubscriptionGroup e removeFromSubscriptionGroup para Android, iOS ou Web. Os métodos do SDK não substituem os fluxos regulatórios de aceitação ou cancelamento de inscrição gerenciados por palavras-chave e pela REST API.
• Formulário de captura de número de telefone em mensagem no app: Os números de telefone dos usuários podem ser coletados por meio do modelo de captura de número de telefone no editor de arrastar e soltar de mensagens no app.
• Tratamento automático na aceitação/cancelamento do usuário: Quando os usuários enviam uma palavra-chave padrão de aceitação ou cancelamento, a Braze define e atualiza automaticamente o estado de inscrição dos usuários.
• Importação de usuários: Os usuários podem ser adicionados a grupos de inscrições de e-mail ou SMS e RCS por meio de Import Users. Ao atualizar o status do grupo de inscrições, você precisa ter estas duas colunas no seu CSV: subscription_group_id e subscription_state. Consulte Importação de usuários para saber mais.
• Dashboard da Braze: Selecione User Search na barra lateral, abra o perfil de um usuário e atualize os grupos de inscrições de SMS ou RCS em Contact Settings na guia Engagement.
• Cloud Data Ingestion (CDI): Inclua subscription_group_id e subscription_state nas linhas sincronizadas. Consulte Configuração de tabela do Cloud Data Ingestion.
• Etapa de atualização de usuário: Atualize o status de inscrição em um Canvas com uma etapa de Atualização de Usuário. Consulte Atualizar o estado de um usuário em um Canvas para considerações sobre tempo.

Atualizar o estado de um usuário em um Canvas

Ao atualizar o status do grupo de inscrições de um usuário como parte de um fluxo de Canvas, use uma etapa de Atualização de Usuário em vez de um webhook. A etapa de Atualização de Usuário aguarda o processamento ser concluído antes de avançar o usuário para a próxima etapa, garantindo que as etapas de envio de mensagens seguintes usem o status de inscrição atualizado.

Se você usar um webhook para atualizar grupos de inscrições, o usuário avança assim que o webhook é enviado — e não quando a alteração de inscrição termina de ser processada. Isso pode criar uma condição de corrida em que uma etapa de SMS subsequente é executada antes do usuário estar inscrito, fazendo com que a mensagem falhe para parte dos usuários. Se for necessário usar um webhook, adicione uma etapa de postergação de pelo menos 1 minuto antes da próxima etapa de envio de mensagens.

Como a Braze lida com estados de inscrição órfãos

Um estado de inscrição órfão é um estado de inscrição armazenado para um número de telefone ou endereço de e-mail que não está associado a nenhum perfil de usuário. Para SMS, e-mail, WhatsApp e LINE, a Braze lida com estados de inscrição órfãos da seguinte forma:

• Se um usuário for excluído e for o único usuário associado a um determinado número de telefone ou endereço de e-mail, o estado de inscrição desse número de telefone ou endereço de e-mail será excluído imediatamente.
• Se você chamar /subscription/status/set ou /v2/subscription/status/set com um número de telefone ou endereço de e-mail que não está atualmente associado a nenhum perfil de usuário, a Braze armazena esse estado de inscrição por até 30 dias, após os quais ele é automaticamente excluído.
  • Se use_double_opt_in_logic estiver definido como true e nenhum perfil de usuário estiver associado ao número de telefone fornecido, o estado de inscrição não será atualizado; um usuário precisa existir para entrar no fluxo de trabalho de opt-in duplo.
• Se um novo perfil de usuário for criado com um número de telefone ou endereço de e-mail que possui um estado de inscrição órfão armazenado, esse usuário herda o estado de inscrição armazenado, mas apenas dentro do período de 30 dias. Esse período de tolerância de 30 dias é intencional e existe para lidar com condições de corrida quando a criação de um usuário e a definição do estado de inscrição do identificador de canal acontecem em chamadas de API separadas. Um exemplo dessa condição de corrida é quando uma solicitação /subscription/status/set é processada para um número de telefone antes que a solicitação /users/track que cria o perfil de usuário correspondente seja processada.

Verificar o grupo de um usuário

Para verificar o grupo de inscrições de um usuário, use um dos seguintes métodos:

• Perfil do usuário: Os perfis individuais dos usuários podem ser acessados pelo dashboard da Braze selecionando User Search na barra lateral. Nessa página, é possível pesquisar perfis de usuários 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, é possível ver os grupos de inscrições de SMS e RCS de um usuário.
• REST API: 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 REST API da Braze.

Enviar mensagens com um grupo de inscrições

Para lançar uma campanha de SMS ou RCS pela Braze, selecione um grupo de inscrições no menu suspenso SMS/MMS/RCS Variants. Depois de selecionado, um filtro de público é adicionado automaticamente à sua campanha ou Canvas, garantindo que apenas os usuários subscribed ao grupo de inscrições selecionado estejam no público-alvo.

Antes que os usuários possam receber mensagens de uma campanha ou Canvas, eles devem estar inscritos no grupo de inscrições selecionado. Se os envios falharem para usuários que, de outro modo, são válidos, confirme se eles estão inscritos usando um dos métodos em Definir o estado de um usuário. Para requisitos de dupla aceitação, consulte Estados do grupo de inscrições.

Importante

Em conformidade com as leis e regulamentos internacionais de telecomunicação, a Braze nunca envia SMS ou RCS para usuários que não estejam inscritos no grupo de inscrições selecionado.

Práticas recomendadas para grupos de inscrições de SMS

Crie grupos de inscrições de SMS separados para cada finalidade de envio de mensagens (por exemplo, transacional versus marketing) e para cada espaço de trabalho. Quando você opera em vários países, considere criar grupos separados por região para atender às regras de conformidade locais — por exemplo, as restrições do Brasil sobre janelas de envio promocional.

Ativar grupos de inscrições

Para ativar grupos de inscrições para SMS, MMS ou RCS, consulte o seguinte:

• sms
• mms
• rcs

Lidando com cancelamentos de inscrição em linguagem natural no Agent Console

Para um gerenciamento abrangente de inscrições, você pode capturar intenções de cancelamento que não se enquadram em palavras-chave padrão ou personalizadas (como “Por favor, não me envie mais mensagens”). Ao criar um agente de IA, você pode usar análise de sentimento para identificar e agir automaticamente sobre essas solicitações.

Configuração

1. No Agent Console, crie um “SMS Sentiment Analysis Agent”.

Dica

Use o Operator para ajudar com a configuração inicial do agente.

2. Crie um Canvas baseado em ação disparado por Send an SMS inbound message, dentro da categoria de palavra-chave Other.
3. Adicione a etapa de agente ao Canvas para identificar a intenção de cancelamento de inscrição.
4. Adicione uma etapa de mensagem de SMS subsequente para confirmar a solicitação: “Parece que você está tentando cancelar a inscrição de SMS. Vamos cancelar sua inscrição. Se isso foi um engano, envie START para se inscrever novamente.”
5. Adicione uma etapa de atualização de usuário para alterar o status do usuário no grupo de inscrições de SMS específico para “Unsubscribed.”

Nota

O uso do Agent Console consome créditos de mensagem ou de ação.

Migrar tráfego de SMS para RCS

Se você tiver grupos de inscrições separados para SMS e RCS, pode migrar usuários de SMS para RCS usando um Canvas de uma etapa.

A Braze recomenda que você teste o envio de RCS para volumes menores de usuários inicialmente e migre mais usuários para o grupo de inscrições RCS ao longo do tempo. Por exemplo, se você tiver 1.000.000 de usuários inscritos em um grupo de inscrições de SMS, isso poderia ser feito migrando primeiro todos os usuários para o novo grupo de inscrições e depois segmentando um público menor de 50.000 a 100.000 (5-10%) para testar as mensagens RCS.

Etapa 1: Criar um Canvas e preencher o cronograma de entrada

Crie um Canvas e dê a ele um nome facilmente identificável (como “Transferência de Usuários do Grupo de Inscrições SMS-RCS”). Em seguida, agende a campanha no momento mais conveniente para você.

Etapa 2: Definir seu público

Defina seu público usando um dos métodos a seguir. Em seguida, vá para a etapa Configurações de envio e selecione Usuários inscritos ou com aceitação.

Etapa 3: Configurar uma etapa de atualização de usuário

Adicione uma etapa de atualização de usuário ao seu Canvas. Na etapa, abra o Editor JSON avançado e insira o seguinte (para o campo de identificador único do usuário, recomendamos usar o campo braze_id):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "attributes": [
    {
      "braze_id": "{{${braze_id}}}",
      "subscription_groups": [
        {
          "subscription_group_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "subscription_state": "subscribed",
          "use_double_opt_in_logic": true
        }
      ]
    }
  ]
}

Importante

Ao usar use_double_opt_in_logic, um perfil de usuário já deve existir para que o estado de inscrição seja atualizado. Se nenhum perfil de usuário estiver associado ao identificador fornecido, o estado de inscrição não será atualizado.

Etapa 4: Testar o Canvas

Recomendamos fortemente que você teste seu Canvas para confirmar que ele funciona conforme o esperado antes de enviá-lo ao seu público mais amplo.

Etapa 5: Lançar seu Canvas

Depois de ter testado seu Canvas com sucesso, lance-o para o seu subconjunto de usuários!

Para confirmar que seus usuários foram migrados com sucesso, recomendamos verificar alguns perfis de usuário individuais que foram atualizados. Na guia Engajamento, procure por Configurações de contato e role para visualizar os grupos de inscrições nos quais o usuário está inscrito. O toggle do grupo de inscrições RCS agora deve estar ativado.

Para a configuração do remetente RCS e do grupo de inscrições, consulte também Configurar RCS.

Práticas recomendadas

Designe grupos de inscrições separados

• Tipo de mensagem: Crie grupos de inscrições distintos para cada tipo de mensagem, como Transacional e Marketing.
• Espaço de trabalho: Crie grupos de inscrições distintos para cada espaço de trabalho para manter clareza e organização.

Considere o exemplo a seguir com quatro grupos de inscrições em dois espaços de trabalho:

• Espaço de trabalho de produção
  • Marketing - PROD para SMS
  • Transactional - PROD para SMS
• Espaço de trabalho de desenvolvimento (para testes)
  • Marketing - DEV para SMS
  • Transactional - DEV para SMS

Use convenções de nomenclatura claras

Escolha nomes de grupos de inscrições descritivos e claros para que o grupo correto seja selecionado ao criar campanhas de SMS.

Separe os grupos por país

As regulamentações de SMS variam por país. Sugerimos separar os grupos de inscrições de SMS por país. Isso ajuda você a atender aos padrões de conformidade em todas as regiões onde você envia mensagens.

Para cada grupo de inscrições, você também pode configurar uma lista de permissões de países em Geographic Permissions para que SMS, MMS e RCS sejam enviados apenas para regiões aprovadas. Para saber mais, consulte Permissões geográficas.

Por exemplo, no Brasil, o envio de mensagens de marketing fora do horário das 9h às 21h no fuso local é proibido, e o país abrange três fusos horários. Para cumprir essas regulamentações, você pode configurar grupos separados para o envio de mensagens para o Brasil e os Estados Unidos. Isso evita que usuários no Brasil recebam mensagens de marketing durante horários proibidos.