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.
| Status | Definição |
|---|---|
| Inscreveu-se | O usuário confirmou explicitamente que deseja receber SMS e RCS de um grupo de inscrição específico. Um usuário pode se inscrever tendo seu estado de inscrição atualizado por meio da API de inscrição da Braze ou enviando uma mensagem de texto com uma resposta de palavra-chave de aceitação. Um usuário deve estar inscrito em um grupo de inscrição SMS ou RCS para receber SMS, RCS ou ambos. |
| Cancelou inscrição | O usuário optou explicitamente por não receber mensagens do seu grupo de inscrição SMS e RCS e dos números de telefone de envio dentro do grupo de inscrição. Eles podem cancelar a inscrição enviando uma mensagem de texto com uma palavra-chave de cancelamento, ou a marca pode cancelar a inscrição de usuários por meio da API de inscrição da Braze. Usuários que cancelaram a inscrição de um grupo de inscrição SMS e RCS não receberão mais SMS ou RCS de números de telefone de envio que pertencem ao grupo de inscrição. |
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/setusando 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
addToSubscriptionGrouppara 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_idesubscription_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.
Em conformidade com as normas e diretrizes internacionais de telecomunicações, a Braze nunca enviará SMS ou RCS para usuários que não se inscreveram no grupo de inscrições selecionado.

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.

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.
| Método | Descrição |
|---|---|
| Criar um segmento | Construa um segmento que inclua todos os usuários em um grupo de inscrições ou um subconjunto usando filtros de segmentação (como 5-10% aleatório). Os segmentos são atualizados antes de cada envio para refletir sua base de usuários atual. |
| Aplicar filtros de campanha ou Canvas | Refine o público na etapa Público-Alvo da sua campanha ou Canvas. Ajuste as opções de direcionamento sem sair da página para maior flexibilidade. |
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
}
]
}
]
}

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.
Editar esta página no GitHub