CheckNumber.AI · 7 min read
Transforme uma exportação vCard em uma lista de verificação de números de telefone em lote
Extraia entradas TEL de vCards para um arquivo de lote com um número por linha, preservando IDs de contato, rótulos e exceções de revisão.
Para transformar uma exportação vCard em uma lista de verificação de números de telefone em lote, extraia cada entrada TEL, mantenha sua referência de contato de origem e normalize o número de telefone em um arquivo separado com um número por linha. Um cartão de contato pode conter vários campos de telefone, portanto, o número de entradas para verificação não será necessariamente igual ao número de cartões. Mantenha um mapeamento para o cartão original antes de remover duplicatas ou realizar qualquer upload.
Entenda o que uma entrada TEL de vCard representa
A especificação vCard define TEL como uma propriedade de telefone dentro de um cartão de contato. Um cartão pode incluir várias propriedades TEL com rótulos ou parâmetros de tipo que distinguem o uso comercial, móvel, residencial ou outro. Algumas exportações representam o valor como texto; outras usam uma forma de URI. Um nome no cartão é o contexto do contato, não parte do número a ser verificado. Da mesma forma, um marcador de preferência é uma dica sobre qual número a agenda pode mostrar primeiro, não uma garantia de que o número preferencial seja válido.
Um guia genérico de CSV geralmente começa depois que os dados de contato já foram nivelados. A conversão de vCard tem um problema anterior: um cartão pode se expandir para zero, uma ou várias linhas de telefone. Se a equipe mantiver apenas o primeiro valor TEL, poderá perder uma linha comercial útil. Se copiar o cartão inteiro para uma única célula de planilha, um verificador não conseguirá interpretar a entrada como um número de telefone por linha. A etapa de conversão deve preservar tanto o número quanto o relacionamento com o cartão.
Crie uma tabela de extração que preserve a origem
Salve a exportação .vcf original e crie uma tabela de trabalho com um identificador de cartão estável, um identificador de ocorrência TEL, o texto TEL original, o nome exibido no cartão (se necessário para revisão interna), qualquer rótulo de tipo TEL, o país interpretado, o candidato normalizado e um status de revisão. Estes são campos locais propostos, não campos de upload ou resultado documentados do CheckNumber.AI. Um único cartão com entradas TEL comercial e móvel torna-se duas linhas na tabela que compartilham um ID de cartão, mas possuem IDs de ocorrência separados.
Use um analisador compatível com vCard sempre que possível. O formato possui regras de escape e quebra de linha; dividir apenas por caracteres de nova linha pode corromper propriedades longas. Mantenha o valor TEL original ao lado do valor analisado para que um revisor possa distinguir um erro de análise de um registro de origem incorreto. Se um valor TEL for um URI tel:, trate sua notação URI no analisador local e retenha o valor não modificado para auditoria. Não presuma que a agenda de contatos de origem usou um país consistente ou armazenou todos os números em formato internacional.
Normalize candidatos e isole entradas incertas
Para cada ocorrência TEL, determine se há contexto de país suficiente para formar um número de telefone internacional. Um número local sem código de país pode exigir um país associado ao contato ou ao sistema de origem; o idioma de um contato, por si só, é uma evidência fraca. Não tente adivinhar o país a partir de um prefixo familiar nem force um número a ter uma forma que pareça válida. Coloque valores incompletos, apenas com ramais, códigos de serviço e valores ambíguos em uma fila de revisão. Se um número incluir um ramal de PABX, mantenha-o no mapa e envie apenas o número base público onde essa separação for suportada pela fonte.
O plano de numeração ITU-T Recommendation E.164 fornece a estrutura para números internacionais. Para o fluxo de trabalho em lote do CheckNumber.AI, os arquivos de lista telefônica usam um país por arquivo e um número por linha com código de país; o sinal de mais pode ser omitido. Crie um arquivo separado apenas com números para cada país. Um cartão que contenha números de dois países pode contribuir com uma entrada para cada arquivo, permanecendo como um único cartão no mapa de origem. Nunca coloque nomes de contatos, rótulos TEL ou IDs em uma linha apenas com números.
Remova duplicatas de entradas de verificação sem colapsar contatos
Vários cartões de contato podem se referir à mesma central telefônica da empresa ou ao mesmo número familiar. Normalize os valores candidatos e, em seguida, crie um mapa de cada entrada de verificação única para todos os IDs de ocorrência TEL que a produziram. Isso pode reduzir verificações redundantes, mas as linhas de origem devem permanecer separadas. Um número duplicado não é evidência de que os cartões representam a mesma pessoa. Da mesma forma, um único cartão com dois números não implica que os números compartilhem o mesmo sinal de validade ou atividade.
Antes do upload, compare as contagens em cada etapa: cartões analisados, propriedades TEL extraídas, entradas que exigem revisão, candidatos normalizados e números únicos preparados. Investigue qualquer queda surpreendente. Amostre cartões com múltiplos valores TEL e garanta que eles tenham múltiplas linhas de mapeamento. Verifique alguns registros de ponta a ponta: propriedade vCard original, candidato normalizado local, linha de upload e chave de mapeamento. Isso é mais informativo do que apenas confirmar que um arquivo CSV ou TXT abre.
Verifique e reúna os resultados
Escolha o produto de verificação de números de telefone em lote documentado que responda à pergunta da equipe; o catálogo de produtos do CheckNumber.AI distingue diferentes sinais de verificação. Um resultado de formato ou validade, um sinal de registro em plataforma e um sinal de atividade têm significados diferentes. Não trate um como prova do outro nem infira a propriedade do contato a partir de qualquer um deles. Mantenha a data da verificação e o produto selecionado com o resultado local.
Quando os resultados forem exportados, combine o número verificado com a chave normalizada na tabela de extração e, em seguida, expanda esse relacionamento de volta para cada ocorrência TEL e cartão. Não dependa da ordem do arquivo nem presuma que cada linha de upload produziu uma linha de resultado idêntica. Investigue resultados não correspondentes, duplicados ou incertos antes de atualizar a agenda de contatos ou o CRM. Preserve o rótulo TEL original para que a equipe possa saber se um resultado se aplicou a uma linha comercial ou móvel. Uma etapa de revisão gerenciada pelo usuário pode então decidir se deve sinalizar, corrigir ou manter cada valor de contato. O serviço de verificação fornece um sinal em nível de número; a reconciliação do cartão de contato pertence à equipe.
FAQ
Como as equipes podem lidar com várias entradas TEL em um único vCard?
Expanda cada propriedade TEL em uma linha local separada com seu próprio ID de ocorrência, mantendo o mesmo ID de cartão de origem. Prepare cada número adequado como uma entrada de verificação individual.
Números duplicados em cartões diferentes devem ser excluídos?
Não. Remova duplicatas das entradas de verificação se for útil, mas retenha cada relacionamento entre cartão e número. Números compartilhados não provam que se tratam de pessoas ou empresas duplicadas.
O que acontece se uma entrada TEL não tiver código de país?
Use o contexto de origem confiável para determinar o país ou mantenha-o para revisão. Não adivinhe um país apenas para fazer com que o valor passe em uma verificação de formato.
Uma verificação de telefone pode validar o nome em um vCard?
Não. Um sinal de verificação em nível de número não valida a identidade do proprietário do cartão ou o relacionamento atual entre o número e o contato nomeado.
