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 mensagens integradas entre canais sobre grupos de inscrições, consulte Grupos de inscrições.

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 fica no nível do grupo de inscrições e não é compartilhado entre grupos de inscrições. Ou seja, um usuário pode estar subscribed em um grupo de inscrições transacional, mas unsubscribed em um promocional. Isso também vale para grupos de inscrições separados de SMS e RCS: um cancelamento em um deles não passa para o outro.
Se você mantiver SMS e RCS em grupos separados, será responsável por manter os estados de inscrição alinhados. Para saber mais, consulte Migrar o tráfego de SMS para RCS. Essa separação de estados permite que as marcas continuem enviando mensagens SMS e RCS relevantes para os usuários.
| Estado | Definição |
|---|---|
| Inscrito | O usuário está inscrito para receber SMS e RCS de um grupo de inscrições específico. Um usuário pode ser inscrito de duas formas: com a atualização do estado de inscrição pela API de inscrições da Braze ou ao enviar uma palavra-chave de aceitação por mensagem de texto. Para receber SMS, RCS ou ambos, o usuário precisa estar inscrito em um grupo de inscrições de SMS ou RCS. Quando a aceitação dupla está ativada, os usuários precisam confirmar a intenção de aceitação antes que o status de inscrição seja atualizado para Subscribed. |
| Cancelou inscrição | O usuário cancelou explicitamente o recebimento de mensagens do seu grupo de inscrições de SMS e RCS e dos números de telefone de envio desse grupo. Ele pode cancelar a inscrição enviando uma palavra-chave de cancelamento por mensagem de texto, ou você pode cancelar a inscrição dos usuários pela API de inscrições da Braze. Usuários que cancelaram a inscrição de um grupo de inscrições de SMS e RCS deixam de receber qualquer SMS ou RCS dos números de telefone de envio que pertencem ao grupo de inscrições. |
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 existente é 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 for 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 mudar de número. Se vários usuários compartilharem esse número de telefone, todos terão a inscrição cancelada.
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/setpara definir perfis de usuário de forma programática 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 de SMS e RCS usando
addToSubscriptionGrouperemoveFromSubscriptionGrouppara Android, iOS ou Web. Os métodos do SDK não substituem os fluxos regulatórios de aceitação ou cancelamento gerenciados por palavras-chave e pela REST API. - Formulário de mensagem no app para 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.
- Gerenciado automaticamente na aceitação ou no cancelamento do usuário: Quando os usuários enviam por mensagem de texto uma palavra-chave padrão de aceitação ou cancelamento, a Braze define e atualiza automaticamente o estado de inscrição deles.
- Importação de usuário: Os usuários podem ser adicionados a grupos de inscrições de e-mail ou de SMS e RCS em Importar usuários. Ao atualizar o status do grupo de inscrições, seu CSV precisa ter estas duas colunas:
subscription_group_idesubscription_state. Para saber mais, consulte Importação de usuário. - Dashboard da Braze: Selecione Pesquisa de usuário na barra lateral, abra o perfil de um usuário e atualize os grupos de inscrições de SMS ou RCS em Configurações de contato, na guia Engajamento.
- Cloud Data Ingestion (CDI): Inclua
subscription_group_idesubscription_statenas linhas sincronizadas. Consulte Configuração de tabelas 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 ver as considerações de 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 Canvas Flow, use uma etapa de Atualização de Usuário em vez de um webhook. A etapa de Atualização de Usuário espera o processamento terminar antes de avançar o usuário para a próxima etapa. Assim, as etapas de mensagem seguintes usam 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 mudança de inscrição termina de ser processada. Isso pode criar uma condição de corrida em que uma etapa de SMS seguinte é executada antes de o usuário estar inscrito, fazendo a mensagem falhar para 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 mensagem.
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/setou/v2/subscription/status/setcom 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_logicestiver definido comotruee 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
- 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/trackque 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 de usuário: Os perfis de usuário individuais podem ser acessados pelo dashboard da Braze selecionando Pesquisa de usuário na barra lateral. Lá, você pode procurar 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 ver os grupos de inscrições de SMS e RCS do usuário.
- REST API: O grupo de inscrições de perfis de usuário individuais pode ser visualizado pelo endpoint para listar os grupos de inscrições do usuário ou pelo endpoint para listar o 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 Variantes de SMS/MMS/RCS. Depois da seleção, um filtro de público é adicionado automaticamente à sua Campaign ou ao seu Canvas. Isso garante que somente usuários subscribed no grupo de inscrições selecionado façam parte do público-alvo.
Para receber mensagens de uma Campaign ou de um Canvas, os usuários precisam estar inscritos no grupo de inscrições selecionado. Se os envios falharem para usuários que, fora isso, são válidos, confirme se eles estão inscritos usando um dos métodos em Definir o estado de um usuário. Para saber mais sobre os requisitos de aceitação dupla, consulte Estados do grupo de inscrições.

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

Domínios de encurtamento de links
Cada grupo de inscrições de SMS, MMS e RCS pode usar um domínio de encurtamento de links para URLs encurtadas quando o encurtamento de links está ativado. Para atribuir um domínio curto compartilhado da Braze ou um domínio personalizado, consulte Domínios personalizados de autoatendimento.
Melhores práticas para grupos de inscrições
Crie grupos de inscrições separados para cada finalidade de envio de mensagens (por exemplo, transacional versus marketing) e para cada espaço de trabalho. Se você opera em vários países, considere criar grupos separados por região para atender às regras de conformidade locais, como as restrições do Brasil aos horários de envio de mensagens promocionais.
Ativar grupos de inscrições
Para ativar grupos de inscrições para SMS, MMS ou RCS, consulte as informações a seguir:
Durante o processo de integração de SMS, um gerente de integração da Braze configura os grupos de inscrições da sua conta no dashboard. Ele trabalha com você para definir quantos grupos de inscrições você precisa e adiciona os números de telefone de envio adequados a eles. O prazo para configurar um grupo de inscrições depende do tipo de número de telefone que você está adicionando. Por exemplo, solicitações de short code podem levar de 8 a 12 semanas, enquanto long codes podem ser configurados em até um dia. Se 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 do seu grupo de inscrições precisa estar ativado para enviar MMS. Isso é indicado por uma tag ao lado do grupo de inscrições.

É necessário ter um remetente verificado para RCS no seu grupo de inscrições antes de enviar uma mensagem RCS.
Há duas formas de adicionar um remetente verificado para RCS:
- Adicioná-lo a um grupo de inscrições existente
- Criar um novo grupo de inscrições de RCS
A abordagem escolhida depende dos seus casos de uso e da sua integração de RCS. Seu gerente de sucesso do cliente pode adicionar o remetente para você e orientar você na migração do tráfego de SMS.
Gerenciar cancelamentos de inscrição em linguagem natural no Agent Console
Para um gerenciamento completo de inscrições, você pode capturar intenções de cancelamento que não correspondem às palavras-chave padrão ou personalizadas (como “Por favor, não me mande mensagens”). Ao criar um agente de IA, você pode usar análise de sentimento para identificar essas solicitações e agir sobre elas automaticamente.
Configuração
- No Agent Console, crie um “Agente de análise de sentimento de SMS”.

- Crie um Canvas baseado em ação disparado por Send an SMS inbound message, na categoria de palavra-chave Other.
- Adicione a etapa Agente ao Canvas para identificar a intenção de cancelamento.
- Adicione em seguida uma etapa Mensagem de SMS para confirmar a solicitação: “Parece que você quer cancelar sua inscrição de SMS, então vamos cancelar sua inscrição. Se isso foi um engano, envie START para se inscrever novamente.”
- Adicione uma etapa Atualização de Usuário para alterar o status do usuário no grupo de inscrições específico para “Unsubscribed”.

O uso do Agent Console consome créditos de mensagem ou créditos de ação.
Migrar o tráfego de SMS para RCS
Você pode adicionar um remetente de RCS a um grupo de inscrições de SMS existente ou criar um grupo de inscrições de RCS separado. As duas abordagens funcionam de forma diferente:
| Aspecto | Mesmo grupo de inscrições (recomendado para fazer upgrade do tráfego de SMS) | Grupos de inscrições separados |
|---|---|---|
| Elegibilidade | Os usuários inscritos em SMS ficam automaticamente elegíveis para RCS. | Você precisa migrar os usuários para o grupo de RCS. |
| Cancelamentos de inscrição | Um STOP enviado ao remetente de SMS ou ao remetente de RCS cancela a inscrição do usuário no grupo inteiro. | Cancelamentos de inscrição em um grupo não são transferidos para o outro. Você é responsável por manter os estados de inscrição alinhados. Por exemplo, cancele a inscrição dos usuários no grupo de RCS quando eles cancelarem a inscrição em SMS. |
Tenha também em mente estes limites:
- Um grupo de inscrições não pode misturar prestadores de serviço de SMS, e um remetente de RCS só pode pertencer a um grupo de inscrições. Se o seu remetente de SMS e o seu remetente de RCS usarem prestadores diferentes, eles precisam ficar em grupos separados, e os estados de inscrição deles não serão sincronizados.
- Os usuários não conseguem registrar a aceitação enviando mensagens ao remetente de RCS. As palavras-chave de aceitação passam pelo remetente de SMS do mesmo grupo.
Se você tiver grupos de inscrições separados para SMS e RCS, poderá migrar usuários de SMS para RCS com um Canvas de uma etapa.
A Braze recomenda testar primeiro o envio de RCS para volumes menores de usuários e migrar mais usuários para o grupo de inscrições de RCS aos poucos. Por exemplo, se você tiver 1.000.000 de usuários inscritos em um grupo de inscrições de SMS, pode começar migrando todos os usuários para o novo grupo de inscrições. Depois, segmente um público menor, de 50.000 a 100.000 usuários (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 fácil de identificar (como “Transferência de usuários do grupo de inscrições SMS-RCS”). Em seguida, agende o envio para quando for mais conveniente para você.
Etapa 2: Definir seu público
Defina seu público usando um dos métodos a seguir. Depois, acesse a etapa Configurações de envio e selecione Usuários inscritos ou que aceitaram.
| Método | Descrição |
|---|---|
| Criar um Segment | Crie um Segment que inclua todos os usuários de um grupo de inscrições ou um subconjunto definido com filtros de segmentação (como 5-10% aleatórios). Os Segments são atualizados antes de cada envio para refletir sua base de usuários atual. |
| Aplicar filtros de Campaign ou Canvas | Refine o público na etapa Público-alvo da sua Campaign ou Canvas. Ajuste as opções de direcionamento sem sair da página, com mais flexibilidade. |
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 exclusivo do usuário, recomendamos usar o campo braze_id):
{
"attributes": [
{
"braze_id": "{{${braze_id}}}",
"subscription_groups": [
{
"subscription_group_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"subscription_state": "subscribed",
"use_double_opt_in_logic": true
}
]
}
]
}

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

Etapa 4: Testar o Canvas
Recomendamos fortemente testar seu Canvas para confirmar que ele funciona como esperado antes de enviá-lo para um público mais amplo.
Etapa 5: Lançar seu Canvas
Depois de testar seu Canvas com sucesso, é só lançá-lo para o seu subconjunto de usuários!
Para confirmar que seus usuários foram migrados, recomendamos verificar alguns perfis de usuário que foram atualizados. Na guia Engajamento, procure Configurações de contato e role a tela para ver os grupos de inscrições em que o usuário está inscrito. A chave do grupo de inscrições de RCS agora deve estar ativada.
Para configurar o remetente e o grupo de inscrições de RCS, consulte também Configurar o RCS.
Melhores práticas
Defina 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. Assim, você mantém tudo claro e organizado.
Veja 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
- Transacional - PROD para SMS
- Espaço de trabalho de desenvolvimento (para testes)
- Marketing - DEV para SMS
- Transacional - DEV para SMS
Use convenções de nomenclatura claras
Escolha nomes descritivos e claros para os grupos de inscrições. Assim, o grupo correto é selecionado ao criar campanhas de SMS.
Separe os grupos por país
As regulamentações de SMS variam de país para país. Recomendamos separar os grupos de inscrições por país. Isso ajuda você a cumprir os padrões de conformidade em todas as regiões para onde envia mensagens.
Para cada grupo de inscrições, você também pode configurar uma lista de permissões de países em Permissões geográficas. Assim, SMS, MMS e RCS são enviados apenas para regiões aprovadas. Para saber mais, consulte Permissões geográficas.
Por exemplo, no Brasil, é proibido enviar mensagens de marketing fora do horário entre 9h e 21h no fuso local, 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 impede que usuários no Brasil recebam mensagens de marketing em horários proibidos. Para conferir a janela de horário de silêncio recomendada, consulte Cumprir os horários de envio de SMS.