Manipulação de Eventos nos Serviços de Comunicação do Azure

  • Artigo

Os Serviços de Comunicação do Azure integram-se à Grade de Eventos do Azure para fornecer notificações de eventos em tempo real de maneira confiável, escalonável e segura. A finalidade deste artigo é ajudar você a configurar aplicativos para escutar eventos dos Serviços de Comunicação. Por exemplo, talvez seja interessante atualizar um banco de dados, criar um item de trabalho e enviar uma notificação por push sempre que uma mensagem SMS for recebida por um número de telefone associado ao seu recurso dos Serviços de Comunicação.

A Grade de Eventos do Azure é um serviço de roteamento de eventos totalmente gerenciado que usa um modelo de publicação-assinatura. A Grade de Eventos tem suporte interno para serviços do Azure, como Azure Functions e Aplicativos Lógicos do Azure. Ela pode entregar alertas de eventos para serviços que não são do Azure usando webhooks. Para obter uma lista completa dos manipuladores de eventos que dá suporte a Grade de Eventos, consulte Uma introdução à Grade de Eventos do Azure.

Diagram showing Azure Event Grid's event model.

Observação

Para saber mais sobre como a residência de dados está relacionada à manipulação de eventos, visite a documentação conceitual da Residência de Dados

Tipos de evento

A Grade de eventos usa assinaturas de evento para rotear mensagens de evento para os assinantes.

Os Serviços de Comunicação do Azure emitem os seguintes tipos de evento:

Você pode usar o portal do Azure ou a CLI do Azure para assinar eventos emitidos pelo recurso dos Serviços de Comunicação.

Assuntos do evento

O campo subject de todos os eventos dos Serviços de Comunicação identifica o usuário, o número de telefone ou a entidade direcionada pelo evento. Prefixos comuns são usados para permitir uma filtragem simples da Grade de Eventos.

Prefixo do assunto Entidade do Serviço de Comunicação
phonenumber/ Número de telefone PSTN
user/ Usuário dos Serviços de Comunicação
thread/ Conversa de chat.

O seguinte exemplo mostra um filtro para todas as mensagens SMS e relatórios de entrega enviados a todos os números de telefone de código de área 555 de propriedade de um recurso dos Serviços de Comunicação:

"filter": {
  "includedEventTypes": [
    "Microsoft.Communication.SMSReceived",
    "Microsoft.Communication.SMSDeliveryReportReceived"
  ],
  "subjectBeginsWith": "phonenumber/1555",
}

Próximas etapas