Partilhar via


Início Rápido: Processar sms e eventos de relatórios de entrega

Comece a utilizar Azure Communication Services com Azure Event Grid para processar eventos SMS dos Serviços de Comunicação. Depois de subscrever eventos SMS, como mensagens de entrada e relatórios de entrega, pode gerar e receber estes eventos. A conclusão deste início rápido implica um pequeno custo de alguns cêntimos de USD ou menos na sua conta do Azure.

Importante

As capacidades de SMS e RTPC dependem do número de telefone que utiliza e do país/região em que está a operar, conforme determinado pelo seu endereço de faturação do Azure. Para obter mais informações, veja a Documentação de elegibilidade da subscrição .

Pré-requisitos

Sobre o Event Grid

O Event Grid é um serviço de eventos baseado na cloud. Neste artigo, irá aprender a subscrever eventos do serviço de comunicação e acionar um evento para ver o resultado. Normalmente, envia eventos para um ponto final que processa os dados de eventos e efetua ações. Neste artigo, iremos enviar os eventos para uma aplicação Web que recolhe e apresenta as mensagens.

Configurar o ambiente

Para configurar o ambiente que iremos utilizar para gerar e receber eventos, siga os passos nas secções seguintes.

Registar um fornecedor de recursos do Event Grid

Se ainda não utilizou o Event Grid na sua subscrição do Azure, poderá ter de registar o seu fornecedor de recursos do Event Grid. Para registar o fornecedor, siga estes passos:

  1. Aceda ao portal do Azure.
  2. No menu esquerdo, selecione Subscrições.
  3. Selecione a subscrição que utiliza para o Event Grid.
  4. No menu esquerdo, em Definições, selecione Fornecedores de Recursos.
  5. Localize Microsoft.EventGrid.
  6. Se o seu fornecedor de recursos não estiver registado, selecione Registar.

A conclusão do registo poderá demorar algum tempo. Selecione Atualizar para atualizar o estado. Quando Registado aparecer em Estado, está pronto para continuar.

Implementar o visualizador do Event Grid

Neste início rápido, vamos utilizar um visualizador do Event Grid para ver eventos quase em tempo real. O visualizador fornece ao utilizador a experiência de um feed em tempo real. Além disso, o payload de cada evento deve estar disponível para inspeção.

Para configurar o visualizador, siga os passos no Azure Event Grid Viewer.

Subscrever eventos de SMS através de web hooks

Pode subscrever eventos específicos para fornecer ao Event Grid informações sobre onde enviar os eventos que pretende controlar.

  1. No portal, aceda ao recurso dos Serviços de Comunicação que 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 Subscrição de Eventos.

    Captura de ecrã que mostra a página Eventos de um recurso Azure Communication Services. O botão Subscrição de Eventos está destacado.

  4. Na página Criar Subscrição de Eventos , introduza um nome para a subscrição do evento.

  5. Em Tipos de Eventos, selecione os eventos que pretende subscrever. Para SMS, pode escolher SMS Received e SMS Delivery Report Received.

  6. Se lhe for pedido para fornecer um Nome do Tópico do Sistema, não hesite em fornecer uma cadeia exclusiva. Este campo não tem impacto na sua experiência e é utilizado para fins de telemetria interna.

    Captura de ecrã a mostrar a caixa de diálogo Criar Subscrição de Eventos. Em Tipos de Eventos, são selecionados OS SMS Recebidos e o Relatório de Entrega por SMS recebidos.

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

    Captura de ecrã a mostrar um detalhe da caixa de diálogo Criar Subscrição de Eventos. Na lista Tipo de Ponto Final, o Web Hook está selecionado.

  8. Em Ponto final, selecione Selecionar um ponto final e, em seguida, introduza o URL da sua aplicação Web.

    Neste caso, vamos utilizar o URL do visualizador do Event Grid que configurámos anteriormente no início rápido. O URL do exemplo tem este formato: https://{{site-name}}.azurewebsites.net/api/updates

  9. Selecione Confirmar a Seleção.

    Captura de ecrã a mostrar a caixa de diálogo Selecionar Web Hook. A caixa Ponto Final do Subscritor contém um U R L e um botão Confirmar Seleção está visível.

Ver eventos de SMS

Para gerar e receber eventos de SMS, siga os passos nas secções seguintes.

Acionar eventos SMS

Para ver os acionadores de eventos, precisamos de gerar alguns eventos.

  • SMS Received os eventos são gerados quando o número de telefone dos Serviços de Comunicação recebe uma mensagem sms. Para acionar um evento, envie uma mensagem do seu telemóvel para o número de telefone anexado ao recurso dos Serviços de Comunicação.
  • SMS Delivery Report Received os eventos são gerados quando envia um SMS a um utilizador através de um número de telefone dos Serviços de Comunicação. Para acionar um evento, tem de ativar a opção Delivery Report do SMS que enviar. Experimente enviar uma mensagem para o telemóvel com Delivery Report a origem ativada. A conclusão desta ação implica um pequeno custo de alguns cêntimos de USD ou menos na sua conta do Azure.

Consulte a lista completa de eventos suportados pelo Communication Services.

Receber eventos sms

Depois de gerar um evento, irá reparar que SMS Received os eventos e SMS Delivery Report Received são enviados para o ponto final. Estes eventos são apresentados no visualizador do Event Grid que configurámos no início deste início rápido. Selecione o ícone de olho junto ao evento para ver todo o payload. Os eventos devem ter um aspeto semelhante aos seguintes dados:

Captura de ecrã do visualizador Azure Event Grid que mostra o esquema do Event Grid para um evento recebido por SMS.

Captura de ecrã do visualizador Azure Event Grid que mostra o esquema do Event Grid para um evento de relatório de entrega de SMS.

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

Limpar os recursos

Se quiser limpar e remover uma subscrição do Communication Services, pode eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados ao mesmo. Saiba mais sobre a limpeza de recursos.

Passos seguintes

Neste início rápido, aprendeu a consumir eventos SMS. Pode receber mensagens SMS ao criar uma subscrição do Event Grid.

Também poderá querer: