Perguntas frequentes

Este artigo aborda perguntas frequentes sobre envio de mensagens por SMS, MMS e RCS.

Geral

O que é um app_id no objeto da API de SMS?

A chave de API do identificador do app, ou app_id, é um parâmetro que associa a atividade a um app específico no seu espaço de trabalho. Ele designa com qual app dentro do espaço de trabalho você está interagindo. Por exemplo, você tem um app_id para o seu app iOS, um app_id para o seu app Android e um app_id para a sua integração web.

Para SMS, o parâmetro app_id é obrigatório ao enviar mensagens SMS pela API (como o endpoint /messages/send). Ele especifica qual app no seu espaço de trabalho está associado à atividade de SMS ou à chamada de API. Você pode usar qualquer app_id válido de um app configurado no seu espaço de trabalho para envio de mensagens SMS, independentemente de o usuário ter esse app específico no perfil dele.

Você pode encontrar seu app_id acessando Configurações > Configurações do app e localizando a seção Identification.

O que acontece se vários usuários tiverem o mesmo número de telefone?

Quando vários perfis de usuário que compartilham o mesmo número de telefone (habilitado para SMS) são elegíveis para uma Campaign baseada em ação ou um componente do Canvas ao mesmo tempo, disparados pelo evento de um SMS recebido, a Braze fará a deduplicação dos usuários no nível do componente do Canvas. Isso evita que os usuários recebam mais de um SMS para um componente do Canvas, mesmo que vários usuários compartilhem o mesmo número de telefone.

A Braze usará o seguinte fluxo para determinar o perfil destinatário:

• Verificar qual perfil recebeu SMS mais recentemente (até 7 dias atrás); se existir, enviar para esse usuário.
• Se nenhum tiver recebido SMS nos últimos 7 dias, enviar para o usuário que tem um alias de usuário “phone” correspondente ao número de telefone.
• Se nenhum existir, enviar para um perfil aleatório entre os disponíveis.

Se você receber uma palavra-chave “START” ou “STOP” do número de telefone compartilhado, todos os perfis de usuário serão inscritos e habilitados para SMS ou terão a inscrição cancelada. Isso também se aplica a alterações de status via API. Por exemplo, se vários perfis com IDs externos diferentes tiverem os mesmos números de telefone, uma alteração de status do grupo de inscrições pela API atualizará todos os perfis com esse número de telefone, mesmo que apenas um ID externo seja especificado.

Para evitar atualizações desnecessariamente grandes, a Braze atualizará no máximo 100 perfis de usuário que compartilham um identificador quando uma atualização de inscrição for feita. Se mais de 100 perfis de usuário compartilharem o mesmo número de telefone, nem todos os perfis serão atualizados.

Por que vejo um pico nas inscrições de SMS de uma fonte específica?

Se você observar um aumento inesperadamente grande nas contagens de inscrição — especialmente ao analisar dados do endpoint /subscription/status/set pelo Currents — isso pode ser causado por perfis de usuário duplicados.

Quando uma solicitação é feita ao endpoint /subscription/status/set apenas com um número de telefone (sem external_id fornecido), a Braze atualiza todos os perfis de usuário que compartilham esse número de telefone. Se o seu espaço de trabalho tiver perfis duplicados, a contagem de usuários que atualizaram o status de inscrição será inflada, mesmo que apenas um número de telefone tenha sido alterado.

Para analisar os dados de inscrição com mais precisão ao extrair do Currents, atualize sua consulta para contar números de telefone distintos em vez de contar todos os eventos de alteração de status de inscrição.

O que são short codes compartilhados?

Com um short code compartilhado, todas as mensagens de texto, independentemente de qual empresa ou organização as envia, chegam ao dispositivo móvel do consumidor a partir do mesmo número de telefone de 5 a 6 dígitos. Embora os short codes compartilhados tenham custo relativamente baixo e estejam disponíveis imediatamente, isso significa que sua empresa não terá um short code dedicado.

Algumas desvantagens dessa abordagem incluem:

• Se seus clientes cancelarem a inscrição das mensagens de outra empresa que compartilha um short code com você, eles também terão cancelado a inscrição das suas mensagens.
• Se uma empresa violar as regras, as mensagens de todas as empresas serão suspensas.
• Problemas de segurança

Cobrança e preços

Como serei cobrado pelo SMS?

Além das cobranças por códigos curtos e longos, a Braze oferece uma cota de mensagens SMS para diferentes países. Ou seja, trabalhamos com você para definir um determinado número de segmentos de mensagem para diferentes países, que você usará para enviar campanhas de SMS. A cobrança é feita pelo número de segmentos de mensagem enviados por país. Para saber mais sobre como os segmentos de mensagem são calculados, consulte nosso guia de Segmentos de mensagem e limites de texto. Seu gerente de conta entrará em contato para informá-lo caso esteja próximo de atingir seu limite máximo, fornecendo relatórios relevantes para mantê-lo informado. Para mais dúvidas sobre excedentes, entre em contato com seu representante da Braze.

Os preços de MMS e SMS são diferentes?

MMS e SMS têm custos diferentes e são cobrados separadamente com base no volume. Entre em contato com a equipe de integração da Braze para obter informações sobre preços.

Como posso evitar excedentes?

Embora não possamos garantir que você nunca terá um excedente, você pode seguir estas precauções para diminuir as chances de ultrapassar seus limites:

• Preste atenção ao número de caracteres no seu SMS. Enviar mais de um segmento sem querer pode causar excedentes. Para mais detalhes, consulte nosso detalhamento de segmentos.
• Calcule cuidadosamente os caracteres do seu SMS levando em conta Liquid ou Connected Content. O criador de SMS da Braze no seu dashboard não estima nem considera o uso de nenhum desses recursos.
• Considere o tipo de codificação que sua mensagem usa. Se sua mensagem usa codificação GSM-7, geralmente você pode estimar o envio de uma mensagem com 128 caracteres por segmento de mensagem. Se sua mensagem usa codificação UCS-2, geralmente você pode estimar o envio de uma mensagem com 67 caracteres por segmento de mensagem.
• Teste, teste e teste! Sempre teste suas mensagens SMS antes do lançamento, especialmente ao usar Liquid e Connected Content.

Se uma mensagem for enviada para um telefone fixo, ela ainda contará no meu total de envios de SMS?

Nos EUA, Canadá e Reino Unido:

• Se um SMS for enviado para um telefone fixo, ele será marcado como Undelivered. Observe que a Twilio ainda cobrará pela tentativa de entrega, então mensagens marcadas como Sent, Delivered ou Undelivered nos seus registros de mensagens serão cobradas.
• No Reino Unido, algumas operadoras convertem o SMS em uma mensagem de voz, entregando a mensagem.

Em outros países:

• A Twilio retornará um erro, e você não será cobrado pela tentativa de envio do SMS.

Por que o dashboard da Braze está me alertando que posso ser cobrado por segmentos de mensagem adicionais quando minha mensagem tem menos de 160 (GSM-7) ou 70 (UCS-2) caracteres?

Você pode ser cobrado por segmentos de mensagem adicionais se tiver personalização com Liquid incluída na sua mensagem. A renderização do bloco de conteúdo não ocorre até que a mensagem esteja sendo preparada para envio. Quando você está editando um SMS com um bloco de conteúdo, a Braze não sabe o que o bloco de conteúdo conterá, mas fornece uma estimativa aproximada. Recomendamos que os usuários usem o painel de teste para visualizar a mensagem e entender melhor o que esperar.

Envio e entregabilidade

É possível incluir links em um SMS?

Você pode incluir qualquer link em qualquer Campaign de SMS que desejar. No entanto, há algumas questões a considerar:

• Links podem ocupar grande parte do limite de 160 caracteres do SMS. Se você incluir um link e texto, isso pode resultar em duas mensagens SMS em vez de apenas uma.
• Empresas frequentemente usam encurtadores de links para reduzir o impacto na contagem de caracteres. No entanto, ao enviar um link encurtado por um long code, as operadoras podem bloquear ou rejeitar a mensagem, pois podem suspeitar do redirecionamento do link.
• Usar um short code seria o tipo de número mais confiável para incluir links.

A Braze também possui seu próprio recurso de encurtamento de links, que encurta links e fornece análise de cliques automaticamente. Consulte Encurtamento de links para saber mais.

É necessário limitar a taxa de envio de mensagens SMS?

A taxa de concorrência e throughput padrão permite o envio de aproximadamente 360.000 mensagens por hora por short code. Throughput adicional requer short codes adicionais.

Como colocar URLs na lista de permissões para SMS?

Antes de enviar mensagens SMS contendo URLs para usuários em determinados países (por exemplo, Suécia ou países nórdicos), você precisa registrar essas URLs junto à operadora. Entre em contato com seu gerente de atendimento ao cliente da Braze para obter ajuda. Esse processo leva cerca de cinco dias.

Quais são as melhores práticas de envio para evitar a detecção de SPAM no SMS?

1. Certifique-se de que as instruções de aceitação e cancelamento de inscrição estejam claras.
2. Garanta que você (a marca) tenha um relacionamento com o cliente.
3. Certifique-se de que o conteúdo seja relevante para o relacionamento e para o que o usuário optou por receber.

Para mais orientações sobre como evitar a detecção de SPAM, acesse as diretrizes de leis e regulamentações de SMS.

Quantos caracteres um emoji usa?

Emojis podem ser complicados, pois não existe uma contagem de caracteres padrão para todos os emojis. Há o risco de o emoji exceder o limite de caracteres e dividir o SMS em várias mensagens, mesmo que apareça como uma única mensagem no criador da Braze. Ao testar suas mensagens, você pode verificar melhor se uma mensagem será dividida usando nossa calculadora de segmentos.

Grupos de inscrições e aceitação/cancelamento

Como criar lógica para aceitações seletivas de SMS para que os usuários fiquem no grupo de inscrições correto?

Palavras-chave personalizadas seriam registradas como eventos personalizados, então você precisaria criar segmentos com base nas palavras-chave que os clientes podem enviar por mensagem de texto. Por exemplo, se um usuário aceita receber SMS para mensagens VIP, mas não para alertas, você pode criar um Segment VIP e um Segment de alertas e, em seguida, atribuir o usuário ao Segment apropriado.

Se um usuário enviar “Stop” para nosso short code, ele é removido do grupo de inscrições?

Como isso aparece no perfil de usuário? O grupo de inscrições voltará a exibir 2 traços (- -), e haverá eventos personalizados para inscrição e cancelamento de inscrição.

Se um usuário cancelou a inscrição e envia uma palavra-chave para nosso short code e long code, ele recebe a resposta que configuramos para essa palavra-chave na Braze?

Se um usuário cancelou a inscrição e envia uma palavra-chave de uma das categorias de palavras-chave padrão, ele receberá a resposta para essa palavra-chave. Se um usuário cancelou a inscrição e envia uma palavra-chave personalizada, ele não receberá a resposta para essa palavra-chave.

As propriedades de evento de SMS capturam palavras-chave dentro de uma frase?

Para que uma palavra-chave seja reconhecida dentro de uma frase (por exemplo, “please stop texting me”), você precisará usar uma instrução Liquid na mensagem para reconhecer a palavra específica. As propriedades de evento têm um limite de 256 caracteres; fora isso, não há limite de caracteres.

Testes

As mensagens de texto de teste contam para os limites?

Sim. Leve isso em consideração ao testar mensagens.

Um usuário precisa fazer parte de um grupo de inscrições de SMS para receber mensagens de teste por SMS?

Sim. Os usuários devem ter um número de telefone válido, fazer parte do grupo de inscrições de SMS usado para o envio de teste e ter pelo menos um país selecionado em Geographic Permissions para SMS.

Existe uma maneira de verificar se um alias existe em um perfil de usuário?

Os aliases não são visíveis no perfil de usuário. Você precisaria usar os endpoints de Exportação de dados de usuários para confirmar se os aliases foram definidos.

MMS

Há alguma alteração nos dados do Currents ao enviar um MMS?

Não, o mesmo nível de insight será fornecido ao enviar uma mensagem MMS.

Posso controlar a ordem em que a imagem e o corpo da mensagem de um MMS são entregues?

A Braze não tem controle sobre a ordem de exibição quando tanto o corpo da mensagem quanto as imagens estão incluídos em uma mensagem MMS. Isso depende de vários fatores, incluindo, mas não se limitando a:

• A operadora que recebe a mensagem
• O dispositivo que recebe a mensagem
• O tamanho total da mensagem

O MMS requer um processo de integração separado?

Não. O MMS agora está incluído no nosso processo de integração de SMS. Clientes existentes que já passaram pela integração podem começar a enviar Campaigns de MMS após concluir as seguintes etapas:

1. Adquirir o MMS.
2. Entrar em contato com a equipe de integração da Braze para solicitar a ativação do recurso de MMS. Isso habilitará o MMS e um grupo de inscrições de SMS/MMS será criado ou atualizado para você.

Em seguida, a equipe de integração da Braze garantirá que seus short codes e long codes estejam habilitados (nos EUA e Canadá) para MMS. Eles também atualizarão seus grupos de inscrições para mostrar seus números atuais que foram adicionados ou habilitados para MMS. Após essas etapas serem concluídas, você poderá enviar mensagens MMS imediatamente pelo nosso criador nativo de SMS.

Por que não consigo encontrar o MMS no meu dashboard mesmo com o recurso habilitado?

O MMS só é exibido no dashboard da Braze quando um grupo de inscrições é considerado “habilitado para MMS”. Isso é refletido por uma tag de MMS ao selecionar o grupo de inscrições no criador de uma mensagem SMS/MMS. Isso significa que pelo menos um número no grupo de inscrições é capaz de enviar uma mensagem MMS.

Além disso, certas situações exigirão que a Twilio reautorize a habilitação de short codes que originalmente não tinham MMS habilitado. Esse processo de aprovação pode levar semanas.

RCS

Por que minha mensagem RCS não é renderizada corretamente em dispositivos iOS?

As mensagens RCS podem ser renderizadas de forma diferente em dispositivos iOS dependendo do sistema operacional e do app de mensagens. Em dispositivos iOS, os seguintes comportamentos podem ocorrer:

• Ações sugeridas de diferentes mensagens RCS na mesma conversa podem ser agrupadas e exibidas na ordem errada.
• Botões de rich cards e ações sugeridas que estão fora do rich card podem permanecer visíveis mesmo após tocar em um botão de rich card ou em uma ação sugerida.

Posso enviar mensagens de voz pré-gravadas com RCS?

Sim, você pode usar mensagens de mídia para enviar arquivos de áudio.

Por que os opt-ins de SMS via REST API não correspondem ao Total de opt-ins no desempenho de SMS/MMS/RCS?

Total de opt-ins e Total de descadastramentos no dashboard de desempenho de SMS/MMS/RCS contam alterações de inscrição geradas pelo processamento de palavras-chave de SMS recebidos (por exemplo, um usuário enviando uma palavra-chave de opt-in para o seu short code). Eles não incluem todas as atualizações de inscrição feitas pela REST API, pelo dashboard ou por outras fontes.

Para analisar opt-ins e descadastramentos por origem, use o Criador de consultas em USERS_BEHAVIORS_SUBSCRIPTIONGROUP_STATECHANGE_SHARED e filtre por STATE_CHANGE_SOURCE (por exemplo, Rest API versus Inbound Message).