Unir um CSV de Consulta da operadora original a linhas de contato originais

Para unir um CSV de consulta de operadora aos registros de contato, crie um arquivo auxiliar local antes do upload: mapeie cada número preparado com código de país para cada ID de linha de contato original que o forneceu.

Para unir um CSV de consulta de operadora aos registros de contato, crie um arquivo auxiliar local antes do upload: mapeie cada número preparado com código de país para cada ID de linha de contato original que o forneceu. Envie apenas identificadores preparados para o país selecionado e, em seguida, reconcilie o CSV retornado pelo identificador, em vez da posição da linha no arquivo. Isso preserva contatos duplicados sem fingir que o serviço em lote retorna uma linha para cada registro de origem.

Prepare o arquivo auxiliar antes de criar o arquivo em lote

A Consulta da operadora original em tempo real do CarrierLookup retorna a operadora originalmente alocada, a operadora subjacente, o tipo de número e a geografia de alocação. Seu produto separado de consulta de operadora Global lida com tarefas de arquivo assíncronas. A página Consulta de operadora Global é o caminho do produto relevante. O processamento em lote aceita TXT ou CSV de uma coluna com um número com código de país em cada linha e um país ISO selecionado. O arquivo preparado deve ser essencialmente para esse país selecionado. Não presuma que o produto aceite XLSX, esquemas mistos ou um arquivo contendo IDs de linha de CRM.

Uma exportação de CRM de origem pode conter números repetidos, formatos de exibição diferentes, valores em branco e números fora do país pretendido. Antes do envio, crie um mapeamento local do número canônico com código de país para uma lista de IDs de linha de origem. Mantenha o texto original e a decisão de normalização ao lado de cada linha para auditoria. Por exemplo, dois contatos podem compartilhar um número de central telefônica comercial; o arquivo auxiliar deve preservar ambos os IDs de linha, mesmo que a lista enviada contenha esse número apenas uma vez. Esta é uma estrutura de dados de propriedade do cliente, não uma coluna retornada pelo produto em lote.

Separe uma linha de origem rejeitada de um identificador preparado excluído. Uma linha pode estar inutilizável antes do upload porque carece de contexto suficiente para normalizar, enquanto o pré-processamento em lote pode excluir posteriormente duplicatas ou números fora do país selecionado. Registre o estágio claramente.

Use o significado do identificador, não a posição da linha, como chave de união

Uma tarefa em lote bem-sucedida retorna um CSV com um identificador e campos de alocação original. Identificadores em lote são dígitos com código de país sem sinal de mais ou espaços. O CRM de origem pode armazenar números E.164 com um sinal de mais inicial, formatação nacional ou pontuação. Normalize ambos os lados para a mesma forma de comparação de propriedade do cliente antes de unir, mantendo cada representação original separadamente. Não presuma que a ordem das linhas do CSV corresponda à ordem das linhas de contato; o pré-processamento pode excluir entradas inválidas ou duplicadas.

A união é de muitos para um: várias linhas de contato podem apontar para um número preparado e uma linha de consulta retornada. Expanda o resultado de volta para essas linhas de origem somente após validar a chave. Por outro lado, se um identificador retornado estiver ausente do manifesto enviado, coloque-o em quarentena para revisão em vez de anexá-lo à linha mais próxima. Esta é uma regra de reconciliação, não uma afirmação de que linhas inesperadas são comportamento normal do produto.

Um manifesto compacto pode conter ID da linha de origem, texto original do telefone, valor de comparação normalizado, país selecionado, nome do arquivo preparado e referência do lote de envio. Estes são campos de metadados locais. Eles não devem ser anunciados como colunas CSV do CarrierLookup. A documentação da API deve ser usada para o envio da tarefa atual e detalhes do resultado.

Verifique exclusões e duplicatas antes de atualizar registros

O pré-processamento em lote exclui linhas inválidas, duplicatas, números sem código de país e números fora do país selecionado. Linhas excluídas não são cobradas. É por isso que uma contagem de linhas de upload, uma contagem de válidos preparados e uma contagem de resultados podem diferir. Reconcilie-as como três quantidades separadas. Não preencha a operadora de uma linha excluída a partir de uma linha de saída adjacente. Se contatos de origem duplicados compartilharem um número normalizado, o aplicativo pode mapear o único resultado concluído de volta para ambos, com o mesmo tempo de observação e origem.

Uma tarefa pode falhar durante a preparação se poucos números de celular válidos forem estimados ou se outra condição de aceitação falhar. Nesse caso, não crie linhas de resultado fantasmas a partir do arquivo de entrada. Mantenha o manifesto para diagnóstico e consulte a documentação do produto para os limites atuais por produto. Este artigo intencionalmente não declara um mínimo, máximo ou tempo de conclusão normal específico para a tarefa. A tarefa em lote é assíncrona, portanto, aguarde o sucesso antes de usar seu CSV.

Os campos do CSV descrevem a alocação original, não a operadora atual após a portabilidade do número. Região e cidade são geografia de alocação de faixa, não a localização de um contato. Uma linha concluída com campos de alocação vazios deve permanecer uma linha concluída com valores indisponíveis, não ser descartada como uma união inválida.

Produza um relatório de reconciliação antes da gravação no CRM

O relatório final de propriedade do cliente deve listar identificadores únicos enviados, identificadores retornados, chaves enviadas não correspondentes, chaves retornadas inesperadas, linhas de origem cujos números foram rejeitados antes do upload e linhas de origem duplicadas que receberão o mesmo resultado. Um revisor deve aprovar a política de união para casos não correspondentes antes que as gravações comecem. Mantenha o CSV bruto e o arquivo auxiliar sob a política de acesso e retenção da própria organização para que uma auditoria posterior possa reproduzir o mapeamento.

Para cada atualização de CRM, verifique se o contato ainda possui o mesmo número normalizado. Se ele mudou enquanto a tarefa era executada, marque um conflito em vez de sobrescrever o registro atual com contexto de operadora obsoleto. Uma verificação de versão de registro opcional pode ajudar a integração do cliente a aplicar essa regra; não é um recurso do CarrierLookup. Armazene a origem da consulta e o tempo de observação com os campos de alocação original.

Após um teste, amostre um número repetido, um número excluído durante a preparação, um resultado de campo vazio concluído e um contato editado durante a tarefa. Os resultados esperados são, respectivamente, uma expansão deliberada de muitos para um, nenhum resultado de operadora inventado, valores vazios preservados e um conflito adiado. Esta validação visa o risco real de um fluxo de trabalho de arquivo: mapear uma consulta tecnicamente correta no contato errado.

Se uma linha de origem contiver vários campos de telefone, registre qual campo gerou cada identificador preparado. Um número de contato principal e um número alternativo não devem receber valores de operadora intercambiáveis. O arquivo auxiliar pode então explicar por que uma linha CSV concluída atualizou um campo, mas deixou o outro intocado, mesmo quando ambos os valores pertencem ao mesmo registro de pessoa ou empresa.

FAQ

As equipes devem unir linhas CSV em lote por posição?

Não. Use o identificador retornado com código de país e um mapeamento de arquivo auxiliar local para IDs de linha de origem; o pré-processamento pode remover linhas.

Como contatos duplicados com um número de telefone devem ser tratados?

Preserve cada ID de linha de origem no arquivo auxiliar, envie o identificador preparado uma vez quando apropriado e mapeie deliberadamente o resultado concluído de volta para cada linha correspondente.

O que acontece com um número excluído durante a preparação?

Mantenha-o em um relatório de exclusão e não invente um resultado de operadora para essa linha de origem.

O CSV pode mostrar a rede ou localização atual de um contato?

Não. Ele relata a operadora original e a geografia de alocação de faixa numérica, que não são fatos de rede atual ou localização de pessoa.

Saiba mais

Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.

• Ver a documentação do produto →
• Falar com a equipe →