Skip to content

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, se uma marca planeja enviar mensagens SMS transacionais e promocionais, será necessário configurar dois grupos de inscrições com pools separados de números de telefone de envio no dashboard da Braze.

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 elas 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 de telefone 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 será herdado.

Por exemplo, se o Usuário A tem um número de telefone inscrito em vários grupos de inscrições e esse número é adicionado ao Usuário B, o Usuário B será 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 compartilharem esse número de telefone, todos serão desinscritos.

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

  • REST API: Os perfis de usuário podem ser definidos programaticamente pelo endpoint /subscription/status/set usando a REST API da Braze.
  • Integração de SDK: Os usuários podem ser adicionados a um grupo de inscrições de e-mail ou SMS e RCS usando o método addToSubscriptionGroup para Android, iOS ou Web.
  • Formulário IAM de captura de número de telefone: Os números de telefone dos usuários podem ser coletados pelo modelo de captura de número de telefone no editor de arrastar e soltar de mensagens no app.
  • Tratamento automático ao opt-in/descadastramento do usuário: Quando os usuários enviam uma palavra-chave padrão de opt-in ou descadastramento, 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 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.

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 do Canvas, use uma etapa de Atualização de usuário em vez de um webhook. A etapa de Atualização de usuário aguarda a conclusão do processamento antes de avançar o usuário para a próxima etapa, para que as etapas de envio de mensagens subsequentes 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 que o usuário esteja inscrito, fazendo com que a mensagem falhe para uma parte dos usuários. Se você precisar usar um webhook, adicione uma etapa de postergação de pelo menos 1 minuto antes da próxima etapa de envio de mensagens.

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 de usuário: Os perfis de usuário individuais podem ser acessados pelo dashboard da Braze selecionando Pesquisa de usuários na barra lateral. Nessa tela, 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 Engajamento, você pode visualizar os grupos de inscrições de SMS e RCS de um usuário.
  • 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.

Enviar mensagens com um grupo de inscrições

Para lançar uma Campaign de SMS ou RCS pela Braze, selecione um grupo de inscrições no menu suspenso SMS/MMS/RCS Variants. Após a seleção, um filtro de público será adicionado automaticamente à sua Campaign ou Canvas, garantindo que apenas os usuários subscribed no grupo de inscrições selecionado estejam no público-alvo.

Criador de SMS com o menu suspenso do grupo de inscrições aberto e "Messaging Service A for SMS" destacado pelo usuário.

Ativar grupos de inscrições

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

Durante o processo de integração de SMS, um gerente de integração da Braze configurará os grupos de inscrições para a conta do seu dashboard. Ele trabalhará com você para determinar quantos grupos de inscrições são necessários e adicionará os números de telefone de envio apropriados aos seus grupos de inscrições. Os prazos para configurar um grupo de inscrições dependerão do tipo de números de telefone que você está adicionando. Por exemplo, solicitações de códigos curtos podem levar de 8 a 12 semanas, enquanto códigos longos podem ser configurados em um dia. Se você tiver dúvidas sobre a configuração do seu dashboard da Braze, entre em contato com seu representante da Braze para obter suporte.

Para enviar uma mensagem MMS, pelo menos um número dentro do seu grupo de inscrições deve estar habilitado para enviar MMS. Isso é indicado por uma tag localizada ao lado do grupo de inscrições.

Menu suspenso do grupo de inscrições com "Messaging Service A for SMS" destacado. A entrada é prefixada com a tag "MMS".

Um remetente verificado por RCS deve estar presente no seu grupo de inscrições antes que você possa enviar uma mensagem RCS.

Existem duas maneiras de adicionar um remetente verificado por RCS:

  • Adicioná-lo a um grupo de inscrições existente
  • Criar um novo grupo de inscrições RCS A escolha depende em grande parte dos casos de uso de RCS nos quais você está interessado.

Dependendo da sua integração, a Braze pode adicionar remetentes verificados por RCS aos seus grupos de inscrições de SMS existentes ou configurar novos grupos de inscrições para você. Em ambos os casos, seu gerente de sucesso do cliente guiará você por uma atualização de tráfego SMS eficiente e sem complicações.

Migrar tráfego de SMS para RCS

Se você tiver grupos de inscrições de SMS e RCS separados, poderá migrar usuários de SMS para RCS usando um Canvas de uma única 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 significar primeiro migrar todos os usuários para o novo grupo de inscrições e depois segmentar 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, programe o Canvas para quando for conveniente para você.

Etapa 2: Definir seu público

Defina seu público usando um dos seguintes métodos. Em seguida, vá para a etapa Configurações de envio e selecione Usuários que estão inscritos ou optaram por receber.

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

"Objeto de Atualização de Usuário" que contém o código JSON mencionado anteriormente.

Etapa 4: Testar o Canvas

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

Etapa 5: Lançar seu Canvas

Após testar seu Canvas com sucesso, lance-o para 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 de remetente e grupo de inscrições RCS, consulte também Configurar RCS.

Práticas recomendadas

Designar grupos de inscrições separados

  • Tipo de envio de mensagens: Crie grupos de inscrições distintos para cada tipo de envio de mensagens, 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 seguinte exemplo com quatro grupos de inscrições em dois espaços de trabalho:

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

Usar convenções de nomenclatura claras

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

Separar 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 envia mensagens.

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