Início Rápido: Processar eventos de Email

  • Artigo

Comece a utilizar Azure Communication Services com Azure Event Grid para processar eventos de Email dos Serviços de Comunicação. Depois de subscrever Email eventos como relatórios de entrega e relatórios de cativação, irá 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.

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 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.

Poderá demorar algum tempo até que o registo seja concluído. Selecione Atualizar para atualizar o estado. Quando o Registo for apresentado em Estado, estará pronto para continuar.

Implementar o visualizador do Event Grid

Para este início rápido, vamos utilizar um visualizador do Event Grid para ver eventos em tempo quase 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 em Azure Event Grid Visualizador.

Subscrever eventos de Email com 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 Evento.

    Captura de ecrã que mostra a página Eventos de um recurso Azure Communication Services. O botão Subscrição de Eventos é 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 aos quais pretende subscrever. Para Email, pode escolher Email Delivery Report Received e Email Engagement Tracking 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ã que mostra a caixa de diálogo Criar Subscrição de Eventos. Em Tipos de Eventos, Email Relatório de Entrega Recebido e Email Relatório de Controlo de Cativação Recebidos estão selecionados.

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

    Captura de ecrã que mostra 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ã que mostra a caixa de diálogo Selecionar Web Hook. A caixa Ponto Final do Subscritor contém um URL e está visível um botão Confirmar Seleção.

Ver eventos de Email

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

Acionar eventos de Email

Para ver os acionadores de eventos, precisamos de gerar alguns eventos. Para acionar um evento, envie um e-mail com o recurso de domínio Email anexado ao recurso dos Serviços de Comunicação.

  • Email Delivery Report Receivedos eventos são gerados quando o estado Email está no estado do terminal, ou seja, Entregue, Com Falha, FiltradoSpam, Em Quarentena.
  • Email Engagement Tracking Report Received os eventos são gerados quando o e-mail enviado é aberto ou é clicada uma ligação no e-mail. Para acionar um evento, tem de ativar a opção User Interaction Tracking no recurso de domínio Email

Veja a lista completa dos eventos suportados pelo Communication Services.

Receber eventos de Email

Depois de gerar um evento, irá reparar que Email Delivery Report Received e Email Engagement Tracking Report Received os eventos são enviados para o seu 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 Azure Event Grid visualizador que mostra o esquema do Event Grid para um evento de entrega de E-mail recebido.

Captura de ecrã do visualizador Azure Event Grid que mostra o esquema do Event Grid para um evento de relatório de controlo de interação de E-mail.

  • EngagementContext refere-se à ligação clicada quando o engagementType é Click.
  • UserAgent refere-se ao User-Agent a partir do qual este evento de envolvimento de e-mail teve origem. Por ex. Se o utilizador interagiu no Edge com um computador Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, como Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType refere-se ao tipo de cativação, os valores possíveis são "Ver" ou "Clicar".

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

Limpar os recursos

Se quiser limpar e remover uma subscrição dos Serviços de Comunicação, 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 Email eventos. Pode receber Email eventos ao criar uma subscrição do Event Grid.

Enviar E-mail

Para obter informações de esquema e eventos de exemplo, veja Azure Communication Services - Email eventos.

Também poderá querer ver os seguintes artigos: