**Aviso de fim do suporte:** em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte [Fim do suporte do Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Observação:** APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.
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á.
# Usar o serviço de validação de número de telefone do Amazon Pinpoint
O Amazon Pinpoint inclui um serviço de validação de números de telefone que você pode usar para determinar se um número de telefone é válido, além de obter informações adicionais sobre o próprio número de telefone. Por exemplo, quando você usa o serviço de validação de números de telefone, ele retorna as seguintes informações:
+ O número de telefone em formato E.164.
+ O tipo de número de telefone (como celular, fixo ou VoIP).
+ A cidade e o país onde o número telefone está localizado.
+ A operadora associada ao número de telefone.
Há um custo adicional pelo uso do serviço de validação de números de telefone. Para mais informações, consulte [Definição de preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/#Phone_Number_Validate).
**Importante**
Para números de telefone originados nos Estados Unidos e Canadá, a API de validação de número de telefone não retornará mais dados de `City`, `County`, `Timezone` e `ZipCode`.
## Casos de uso da validação de número de telefone do Amazon Pinpoint
Você pode aplicar o serviço de validação de números de telefone a vários casos de uso, incluindo os seguintes:
+ **Verificação de números de telefone fornecidos em um formulário da Web**: se você usa formulários na web para coletar informações de contato de seus clientes, é possível validar os números de telefone fornecidos pelos clientes antes do formulário ser enviado. Use o back-end do site para validar o número usando a API do Amazon Pinpoint. A resposta da API indica se o número é inválido, por exemplo, se o número de telefone estiver formatado incorretamente. Se você determinar que o número de telefone fornecido pelo cliente é inválido, seu formulário da Web poderá notificar o cliente para que ele forneça outro número.
+ **Limpeza de seu banco de dados de contatos**: se você tem um banco de dados de números de telefone de clientes, é possível validar cada número de telefone e atualizar o banco de dados de acordo com as descobertas. 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`. É possível validar o número de telefone primeiro e depois a propriedade `ChannelType` para endpoints novos ou existentes seguindo as instruções em [Adicionar endpoints ao Amazon Pinpoint](audience-define-endpoints.md) para um único endpoint ou [Adicionar um lote de endpoints ao Amazon Pinpoint](audience-define-endpoints-batch.md) para vários endpoints.
+ **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.
## Valide um número de telefone usando o AWS CLI
O exemplo a seguir mostra como validar um número de telefone usando a AWS CLI. Para obter mais informações, consulte [phone-number-validate](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/phone-number-validate.html) na *Referência de comandos da AWS CLI *. Por ver exemplos de respostas de validação, consulte [Resposta da validação do número de telefone](#validate-phone-numbers-example-responses). Para obter mais informações sobre como configurar o AWS CLI, consulte [Configurar o AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) no [Guia do AWS Command Line Interface Usuário](https://docs.aws.amazon.com/cli/latest/userguide/).
**Para usar o serviço de validação de número de telefone usando o AWS CLI**
+ Na linha de comando, insira o seguinte comando:
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GB
```
No comando anterior, *\$1442079460881* substitua pelo número de telefone que você deseja validar e *GB* pelo código ISO de dois dígitos do país ou região.
**nota**
Você sempre deve incluir o código do país ao fornecer o número de telefone para o serviço de validação de números de telefone. Se você não incluir o código do país, o serviço poderá retornar informações de um número de telefone em outro país. Você pode ter traços no número de telefone, por exemplo*\$144-207-946-0881*.
## Resposta da validação do número de telefone
As informações fornecidas pelo serviço de validação de números de telefone podem variar um pouco de acordo com os dados disponíveis para o número de telefone. Esta seção contém exemplos de respostas do serviço de validação de números de telefone.
**nota**
Os dados fornecidos pelo serviço de validação de números de telefone são baseados nas informações fornecidas por operadoras de telefonia 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 que você forneceu migrou de uma operadora para outra, a resposta do serviço de validação de números de telefone pode incluir o nome da operadora original, em vez de o atual.
**Números de telefone celular válidos**
Quando você envia uma solicitação para o serviço de validação de números de telefone, e o número de telefone é um celular válido, ele retorna informações semelhantes às do seguinte exemplo:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp Mobile",
"City": "Seattle",
"CleansedPhoneNumberE164": "+12065550142",
"CleansedPhoneNumberNational": "2065550142",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+12065550142",
"PhoneType": "MOBILE",
"PhoneTypeCode": 0,
"Timezone": "America/Los_Angeles",
"ZipCode": "98101"
}
}
```
**Números de telefone fixo válidos**
Se a solicitação contiver um número de telefone fixo válido, o serviço de validação de números de telefone retornará informações semelhantes às do seguinte exemplo:
```
{
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"Country": "United States",
"City": "Santa Clara",
"ZipCode": "95037",
"Timezone": "America/Los_Angeles",
"CleansedPhoneNumberNational": "4085550101",
"CleansedPhoneNumberE164": "14085550101",
"Carrier": "AnyCompany",
"PhoneTypeCode": 1,
"PhoneType": "LANDLINE",
"OriginalPhoneNumber": "+14085550101"
}
```
**Números de telefone VoIP válidos**
Se a solicitação contiver um número de telefone VoIP (Voz sobre IP) válido, o serviço de validação de números de telefone retornará informações semelhantes às do seguinte exemplo:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}
```
**Números de telefone inválidos**
Se a solicitação contiver um número de telefone inválido, o serviço de validação de números de telefone retornará informações semelhantes às do seguinte exemplo:
```
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}
```
Observe que a propriedade `PhoneType` 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 `PhoneType` é `INVALID`, pois é improvável que esses números pertençam a destinatários reais.
**Outros números de telefone**
Ocasionalmente, a resposta do serviço de validação de números de telefone inclui um valor `PhoneType` de `OTHER`. O serviço pode retornar esse tipo de resposta nas seguintes situações:
+ O número de telefone é gratuito (público).
+ O número de telefone está reservado para uso em programas de TV e filmes, como os números de telefone da América do Norte que começam com *555*.
+ O número de telefone inclui um código de área que não está em uso no momento, como o código de área *999* na América do Norte.
+ O número de telefone está reservado para qualquer outra finalidade.
O exemplo a seguir mostra a resposta que o serviço de validação de números de telefone fornece quando a solicitação inclui um número de telefone norte-americano fictício:
```
{
"NumberValidateResponse": {
"Carrier": "Multiple OCN Listing",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "OTHER",
"PhoneTypeCode": 4,
"Timezone": "America/Los_Angeles"
}
}
```
**Números de telefone pré-pagos**
Se a solicitação contiver um número de telefone pré-pago válido, o serviço de validação de números de telefone retornará informações semelhantes às do seguinte exemplo:
```
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}
```
Para obter mais informações sobre as informações contidas nessas respostas, consulte [Validação de número de telefone](https://docs.aws.amazon.com/pinpoint/latest/apireference/phone-number-validate.html) na *Referência de API do Amazon Pinpoint*.