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](https://aws.amazon.com/end-user-messaging/pricing/#Phone_number_validate).
## 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 [CarrierLookup](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_CarrierLookup.html)a referência da API AWS End User Messaging SMS ou [carrier-lookup](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/carrier-lookup.html) 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`