Enviar e receber notificações SMS - AWS Mobile SDK
Criar um tópicoInscrever-se em um tópico usando o protocolo SMSPublicar uma mensagem

O AWS Mobile SDK for Xamarin agora está incluído no AWS SDK for .NET. Este guia faz referência à versão arquivada do Mobile SDK para Xamarin.

Enviar e receber notificações SMS

Você pode usar o Amazon SNS (Amazon Simple Notification Service) para enviar e receber notificações SMS (Short Message Service) para smartphones e celulares habilitados para SMS.

nota

As notificações SMS atualmente podem ser enviadas para números de telefone nos Estados Unidos. As mensagens SMS só podem ser enviadas de tópicos criados na região Leste dos EUA (Norte da Virgínia). No entanto, você pode publicar mensagens em tópicos que você cria na região Leste dos EUA (Norte da Virgínia) a partir de qualquer outra região.

Criar um tópico

Para criar um tópico:

  1. No console do Amazon SNS, clique em Create new topic (Criar outro tópico). A caixa de diálogo Create new topic é exibida.

  2. Na caixa Topic name, digite um nome para o tópico.

  3. Na caixa Display name, digite um nome de exibição. O tópico precisa ter um nome de exibição atribuído a ele, pois os primeiros dez (10) caracteres do nome de exibição são usados como a parte inicial do prefixo da mensagem de texto. O nome de exibição que você inserir será exibido na mensagem de confirmação que o SNS envia ao usuário (o nome de exibição abaixo é "AMZN SMS").

  1. Clique em Create topic (Criar tópico). O novo tópico é exibido na página de Topics.

  2. Selecione o novo tópico e clique no ARN do tópico. A página Topic Details é exibida.

  3. Copie o ARN do tópico, pois ele será necessário quando você inscrever um tópico na próxima etapa.

    arn:aws:sns:us-west-2:111122223333:MyTopic

Inscrever-se em um tópico usando o protocolo SMS

Crie um cliente SNS, transmitindo seu objeto de credenciais e a região do seu grupo de identidades:

var snsClient = new AmazonSimpleNotificationServiceClient(credentials, region);

Para inscrever um tópico, invoque SubscribeAsync e transmita o ARN do tópico que você deseja inscrever, o protocolo ("sms") e o número de telefone:

var response = await snsClient.SubscribeAsync(topicArn, "sms", "1234567890");

Você receberá um arn de inscrição no objeto de resposta da inscrição. Seu arn de inscrição é semelhante a:

arn:aws:sns:us-west-2:123456789012:MyTopic:6b0e71bd-7e97-4d97-80ce-4a0994e55286

Quando um dispositivo se inscreve em um tópico, o SNS envia uma mensagem de confirmação para o dispositivo, e o usuário tem que confirmar que deseja receber notificações, como mostrado abaixo:

Depois que o usuário se inscrever no tópico, ele receberá mensagens SMS quando você publicá-las nesse tópico.

Publicar uma mensagem

Para publicar uma mensagem em um tópico:

  1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon SNS.

  2. No painel de navegação à esquerda, clique em Topics (Tópicos) e selecione o tópico no qual você deseja publicar.

  3. Clique em Publish to topic (Publicar no tópico).

  4. Na caixa Subject, digite um assunto.

  5. Na caixa de Message, digite uma mensagem. O Amazon SNS envia o texto que você inseriu na caixa Message para os assinantes de SMS, salvo se você também inserir texto na caixa Subject. Como o Amazon SNS inclui um prefixo do nome de exibição com todas as mensagens SMS que você envia, a soma do prefixo do nome de exibição e a carga da mensagem não podem exceder 140 caracteres ASCII ou 70 caracteres Unicode. O Amazon SNS trunca mensagens que excedam esses limites.

  6. Clique em Publish message (Publicar mensagem). O Amazon SNS exibe uma caixa de diálogo de confirmação. A mensagem SMS é exibida no seu dispositivo habilitado para SMS, como mostrado abaixo.