Ir para o conteúdo

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. Ela indica com qual app 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.

No caso de SMS, o parâmetro app_id é obrigatório para enviar mensagens SMS pela API (como no endpoint /messages/send). Ele especifica qual app do 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, mesmo que o usuário não tenha esse app específico no perfil.

Para encontrar seu app_id, acesse Configurações > Configurações do app e localize a seção Identificação.

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

Às vezes, vários perfis de usuário compartilham um número de telefone (ativado para SMS) e se tornam elegíveis ao mesmo tempo para uma Campaign baseada em ação ou um componente do Canvas, disparados pelo evento de um SMS recebido. Nesse caso, a Braze elimina usuários duplicados no nível do componente do Canvas. Assim, os usuários não recebem mais de um SMS para um componente do Canvas, mesmo que vários usuários compartilhem o mesmo número de telefone.

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

  • Verifica qual perfil recebeu SMS mais recentemente (até 7 dias atrás). Se houver um, envia para esse usuário.
  • Se nenhum deles recebeu SMS nos últimos 7 dias, envia para o usuário que tem um alias de usuário “phone” correspondente ao número de telefone.
  • Se nenhum deles existir, envia 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 ativados para SMS ou terão a inscrição cancelada. Isso também vale para mudanças de estado feitas pela API. Por exemplo, se vários perfis com IDs externos diferentes tiverem o mesmo número de telefone, uma mudança de estado do grupo de inscrições pela API vai atualizar todos os perfis com esse número, mesmo que apenas um ID externo seja especificado.

Para evitar atualizações desnecessariamente grandes, a Braze atualiza no máximo 100 perfis de usuário que compartilham um identificador quando uma atualização de inscrição é 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 vindas de uma origem específica?

Se você notar um aumento inesperadamente grande na contagem de inscrições, principalmente ao analisar dados do endpoint /subscription/status/set pelo Currents, a causa pode ser 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), a Braze atualiza todos os perfis de usuário que compartilham esse número. Se o seu espaço de trabalho tiver perfis duplicados, a contagem de usuários que atualizaram o estado de inscrição fica inflada, mesmo que apenas um número de telefone tenha mudado.

Para analisar os dados de inscrição com mais precisão ao extraí-los do Currents, ajuste sua consulta para contar números de telefone distintos em vez de contar todos os eventos de mudança de estado de inscrição.

O que são códigos curtos compartilhados?

Com um código curto compartilhado, todas as mensagens de texto chegam ao dispositivo móvel do consumidor pelo mesmo número de telefone de 5 a 6 dígitos, não importa qual empresa ou organização as envie. Os códigos curtos compartilhados têm custo relativamente baixo e ficam disponíveis imediatamente. Por outro lado, sua empresa não terá um código curto dedicado.

Algumas desvantagens dessa abordagem:

  • Se seus clientes cancelarem a aceitação das mensagens de outra empresa que compartilha o código curto com você, eles também deixarão de receber as suas mensagens.
  • Se uma empresa violar as regras, as mensagens de todas as empresas serão suspensas.
  • Problemas de segurança

Faturamento e preços

Como vou ser 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, definimos com você um determinado número de segmentos de mensagem para cada país, que você usará para enviar campanhas de SMS. O faturamento é feito 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 Segmentos de mensagem e limites de texto. Seu gerente de conta vai entrar em contato quando você estiver perto de atingir seu limite máximo e enviará relatórios relevantes para manter você informado. Se tiver outras dúvidas sobre excedentes, entre em contato com seu representante da Braze.

Como sou cobrado pelo RCS?

As mensagens RCS são cobradas por mensagem ou por segmento, dependendo do tipo de mensagem e do país. Para mais detalhes, consulte Faturamento de mensagens RCS.

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?

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

  • Preste atenção ao número de caracteres do seu SMS. Enviar sem querer mais de um segmento pode gerar excedentes. Para saber mais, consulte nosso detalhamento de segmentos.
  • Calcule com cuidado os caracteres do seu SMS considerando o uso de Liquid ou Connected Content. O criador de SMS da Braze no dashboard não estima nem leva em conta o uso desses recursos.
  • Considere o tipo de codificação da sua mensagem. Se a mensagem usa a codificação GSM-7, normalmente dá para estimar 160 caracteres por segmento de mensagem (menos, se você usar caracteres da tabela de extensão do GSM-7). Se a mensagem usa a codificação UCS-2, normalmente dá para estimar 67 caracteres por segmento de mensagem.
  • Teste, teste e teste! Sempre teste suas mensagens SMS antes do lançamento, principalmente quando usar Liquid e Connected Content.

Se uma mensagem for enviada para um telefone fixo, ela ainda conta para o meu número de envios de SMS?

Nos EUA, no Canadá e no Reino Unido:

  • Se um SMS for enviado para um telefone fixo, ele será marcado como Undelivered. O comportamento de cobrança depende do seu provedor de SMS. Com a Twilio, a tentativa de entrega ainda é cobrada. Então, as mensagens marcadas como Sent, Delivered ou Undelivered nos seus registros de mensagens são cobradas.
  • No Reino Unido, algumas operadoras convertem o SMS em uma mensagem de voz e entregam a mensagem.

Em outros países:

  • Com a Twilio, um erro é gerado e você não é cobrado pela tentativa de envio do SMS.

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

Você pode ser cobrado por segmentos de mensagem adicionais se a sua mensagem incluir personalização com Liquid. O processamento do template do Content Block só acontece quando a mensagem está sendo preparada para envio. Quando você edita um SMS com um Content Block, a Braze não sabe o que o Content Block vai conter, mas oferece uma estimativa aproximada. Recomendamos usar o painel de teste para pré-visualizar a mensagem e entender melhor o que esperar.

Envio e entregabilidade

Você pode incluir qualquer link em qualquer Campaign de SMS. No entanto, há alguns pontos a considerar:

  • Os links podem ocupar boa parte do limite de 160 caracteres do SMS. Se você incluir um link e texto, a mensagem pode ser dividida em duas mensagens SMS em vez de uma.
  • As empresas costumam usar encurtadores de link para reduzir o impacto do link na contagem de caracteres. Mas, se você enviar um link encurtado por meio de um código longo, as operadoras podem bloquear ou recusar a mensagem, já que podem desconfiar do redirecionamento do link.
  • Um código curto é o tipo de número mais confiável para incluir links.

A Braze também tem um recurso próprio de encurtamento de links, que encurta os links e fornece análise de dados de cliques automaticamente. Para saber mais, consulte Encurtamento de links.

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

A taxa de concorrência e a capacidade de envio padrão permitem cerca de 360.000 mensagens por hora por código curto. Para aumentar a capacidade de envio, é preciso adicionar mais códigos curtos.

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

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

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

  1. Deixe claras as instruções de aceitação e de cancelamento.
  2. Garanta que você (a marca) tenha um relacionamento com o cliente.
  3. Verifique se o conteúdo é relevante para esse relacionamento e para o que o usuário aceitou receber.

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

Quantos caracteres um emoji usa?

Os emojis podem ser complicados, porque não há uma contagem de caracteres padrão para todos eles. Existe o risco de o emoji ultrapassar o limite de caracteres e dividir o SMS em várias mensagens, mesmo que ele 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 uma lógica de aceitação seletiva de SMS para que os usuários fiquem no grupo de inscrições certo?

As palavras-chave personalizadas são registradas como eventos personalizados. Então, você pode criar Segments com base nas palavras-chave que os clientes podem enviar por mensagem. Por exemplo, se um usuário aceitar receber SMS de mensagens VIP, mas não de alertas, você pode criar um Segment VIP e um Segment de alertas e, em seguida, atribuir o usuário ao Segment adequado.

Se um usuário enviar “Stop” para o nosso código curto, a inscrição dele no grupo de inscrições é cancelada?

Como isso aparece no perfil de usuário? O grupo de inscrições aparece como cancelado em Configurações de contato, e há eventos personalizados para inscrição e cancelamento de inscrição.

Se um usuário tiver cancelado a inscrição e enviar uma palavra-chave para nosso código curto e longo, ele recebe a resposta que configuramos para essa palavra-chave na Braze?

Se um usuário tiver cancelado a inscrição e enviar uma palavra-chave de uma das categorias de palavras-chave padrão, ele receberá a resposta dessa palavra-chave. Se um usuário tiver cancelado a inscrição e enviar uma palavra-chave personalizada, ele não receberá a resposta dessa palavra-chave.

As propriedades de eventos 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ê precisa usar uma instrução Liquid na mensagem para reconhecer a palavra específica. As propriedades de eventos 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, contam. Lembre-se disso ao testar mensagens.

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

Sim, precisa. Os usuários devem ter um número de telefone válido e fazer parte do grupo de inscrições de SMS usado no envio de teste. Também precisam ter pelo menos um país selecionado em Permissões geográficas para SMS.

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

Os aliases não ficam visíveis no perfil de usuário. Para confirmar que os aliases foram definidos, use os endpoints de exportação de dados de usuários.

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.

Por que meu MMS com imagem falha ao enviar?

Alguns provedores de SMS validam o cabeçalho Content-Type nas URLs de imagem. Se um MMS com imagem for interrompido, confirme se a URL da imagem hospedada retorna image/png ou outro tipo de imagem compatível (por exemplo, com curl -I <image-url>). Hospede novamente o ativo na biblioteca de mídia da Braze ou em uma CDN que sirva o Content-Type correto.

Por que a imagem do meu cartão de contato não aparece em um MMS?

As fotos de cartões de contato em MMS podem não ser exibidas quando o arquivo do cartão de contato faz referência a uma URL de imagem que o dispositivo do destinatário não consegue acessar. Crie o cartão de contato em um celular, exporte o arquivo e faça upload na biblioteca de mídia para usar na sua mensagem MMS.

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 continuar visíveis mesmo depois que você toca em um botão do rich card ou em uma ação sugerida.
  • GIFs em rich cards são exibidos como imagens estáticas. Para saber mais, consulte Por que GIFs em rich cards RCS aparecem estáticos no iOS?.
  • No iOS 26, várias sugestões podem ser recolhidas em um menu de opções, e os rótulos das sugestões podem ficar ocultos. A prévia da Braze não mostra isso.
  • Uma sugestão de abrir URL em uma mensagem de mídia aparece como um ícone de link sobre a imagem, sem rótulo. Em vez disso, use um cartão com um botão de abrir URL.
  • As descrições dos cartões são truncadas após três linhas. A prévia não mostra esse truncamento.

Por que GIFs em rich cards RCS aparecem estáticos no iOS?

No iOS, GIFs em rich cards RCS são exibidos como uma imagem estática (o primeiro quadro). No Android, eles são animados normalmente.

Esse comportamento é controlado pelo cliente de mensagens do iOS. O GIF ainda pode aparecer animado na prévia da Braze. Envie uma mensagem de teste para um dispositivo iOS para confirmar como a mensagem entregue aparece.

Para enviar conteúdo animado para iOS:

  • Use uma mensagem RCS de Mídia, que envia o GIF como um arquivo (somente Infobip; a Twilio não aceita mensagens de mídia independentes)
  • Use vídeo no rich card

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, quando um usuário envia 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).

New Stuff!