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á. # Pools telefônicos no AWS End User Messaging SMS Pools de telefones Um pool de números de telefone, também chamado simplesmente de pool, é um conjunto de números de telefone ou IDs de remetente que compartilham as mesmas configurações e que você pode usar para enviar mensagens. Quando você envia mensagens por meio de um pool telefônico, ele escolhe uma identidade de origem apropriada para enviar a mensagem. Se uma identidade de origem no pool telefônico falhar, o pool telefônico fará o failover para outra identidade de origem se estiver no mesmo pool telefônico. Ao criar um grupo, é possível configurar uma identidade de origem especificada. Essa identidade inclui palavras-chave, tipo de mensagem, lista de cancelamento, configuração bidirecional e configuração de cancelamento autogerenciada. Por exemplo, usando grupos, você pode associar uma lista de números de telefone que cancelaram a assinatura com seu número de telefone para um país específico. Ao fazer isso, você pode impedir que mensagens sejam enviadas para usuários que já optaram por não receber mensagens suas. A configuração de cada número de telefone que você adiciona a um grupo deve corresponder à configuração do primeiro número que você especificou ao criar o grupo. 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. **Topics** + [Crie grupo de telefones](phone-pool-create.md) + [Adicionar um número de telefone ou ID de remetente](phone-pool-add-number.md) + [Visualizar todos os pools telefônicos](phone-pool-list.md) + [Excluir um pool de telefones](phone-pool-delete.md) + [Alterar a lista de exclusão de um grupo](phone-pool-manage-opt-out-list.md) + [Atualizar rotas compartilhadas](phone-pool-shared-routes.md) + [Usando proteção contra exclusão do pool telefônico](phone-pool-deletion-protection.md) + [Gerenciar etiquetas para pools de telefones](phone-pool-tags.md) + [Lista de pools de telefones compartilhados](phone-pool-shared.md) # Crie um pool telefônico no AWS End User Messaging SMS Crie grupo de telefones 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 pool e o primeiro número de telefone adicionado tiver a troca de mensagens bidirecional ativada, os outros números de telefone que você adicionar ao pool também deverão ter a troca de mensagens bidirecional ativada. ------ #### [ Create a phone pool (Console) ] Para criar um pool usando o console do AWS End User Messaging SMS, siga estas etapas: **Para criar um pool (console)** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Pools telefônicos**, escolha **Criar pool telefônico**. 1. Na seção **Configuração do pool**, em **Nome do grupo**, insira um nome para o pool. 1. 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 **IDs de remetente disponíveis para associação**, escolha uma ID de remetente para associar ao pool. 1. (Opcional) Expanda as **Tags** e escolha **Adicionar nova tag**. 1. Insira um novo par de chave/valor em branco. 1. (Opcional) Para **Adicionar outra tag**, escolha adicionar tag. 1. Escolha **Criar pool telefônico**. ------ #### [ Create a phone pool (AWS CLI) ] Você pode usar o comando [create-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-pool.html) para criar novos pools. Você também pode adicionar um número de telefone a um pool ao usar a API `RequestPhoneNumber` para comprar um número de telefone. Para obter mais informações, consulte [Solicite um número de telefone no SMS de mensagens para o usuário AWS final](phone-numbers-request.md). **Como criar um grupo usando a 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: + Substitua *originationIdentity* pelo ID exclusivo ou pelo nome do recurso da Amazon (ARN) do número de telefone ou do ID de remetente que deseja adicionar ao grupo. **dica** Você pode encontrar o ID e o ARN de um número de telefone usando a operação [describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html). Você pode encontrar o ID e o ARN de um ID de remetente usando a operação [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html). + Substitua *XX* pelo identificador ISO-3166 alfa-2 do país para o *originationIdentity*. + Se você planeja usar o grupo para enviar mensagens promocionais ou de marketing, substitua *TRANSACTIONAL* por `PROMOTIONAL`. Caso contrário, use `TRANSACTIONAL`. ------ # Adicionar um número de telefone ou ID de remetente a um pool de telefones Adicionar um número de telefone ou ID de remetente Siga estas instruções para adicionar um número de telefone ou um ID de remetente a um pool de telefones. A configuração de cada número de telefone ou ID de remetente que você adicionar a um pool deve corresponder à configuração do pool de telefones. Por exemplo, se você criar um pool e o primeiro número de telefone adicionado tiver a troca de mensagens bidirecional ativada, os outros números de telefone que você adicionar ao pool também deverão ter a troca de mensagens bidirecional ativada. ------ #### [ Add a phone number or sender ID to a pool (Console) ] Para adicionar um número de telefone ou um ID de remetente a um pool usando o console AWS End User Messaging SMS, siga estas etapas: **Adicione um número de telefone ou um ID de remetente (Console).** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Pools de telefones**, escolha o pool telefônico ao qual adicionar a identidade de origem. 1. Na guia **Associated pool originators**, escolha **Adicionar originador**. 1. Escolha uma das seguintes opções: + **Número de telefone** – Se você escolher essa opção, na seção **Números de telefone disponíveis para associação**, faça o seguinte: + Escolha um número de telefone para adicionar ao pool de telefones. + **IDs de remetente** – Se você escolher essa opção, na seção **Sender IDs available for association**, faça o seguinte: + Escolha uma ID de remetente para adicionar o pool telefônico. 1. Escolha **Adicionar originador ao pool**. ------ #### [ Add a phone number or sender ID to a pool (AWS CLI) ] Você pode usar o CLI [associate-origination-identity](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/associate-origination-identity.html) para adicionar números de telefone ou IDs de remetente a um pool existente. A configuração de cada número de telefone ou ID de remetente que você adicionar a um pool deve corresponder à configuração do primeiro número de telefone ou ID de remetente que você especificou ao criar o pool. 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. **Para adicionar um número de telefone ou ID de remetente a um pool usando o AWS CLI** + Na linha de comando, insira o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 associate-origination-identity \ > --pool-id poolId \ > --origination-identity originationIdentity \ > --iso-country-code US ``` No comando anterior, faça as seguintes alterações: + Substitua *poolId* pelo ID ou nome do recurso da Amazon (ARN) do grupo ao qual deseja adicionar a identidades de origem. + Substitua *originationIdentity* pelo ID exclusivo ou pelo nome do recurso da Amazon (ARN) do número de telefone ou do ID de remetente que deseja adicionar ao grupo. + Substitua *\$112065550142* pela identidade de origem que você deseja adicionar ao grupo. Esse valor pode ser um código curto, um número de telefone ou um ID do remetente. + Substitua *US* pelo código ISO-3166 alfa-2 de duas letras para o país da identidade de origem. ------ #### [ List origination identities (AWS CLI) ] Você pode usar o comando [list-pool-origination-identities](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-pool-origination-identities.html) na CLI para ver informações sobre todas as identidades de origem que foram adicionadas a um pool específico. **Como visualizar uma lista de IDs de origem em um grupo usando a AWS CLI** + Na linha de comando, insira o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 list-pool-origination-identities \ > --pool-id pool-78ec067f62f94d57bd3bab991example ``` No comando anterior, substitua *poolId* pelo ID ou nome do recurso da Amazon (ARN) do pool. ------ # Visualizar todos os pools telefônicos no AWS End User Messaging SMS Visualizar todos os pools telefônicos Você pode usar a CLI [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) para exibir informações sobre grupos existentes. Essa operação pode fornecer uma lista completa de todos os grupos em sua conta do AWS End User Messaging SMS, informações sobre um grupo específico ou uma lista de grupos filtrada com base nos critérios que você define. **Como recuperar uma lista de todos os grupos usando a 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`. **Como receber informações sobre grupos específicos usando a 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* pelo ID ou nome do 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 mensagens SMS bidirecionais estão habilitadas para números no grupo. + `self-managed-opt-outs-enabled`: um booleano que indica se os cancelamentos de SMS autogerenciados estão habilitados para números no grupo. + `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 ``` # Excluir um pool telefônico no SMS de mensagens de usuário AWS final Excluir um pool de telefones 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, consulte [Usando a proteção contra exclusão de pools telefônicos no AWS End User Messaging SMS](phone-pool-deletion-protection.md). Os números de telefone e o remetente IDs associados ao pool permanecem na sua conta SMS do AWS End User Messaging. ------ #### [ 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 console AWS End User Messaging SMS, siga estas etapas: **Para excluir um pool (console)** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **pools de telefone**. 1. Na página **Pools telefônicos**, escolha o pool para excluir. 1. Escolha **Excluir**. 1. 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 a API [delete-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-pool.html) 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, *pool-78ec067f62f94d57bd3bab991example* substitua pelo ID exclusivo ou pelo nome de recurso da Amazon (ARN) do pool. Você pode encontrar esses dois valores usando a operação [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html). ------ # Alterar a lista de cancelamento de um pool no AWS End User Messaging SMS. Alterar a lista de exclusão de um grupo Uma *lista de cancelamento* é uma lista de números de telefone de destino para quem mensagens não devem ser enviadas. Quando você envia mensagens SMS, as identidades de destino são adicionadas automaticamente à lista de cancelamento se responderem ao número de origem com a palavra-chave PARAR (a menos que você ative a opção de cancelamento autogerenciada). Se você tentar enviar uma mensagem a um número de destino que está em uma lista de exclusão e essa lista estiver associada ao pool usado para enviar a mensagem, o AWS End User Messaging SMS não tentará enviá-la. Por padrão, quando um pool é criado, ele é atribuído à lista de cancelamento *padrão*. Os pools podem compartilhar a mesma lista de cancelamento. Quando você altera a lista de cancelamento de um pool, qualquer destinatário que tenha optado por não participar anteriormente pode não estar na nova lista e começar a receber mensagens. Para obter mais informações sobre a adição de números de telefone de destino de uma lista de cancelamento, consulte. [Adicione um número de telefone de destino a uma lista de exclusão no AWS End User Messaging SMS](opt-out-list-add-phone-number.md) ------ #### [ Change opt-out list (Console) ] Para alterar a lista de cancelamento usando o console do AWS End User Messaging SMS, siga estas etapas: **Alterar listas de cancelamento** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Phone Pools**, escolha o pool. 1. Na guia **Lista de cancelamento**, selecione **Editar configurações**. + **Criar uma nova lista de exclusão** – Crie uma nova lista de exclusão vazia e insira um nome amigável. + **Escolher uma lista de exclusão existente**: no menu suspenso, escolha uma lista de exclusão criada anteriormente. 1. (Opcional) Para ativar o cancelamento autogerenciado, escolha **Habilitar a exclusão autogerenciada**. 1. Escolha **Salvar alterações**. ------ #### [ Change opt-out list (AWS CLI) ] Você pode usar o comando [update-phone](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) para alterar a lista de cancelamento usada pelo pool. Na linha de comando, insira o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 update-pool --pool-id poolid --opt-out-list-name OptOutListName ``` No comando anterior, faça as seguintes alterações: + Substitua *poolid* pelo poolID ou nome do recurso da Amazon (ARN) do pool. + Substitua *OptOutListName* pelo nome do recurso da Amazon (ARN) ou pelo nome da lista de cancelamento. ------ # Atualizar rotas compartilhadas no AWS End User Messaging SMS Atualizar rotas compartilhadas Em alguns países, o AWS End User Messaging SMS mantém um grupo de identidades de origem compartilhadas. Quando você ativa rotas compartilhadas, o AWS End User Messaging SMS se esforça para entregar a mensagem usando uma das identidades compartilhadas. A identidade de origem pode ser uma ID de remetente, código longo ou código curto e pode variar em cada país. Quando as rotas compartilhadas usam uma ID de remetente como identidade de origem, o ID de remetente será um ID de remetente genérico, como `NOTICE`. As identidades compartilhadas não estão disponíveis em alguns países, incluindo os Estados Unidos. **nota** As rotas compartilhadas podem estar sujeitas a uma maior filtragem a jusante e as rotas dedicadas, quando disponíveis, são preferidas. **Ativar rotas compartilhadas (Console de gerenciamento da AWS)** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Pools telefônicos**, escolha o pool que terá as rotas compartilhadas. 1. Na guia **Rotas compartilhadas**, clique no botão **Editar configurações**. 1. Escolha **Ativar rotas compartilhadas** e, em seguida, **Salvar alterações**. # Usando a proteção contra exclusão de pools telefônicos no AWS End User Messaging SMS Usando proteção contra exclusão do pool telefônico Ao ativar a proteção contra exclusão, você não poderá excluir o pool até que a proteção contra exclusão seja desativada. Por padrão, a proteção contra exclusão fica desabilitada. **Habilitar proteção contra exclusão (Console)** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Pools telefônicos**, escolha o pool telefônico que terá a exclusão ativada. 1. Na guia **Proteção contra exclusão**, escolha o botão **Editar configurações**. 1. Escolha **Ativar proteção contra exclusão** e, em seguida, **Salvar alterações**. # Gerenciar os pools de telefone no AWS End User Messaging SMS Gerenciar etiquetas para pools de telefones Tags são pares de chave-valor que você pode aplicar opcionalmente aos seus recursos da AWS para controlar o acesso ou o uso. Para alterar o nome de um grupo editando o valor do par de chave-valor Nome: ------ #### [ Manage tags (Console) ] Use o console do AWS End User Messaging SMS para adicionar ou editar uma tag no seu pool. **Gerenciamento de etiquetas (console)** 1. Abra o console do AWS End User Messaging SMS 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 **pools de telefone**. 1. Na página **Pools de telefones**, escolha o pool de telefones ao qual deseja adicionar uma etiqueta. 1. Na guia **Tags (Tags)**, selecione **Manage tags (Gerenciar tags)**. + **Adicionar uma tag** — Em **Gerenciar tags**, escolha **Adicionar nova tag** para criar um novo par chave/valor em branco. + **Excluir uma tag** — Em **Gerenciar tags**, escolha **Remover** ao lado do par chave/valor. + **Editar uma tag** — Em **Gerenciar tags**, escolha a **chave** ou o **valor** e edite o texto. 1. Escolha **Salvar alterações**. ------ #### [ Manage tags (AWS CLI) ] Use o AWS CLI para adicionar ou editar uma tag. ``` $ aws pinpoint-sms-voice-v2 tag-resource \ --resource-arn resource-arn \ --tags tags={key1=value1,key2=value2} ``` No exemplo anterior, faça o seguinte: + Substitua *resource-arn* pelo nome do recurso da Amazon (ARN) do recurso ao qual você deseja adicionar uma tag. + Substitua *key1* *e key2* pelas chaves das tags que você deseja adicionar ao recurso. + Substitua *value1* e *value2* pelos valores das tags que você deseja adicionar às respectivas chaves. Use o AWS CLI para excluir uma tag. ``` $ aws pinpoint-sms-voice-v2 untag-resource \ --resource-arn resource-arn \ --tag-keys tags={key1=value1,key2=value2} ``` No exemplo anterior, faça o seguinte: + Substitua *resource-arn* é o nome de recurso da Amazon (ARN) que você deseja remover uma tag. + Substitua *key1* e *key2* pelas chaves das tags que você deseja remover. + Substitua *value1* e *value2* pelos valores das tags que você deseja remover. ------ # Liste os conjuntos de telefones compartilhados com o AWS CLI Lista de pools de telefones compartilhados Você pode usar a CLI [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) ou o [AWS RAM console](https://console.aws.amazon.com/ram) para ver informações sobre pools compartilhados com sua conta. Para obter mais informações sobre recursos de compartilhamento, consulte [Trabalhando com recursos compartilhados no SMS de mensagens para usuários AWS finais](shared-resources.md). **Para recuperar uma lista de pools compartilhados com você usando o AWS CLI** + Na linha de comando, insira o seguinte comando: ``` $ aws pinpoint-sms-voice-v2 describe-pools --owner SHARED ``` No comando anterior, substitua *SHARED* por *SELF* para listar os pools pertencentes à sua conta.