Normalizando números de telefone para E.164 no BigQuery para consulta
Aprenda a normalizar números de telefone para o padrão E.164 no BigQuery. Preserve dados originais e use colunas auxiliares para garantir precisão em suas consultas.
Para normalizar números de telefone para E.164 no BigQuery antes de uma consulta de operadora, preserve a coluna original, remova caracteres de formatação em uma coluna de trabalho e adicione um código de país apenas quando um campo de país confiável suportar essa escolha. Mantenha um sinal de mais inicial para solicitações em tempo real do CarrierLookup. Para uma tarefa de arquivo de um único país, exporte os dígitos com o código do país e reconcilie o CSV retornado usando uma chave estável.
Preserve o número original e sua evidência de país
Não sobrescreva a única cópia de um número de telefone durante a limpeza. Crie colunas separadas para o valor original, país de origem, candidato normalizado e um motivo para rejeição ou revisão manual. Uma fonte pode conter um prefixo de discagem nacional, um formato local ou um código de país escrito de forma inconsistente. Uma expressão regular pode remover a pontuação, mas não pode decidir a qual país um número pertence. Essa decisão requer um campo de país confiável ou outra evidência de fonte autorizada.
A ITU E.164 recommendation define a estrutura de numeração internacional. As consultas em tempo real do CarrierLookup exigem um + inicial, código do país e número do assinante sem espaços ou separadores. Um candidato que apenas se parece com dígitos não é automaticamente um número válido. Mantenha valores incertos fora do conjunto de consulta até que uma pessoa ou uma regra de numeração validada os resolva.
Planeje o formato da exportação desde o início. Solicitações múltiplas em tempo real podem incluir números de diferentes países e retornar na ordem de entrada. A tarefa de arquivo em lote do CarrierLookup aceita números de um único país selecionado. Divida um conjunto de dados de países mistos por uma atribuição de país confiável antes de preparar os arquivos; não escolha um país apenas pelos primeiros dígitos.
Use funções do BigQuery para limpeza mecânica
A BigQuery string-function reference do Google documenta REGEXP_REPLACE, REGEXP_CONTAINS e funções relacionadas. Use-as para transformações mecânicas, como remover espaços, parênteses e hifens de uma cópia do valor de origem. Uma expressão simples como REGEXP_REPLACE(raw_phone, r'[^0-9+]', '') pode criar um candidato para inspeção, mas também pode preservar um sinal de mais interno inesperado. Siga com um teste de formato e um caminho de quarentena em vez de enviar cada saída para a API.
Para dados já armazenados com um sinal de mais inicial e código de país confiáveis, uma expressão candidata pode remover separadores enquanto retém esse sinal de mais. Para números locais, use uma regra de normalização específica do país revisada em relação às orientações de numeração atuais. Uma regra genérica de "adicionar o código do país do CRM" é arriscada quando o valor original já inclui um código de país ou um prefixo de tronco. Documente a transformação específica aplicada a cada tipo de fonte e faça uma amostragem da saída antes da exportação.
Uma tabela de preparo prática contém raw_phone, country_source, normalized_e164, normalization_rule e review_status. Construa a entrada da consulta apenas a partir de linhas marcadas como prontas. Isso evita que um formato rejeitado seja confundido com um resultado de operadora não encontrada e torna as correções reversíveis.
Prepare o caminho múltiplo em tempo real
Para um pequeno conjunto pronto, exporte strings E.164, como + seguido pelos dígitos com código do país, para o fluxo de trabalho múltiplo REST. O endpoint POST /api/v1/batch-check aceita de 1 a 100 números e retorna um resultado síncrono ordenado. Armazene um mapeamento posicional do elemento de solicitação para a chave da linha de origem antes de enviar a chamada. Não confie apenas em valores de telefone idênticos quando o CRM contiver duplicatas.
Leia o identifier e o status exists de cada item retornado. exists=false significa que o item não possui um resultado normal; não é uma declaração de que o número está desconectado. Um resultado bem-sucedido pode conter operadora, operadora subjacente, tipo de número, código do país, região e cidade, com campos opcionais vazios. Mantenha o horário da verificação e a associação de entrada de cada resultado na tabela de preparo.
A verificação única usa a mesma forma E.164 quando um operador precisa inspecionar um registro. Autentique a partir de um servidor confiável usando o cabeçalho X-API-Key documentado. Este fluxo de trabalho oferece às equipes de dados uma maneira de testar a normalização em uma amostra antes de enviar uma lista preparada muito maior.
Prepare tarefas de arquivo de um único país
Para uma lista grande, crie um TXT ou CSV de uma coluna com um número com código de país por linha e selecione o país ISO correspondente para a tarefa em lote. A entrada documentada deve pertencer a esse país selecionado. Na submissão multipart, o campo do país deve preceder o arquivo. A preparação em lote remove linhas inválidas, duplicatas, linhas sem código de país e números fora do país selecionado. Inspecione as contagens de preparação antes de tratar a exportação de origem como totalmente processada.
A tarefa em lote é assíncrona: envie com POST /api/v1/bulk-tasks, salve o ID da tarefa e consulte GET /api/v1/bulk-tasks/{id} com uma frequência não superior a 30 segundos. Uma tarefa bem-sucedida fornece um CSV. Ele relata o identificador como dígitos simples com código de país, sem um sinal de mais. Isso difere da forma de solicitação em tempo real, portanto, não junte o resultado a um campo de telefone original por igualdade direta de string.
Construa uma chave de junção apenas com dígitos normalizados a partir de cada candidato E.164 aceito e retenha a chave da linha de origem separadamente. Se a entrada contiver números duplicados, a preparação em lote pode colapsá-los; decida se um resultado deve ser associado a vários registros de origem. Reconcilie linhas de origem não correspondentes, inválidas e duplicadas fora do CSV de resultado.
Revise os dados unidos antes das atualizações do CRM
A operadora resultante descreve a alocação original, não a operadora que atende atualmente após a portabilidade. Região e cidade são a geografia de alocação, e não a localização ao vivo. Coloque essas descrições no dicionário de dados para que os analistas não confundam um nome de campo com a prova de onde uma pessoa está agora. Um resultado em tempo real concluído com code=0 pode ter campos de operadora opcionais vazios; mantenha os vazios como indisponíveis em vez de gerar um rótulo negativo.
Amostre linhas unidas de vários sistemas de origem e países. Verifique se o número original, a forma E.164 normalizada, a chave de dígitos simples e o identificador de resultado referem-se à mesma entrada. Investigue incompatibilidades na tabela de preparo antes de gravar valores no CRM. Mantenha o carimbo de data/hora da consulta, já que o contexto de alocação pode ser revisitado posteriormente e o próprio registro de origem pode mudar.
Este pipeline separa três trabalhos: o BigQuery limpa uma representação conhecida, o CarrierLookup fornece campos de alocação documentados e a equipe de CRM decide se e como atualizar o contato. Essa divisão torna os erros visíveis e mantém o resultado da operadora dentro de seu significado adequado.
FAQ
Como as equipes podem remover separadores de telefone no BigQuery?
Use uma cópia de trabalho e funções de string documentadas, como REGEXP_REPLACE, e valide o candidato em relação à forma E.164 esperada.
Como as equipes podem atribuir um código de país a um número local?
Use um campo de país confiável e uma regra específica do país revisada. Coloque em quarentena as linhas cujo país ou forma de discagem seja ambígua.
Como as equipes podem unir um CSV em lote a uma entrada E.164?
Crie uma chave estável apenas com dígitos a partir de candidatos E.164 aceitos e reconcilie-a com o identificador do CSV em lote, preservando os IDs das linhas de origem.
Como as equipes podem lidar com uma lista de países mistos?
Use solicitações múltiplas em tempo real para um pequeno conjunto de países mistos ou divida arquivos grandes por atribuição de país confiável antes da submissão em lote.
Saiba mais
Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.