Gerenciando pools telefônicos

Quando você cria um novo pool telefônico, ele herda todas as configurações do primeiro número de telefone ou ID do remetente adicionado. Por exemplo, se você criar um grupo que contenha um número de telefone com mensagens bidirecionais habilitadas, os outros números que você adicionar ao grupo também deverão ter mensagens bidirecionais habilitadas.

Antes de excluir um pool, você precisa desativar a proteção contra exclusão e remover todos os originadores, exceto um, do pool telefônico. Para obter mais informações sobre como desativar a proteção contra exclusão, consulteProteção contra exclusão. Os números de telefone e o remetente IDs associados ao pool permanecem na sua SMS conta de mensagens do usuário AWS final.

nota

Quando você adiciona um número de telefone ou ID de remetente a um pool telefônico e precisa fazer uma atualização, você faz a alteração no pool telefônico. Por exemplo, se você quiser adicionar uma nova palavra-chave a um número de telefone, adicionaria a palavra-chave ao pool telefônico e não ao número de telefone.

Create a phone pool (Console)

Para criar um pool usando o SMS console AWS End User Messaging, siga estas etapas:

Para criar um pool (Console)

1. Abra o SMS console de mensagens do usuário AWS final em https://console.aws.amazon.com/sms-voice/.

2. No painel de navegação, em Configurações, escolha Pools de telefones.

3. Na página Conjuntos telefônicos, escolha Criar pool telefônico.

4. Na seção Configuração do pool, em Nome do pool, insira um nome para o seu pool.

5. Escolha uma das seguintes opções:

   • Número de telefone — Na seção Números de telefone disponíveis para associação, escolha um número de telefone para associar ao pool.

     • Número do simulador (opcional) — Se você não tiver nenhum número de telefone e quiser solicitar um número de telefone do simulador, escolha Número de telefone e, na seção Números de telefone disponíveis para associação, faça o seguinte:

       • Escolha o número do simulador de solicitação.

       • Em Solicitar número do simulador, escolha seu país na lista suspensa.

       • Escolha o número da solicitação.

       • Em Números de telefone disponíveis para associação, escolha o novo número de telefone do simulador.

   • ID do remetente — Na seção Remetente IDs disponível para associação, escolha um ID de remetente para associar ao pool.

6. (Opcional) Expanda as tags e escolha Adicionar nova tag.

   1. Insira um novo par chave/valor em branco.

   2. (Opcional) Escolha Adicionar nova tag para adicionar outra tag.

7. Escolha Criar pool telefônico.

Create a phone pool (AWS CLI)

Você pode usar o comando create-pool para criar novos pools.

Você também pode adicionar um número de telefone a um pool ao usar o RequestPhoneNumber API para comprar um número de telefone. Para ter mais informações, consulte Solicite um número de telefone.

Para criar um pool usando o AWS CLI

• Na linha de comando, insira o seguinte comando:

  $ aws pinpoint-sms-voice-v2 create-pool \
  > --origination-identity originationIdentity \
  > --iso-country-code XX \
  > --message-type TRANSACTIONAL

  No comando anterior, faça as seguintes alterações:

  • Substituir originationIdentity com o ID exclusivo ou o nome de recurso da Amazon (ARN) do número de telefone ou ID do remetente que você deseja adicionar ao pool.

    dica

    Você pode encontrar o ID e o número ARN de telefone usando a describe-phone-numbersoperação. Você pode encontrar o ID e o ID ARN do remetente usando a describe-sender-idsoperação.

  • Substituir XX com o identificador ISO -3166 alfa-2 do país para o originationIdentity.

  • Se você planeja usar o pool para enviar mensagens promocionais ou de marketing, substitua TRANSACTIONAL comPROMOTIONAL. Caso contrário, use TRANSACTIONAL.

List phone pools (AWS CLI)

Você pode usar o describe-pools CLI para visualizar informações sobre os pools existentes.

Essa operação pode fornecer uma lista completa de todos os pools em sua SMS conta de mensagens de usuário AWS final, informações sobre um pool específico ou uma lista de pools que é filtrada com base nos critérios definidos por você.

Para recuperar uma lista de todos os seus pools usando o AWS CLI

• Na linha de comando, insira o seguinte comando:

  $ aws pinpoint-sms-voice-v2 describe-pools

Para encontrar informações sobre grupos específicos, use o parâmetro PoolId.

Para obter informações sobre pools específicos usando o AWS CLI

• Na linha de comando, insira o seguinte comando:

  $ aws pinpoint-sms-voice-v2 describe-pools \ 
  > --pool-id poolId

No comando anterior, substitua poolId com o ID ou o nome de recurso da Amazon (ARN) do pool.

Para ver uma lista filtrada de grupos, use o parâmetro Filters. Você pode usar os seguintes valores de filtro:

• status: o status atual do grupo, como ACTIVE.

• message-type: o tipo de mensagem que o grupo é usado para enviar. Os valores possíveis são TRANSACTIONAL ou PROMOTIONAL.

• two-way-enabled— Um booleano que indica se as SMS mensagens bidirecionais estão habilitadas para números no pool.

• self-managed-opt-outs-enabled— Um booleano que indica se as SMS opções de exclusão autogerenciadas estão habilitadas para números no pool.

• opt-out-list-name: o nome da lista de cancelamento associada ao grupo.

• shared-routes-enabled: um booleano que indica se as rotas compartilhadas estão habilitadas para o grupo.

• deletion-protection-enabled: um booleano que indica se o número de telefone pode ou não ser excluído usando a operação DeletePhoneNumber.

Por exemplo, se você quiser ver uma lista de grupos de mensagens transacionais que oferecem suporte a mensagens bidirecionais, digite o seguinte comando na linha de comando:

$ aws pinpoint-sms-voice-v2 describe-pools \
> --filters Name=message-type,Values=TRANSACTIONAL \
> --filters Name=two-way-enabled,Values=true

Delete a phone pool (Console)

Antes de excluir um pool, você precisa desativar a proteção contra exclusão e remover todos os originadores do pool telefônico. Para excluir um pool usando o SMS console AWS End User Messaging, siga estas etapas:

Para excluir um pool (Console)

1. Abra o SMS console de mensagens do usuário AWS final em https://console.aws.amazon.com/sms-voice/.

2. No painel de navegação, em Configurações, escolha Pool de telefones.

3. Na página Phone Pools, escolha o pool a ser excluído.

4. Escolha Excluir.

5. Digite release e, em seguida, confirme para excluir o pool.

Delete a phone pool (AWS CLI)

Antes de excluir um pool, você precisa desativar a proteção contra exclusão e remover todos os originadores do pool telefônico. Você pode usar o delete-pool API para excluir pools.

Para excluir um pool usando o AWS CLI

• Para excluir um grupo, digite o seguinte comando na linha de comando:

  $ aws pinpoint-sms-voice-v2 delete-pool \
  > --pool-id pool-78ec067f62f94d57bd3bab991example

  No comando anterior, substitua pool-78ec067f62f94d57bd3bab991example com o ID exclusivo ou o Amazon Resource Name (ARN) do pool. Você pode encontrar esses dois valores usando a operação describe-pools.