View a markdown version of this page

Escolha de um número de telefone 10DLC por código de área - AWS Mensagens SMS para o usuário final
Pré-requisitosTipos de padrões de pesquisaConsiderações importantesPesquise e solicite um número de telefone 10DLC

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.

  2. 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:

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 ligarRequestPhoneNumber, 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/.

  2. No painel de navegação, em Configurações, selecione Números de telefone e, depois, Solicitar originador.

  3. Na página Selecionar país, escolha Estados Unidos (EUA) no menu suspenso País de destino da mensagem. Escolha Próximo.

  4. Preencha a seção Caso de uso de mensagens e escolha Avançar.

  5. Em Tipo de originador, escolha o tipo de número 10DLC e associe sua marca e campanha registradas.

  6. (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.

    2. 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.

    3. Selecione a opção Pesquisar. Uma tabela exibe até 10 números de telefone disponíveis.

    4. 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.

  7. Configure o compartilhamento da política de recursos, se necessário, e escolha Avançar.

  8. 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 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-1234567890Substitua pelo ID do seu registro de campanha 10DLC aprovado.

  • +1510Substitua pelo código de área ou padrão que você deseja pesquisar.

  • StartsWithSubstitua 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 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-1234567890Substitua pelo ID do seu registro de campanha 10DLC aprovado.

  • TRANSACTIONALSubstitua por PROMOTIONAL se você estiver enviando mensagens promocionais.

  • SMSSubstitua pelos recursos de que você precisa. Você pode especificar SMSMMS, 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ãoPhoneNumberId, incluindo os Status camposPhoneNumber, 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.