Partilhar via

Guia de início rápido: manipular eventos de e-mail

  • Artigo

Introdução aos Serviços de Comunicação do Azure usando a Grade de Eventos do Azure para manipular eventos de Email dos Serviços de Comunicação. Depois de assinar eventos de e-mail, como relatórios de entrega e relatórios de engajamento, você gera e recebe esses eventos. A conclusão deste início rápido incorre num pequeno custo de alguns cêntimos USD ou menos na sua conta do Azure.

Pré-requisitos

  • Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
  • Um recurso de Serviços de Comunicação. Para obter informações detalhadas, consulte Criar um recurso dos Serviços de Comunicação do Azure.
  • Um recurso de Email com um domínio provisionado. Crie um recurso de e-mail.

Sobre o Event Grid

A Grade de Eventos é um serviço de eventos baseado em nuvem. Neste artigo, você aprenderá como se inscrever em eventos de serviço de comunicação e acionar um evento para exibir o resultado. Normalmente, envia eventos para um ponto final que processa os dados de eventos e efetua 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, siga as etapas nas seções a seguir.

Registrar um provedor de recursos da Grade de Eventos

Se você não tiver usado anteriormente a Grade de Eventos em sua assinatura do Azure, talvez seja necessário registrar seu provedor de recursos da Grade de Eventos. Para registar o fornecedor, siga estes passos:

  1. Aceda ao portal do Azure.
  2. No menu à esquerda, selecione Assinaturas.
  3. Selecione a assinatura que você usa para a Grade de Eventos.
  4. No menu esquerdo, em Definições, selecione Fornecedores de Recursos.
  5. Localize Microsoft.EventGrid.
  6. Se o seu provedor de recursos não estiver registrado, selecione Registrar.

Pode demorar algum tempo até que o registo termine. Selecione Atualizar para atualizar o estado. Quando Registrado aparecer em Status, você estará pronto para continuar.

Implantar o visualizador de Grade de Eventos

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

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

Inscrever-se em eventos de e-mail usando ganchos da Web

Pode subscrever eventos específicos para fornecer à Grelha de Eventos informações sobre para onde enviar os eventos que pretende acompanhar.

  1. No portal, vá para o recurso Serviços de Comunicação que você criou.

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

  3. Selecione Adicionar assinatura de evento.

    Captura de ecrã que mostra a página Eventos de um recurso dos Serviços de Comunicação do Azure. O botão Subscrição de Eventos está destacado.

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

  5. Em Tipos de Eventos, selecione os eventos que pretende subscrever. Para E-mail, você pode escolher Email Delivery Report Received e Email Engagement Tracking Report Received.

  6. Se você for solicitado a fornecer um Nome de Tópico do Sistema, sinta-se à vontade para fornecer uma cadeia de caracteres 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 Evento. Em Tipos de Evento, Relatório de Entrega de Email Recebido e Relatório de Acompanhamento de Envolvimento por Email Recebido são selecionados.

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

    Captura de tela que mostra um detalhe da caixa de diálogo Criar Assinatura de Evento. Na lista Tipo de Ponto de Extremidade, o Gancho da Web está selecionado.

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

    Nesse caso, usaremos a URL do visualizador de Grade de Eventos que configuramos anteriormente no início rápido. O URL para o exemplo tem este formato: https://{{site-name}}.azurewebsites.net/api/updates

  9. Selecione Confirmar a Seleção.

    Captura de tela que mostra a caixa de diálogo Selecionar gancho da Web. A caixa Ponto de extremidade do assinante contém uma URL e um botão Confirmar seleção está visível.

Ver eventos de e-mail

Para gerar e receber eventos por e-mail, siga as etapas nas seções a seguir.

Acionar eventos de e-mail

Para visualizar gatilhos de eventos, precisamos gerar alguns eventos. Para acionar um evento, envie um email usando o recurso de domínio de email anexado ao recurso Serviços de Comunicação.

  • Email Delivery Report Received os eventos são gerados quando o status do e-mail está no estado terminal, como Entregue, Falhado, FiltradoSpam, Colocado em quarentena.

  • Email Engagement Tracking Report Received Os eventos são gerados quando o e-mail enviado é aberto ou um link dentro do e-mail é clicado. Para acionar um evento, você precisa ativar a User Interaction Tracking opção no recurso de domínio de e-mail

Consulte a lista completa de eventos suportados pelos Serviços de Comunicação.

Receber eventos por e-mail

Depois de gerar um evento, você notará que Email Delivery Report Received os Email Engagement Tracking Report Received eventos são enviados para o seu ponto de extremidade. Esses eventos aparecem no visualizador de Grade de Eventos que configuramos no início deste início rápido. Selecione o ícone de olho ao lado do evento para ver toda a carga útil. Os eventos devem ser semelhantes aos seguintes dados:

Captura de ecrã do visualizador da Grelha de Eventos do Azure que mostra o esquema da Grelha de Eventos para um evento recebido do relatório de entrega EMAIL.

Captura de ecrã do visualizador da Grelha de Eventos do Azure que mostra o esquema da Grelha de Eventos para um evento de relatório de acompanhamento de compromisso EMAIL.

  • EngagementContext refere-se ao link clicado quando o engagementType é Click.
  • UserAgent refere-se ao User-Agent do qual este evento de envolvimento por e-mail se originou. Por ex. Se o usuário interagiu no Edge usando uma máquina 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 envolvimento, os valores possíveis são 'Ver' ou 'Clicar'.

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

Clean up resources (Limpar recursos)

Se quiser limpar e remover uma assinatura dos Serviços de Comunicação, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos associados a ele. Saiba mais sobre a limpeza de recursos.

Próximos passos

Neste guia de início rápido, você aprendeu como consumir eventos de email. Você pode receber eventos por e-mail criando uma assinatura da Grade de Eventos.

Enviar E-mail

Para obter informações de esquema e eventos de exemplo, consulte Serviços de Comunicação do Azure - Eventos de email.

Você também pode querer ver os seguintes artigos: