Números de telefone dos usuários

Este artigo aborda diferentes tópicos relacionados aos números de telefone dos seus usuários ou clientes. Se você está procurando informações sobre seus próprios números, acesse nosso artigo sobre números de telefone de envio.

Formato recomendado

Recomendamos importar números de telefone no formato E.164 para garantir a precisão, especialmente se você estiver enviando para várias regiões com diferentes códigos de país ou de área—mesmo para números de telefone dos EUA.

• Números dos EUA: Todos os números dos EUA devem ser números de telefone válidos de 10 dígitos com um código de área válido. Se algum número de 10 dígitos estiver sem o + e o código do país, a Braze o mapeará como número dos EUA. Números de telefone de Porto Rico ainda exigem + e código do país, mesmo usando formatação de 10 dígitos com códigos de área no padrão dos EUA.
• Números internacionais: Todos os números internacionais devem começar com +, seguido do código do país e do número de telefone. Por exemplo, +442071838750.

Veja alguns exemplos mostrando as diferenças entre a formatação local e o formato E.164:

Importar números de telefone

Ao importar números de telefone, é importante seguir o formato recomendado. Para importar números de telefone, use um dos seguintes métodos:

• Fazer upload de um CSV para a Braze
• Usar o endpoint /users/track

Importante

Os números de telefone dos usuários aparecem na Braze como uma string de dígitos. Se você importar um número que contenha caracteres não numéricos (como ,, - ou () além do + inicial, os caracteres não numéricos serão removidos quando renderizados na Braze. Por exemplo, importar +1 (724) 123-4567 aparecerá como +17241234567.

Validação de número de telefone

A Braze usa a biblioteca libphonenumber do Google para validar números de telefone. Quando novos prefixos de números de celular são introduzidos, o suporte é adicionado conforme a biblioteca upstream é atualizada. A Braze não mantém uma lista separada de prefixos válidos.

Tratamento de números de telefone inválidos

Quando um número de telefone é considerado inválido, a Braze marca o número de telefone do usuário como inválido e não tenta enviar mais comunicações para esse número de telefone. Um número de telefone inválido é marcado na guia Engajamento do perfil de usuário.

Um número de telefone é considerado inválido pelos seguintes motivos:

• Erro do provedor: um erro permanente foi recebido do provedor de SMS e RCS. Isso indica que o número de telefone fornecido está formatado incorretamente ou é permanentemente incapaz de receber mensagens SMS ou RCS.
• Desativado: o número de telefone foi desativado porque um assinante móvel encerrou seu serviço e liberou seu número da operadora (e pode eventualmente ser reciclado e atribuído a um novo usuário). Um número de telefone desativado pode ser marcado como inválido mesmo que você não tenha enviado nenhuma mensagem SMS ou RCS para esse número de telefone.

Esses números de telefone inválidos podem ser gerenciados usando endpoints de SMS e RCS.

Nota

Se vários perfis de usuário tiverem o mesmo número de telefone e esse número de telefone for marcado como inválido, todos os perfis de usuário existentes com esse número serão exibidos como inválidos. Perfis de usuário recém-criados nunca serão inicialmente marcados como inválidos.

Você também pode incluir ou excluir qualquer usuário com números de telefone inválidos ao criar um segmento.

Excluir envios de SMS rejeitados da segmentação

Importante

As rejeições de SMS podem contar para a sua cota de SMS, dependendo do seu contrato com a Braze e do provedor de SMS. Para detalhes sobre faturamento, consulte Relatórios.

Para excluir usuários com envios de SMS rejeitados dos seus Segments, use extensões de segmento SQL e faça o seguinte:

1. Acesse Audience > Segment Extensions.
2. Selecione Create New Extension > Full refresh ou Incremental refresh.
3. Escreva uma consulta SQL que identifique usuários com rejeições de SMS. Por exemplo, você pode consultar o evento USERS_MESSAGES_SMS_REJECTION_SHARED para encontrar usuários que receberam rejeições de SMS.
4. Salve sua extensão de segmento.
5. Ao criar seu Segment de SMS, adicione um filtro para excluir os usuários dessa extensão de segmento.

Adicionar usuários a grupos de inscrições de SMS e RCS

Para que um usuário receba uma mensagem SMS ou RCS, ele deve ter um número de telefone válido e ter optado por participar de um grupo de inscrições. Os grupos de inscrições estão vinculados ao programa de SMS ou RCS que você está executando (certifique-se de seguir os requisitos legais para SMS, MMS e RCS e de ter registrado o consentimento de cada cliente). Para saber mais, consulte Grupos de inscrições de SMS e RCS.

Fornecimento e verificação por terceiros

A Braze conta com ferramentas de terceiros para identificar números inválidos. A Braze não é responsável por interrupções ou informações incorretas desses serviços. Portanto, essa ferramenta não deve ser usada como seu único método de conformidade para verificar números inválidos.

Captura de números de telefone

Para capturar números de telefone por meio de mensagens no app, consulte Formulário de inscrição de SMS, RCS e WhatsApp.