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á.
# Escolha de um número de telefone 10DLC por código de área
Ao solicitar um número de telefone com código longo de 10 dígitos (10DLC), você pode pesquisar e escolher um número específico em vez de receber uma tarefa aleatória. Você pode pesquisar por código de área ou por um padrão dentro do número de telefone. Você também pode solicitar um número de telefone exato. Esse recurso está disponível somente para números de telefone 10DLC dos Estados Unidos.
A seleção do número de telefone funciona em duas etapas:
1. **Pesquisa ** — Use a `ListAvailablePhoneNumbers` API ou o console para procurar os números 10DLC disponíveis filtrados por código de área ou padrão.
1. **Solicitação ** — Use a `RequestPhoneNumber` API com o `NumberPreference` parâmetro opcional ou selecione um número no console para solicitar um número de telefone específico.
## Pré-requisitos
Antes de pesquisar e escolher um número de telefone 10DLC, você deve ter o seguinte:
+ Uma marca registrada 10DLC aprovada. Para obter mais informações, consulte [Formulário de registro de marca 10DLC](registrations-10dlc-company.md).
+ Uma campanha aprovada de 10DLC registrada associada à marca. Para obter mais informações, consulte [Formulário de inscrição na campanha 10DLC](registrations-10dlc-register-campaign.md).
A busca por números de telefone retorna números que estão disponíveis por meio do agregador associado ao registro da sua campanha 10DLC. Você não precisa especificar um agregador.
## Tipos de padrões de pesquisa
Você pode pesquisar os números de telefone disponíveis usando os seguintes tipos de padrão:
| Tipo de padrão | Description | Exemplo |
| --- | --- | --- |
| StartsWith | Retorna números que começam com os dígitos especificados. Use isso para pesquisar por código de área. | O filtro \+1510 retorna números no código de área 510, como\+15103921111. |
| EndsWith | Retorna números que terminam com os dígitos especificados. | O filtro 1234 retorna números que terminam em 1234, como\+12025551234. |
| Contains | Retorna números que contêm os dígitos especificados em qualquer lugar do número. | O filtro 555 retorna números contendo 555, como\+15105559876. |
| ExactMatch | Solicita um número de telefone específico. Esse tipo só é válido com a RequestPhoneNumber API, não comListAvailablePhoneNumbers. | O filtro \+15103921234 solicita esse número exato. |
## Considerações importantes
+ A disponibilidade do número de telefone não é garantida. Um número exibido nos resultados da pesquisa pode ser comprado por outro cliente antes de você solicitá-lo. Se isso acontecer, solicite um número diferente ou pesquise novamente.
+ Os resultados da pesquisa não são uma reserva. Os números não são retidos para você entre a etapa de pesquisa e a etapa de solicitação.
+ Os resultados da pesquisa retornam no máximo 10 números por página. Para recuperar páginas adicionais de resultados, use o `NextToken` parâmetro.
+ Se você não especificar a `NumberPreference` ao ligar`RequestPhoneNumber`, o comportamento existente permanecerá inalterado e o SMS de mensagens do usuário AWS final atribuirá um número de telefone automaticamente.
+ Esse recurso está disponível somente para números de telefone 10DLC (`TEN_DLC`) dos Estados Unidos.
## Pesquise e solicite um número de telefone 10DLC
Você pode pesquisar e solicitar um número de telefone 10DLC específico usando o console SMS de mensagens do usuário AWS final ou o. AWS CLI
------
#### [ Console ]
Você pode pesquisar e escolher um número de telefone 10DLC específico durante o processo de solicitação de número de telefone no console SMS de mensagens do usuário AWS final.
**Escolha um número de telefone 10DLC por código de área (console)**
1. Abra o console SMS de mensagens do usuário AWS final em [ https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações**, selecione **Números de telefone** e, depois, **Solicitar originador**.
1. Na ** página ** Selecionar país, escolha ** Estados Unidos (EUA) no ** menu ** suspenso País de destino da ** mensagem. Escolha **Próximo**.
1. Preencha a ** seção Caso de uso de ** mensagens e escolha ** Avançar**.
1. Em Tipo de ** originador**, escolha o tipo de número 10DLC e associe sua marca e campanha registradas.
1. (Opcional) Na ** etapa Preferência de ** número, pesquise um número de telefone específico:
1. Selecione um tipo de padrão de pesquisa: ** Começa com**, ** Termina com ** ou ** Contém**.
1. Insira um padrão. Por exemplo, insira **510** para pesquisar números no código de área 510. O console formata automaticamente sua entrada com o prefixo do código do país.
1. Selecione a opção **Pesquisar**. Uma tabela exibe até 10 números de telefone disponíveis.
1. Selecione o número de telefone desejado e escolha ** Avançar**.
Se você pular essa etapa, o SMS de mensagens do usuário AWS final atribuirá um número de telefone automaticamente.
1. Configure o ** compartilhamento da política de ** recursos, se necessário, e escolha ** Avançar**.
1. Em ** Revisar e solicitar**, verifique suas configurações e escolha ** Solicitar**.
------
#### [ AWS CLI ]
Use o AWS CLI para pesquisar os números de telefone 10DLC disponíveis e, em seguida, solicitar um número específico.
**Etapa 1: Pesquise os números disponíveis **
Use o [ comando ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-available-phone-numbers.html) list-available-phone-numbers para pesquisar os números de telefone 10DLC disponíveis. O exemplo a seguir pesquisa números no código de área 510:
```
$ aws pinpoint-sms-voice-v2 list-available-phone-numbers \
--iso-country-code US \
--number-type TEN_DLC \
--registration-id registration-1234567890 \
--number-preference '[{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}]'
```
Se números que correspondam aos seus critérios de pesquisa estiverem disponíveis, a resposta incluirá uma lista de números de telefone em E.164 formato:
```
{
"AvailablePhoneNumbers": [
"+15103921111",
"+15103922222",
"+15103923333",
"+15103924444",
"+15103925555"
],
"NextToken": "AAMAJDUwNzE4ZTQwLWJkOTUtNDk4Ny..."
}
```
No comando anterior, faça as seguintes alterações:
+ `registration-1234567890`Substitua pelo ID do seu registro de campanha 10DLC aprovado.
+ `+1510`Substitua pelo código de área ou padrão que você deseja pesquisar.
+ `StartsWith`Substitua por `EndsWith` ou `Contains` para alterar o tipo de padrão de pesquisa.
Se a resposta incluir um `NextToken` valor, passe-o em uma solicitação subsequente para recuperar a próxima página de resultados. Quando `NextToken` é nulo, não há mais resultados.
**Etapa 2: solicitar um número específico **
Depois de encontrar um número de telefone nos resultados da pesquisa, use o [ comando ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-phone-number.html) request-phone-number com o `--number-preference` parâmetro para solicitar esse número.
O exemplo a seguir solicita um número de telefone exato:
```
$ aws pinpoint-sms-voice-v2 request-phone-number \
--iso-country-code US \
--message-type TRANSACTIONAL \
--number-type TEN_DLC \
--number-capabilities SMS \
--registration-id registration-1234567890 \
--number-preference '{"PreferenceType": ["ExactMatch"], "Filter": ["+15103921111"]}'
```
Você também pode solicitar um número de telefone usando um padrão. O exemplo a seguir solicita qualquer número disponível no código de área 510:
```
$ aws pinpoint-sms-voice-v2 request-phone-number \
--iso-country-code US \
--message-type TRANSACTIONAL \
--number-type TEN_DLC \
--number-capabilities SMS \
--registration-id registration-1234567890 \
--number-preference '{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}'
```
Nos comandos anteriores, faça as seguintes alterações:
+ `registration-1234567890`Substitua pelo ID do seu registro de campanha 10DLC aprovado.
+ `TRANSACTIONAL`Substitua por `PROMOTIONAL` se você estiver enviando mensagens promocionais.
+ `SMS`Substitua pelos recursos de que você precisa. Você pode especificar `SMS``MMS`, `VOICE` e.
+ Substitua o número de telefone ou o padrão pelo seu valor preferido. `Filter`
Se o número solicitado estiver disponível, a resposta será a mesma de uma `RequestPhoneNumber` resposta padrão`PhoneNumberId`, incluindo os `Status` campos`PhoneNumber`, e. Se o número exato não estiver mais disponível, a solicitação retornará um erro. Pesquise novamente para encontrar um número diferente disponível.
------