Skip to content

Grupos de inscrição SMS e RCS

Os grupos de inscrição são a base para o envio de mensagens SMS, MMS e RCS pela Braze. Um grupo de inscrição é 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) usados para um tipo específico de envio de mensagens. Por exemplo, se uma marca planeja enviar mensagens SMS transacionais e promocionais, dois grupos de inscrições com pools separados de números de telefone para envio precisarão ser configurados no dashboard da Braze.

Estados de grupos de inscrição

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ção e não é compartilhado entre grupos de inscrição, o que significa que um usuário pode estar subscribed em um grupo de inscrição transacional, mas unsubscribed em um promocional. Para as marcas, essa separação de estados garante que elas possam continuar enviando mensagens SMS e RCS relevantes para seus usuários.

Definindo 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 da inscrição desse número de telefone existente será herdado.

Por exemplo, se o Usuário A tiver um número de telefone inscrito em vários grupos de inscrições e esse número de telefone for 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ção do número antigo pela API REST da Braze sempre que um usuário mudar seu número. Se vários usuários compartilharem esse número de telefone, todos eles terão a inscrição cancelada.

Além disso, o estado de inscrição do número de telefone de um usuário anterior pode ser herdado — mesmo que esse número de telefone não esteja atualmente associado a um perfil de usuário. Por exemplo, se um usuário tiver o número de telefone 123-456-7890, se inscrever em um grupo de inscrição e depois tiver seu número de telefone excluído, o estado de inscrição associado a 123-456-7890 persiste e é aplicado quando o número for atribuído novamente posteriormente.

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

  • API REST: Os perfis de usuário podem ser definidos programaticamente pelo endpoint /subscription/status/set usando a API REST da Braze.
  • Integração de SDK: Os usuários podem ser adicionados a um grupo de inscrição de e-mail ou SMS e RCS usando o método addToSubscriptionGroup para Android, iOS ou Web.
  • Tratado automaticamente 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ário: Os usuários podem ser adicionados a grupos de inscrição 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. Para saber mais, consulte Importação de usuário.

Verificando 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ários individuais podem ser acessados pelo dashboard da Braze selecionando Pesquisa de Usuário na barra lateral. Aqui, é possível procurar 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 Engajamento, você pode visualizar os grupos de inscrições de SMS e RCS de um usuário.
  • API REST: 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 da Braze.

Enviando 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 Variantes de SMS/MMS/RCS. Depois de selecionado, um filtro de público será adicionado automaticamente à sua campanha ou Canvas, garantindo que apenas os usuários subscribed do grupo de inscrições selecionado estejam no público-alvo.

Criador de SMS com o menu suspenso do grupo de inscrições aberto e "Serviço de envio de mensagens A para SMS" destacado pelo usuário.

Ativando 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á grupos de inscrições para sua conta no dashboard. Ele trabalhará com você para determinar quantos grupos de inscrições você precisa e adicionará os números de telefone de envio apropriados aos seus grupos de inscrições. Os prazos para a configuração de um grupo de inscrições dependerão do tipo de números de telefone que você está adicionando. Por exemplo, solicitações de código curto 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 suporte.

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

Menu suspenso do grupo de inscrições com "Serviço de envio de mensagens A para SMS" destacado. A entrada é prefixada com a tag "MMS".

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

Existem duas maneiras de adicionar um remetente verificado de RCS:

  • Adicioná-lo a um grupo de inscrições existente
  • Criar um novo grupo de inscrições de 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 de RCS aos seus grupos de inscrições de SMS existentes ou configurar novos grupos de inscrições para você. Em qualquer caso, seu gerente de sucesso do cliente vai guiá-lo por uma atualização de tráfego de SMS eficiente e sem complicações.

Migrando o tráfego de SMS para RCS

Se você tiver grupos de inscrições de SMS e RCS separados, 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 de 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, em seguida, segmentar um público menor de 50.000 a 100.000 (5-10%) para testar as mensagens RCS.

Etapa 1: Crie um Canvas e preencha 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 quando for conveniente para você.

Etapa 2: Defina seu público

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

Etapa 3: Configure 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: Teste o Canvas

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

Etapa 5: Lance seu Canvas

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

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

New Stuff!