**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á.
# Canal de voz do Amazon Pinpoint
**nota**
O Guia do usuário do Amazon Pinpoint foi atualizado. Para obter as informações mais recentes sobre como criar, configurar e gerenciar seus recursos de SMS e voz do AWS End User Messaging, consulte o novo [https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html).
Os tópicos a seguir foram movidos para o novo [https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html).
[Sandbox de voz do Amazon Pinpoint](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice)
[Países e regiões com suporte (canal de voz)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-voice-support-by-country.html)
[Gerenciamento de grupos no Amazon Pinpoint](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-pool.html)
[Práticas recomendadas do canal de voz](https://docs.aws.amazon.com//sms-voice/latest/userguide/best-practices.html#voice-best-practices)
Você pode usar o canal de voz para criar mensagens de voz de um script de texto e fornecer essas mensagens para seus clientes por telefone. O canal de voz é uma ótima maneira de atingir os clientes cujos números de telefone não podem receber mensagens SMS, como por exemplo os usuários que usam linhas fixas ou serviços VoIP.
Para enviar mensagens de voz usando o Amazon Pinpoint, primeiro você precisa habilitar o canal de voz em seu projeto e alugar um número de telefone dedicado para enviar as mensagens. Dependendo de como você usa o Amazon Pinpoint para enviar mensagens de voz, você também pode alterar determinadas configurações para sua conta. Por exemplo, talvez você queira solicitar acesso de produção para aumentar o número de mensagens de voz que você pode enviar.
**Topics**
+ [Configuração do canal de voz do Amazon Pinpoint](channels-voice-setup.md)
+ [Gerenciamento do canal de voz do Amazon Pinpoint](channels-voice-manage.md)
+ [Solução de problemas do canal de voz](channels-voice-troubleshooting.md)
# Configuração do canal de voz do Amazon Pinpoint
Para enviar mensagens de voz usando o Amazon Pinpoint, comece criando um projeto do Amazon Pinpoint. Depois, habilite o canal de voz do projeto e solicite um número de telefone dedicado, conhecido como um *código longo*, para enviar mensagens de voz. Um *código longo* é um número de telefone padrão que contém até 15 dígitos, dependendo do país ou região em que está baseado. Esses números de telefone são *dedicados*, ou seja, reservados para uso somente pela sua conta do Amazon Pinpoint. Você pode alugar números de telefone locais baseados em vários países ou regiões.
**dica**
Você também pode habilitar o canal de voz para um projeto existente. Para fazer isso, use a página de configurações de **SMS e voz** no console do Amazon Pinpoint. Para obter mais informações, consulte [Gerenciamento do canal de voz do Amazon Pinpoint](channels-voice-manage.md).
Observe que as configurações escolhidas para o canal de voz também se aplicam ao canal de SMS do projeto. Para enviar mensagens de voz e SMS do projeto, escolha configurações que ofereçam suporte a seus objetivos para os dois canais. Para saber mais sobre como habilitar e usar o canal de SMS, consulte [Canal de SMS do Amazon Pinpoint](channels-sms.md).
**Como configurar o canal de voz para um novo projeto**
1. Abra o console do Amazon Pinpoint em. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)
1. Na página **Todos os projetos**, escolha **Criar um novo projeto**.
1. Em **Nome do projeto**, digite um nome e selecione **Criar**.
**nota**
O nome do projeto agora pode conter até 64 caracteres alfanuméricos. Ele também pode incluir os seguintes caracteres: vírgula (,), ponto (.), arroba (@), sublinhado (\$1), sinal de igual (=) e o sinal de mais (\$1).
1. Em **Atributos do projeto**, na seção **SMS e voz**, selecione **Configurar**.
1. Selecione **Habilitar o canal de SMS para este projeto**.
1. Expanda a seção **Configurações avançadas** e escolha **Solicitar códigos longos**.
1. Na página **Definir seus números de telefone**, em **País**, escolha o país onde seus destinatários estão localizados. Você pode escolher apenas um país por vez, mas pode adicionar outros posteriormente, se necessário.
1. Especifique o caso de uso do número de telefone. Você pode escolher uma das seguintes opções:
+ **Promocional**: escolha essa opção para enviar mensagens de marketing ou mensagens promovendo sua empresa ou serviço.
+ **Transacional**: escolha essa opção para enviar mensagens urgentes, como redefinições de senha ou alertas de transações.
Em alguns países e regiões, o valor escolhido pode determinar o preço que você paga a cada mensagem enviada. As mensagens transacionais são otimizadas para alta capacidade de entrega, resultando em um custo mais alto em muitos países. As mensagens promocionais são otimizadas para proporcionar uma boa relação custo-benefício. Para obter mais informações sobre definição de preços de SMS, consulte [Definição de preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
1. A seção **Resumo** exibe informações sobre o número. O **Preço por mês** mostra o custo de um único número.
1. Em **Quantidade**, escolha a quantidade de números que deseja comprar. Você pode comprar até 10 números em uma única solicitação. Você pode comprar números adicionais posteriormente. O **Subtotal** é atualizado para exibir o custo mensal total da quantidade de números de telefone que você está comprando.
1. (Opcional) Se você quiser comprar números de telefone adicionais, escolha **Adicionar um país ou região** e repita as etapas anteriores até definir solicitações para todos os países em que precisa de códigos longos.
1. Quando terminar a compra dos números de telefone, escolha **Próximo**.
1. A página **Revisão e solicitação** exibe os detalhes da solicitação de número para cada país de destino.
1. O **Custo total** exibe o custo total de todos os números de todos os países que você escolheu.
1. Escolha **Solicitar** quando estiver tudo pronto. Caso contrário, escolha **Anterior** para voltar e fazer as alterações. Depois de escolher **Solicitar**, você não poderá mais fazer alterações.
# Gerenciamento do canal de voz do Amazon Pinpoint
Você pode usar o console do Amazon Pinpoint para habilitar o canal de voz de um projeto e gerenciar as configurações que se aplicam ao canal de voz da sua conta do Amazon Pinpoint. Por exemplo, você pode solicitar acesso à produção para a sua conta, ou solicitar números de telefone dedicados para enviar mensagens de voz.
## Gerenciar o canal de voz
Para poder usar o Amazon Pinpoint para enviar mensagens de voz, habilite o canal de voz para um ou mais projetos. Para saber como criar um projeto e habilitar o canal de e-mail para ele, consulte [Configuração do canal de voz do Amazon Pinpoint](channels-voice-setup.md). Para habilitar o canal de voz em um projeto existente, execute as etapas a seguir:
Observe que as configurações escolhidas para o canal de voz também se aplicam ao canal de SMS do projeto. Para enviar mensagens de voz e SMS do projeto, escolha configurações que ofereçam suporte a seus objetivos para os dois canais. Para saber mais, consulte [Canal de SMS do Amazon Pinpoint](channels-sms.md).
**Para habilitar o canal de voz para um projeto existente**
1. Abra o console do Amazon Pinpoint em. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)
1. Na página **Todos os projetos**, escolha o projeto para o qual você deseja habilitar o canal de voz.
1. No painel de navegação, em **Configurações**, selecione **SMS e voz**.
1. Na página **SMS e voz** ao lado de **Configurações de SMS**, escolha **Editar**.
1. Selecione **Habilitar o canal de voz para este projeto**.
1. Escolha **Salvar alterações**.
1. Na página **SMS e voz** em **Configurações de número**, consulte a tabela para determinar se qualquer número de telefone já associado à sua conta pode ser usado para enviar mensagens de voz. Se houver, a coluna **Voz** exibirá **Ativado** ao lado de cada número de telefone que você pode usar para enviar mensagens de voz. Se não houver, [solicite um número de telefone](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-request.html) no *Guia do usuário do AWS End User Messaging SMS*.
# Solução de problemas do canal de voz
Para registrar em log as mensagens de voz do Amazon Pinpoint, consulte [Como faço para configurar o registro em log de mensagens de voz do Amazon Pinpoint para a API de SMS e voz, v1, do Amazon Pinpoint](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup)?.
## Voz
****Problemas e soluções****
+ Por padrão, o canal de voz de um projeto do Amazon Pinpoint é desativado. Para ver se a voz está ativada em seu projeto, selecione a página **Configurações** abaixo do projeto. Em **Atributos** para SMS e voz, você verá se cada um deles está desativado ou ativado. Embora você possa ativar o SMS na opção **Gerenciar**, você pode ativar o canal de voz executando o seguinte comando:
```
aws pinpoint update-voice-channel --application-id AppId --voice-channel-request Enabled=true
```
+ TooManyRequests exceção
+ Se sua conta estiver em uma sandbox, há um limite de 20 mensagens em um período de 24 horas. Esse limite pode ser aumentado pelo [Sandbox de box](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice) no *Guia do usuário do AWS End User Messaging SMS*.
+ O canal de voz do Amazon Pinpoint tem um limite rígido de cinco mensagens por destinatário em um período de 24 horas. Esse limite é fixo que não pode ser alterado.