**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 SMS 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 voz e SMS, consulte o novo [Guia do usuário do AWS End User Messaging SMS](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html).
O tópico a seguir foi movido para o novo [Guia do usuário do AWS End User Messaging SMS](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html).
[Sobre o sandbox de SMS/MMS e voz](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html)
[Escolher um número de telefone ou ID do remetente](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-number-types.html)
[Limites e restrições de SMS e MMS](https://docs.aws.amazon.com//sms-voice/latest/userguide/sms-limitations.html)
[Solicitar suporte para SMS, MMS e mensagens de voz](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport.html)
[Monitorando atividades de gastos com SMS, MMS e voz com AWS End User Messaging SMS](https://docs.aws.amazon.com//sms-voice/latest/userguide/monitor-spending.html)
[Tutorial para usuários pela iniciantes](https://docs.aws.amazon.com//sms-voice/latest/userguide/getting-started-tutorial.html)
[Palavras-chave](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-keywords.html)
[Sistema de mensagens SMS bidirecionais](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html)
[Capacidades e limitações de SMS e MMS do país](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-support-by-country.html)
[Pools de telefones](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-pool.html)
[Práticas recomendadas](https://docs.aws.amazon.com//sms-voice/latest/userguide/best-practices.html)
[Entender os relatórios de uso e faturamento de SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-billing.html)
Você pode usar o canal SMS no Amazon Pinpoint para enviar mensagens de texto (SMS) para os dispositivos móveis dos seus clientes. O Amazon Pinpoint pode enviar mensagens SMS para destinatários em mais de 200 países e regiões. Em alguns países e regiões, você também pode receber mensagens de seus clientes usando o recurso de SMS bidirecional. Quando você cria uma nova conta do Amazon Pinpoint, sua conta é colocada em uma sandbox de SMS. Inicialmente, isso limita seus gastos mensais e para quem você pode enviar mensagens. Para obter mais informações, consulte [SMS sandbox](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-sms) no *Guia do usuário do AWS End User Messaging SMS*.
Para enviar mensagens de texto usando o Amazon Pinpoint você precisa [habilitar o canal de SMS em seu projeto](channels-sms-setup.md). Dependendo de como você usa o Amazon Pinpoint para enviar mensagens SMS, talvez você também precise iniciar uma solicitação no Suporte para solicitar que determinadas opções de SMS sejam habilitadas ou modificadas na sua conta. Por exemplo, você pode solicitar um aumento de sua cota de gastos com SMS, mudar da sandbox à produção ou solicitar um código curto para usar ao enviar e receber mensagens.
Para receber mensagens de texto usando o Amazon Pinpoint, primeiro você deve obter um código curto ou um código longo dedicado. Quando você tem um número dedicado, você pode habilitar o SMS bidirecional para ele. Por fim, você pode especificar as mensagens que o Amazon Pinpoint envia para os clientes quando ele recebe mensagens.
Na seção Configurações de SMS e voz do console do Amazon Pinpoint, é possível gerenciar as configurações de canal de SMS para seu caso de uso e orçamento. Por exemplo, você pode definir o sua cota de gastos de SMS mensal ou alterar o tipo de mensagem padrão.
**nota**
Quando você definir as configurações de canal de SMS no Amazon Pinpoint, as alterações serão aplicadas aos outros Serviços da AWS que enviam mensagens SMS, como o Amazon SNS.
**Topics**
+ [Configuração do canal de SMS do Amazon Pinpoint](channels-sms-setup.md)
+ [Gerenciamento do canal de SMS do Amazon Pinpoint](channels-sms-manage.md)
+ [Rotas de mensagens](channels-sms-limitations-routes.md)
+ [Fallback de mensagens](channels-sms-limitations-fallback.md)
+ [Solução de problemas do canal de SMS](channels-sms-troubleshooting.md)
# Configuração do canal de SMS do Amazon Pinpoint
Para enviar mensagens SMS com o Amazon Pinpoint, você precisa de um projeto do Amazon Pinpoint em que o canal de SMS esteja habilitado.
Você pode também habilitar o canal de SMS para um projeto existente usando 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 SMS do Amazon Pinpoint](channels-sms-manage.md).
## Criar um novo projeto usando o console do Amazon Pinpoint
A primeira etapa para configurar o canal de SMS no Amazon Pinpoint é criar um novo projeto. Depois, habilite o canal de SMS para esse projeto.
**Como criar um novo projeto do Amazon Pinpoint e habilitar o canal de SMS**
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. Em **Configurações no nível da conta**, você pode alterar as seguintes configurações:
+ **Tipo de mensagem padrão**: a categoria de mensagens que você pretende enviar. Escolha **Transacional** para conteúdo urgente, como alertas e senhas de uso único, ou escolha **Promocional** para conteúdo relacionado a marketing.
+ **Limite de gastos da conta**: digite a quantidade máxima de dinheiro em dólares americanos (USD) que você deseja gastar em mensagens SMS a cada mês. Se seus gastos mensais excederem esse valor, o Amazon Pinpoint e outros Serviços da AWS deixarão de enviar mensagens SMS da sua conta.
**nota**
Se você não tiver usado o Amazon Pinpoint ou o Amazon SNS para enviar mensagens SMS da sua Conta da AWS, sua conta terá uma cota de gastos padrão de USD 1,00. É possível solicitar um aumento dessa cota para toda essa conta. Para obter mais informações, consulte [Requesting increases to your monthly SMS or Voice spending quota](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport-spend-threshold.html) no *Guia do usuário do AWS End User Messaging SMS*.
+ **ID do remetente padrão**: a identidade que aparece nos dispositivos dos destinatários quando eles recebem mensagens. O suporte a recursos de ID de remetentes varia de acordo com o país ou a região.
**Importante**
Essas configurações se aplicam a toda a sua Conta da AWS. Quando você altera essas configurações, elas se aplicam a todos os outros projetos do Amazon Pinpoint em sua conta e a outros Serviços da AWS que você usa para enviar mensagens SMS, como o Amazon SNS.
1. Quando terminar, escolha **Salvar alterações**.
## Próximas etapas
Você criou um projeto que está habilitado para mensagens SMS. Agora, você pode usar o Amazon Pinpoint para enviar mensagens SMS.
Algumas opções de SMS, como números de origem dedicados ou remetente IDs, não estão disponíveis até você entrar em contato. Suporte Para obter mais informações, consulte [Requesting support for SMS and voice messaging](https://docs.aws.amazon.com//sms-voice/latest/userguide/awssupport.html) no *Guia do usuário do AWS End User Messaging SMS*.
Para atrair um segmento de público com uma campanha de SMS, consulte [Campanhas do Amazon Pinpoint](campaigns.md).
Para enviar uma mensagem SMS diretamente para um público limitado sem criar uma campanha, consulte [Enviar mensagens de teste com o Amazon Pinpoint](messages.md).
# Gerenciamento do canal de SMS do Amazon Pinpoint
Você pode gerenciar as configurações de SMS, como seu tipo de mensagem padrão (transacional ou promocional) e sua cota de gastos mensais, diretamente no console do Amazon Pinpoint.
## Atualização das configurações do canal de SMS
Você pode alterar várias configurações relacionadas a SMS. A maioria dessas configurações se aplica a todo o seu projeto Conta da AWS, mas algumas se aplicam a projetos específicos.
**Como editar as configurações de SMS de um projeto**
1. Faça login no Console de gerenciamento da AWS e 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 cujas configurações de SMS você deseja editar.
1. No painel de navegação, em **Configurações**, selecione **SMS e voz**.
1. Na seção **Configurações de SMS**, escolha **Editar**.
1. Altere as configurações de SMS do seu projeto conforme necessário. Você pode alterar as seguintes configurações:
+ **Habilitar o canal de SMS para este projeto**
Selecione essa opção para habilitar ou desabilitar o canal de SMS do projeto. Se essa configuração não estiver ativada, você não poderá enviar mensagens SMS desse projeto. Essa configuração se aplica somente ao projeto atual.
+ **Configurações no nível da conta**: altere essas configurações para modificar as configurações de SMS da sua Conta da AWS. Essas configurações se aplicam a toda a sua conta do Amazon Pinpoint e a tudo o Serviços da AWS que você pode usar para enviar mensagens SMS, como o Amazon Simple Notification Service (Amazon SNS). Você pode alterar as seguintes configurações:
+ **Tipo de mensagem padrão**: selecione a categoria de mensagens SMS que pretende enviar desta conta. Se você enviar mensagens relacionadas à conta ou mensagens urgentes, como senhas de uso único, escolha **Transacional**. Se você planeja enviar mensagens que contenham material de marketing ou outro conteúdo promocional, escolha **Promocional**. Essa configuração se aplica a todo o seu Conta da AWS.
+ **Limite de gastos da conta**: a quantia máxima de dinheiro (em dólares americanos) que você pode gastar enviando mensagens a cada mês. Você pode usar essa configuração para garantir que o envio de SMS não exceda seu orçamento ou como forma de evitar aumentos inesperados nos gastos. O preço do envio de uma mensagem SMS varia de acordo com o país de destino dessa mensagem. Para obter os preços atuais, consulte [Definição de preços do Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/#SMS_text_messages). Essa configuração se aplica a toda a sua Conta da AWS.
+ **ID do remetente da conta**: o ID de remetente alfabético que você deseja usar ao enviar mensagens da sua conta. Essa configuração se aplica a todo o seu Conta da AWS.
**nota**
Se você não enviar mensagens para países onde o ID de remetente é aceito pelas operadoras de celular desse país , não é necessário especificar nada nesse campo. O remetente IDs não é suportado em destinos comuns de mensagens, como Estados Unidos da América, Canadá e Brasil.
Além disso, alguns países exigem que o remetente IDs seja pré-registrado em agências governamentais ou organizações do setor.
Para obter uma lista de países que oferecem suporte a remetentes alfabéticos IDs, consulte [Países e regiões suportados (canal SMS)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html) no Guia do *usuário de SMS de mensagens para usuários AWS finais*.
1. Quando terminar, escolha **Salvar alterações**.
# Rotas de mensagens
A rota que sua mensagem usa depende do tipo definido para a mensagem, seja **promocional** ou **transacional**. Ao comprar um novo número usando o console do Amazon Pinpoint, você deverá escolher o tipo de rota.
Uma rota promocional geralmente consiste em mensagens de marketing ou relacionadas a vendas. Alguns países ou regiões têm horários de silêncio, ou seja, quando você não tem permissão para enviar mensagens promocionais. Uma rota transacional é para mensagens mais urgentes, como redefinições de senha ou senhas de uso único. Isso pode ser aplicado ao número quando você compra um novo número ou pode ser passado como um parâmetro opcional na operação SendMessages da API do Amazon Pinpoint. Ao enviar uma mensagem usando esse número como origem, o Amazon Pinpoint escolhe a rota promocional ou transacional aplicável.
Você passa o tipo de rota como um parâmetro opcional usando a operação [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) da API do Amazon Pinpoint. Em alguns casos, você pode usar um SenderID como origem ou ter um grupo compartilhado de números. Se você tiver números transacionais e promocionais associados à sua conta no país de destino, o Amazon Pinpoint escolhe um número transacional por padrão. Os recibos de entrega e o painel de entrega mostram a rota como promocional ou transacional, com base no número escolhido.
# Fallback de mensagens
Ao enviar uma mensagem usando a API do Amazon Pinpoint, três parâmetros opcionais podem ser passados na solicitação: `originationNumber`, `registeredKeyword` e `senderID`. Se o Amazon Pinpoint encontrar erro um `originationNumber`, por exemplo, um caractere inválido, e o erro for recuperável, o Amazon Pinpoint usa um processo de fallback para escolher um número válido para a solicitação. O fallback verifica se há um número válido na ordem abaixo. A qualquer momento durante esse processo, o Amazon Pinpoint escolherá o primeiro número válido encontrado como o número de origem.
1. Número de origem. Todos os outros números de origem válidos são verificados.
1. Palavra-chave. As palavras-chave registradas são verificadas e comparadas com qualquer número dedicado.
1. ID de remetente. Todos os outros IDs de remetente válidos são verificados.
**nota**
Se você enviar uma mensagem com um `originationNumber` que não existe na sua conta, não haverá um processo de fallback e, em vez disso, uma mensagem de exceção será retornada.
Se nenhum dos parâmetros anteriores for passado na solicitação, o Amazon Pinpoint examinará sua conta e verificará se há um número válido nesta ordem:
1. Números dedicados. Todos os números dedicados associados à sua conta são verificados nesta ordem: código curto, 10DLC, depois código longo/número gratuito. Os números nacionais são verificados antes dos números internacionais. Se você tiver códigos longos transacionais e promocionais na sua conta, o Amazon Pinpoint escolhe um número transacional por padrão.
1. IDs de remetente padrão.
1. Rotas compartilhadas.
**nota**
O Amazon Pinpoint tentará entregar mensagens em países onde uma identidade de origem não é necessária.
# Solução de problemas do canal de SMS
Verifique se o registro em log está ativado para ajudar a identificar a causa da falha. Para obter mais informações, consulte [Monitorar e registrar em log.](troubleshooting.md#troubleshooting-logging) Para ativar o registro de mensagens de voz do usuário AWS final (SMS) e da API Voice v2, consulte [Como faço para configurar o registro de mensagens de voz do Amazon Pinpoint para as APIs Amazon Pinpoint SMS](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup-v2) e Voice v2? .
## Falhas de entrega de SMS
****Problemas e soluções****
+ Confirme se o número é válido usando o [Validador de números do Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/developerguide/validate-phone-numbers.html). A entrega de SMS é compatível apenas com phoneType 'MOBILE'. A entrega de SMS para números 'VOIP' é feita com o melhor esforço possível.
+ Confirme se sua cota mensal de gastos com SMS não está esgotada. Para obter mais informações, consulte [Monitoring SMS, MMS, and voice spending activity](https://docs.aws.amazon.com//sms-voice/latest/userguide/monitor-spending.html) no *Guia do usuário do AWS End User Messaging SMS*.
+ Se o problema de entrega estiver limitado a um ou dois dispositivos, descarte os problemas relacionados ao dispositivo. Verifique se os números podem receber SMS fora do Amazon Pinpoint no momento da falha.
+ Ative o registro em log de eventos SMS para ajudar a identificar a causa da falha.
+ Revise o [status da mensagem](https://docs.aws.amazon.com//pinpoint/latest/developerguide/event-streams-data-sms.html#event-streams-data-sms-attributes-attrs).
+ Veja como resolver um [Erro desconhecido ao tentar entrar em contato com o telefone](https://repost.aws/knowledge-center/sns-unknown-error-phone-sms).
+ Anote os requisitos e regulamentos especiais. Consulte [Supported countries and regions (SMS channel)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html) no *Guia do usuário do AWS End User Messaging SMS* e confirme se esses requisitos estão sendo atendidos.
## Solução de problemas de SMS bidirecionais
As respostas de mensagens SMS bidirecionais não são recebidas no tópico do SNS, nos assinantes ou em ambos.
****Problemas e soluções****
+ Verifique se você tem um número com SMS bidirecional habilitado para um país onde o atributo é aceito. Consulte [Supported countries and regions (SMS channel)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-sms-by-country.html) e [Two-way SMS messaging](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html) no *Guia do usuário do AWS End User Messaging SMS*.
+ Verifique se o número do remetente é do mesmo país que o número bidirecional habilitado para SMS no Amazon Pinpoint.
+ Verifique se o número do usuário é um número de celular válido e não um número virtual usando a [API de validação de números de telefone do Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/developerguide/validate-phone-numbers.html). A comunicação entre dois números virtuais, como os do Amazon Pinpoint, será tentada com o máximo esforço.
+ Analise [ CloudWatch as métricas do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-monitoring-using-cloudwatch.html#sns-metrics) para`NumberOfMessagesPublished`,`NumberOfNotificationsDelivered`, e verifique `NumberOfNotificationsFailed` se o tópico do Amazon SNS é capaz de receber o SMS de entrada.
+ Se houver pontos de dados para `NumberOfMessagesPublished` no momento dos carimbos de data/hora de entrada do SMS, a resposta do destinatário foi recebida com sucesso posteriormente. Ative o registro em log no tópico do Amazon SNS para o protocolo de entrega que está sendo usado. Consulte [Status de entrega de mensagens do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-topic-attributes.html).
+ Se não houver pontos de dados para a métrica `NumberOfMessagesPublished` no momento dos carimbos de data/hora do SMS de entrada:
+ Analise a política de tópicos do Amazon SNS para confirmar se ela permite que o serviço Amazon Pinpoint publique no tópico do Amazon SNS. Para ver um exemplo de política, consulte [Two-way SMS messaging](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html) no *Guia do usuário do AWS End User Messaging SMS*.
+ Se o tópico do Amazon SNS vinculado ao número SMS bidirecional estiver criptografado:
+ Verifique se a chave usada é simétrica.
+ Verifique se a política de chave foi modificada para permitir que o Amazon Pinpoint use a chave, consulte [Amazon SNS topic policies for Amazon SNS topics](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-two-way-sms.html#phone-number-two-way-sms-iam-policy-auto) no *Guia do usuário do AWS End User Messaging SMS*.