Consulta internacional de operadora: verificando números em vários países
Como realizar uma consulta internacional de operadora em números de vários países: formatação, verificações síncronas múltiplas, arquivos em lote e notas regionais.
Um guia prático para realizar uma consulta internacional de operadora em listas de telefones de diversos países, desde a formatação E.164 até a escolha entre verificações em tempo real e arquivos em lote.
Uma consulta internacional de operadora funciona melhor quando cada número está escrito no formato E.164, com um sinal de mais, o código do país e o número do assinante. O CarrierLookup retorna a operadora à qual cada número foi originalmente alocado, além do tipo de linha e a geografia da alocação. As verificações em tempo real aceitam números de diferentes países em uma única solicitação, enquanto as tarefas de arquivos em lote são estruturadas em torno de um país selecionado por arquivo. O resultado é o contexto da alocação original, não a rede que atende ao número hoje.
Comece com uma entrada E.164 limpa
Toda consulta internacional de operadora depende da presença do código do país. O formato E.164 começa com um sinal de mais, seguido pelo código do país e o número do assinante, sem espaços, traços ou colchetes. Uma string em formato nacional, como um número começando com um zero de tronco, não pode ser alocada a um país sem suposições, portanto, deve ser convertida antes da consulta.
Um breve checklist de preparação para uma lista mista:
- Adicione o sinal de mais e o código do país a cada linha.
- Remova espaços, pontuação e textos de ramais.
- Descarte espaços reservados óbvios e linhas em branco.
- Mantenha a coluna da fonte original para que as linhas rejeitadas possam ser rastreadas.
Um formato rejeitado não é um resultado de "sem operadora". Isso significa apenas que a entrada não pôde ser lida como um número, portanto, corrija a formatação e execute novamente.
Verificando listas de vários países em tempo real
A Consulta da operadora original em tempo real não solicita uma seleção de país separada, pois o código do país dentro de cada número já o contém. Um único número passa pelo POST /api/v1/check, e uma solicitação síncrona múltipla passa pelo POST /api/v1/batch-check com 1 a 100 números, mesmo quando vêm de países diferentes. Os resultados retornam na ordem da entrada, para que possam ser correspondidos às linhas de origem pela posição.
O painel oferece a mesma consulta múltipla em tempo real para até 500 números de cada vez, o que atende a um analista que possui uma lista colada e deseja respostas na tela.
Em uma resposta múltipla, cada item informa se um resultado normal existe. A ausência de um resultado normal não é uma declaração de que o número é inválido ou desconectado. Se uma solicitação múltipla exceder o tempo limite, toda a solicitação falhará sem resultados parciais e o valor total será retornado.
Quando mudar para uma tarefa de arquivo em lote
As tarefas de arquivo em lote são assíncronas e adequadas para listas grandes. Uma tarefa utiliza um arquivo TXT ou CSV com um número codificado por país por linha e um país ISO selecionado. Como a tarefa é limitada a um país, uma lista global deve ser dividida por país primeiro e, em seguida, enviada como tarefas separadas.
O pré-processamento exclui linhas inválidas, duplicatas, números sem código de país e números fora do país selecionado. As linhas excluídas não são cobradas. Uma tarefa passa pelo processamento, sucesso ou falha, e uma tarefa bem-sucedida retorna um CSV para download. Verifique o status da tarefa com uma frequência não superior a 30 segundos.
Limites por produto se aplicam ao tamanho do arquivo e à contagem de números, portanto, verifique a documentação da API atual antes de planejar um upload muito grande.
Notas regionais e o significado da saída
A cobertura não é idêntica em todos os lugares. As verificações de número único em tempo real suportam a China continental (+86), Hong Kong (+852) e Macau (+853) para volumes pequenos, enquanto as tarefas de arquivo em lote não suportam essas regiões. O suporte para Taiwan (+886) não está confirmado, portanto, teste uma pequena amostra antes de incluí-lo em um plano.
Uma maneira rápida de escolher um caminho:
| Situação | Caminho sugerido |
|---|---|
| Alguns números de muitos países | Verificação única ou múltipla em tempo real |
| Uma lista colada da equipe | Consulta múltipla no painel |
| Uma lista grande de um país | Tarefa de arquivo em lote |
| China continental, Hong Kong ou Macau | Apenas verificações únicas em tempo real |
Ao ler os resultados, trate a operadora como a alocação original, e a região e a cidade como a geografia da faixa numérica. Nenhum deles descreve onde uma pessoa está, e nenhum estabelece que um número pode receber chamadas ou mensagens.
FAQ
Uma solicitação pode conter números de vários países?
Sim, para solicitações síncronas múltiplas. Uma solicitação múltipla aceita de 1 a 100 números E.164, e eles podem vir de países diferentes. As tarefas de arquivo em lote diferem, pois cada tarefa é estruturada em torno de um país selecionado, portanto, uma lista global deve ser dividida antes do envio.
Como as equipes podem lidar com números que não retornam um resultado normal?
Mantenha-os em uma lista de revisão separada. As equipes podem verificar novamente a formatação, confirmar a origem do número e tratar a coluna da operadora como desconhecida em vez de negativa.
Uma consulta internacional de operadora mostra a rede atual?
Não. O CarrierLookup relata a operadora à qual uma faixa numérica foi originalmente alocada. Após a portabilidade de um número para outra rede, a operadora original permanece a mesma. O resultado é útil para segmentação e enriquecimento de dados, não para decidir qual rede atende a um número atualmente.
Saiba mais
Escolha as informações do produto que se encaixam na próxima etapa do seu fluxo de trabalho.