Como inserir números de telefone

Há apenas um formato de telefone que funciona em todo o REDA Connect: o número internacional completo, somente com dígitos: primeiro o código do país e depois o número, sem +, espaços, hífens, parênteses. Remova o prefixo nacional somente quando o formato internacional do país exigir; preserve zeros significativos. Para um número dos EUA que aparece como +1 (415) 555-0123 em um cartão, armazene 14155550123. Para o celular indiano 88888 88888, armazene 918888888888. Essa regra não é uma preferência de estilo: qualquer outro formato causa as duas falhas concretas descritas a seguir. É a causa mais comum de «funcionou na demonstração, mas não com nossos dados reais».

A ajuda dos campos do pacote especifica o formato dos números da conta: «O número deve ser informado no seguinte formato: <Country ISD Code><Number>. O número não deve conter caracteres especiais nem espaços. Por exemplo, para os Estados Unidos (ISD Code é 1), se o número for 2223334444, informe 12223334444.» A mesma convenção se aplica a todos os números usados pelo REDA Connect.

Onde a regra se aplica

• Os números da própria conta: Número do WhatsApp e Número de remetente SMS em cada Conta Connect.
• Os campos de telefone dos seus registros: o campo que cada configuração de objeto define como telefone de um canal (MobilePhone em Contato, Phone em Lead ou qualquer campo personalizado). As mensagens recebidas são comparadas com esses valores.
• O número do destinatário de cada mensagem (o campo Número de destinatário), nas mensagens criadas por automações ou integrações.

Por quê: as duas falhas

1. Armazenar um + impede o envio de SMS. Ao enviar um SMS, o REDA Connect adiciona o + ao número do destinatário e ao Número de remetente SMS da conta. Se o valor armazenado já começar com +, o provedor receberá um número que começa com ++ e rejeitará o envio: a mensagem termina com Status Falhou e o erro do provedor no campo Mensagem de erro.

2. A correspondência de mensagens recebidas é exata. Quando um cliente envia uma mensagem, o WhatsApp e a Twilio identificam o remetente pelo número internacional completo em dígitos (o + inicial da Twilio é removido antes da busca). O REDA Connect procura um registro cujo campo de telefone configurado seja igual a esse valor caractere por caractere. Nenhum dos valores é normalizado: não se removem espaços, hífens ou parênteses, nem se buscam correspondências pelo final do número ou por aproximação. Um registro com o telefone +1 (415) 555-0123 simplesmente não é encontrado quando chega uma mensagem de 14155550123: a mensagem chega, mas não se vincula ao registro. Ela aparece apenas no feed global, sem associação, e nenhuma automação baseada no registro é executada. Veja como os registros são escolhidos em Vincular mensagens recebidas a registros.

Exemplo prático: oito formas de armazenar um número

O número do cliente é +1 415 555-0123, dos EUA. Veja o que acontece com cada formato que uma organização pode ter armazenado:

A linha 1 é a única que funciona nos dois sentidos e nos dois canais. Alguns valores incorretos podem parecer válidos em um caso muito específico, dificultando a identificação da falha depois. Armazene todos os números como na linha 1 para evitar esses problemas.

Adote uma convenção e normalize os dados uma vez

Como a correspondência é exata, a uniformidade em toda a organização importa mais do que qualquer valor individual:

1. Documente a convenção para quem insere dados: código do país + número, somente dígitos. Inclua-a também na integração das equipes de vendas e suporte.
2. Corrija os sistemas de origem: formulários web para criar leads, importações e integrações que gravam campos de telefone devem armazenar apenas dígitos. Um + adicionado por um sistema anterior no fluxo reintroduzirá o problema sem aviso.
3. Faça uma normalização inicial dos campos de telefone usados pelas configurações de objetos. Crie uma exibição de lista ou um relatório filtrado pelo campo de telefone, procure valores com +, espaços, hífens ou parênteses e corrija-os (ferramentas de atualização em massa ajudam com grandes volumes). Faça isso antes de entrar em produção: um número sem correspondência não gera erro; ele simplesmente não é vinculado, sem aviso.

Solução de problemas

Perguntas frequentes

Próximos passos

• Vincular mensagens recebidas a registros: como a correspondência exata escolhe um registro e o que acontece quando há várias correspondências.
• Criar uma Conta Connect: os campos da conta onde esses números são armazenados.
• Contas padrão e ordem de seleção: depois do formato, a outra decisão de seleção que vale entender.