Início Rápido: manipular eventos de relatório de entrega e SMS

Introdução aos Serviços de Comunicação do Azure usando a Grade de Eventos do Azure para manipular eventos de SMS dos Serviços de Comunicação. Quando assina eventos de SMS, como mensagens de entrada e relatórios de entrega, você gera e recebe esses eventos. A realização deste início rápido gera um pequeno custo de alguns centavos de dólar ou menos em sua conta do Azure.

Importante

Os recursos de SMS e PSTN dependem do número de telefone que você usa e do país/região no qual você está operando, conforme determinado pelo seu endereço de cobrança do Azure. Para saber mais, acesse a documentação Qualificação de assinatura.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Um recurso dos Serviços de Comunicação. Para obter informações detalhadas, consulte Criar um recurso dos Serviços de Comunicação do Azure.
• Um número de telefone habilitado para SMS. Obter um número de telefone.

Sobre a Grade de Eventos

A Grade de Eventos do Azure é um serviço de eventos baseado em nuvem. Neste artigo, você aprenderá a assinar eventos do serviço de comunicação e a disparar um evento para exibir o resultado. Normalmente, você envia eventos para um ponto de extremidade que processa os dados de evento e realiza ações. Neste artigo, enviaremos os eventos para um aplicativo Web que coleta e exibe as mensagens.

Configurar o ambiente

Para configurar o ambiente que usaremos para gerar e receber eventos, execute as etapas das seções a seguir.

Registrar um provedor de recursos da Grade de Eventos

Se você ainda não tiver usado a Grade de Eventos da sua assinatura do Azure, talvez seja necessário registrar o provedor de recursos desse serviço. Para registrar o provedor, siga estas etapas:

1. Vá para o portal do Azure.
2. No menu à esquerda, selecione Assinaturas.
3. Selecione a assinatura que você usa para a Grade de Eventos.
4. No menu à esquerda, em Configurações, selecione Provedores de recursos.
5. Encontre Microsoft.EventGrid.
6. Caso o provedor de recursos não esteja registrado, selecione Registrar.

A conclusão do registro pode demorar um pouco. Selecione Atualizar para atualizar o status. Quando Registrado aparecer sob Status, você poderá continuar.

Implantar o visualizador da Grade de Eventos

Para este início rápido, usaremos o visualizador da Grade de Eventos para exibir eventos quase em tempo real. O visualizador dá ao usuário a experiência de um feed em tempo real. Além disso, o conteúdo do evento também deve estar disponível para inspeção.

Para configurar o visualizador, siga as etapas em Visualizador da Grade de Eventos do Azure.

Assinar eventos de SMS usando web hooks

Você pode assinar eventos específicos para fornecer à Grade de Eventos informações sobre onde enviar os eventos que deseja acompanhar.

1. No portal, acesse o recurso dos Serviços de Comunicação que você criou.

2. No recurso dos Serviços de Comunicação, no menu esquerdo da página Serviços de Comunicação, selecione Eventos.

3. Selecione Adicionar assinatura de evento.

   

4. Na página Criar assinatura de evento, insira um nome para a assinatura do evento.

5. Em Tipos de evento, selecione os eventos aos quais deseja assinar. Para SMS, você pode escolher SMS Received e SMS Delivery Report Received.

6. Se for solicitado que você forneça um Nome do Tópico do Sistema, fique à vontade para fornecer uma cadeia de caracteres exclusiva. O campo não tem impacto sobre sua experiência e é usado para fins de telemetria interna.

   

7. Para Tipo de ponto de extremidade, selecione Web Hook.

   

8. Para Ponto de extremidade, escolha Selecionar um ponto de extremidade e insira a URL do seu aplicativo Web.

   Neste caso, usaremos a URL do Visualizador da Grade de Eventos do Azure configurado anteriormente no início rápido. A URL de exemplo tem este formato: https://{{site-name}}.azurewebsites.net/api/updates

9. Selecione Confirmar seleção.

   

Exibir eventos de SMS

Para gerar e receber eventos de SMS, siga as etapas das próximas seções.

Disparar eventos de SMS

Para exibir gatilhos de evento, precisamos gerar alguns eventos.

• Os eventos SMS Received são gerados quando o número de telefone dos Serviços de Comunicação recebe uma mensagem de texto. Para disparar um evento, envie uma mensagem do seu telefone para o número de telefone anexado ao seu recurso de Serviços de Comunicação.
• Os eventos SMS Delivery Report Received são gerados quando você envia um SMS para um usuário com um número de telefone dos Serviços de Comunicação. Para disparar um evento, você precisa ativar a opção Delivery Report do SMS que envia. Tente enviar uma mensagem para seu telefone com Delivery Report ativado. A realização dessa ação gera um pequeno custo de alguns centavos de dólar ou menos em sua conta do Azure.

Confira a lista completa de eventos com suporte dos Serviços de Comunicação do Azure.

Receber eventos de SMS

Depois de gerar um evento, você observará que os eventos SMS Received e SMS Delivery Report Received são enviados para o ponto de extremidade. Esses eventos aparecem no Visualizador da Grade de Eventos do Azure configurado neste início rápido. Selecione o ícone de olho ao lado do evento para ver todo o conteúdo. Os eventos devem ser parecidos com estes dados:

Saiba mais sobre os esquemas de evento e outros conceitos de eventos.

Limpar os recursos

Se quiser limpar e remover uma assinatura dos Serviços de Comunicação, exclua o recurso ou o grupo de recursos. Excluir o grupo de recursos também exclui todos os recursos associados a ele. Saiba mais sobre como limpar recursos.

Próximas etapas

Neste guia de início rápido, você aprendeu a consumir eventos de SMS. Você pode receber mensagens SMS criando uma assinatura da Grade de Eventos.

Enviar SMS

Talvez seja necessário também:

• Saber mais sobre os conceitos de manipulação de eventos
• Saber mais sobre a Grade de Eventos