View a markdown version of this page

Use o serviço de busca de operadoras - AWS SMS de mensagens para o usuário final
Casos de uso de pesquisa de operadorasFormatos de número de telefone compatíveisUsando o serviço de busca de operadoras no AWS CLI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use o serviço de busca de operadoras

AWS O End User Messaging SMS inclui um serviço de busca de operadora que você pode usar para obter informações sobre um número de telefone, inclusive se o número de telefone é válido. O serviço de busca da operadora retorna as seguintes informações para um número de telefone:

  • O número de telefone no formato E164 (limpo da entrada original).

  • O tipo de número de telefone (como inválido, telefone fixo, celular, outro).

  • O nome do país ou região do número de telefone.

  • O código de discagem numérica do país ou região para o número de telefone.

  • O código de país ou região de dois caracteres, no formato ISO 3166-1 alfa-2, para o número de telefone.

  • Para números de celular, o código do país do celular (MCC).

  • Para números de celular, o código de rede móvel (MNC).

  • A operadora ou o provedor de serviços no qual o número de telefone está registrado no momento. Em alguns países e regiões, esse valor pode ser a operadora ou o provedor de serviços com o qual o número de telefone foi originalmente registrado.

Há uma taxa adicional pelo uso do serviço de busca de operadoras. Para obter mais informações, consulte Preços de SMS para usuários AWS finais.

Casos de uso de pesquisa de operadoras

Você pode usar o serviço de consulta de operadora para habilitar vários casos de uso, incluindo os seguintes:

  • Pesquisar números de telefone fornecidos em um formulário da web — Se você usa formulários baseados na web para coletar informações de contato de seus clientes, poderá pesquisar os números de telefone fornecidos pelos clientes antes de enviar o formulário. Use o back-end do seu site para pesquisar e validar o número usando a API AWS End User Messaging SMS. A resposta da API indica se o número é válido, por exemplo, se o número de telefone está formatado corretamente. Se você determinar que o número de telefone fornecido pelo cliente é inválido, seu formulário da web poderá solicitar que o cliente forneça um número válido.

  • Limpando seu banco de dados de contatos existente — Se você tiver um banco de dados de números de telefone de clientes, poderá pesquisar cada número de telefone e atualizar seu banco de dados usando os resultados da pesquisa da operadora. Por exemplo, caso encontre endpoints com números de telefone que não podem receber mensagens SMS, você poderá alterar a propriedade ChannelType do endpoint de SMS para VOICE.

  • Escolha do canal adequado antes de enviar a mensagem: se você pretende enviar uma mensagem SMS, mas constata que o número de destino é inválido, você pode enviar a mensagem ao destinatário por um canal diferente. Por exemplo, se o endpoint não puder receber mensagens SMS, você pode enviar uma mensagem de voz em vez disso.

Formatos de número de telefone compatíveis

Os números de telefone devem estar no formato E164, começando com um sinal de adição (+) seguido pelo código de discagem do país e pelo número de telefone (por exemplo, +12065551234). O serviço de busca de operadoras aceita vários caracteres de formatação e os remove automaticamente durante o processamento. Você pode incluir os seguintes caracteres de formatação na entrada do número de telefone:

  • Parênteses: +1 (555) 123-4567

  • Suportes: +1 [555] 123-4567

  • Espaços: +1 555 123 4567

  • Hífens: +1-555-123-4567

  • Períodos: +1.555.123.4567

  • Vírgulas: +1,555,123,4567

  • Formatação mista: +1 (555)-123.4567

Todos os caracteres de formatação são removidos automaticamente durante o processamento e o serviço retorna o número de telefone no formato E164 padrão (por exemplo,+15551234567) no E164PhoneNumber campo da resposta.

Usando o serviço de busca de operadoras no AWS CLI

O exemplo a seguir mostra como usar o serviço de busca de operadora no AWS CLI. O serviço aceita números de telefone com vários caracteres de formatação (parênteses, colchetes, espaços, hífens, pontos, vírgulas) e os converte automaticamente no formato E164 para processamento. Para obter mais informações, consulte CarrierLookupa referência da API AWS End User Messaging SMS ou carrier-lookup na Referência de AWS CLI comandos.

Para usar o serviço de consulta de operadora (CLI)

  • Na linha de comando, insira o seguinte comando: Você pode usar vários formatos de número de telefone - o serviço aceita caracteres especiais como parênteses, colchetes, espaços, hífens, pontos e vírgulas:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    Ou com formato E164:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Respostas de pesquisa da operadora

As informações fornecidas pelo serviço de busca de operadoras variam um pouco com base nos dados disponíveis para o número de telefone que você fornece. Esta seção contém exemplos das respostas que o serviço de consulta de operadoras retorna.

nota

Os dados fornecidos pelo serviço de busca de operadoras são baseados em informações fornecidas por provedores de telecomunicações e outras entidades em todo o mundo. As operadoras em alguns países podem atualizar essas informações com menos frequência do que em outros países. Por exemplo, se você emitir uma solicitação para validar um número de celular e o número fornecido for transferido de uma operadora móvel para outra, a resposta do serviço de busca de operadora poderá incluir o nome da operadora original, em vez da atual.

Números de telefone celular válidos

A resposta a seguir é um exemplo das informações CarrierLookup retornadas para um número de celular válido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Números de telefone fixo válidos

A resposta a seguir é um exemplo das informações CarrierLookup retornadas para um número de telefone fixo válido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Números de telefone inválidos

Se sua solicitação contiver um número de telefone inválido, o serviço de busca da operadora retornará informações semelhantes ao exemplo a seguir:

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Observe que a propriedade PhoneNumberType nessa resposta indica que esse número de telefone é INVALID e não inclui informações sobre a operadora ou a localização associadas ao número de telefone. Evite enviar mensagens SMS ou por voz para números de telefone cuja propriedade PhoneNumberType é INVALID, pois é improvável que esses números pertençam a destinatários reais.

Outros números de telefone

Números de telefone que não são classificados como móveis, fixos ou inválidos são retornados com um PhoneNumberType valor de. OTHER