Ir para o conteúdo
↗ COEX.

Integração

Telefone brasileiro na API: máscara visual e número normalizado

Conteúdo editorial da DropFlow · Atualizado em

A interface pode exibir um telefone com espaços, parênteses e hífen, enquanto uma integração exige outro formato para o campo de destinatário. A normalização deve seguir o contrato da operação sem inventar dígitos. Além disso, o telefone visível não substitui o Phone Number ID quando uma rota exige o identificador do recurso.

Roteiro de verificação

  • Separe o valor exibido ao operador do valor técnico enviado à API. Preserve uma representação de origem para diagnosticar erros de importação.
  • Identifique se o cadastro já contém código de país e DDD. Não acrescente 55 ou um nono dígito repetidamente sem verificar a informação fornecida.
  • Valide o formato de acordo com o campo utilizado e rejeite entradas incompletas que não possam ser interpretadas com segurança. Solicite correção ao responsável pelo cadastro.
  • Teste números nacionais e estrangeiros suportados pela operação, além de entradas com máscara. Uma regra exclusiva de Brasil não deve alterar silenciosamente contatos de outro país.

Exemplo para orientar o teste

O contato pode ser mostrado como (47) 99999-9999, mas a integração precisa receber o formato técnico documentado. Se o sistema acrescenta o país a um valor que já o contém, cria um destinatário diferente ou inválido.

Cuidados e limites

Não deduza DDD pela localização da empresa nem altere um telefone de cliente para fazer a validação passar. Dados ausentes devem ser corrigidos, não fabricados.

Como conferir o resultado

Compare entrada original, apresentação e valor técnico em exemplos fictícios. Confirme que a normalização é consistente e não modifica um número já válido em repetidas execuções.

Fontes e condições

As condições da Meta podem mudar. Consulte as referências oficiais e os termos antes de executar alterações no seu número.

Preferências de cookies

Necessários: autenticação, segurança e registro da sua escolha. Sempre ativos.

O GTM compartilhado contém tags das duas categorias e será carregado somente se ambas forem autorizadas. Eventos da Meta no servidor dependem da opção de publicidade.

Você pode alterar ou retirar sua escolha aqui a qualquer momento. Sem consentimento, não enviamos novos eventos de publicidade.