Tratamento de eventos nos Serviços de Comunicação do Azure

  • Artigo

Os Serviços de Comunicação do Azure integram-se com a Grelha de Eventos do Azure para fornecer notificações de eventos em tempo real de uma forma fiável, escalável e segura. O objetivo deste artigo é ajudá-lo a configurar seus aplicativos para ouvir eventos dos Serviços de Comunicação. Por exemplo, talvez você queira atualizar um banco de dados, criar um item de trabalho e entregar uma notificação por push sempre que uma mensagem SMS for recebida por um número de telefone associado ao 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 o Azure Functions e o Azure Logic Apps. Ele pode fornecer alertas de eventos para serviços que não sejam do Azure usando webhooks. Para obter uma lista completa dos manipuladores de eventos suportados pela Grade de Eventos, consulte Uma introdução à Grade de Eventos do Azure.

Diagram showing Azure Event Grid's event model.

Nota

Para saber mais sobre como a residência de dados se relaciona com o tratamento de eventos, visite a documentação conceitual da Residência de Dados

Tipos de eventos

A grade de eventos usa assinaturas de eventos para rotear mensagens de eventos para 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 se inscrever em eventos emitidos pelo recurso dos Serviços de Comunicação.

Temas do evento

O subject campo de todos os eventos dos Serviços de Comunicação identifica o usuário, número de telefone ou entidade que é alvo do evento. Os prefixos comuns são usados para permitir a filtragem simples da Grade de Eventos.

Prefixo do assunto Entidade de Serviço de Comunicação
phonenumber/ Número de telefone PSTN
user/ Utilizador dos Serviços de Comunicação
thread/ Tópico de bate-papo.

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

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

Próximos passos