Dividir uma lista de telefones de vários países em tarefas de Consulta da operadora original

Um manifesto de país para arquivo transforma uma exportação de CRM mista em tarefas de Consulta da operadora original revisadas e específicas por país.

Para dividir uma lista de telefones de vários países para tarefas em lote do CarrierLookup, preserve a exportação de origem, analise cada número para uma forma internacional, agrupe as linhas elegíveis pelo país ISO selecionado e escreva um arquivo TXT ou CSV revisado por país. Mantenha um manifesto vinculando cada arquivo de saída ao seu país, linhas de entrada, exclusões e resultado posterior. O serviço em lote do CarrierLookup processa um arquivo de país selecionado; ele não divide uma exportação mista para a equipe.

Comece com a lista de origem e sua evidência de país

Um campo de mercado de CRM não é suficiente para colocar um número em uma tarefa em lote. Um cliente pode morar em um país e manter um número de outro. Comece pelo código de país internacional do número de telefone e mantenha o país ou mercado original do CRM como um campo de negócio separado. A ITU-T Recommendation E.164 define a estrutura de numeração internacional; ela também reconhece códigos de numeração que cobrem um plano integrado em vez de um rótulo simples de um país. Use um analisador de numeração mantido e inspecione linhas ambíguas em vez de atribuir um país apenas pelo primeiro dígito ou por uma coluna de planilha.

Leia identificadores de telefone como texto. Softwares de planilha e leitores de CSV podem, de outra forma, alterar caracteres iniciais ou inferir tipos numéricos. Por exemplo, a pandas read_csv documentation descreve dtype explícito e leitura em partes. Uma equipe que usa outra ferramenta precisa das mesmas propriedades: importação que preserva o texto e uma maneira repetível de lidar com uma exportação grande sem alterar silenciosamente os identificadores.

Mantenha o arquivo de origem intocado e uma referência de linha local. Se um valor de telefone não tiver um código de país internacional, não tente adivinhar um apenas para fazer a linha passar na aceitação do lote. Marque-o para revisão de dados de origem. Uma linha rejeitada antes do envio deve permanecer visível no relatório de aceitação, mesmo que nunca apareça em um arquivo de resultado do CarrierLookup.

Crie um manifesto de país para arquivo antes do upload

Crie um manifesto com uma linha por arquivo de saída pretendido. Os campos sugeridos de propriedade do cliente são: país ISO selecionado, nome do arquivo de saída, data da exportação de origem, contagem de linhas de origem, contagem de números únicos preparados, contagem de linhas excluídas, revisor e uma soma de verificação do arquivo. Mantenha um arquivo auxiliar separado de cada número canônico de volta para cada linha de contato original. Estes são controles locais, não campos na resposta ou no CSV do CarrierLookup.

Divida apenas números preparados com código de país em arquivos TXT ou CSV de uma coluna. A CarrierLookup API documentation identifica um país selecionado para o serviço em lote de Consulta da operadora original global, enquanto consultas individuais e múltiplas em tempo real aceitam números de diferentes países. Essa distinção é o motivo pelo qual uma exportação mista precisa de preparação para o lote, mas pode ser tratada de forma diferente em um fluxo de trabalho em tempo real menor.

O manifesto também deve declarar o motivo pelo qual uma linha foi excluída: código de país ausente, número não analisável, identificador preparado duplicado ou país não incluído na execução atual. Duplicatas podem representar vários contatos de origem legítimos. Desduplique a chave de envio enquanto preserva cada relacionamento de linha de origem no arquivo auxiliar; após um resultado bem-sucedido, a equipe pode mapear deliberadamente o contexto de alocação de volta para cada registro correspondente.

Execute um relatório de aceitação para cada partição de país

Antes do envio, compare cada arquivo com o manifesto. Verifique se cada linha contém um número com código de país, se o país selecionado é consistente com as linhas preparadas e se nenhum cabeçalho ou coluna de CRM foi incluído no arquivo de uma coluna. O arquivo deve ser essencialmente para o país selecionado sob as regras de serviço atuais. Não declare um limite fixo de linhas ou tamanho de arquivo de memória; verifique as informações do produto em lote e a documentação da API para os limites de aceitação atuais.

Um relatório de aceitação pode mostrar quatro totais: linhas de origem consideradas, linhas retidas para reparo de dados, identificadores únicos escritos e linhas de origem duplicadas representadas através do arquivo auxiliar. Recalcule esses totais a partir dos arquivos em vez de copiá-los de uma exportação anterior. Um manifesto que diz um país enquanto seu arquivo contém outro é um erro operacional evitável; peça a um revisor que compare o arquivo e o país selecionado antes do envio.

Trate uma pequena partição de país como um ponto de decisão. Se ela não atender às regras atuais de aceitação em lote, retenha-a ou use um fluxo de trabalho em tempo real documentado quando apropriado. Não a preencha com números repetidos. O CarrierLookup possui uma Consulta da operadora original síncrona para números individuais e solicitações de vários números, além de um serviço de arquivo de Consulta da operadora original global assíncrono. São fluxos de trabalho diferentes, e a equipe deve escolher com base na partição real e nos limites atuais do produto.

Envie e monitore cada tarefa separadamente

Para cada partição aprovada, envie o arquivo com o país selecionado correspondente e registre a referência da tarefa retornada no manifesto. Não anexe o arquivo de um país à tarefa de outro país simplesmente porque os nomes dos arquivos parecem semelhantes. A referência da API do CarrierLookup documenta os endpoints de envio em lote e status da tarefa; as regras atuais da API devem reger os detalhes de upload e a verificação. O processamento em lote é assíncrono, portanto, um upload aceito não é um resultado de operadora concluído.

Acompanhe cada tarefa independentemente como processando, sucesso ou falha. Uma tarefa que falha durante a preparação pode ter excluído linhas inválidas, duplicadas, sem país ou fora do país e ainda pode falhar em outra condição de aceitação. Preserve seu manifesto e erro para reparo. Não infira valores de operadora a partir de uma tarefa com falha ou do prefixo do número de origem. Uma tarefa bem-sucedida fornece um CSV para seus números preparados, que deve ser armazenado junto com o manifesto e o arquivo auxiliar correspondentes.

Após o download, verifique se o arquivo pertence à tarefa pretendida e ao país selecionado. Identificadores em lote são dígitos simples com seu código de país, sem sinal de mais ou espaços. Normalize a chave de comparação de propriedade do cliente em ambos os lados, mantendo os arquivos brutos. O resultado descreve a operadora originalmente alocada, a operadora subjacente, o tipo de linha e a geografia da faixa numérica onde disponível; não se trata de uma operadora atual após a portabilidade ou da localização ao vivo de uma pessoa.

Concilie resultados sem perder contatos de origem

Junte os identificadores retornados ao arquivo auxiliar, não às posições originais das linhas do CSV. O pré-processamento em lote pode remover entradas duplicadas e inválidas, portanto, a ordem das linhas não é uma chave de junção confiável. Produza contagens para identificadores retornados, identificadores preparados não correspondentes e identificadores retornados que não correspondem ao manifesto. Interrompa qualquer atualização automática de CRM para chaves inesperadas até que um operador investigue.

Para um número compartilhado por várias linhas de origem, mapeie uma consulta concluída para essas linhas deliberadamente e retenha o mesmo tempo de observação e referência da tarefa. Se o número de um contato mudou após a exportação, marque um conflito em vez de sobrescrever seus dados atuais. Verificações de versão opcionais são uma escolha de integração do cliente, não um recurso do produto. Mantenha campos de operadora vazios como informações de alocação indisponíveis em vez de recodificá-los como um número inválido ou inalcançável.

A ação final é enviar um arquivo revisado específico por país através da Consulta da operadora original global e salvar seu manifesto com o resultado. Isso dá aos operadores de CRM um caminho rastreável da exportação de origem mista para tarefas separadas e de volta, sem alegar que os dados de alocação provam a rede presente, a capacidade de contato, a identidade ou o consentimento.

FAQ

O CarrierLookup em lote pode dividir automaticamente um CSV de vários países?

Nenhuma divisão desse tipo está documentada. Prepare arquivos específicos por país e selecione o país correspondente para cada tarefa.

O que deve acontecer com números com códigos de país ausentes?

Retenha-os para revisão de dados de origem. Não invente um código de país para fazer o upload passar.

Os resultados devem ser unidos à exportação original pelo número da linha?

Não. Use o identificador retornado e um arquivo auxiliar de propriedade do cliente que mapeia cada número preparado para suas linhas de origem.

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 →