Microsoft Exchange Online Spoke
O Microsoft Exchange Online spoke cria e gerencia calendário e e-mail em Microsoft Exchange Online. Para criar, gerenciar ou excluir usuários e grupos, use o Microsoft Azure AD spoke.
Nota:
A gestão de usuários e grupos pode ser feita usando Microsoft Azure AD e não Microsoft Exchange Online spoke.
Solicitar aplicativos na Store
Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.
Assinatura do IntegrationHub
Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.
Versão do spoke
Microsoft Exchange Online spokev 3.11.0 é a versão mais recente.
Dependências do spoke
Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:
- Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
- Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
- ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
- Objeto complexo (com.glide.cobject)
- Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)
- Tabelas remotas (com.glide.script.vtable)
- Fonte de dados de importação do sistema (com.glide.system_import_data_source)
- Pacote de utilidade do spoke do iHub (com.snc.ihub_spoke_util_pack)
Nota:
Alguns desses plug-ins são recursos licenciáveis e exigem uma licença apropriada, se usados fora da implementação do spoke. Para obter informações sobre licenças, entre em contato com o gerente da sua conta.
Versão compatível
Microsoft REST API do gráfico v1.0
Módulo Spoke
. Microsoft Exchange Online spokeAdiciona a aplicação Microsoft Exchange Online à sua instância e inclui estes módulos:
| Módulo | Descrição |
|---|---|
| Eventos | Exibe a lista de eventos no Microsoft Exchange Online. |
| Assinaturas | Exibe a lista de assinaturas no Microsoft Exchange Online. |
| Registro do Webhook | Exibe a lista de registros de webhook do Microsoft Exchange Online. |
| Calendários | Exibe uma lista de calendários no Microsoft Exchange Online. |
| Dados de transformação dos eventos de calendário | Exibe a lista de registros da fonte de dados. |
Fluxos de spoke
O spoke do Microsoft Exchange Online fornece fluxos de amostra no estado Publicado para demonstrar a automação da renovação de assinaturas. Os fluxos de amostra disponíveis incluem:
| Fluxo | Descrição |
|---|---|
| Renovar assinaturas | Recupera todos os registros de assinatura e renova as assinaturas se uma renovação for necessária, com base no tempo de expiração. Se alguma assinatura tiver seu status marcado como "Em exclusão", seu registro será excluído e não será considerado para renovação. |
Subfluxos do spoke
O spoke fornece subfluxos no estado Publicado para integrar com Microsoft Exchange Online serviço. Esses subfluxos podem ser usados como parte de outros subfluxos e fluxos.
| Categoria | Subfluxos | Descrição |
|---|---|---|
| Gestão de webhook | Verifique Assinatura de evento | Verifica se existe uma assinatura de webhook com recurso de evento especificado ou URL de notificação e tipo de mudança. |
| Criar ou atualizar registro de assinatura | Verifica se o registro de assinatura especificado existe no Microsoft Exchange Online e atualiza o registro de assinatura, se ele existir. Se o registro de assinatura não existir, um novo registro de assinatura será criado. | |
| Criar ou atualizar assinaturas de recursos | Verifica as assinaturas dos recursos especificados. Se a assinatura dos recursos especificados não existir, novas assinaturas serão criadas. Nota: Este subfluxo está disponível somente quando Sincronização do calendário do local de trabalho o plug-in já está instalado. |
|
| Excluir assinatura | Exclui a assinatura especificada quando a assinatura especificada está relacionada somente à aplicação especificada. | |
| Recriar assinatura removida | Recria uma assinatura de webhook removida usando os detalhes do registro de assinatura relacionado. | |
| Gestão do ciclo de vida da assinatura | Gerencia o ciclo de vida de uma assinatura de webhook. | |
| Gestão de calendário | Sincronização de calendário | Sincroniza o calendário recuperando eventos da tabela Dados transformados de eventos do calendário do Exchange Online e adicionando os eventos recuperados ao Microsoft Exchange Online Tabela de eventos. Cria uma assinatura se não existir uma assinatura válida para o calendário especificado do usuário. |
| Criar ou atualizar registro de evento | Verifica o registro de evento existente específico e atualiza com as propriedades especificadas. Se o registro de evento especificado não existir, um novo registro de evento será criado. | |
| Excluir evento de programação de calendário | Exclui o evento especificado no Microsoft Exchange Online e os registros relacionados de tabelas de eventos, anexos relacionados, registros relacionados de participantes do evento e tabelas m2m de evento para assinatura. | |
| Excluir registro de evento | Exclui o registro de evento especificado das tabelas de eventos e dos anexos relacionados, registros relacionados dos participantes do evento e das tabelas m2m de evento para assinatura. | |
| Gestão do ciclo de vida do evento | Recupera os detalhes do evento e atualiza os registros nas tabelas m2m de evento, participantes e evento para assinatura de acordo. | |
| Pesquisar e atualizar anexos do registro de evento | Recupera os anexos de um registro de evento específico do Microsoft Exchange Online e os atualiza. | |
| Pesquisar e atualizar mudança de programação do calendário | Recupera os detalhes do evento de um registro de evento especificado e os atualiza. | |
| Sincronizar eventos | Sincroniza a exibição do calendário com base nos dados da tabela Dados transformados de eventos do calendário do Exchange Online. | |
| Atualizar evento de programação de calendário | Atualiza as propriedades de um objeto de evento no Microsoft Exchange Online e o registro relacionado na tabela de eventos. |
Nota:
- Use a tabela Registro do webhook do Microsoft Exchange Online para gerar um URL de retorno de chamada e armazenar o valor secreto (estado do cliente) para assinaturas do webhook.
- Certifique-se de que a assinatura do webhook esteja armazenada na tabela Assinaturas do Microsoft Exchange Online com o campo Status definido como Ativo.
Ações do spoke
. Microsoft Exchange Online spokefornece ações para automatizar tarefas de calendário e e-mail quando um incidente é criado no ServiceNow instância.
| Categoria | Ação | Descrição |
|---|---|---|
| Gestão de calendário | Copiar anexo em evento do calendário | Copia um ServiceNow anexo a um Trocarevento de calendário. |
| Criar evento de calendário | Cria um evento no calendário padrão do usuário e especifica o fuso horário para os horários de início e término do evento. | |
| Criar eventos de calendário recorrentes | Cria um evento recorrente no calendário padrão do usuário e especifica o fuso horário para as horas de início e término do evento. | |
| Excluir anexo | Exclui o anexo especificado no evento. | |
| Excluir evento de calendário | Exclui um evento de calendário. | |
| Encontrar horários das reuniões | Recupera horários e locais da reunião com base na disponibilidade do organizador da reunião e dos participantes para o horário e os locais especificados. | |
| Pesquisar anexos por ID de evento | Recupera todos os anexos no evento especificado. | |
| Pesquisar calendário por ID | Recupera os detalhes do calendário do ID especificado. | |
| Pesquisar calendário de eventos por ID de usuário | Recupera a lista de objetos de evento na caixa de correio do usuário. | |
| Pesquisar fluxo de exibição de calendário | Recupera a lista de entradas de reunião para o ID de usuário especificado para o período de tempo especificado. | |
| Pesquisar fluxo de calendários | Recupera detalhes dos calendários de todos os usuários. | |
| Pesquisar evento por ID | Recupera os detalhes do evento de calendário para o ID especificado. | |
| Pesquisar cronogramas | Recupera a lista de cronogramas. | |
| Pesquisar configurações de ausência temporária | Recupera os detalhes das configurações de ausência temporária dos destinatários especificados. | |
| Pesquisar fusos horários | Recupera os detalhes de todos os fusos horários disponíveis. | |
| Atualizar evento de calendário | Atualiza as propriedades de um objeto de evento. | |
| Gestão de e-mails | Excluir mensagem | Exclui a mensagem na caixa de entrada de um usuário ou de uma pasta personalizada. |
| Pesquisar pastas de e-mail por ID de usuário | Recupera todas as pastas de e-mail de um ID de usuário especificado. | |
| Pesquisar mensagens por ID da pasta de e-mail | Recupera todas as mensagens em uma pasta de e-mail. | |
| Pesquisar mensagens por ID de usuário | Recupera todas as mensagens na pasta da caixa de entrada do usuário. | |
| Enviar e-mail | Envia um e-mail com o assunto e o corpo da mensagem para a lista de destinatários especificada. | |
| Definir resposta automática da caixa de correio | Define a mensagem de resposta automática do usuário para o período fornecido. | |
| Gestão de Webhook | Pesquisar assinatura por ID | Recupera detalhes da assinatura do webhook para o ID especificado. |
| Pesquisar fluxo de assinaturas | Recupera detalhes de todas as assinaturas de webhook. | |
| Renovar assinatura de webhook | Renova a assinatura do webhook especificado. | |
| Assinar webhook | Cria uma assinatura de webhook para o recurso especificado. | |
| Cancelar assinatura do webhook | Exclui a assinatura do webhook especificada. | |
| Gestão da caixa de correio | Criar caixa de correio | Cria caixas de correio e contas de usuário simultaneamente. |
| Excluir caixa de correio | Exclui ou desabilita caixas de correio e contas de usuário simultaneamente. | |
| Habilitar caixa de Correio | Habilita uma caixa de correio no Microsoft Exchange Online. A caixa de correio pode estar em um estado arquivado. | |
| Pesquisar caixa de correio | Recupera a lista de caixas de correio. |
As permissões necessárias para executar essas ações são:
| Categoria | Ação | Tipo de permissão | Permissões (do menos para o mais privilegiado) |
|---|---|---|---|
| Gestão de calendário | Copiar anexo em evento do calendário | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Criar evento de calendário | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Criar eventos de calendário recorrentes | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Excluir anexo | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Excluir evento de calendário | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Encontrar horários das reuniões | Delegado (conta corporativa ou escolar) | Calendars.Read, Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | ||
| Aplicação | Sem suporte. | ||
| Pesquisar anexos por ID de evento | Delegado (conta corporativa ou escolar) | Calendários.Ler | |
| Delegado (conta pessoal da Microsoft) | Calendários.Ler | ||
| Aplicação | Calendários.Ler | ||
| Pesquisar calendário por ID | Delegado (conta corporativa ou escolar) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Aplicação | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Pesquisar calendário de eventos por ID de usuário | Delegado (conta corporativa ou escolar) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Aplicação | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Pesquisar fluxo de exibição de calendário | Delegado (conta corporativa ou escolar) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Aplicação | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Pesquisar fluxo de calendários | Delegado (conta corporativa ou escolar) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | ||
| Aplicação | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Pesquisar evento por ID | Delegado (conta corporativa ou escolar) | Calendars.ReadBasic, Calendars.Read | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadBasic, Calendars.Read | ||
| Aplicação | Calendars.ReadBasic, Calendars.Read | ||
| Pesquisar cronogramas | Delegado (conta corporativa ou escolar) | Calendars.readBasic, Calendars.Read, Calendars.readWrite | |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | ||
| Aplicação | Calendars.readBasic, Calendars.Read, Calendars.readWrite | ||
| Pesquisar configurações de ausência temporária | Delegado (conta corporativa ou escolar) | Mail.Read, Mail.Read.Shared | |
| Delegado (conta pessoal da Microsoft) | E-mail.Leitura | ||
| Aplicação | E-mail.Leitura | ||
| Pesquisar fusos horários | Delegado (conta corporativa ou escolar) | User.Read, User.readBasic.All | |
| Delegado (conta pessoal da Microsoft) | User.Read | ||
| Aplicação | User.Read.All | ||
| Atualizar evento de calendário | Delegado (conta corporativa ou escolar) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Gestão de e-mails | Excluir mensagem | Delegado (conta corporativa ou escolar) | ReadWrite |
| Delegado (conta pessoal da Microsoft) | ReadWrite | ||
| Aplicação | ReadWrite | ||
| Pesquisar pastas de e-mail por ID de usuário | Delegado (conta corporativa ou escolar) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Pesquisar mensagens por ID da pasta de e-mail | Delegado (conta corporativa ou escolar) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Pesquisar mensagens por ID de usuário | Delegado (conta corporativa ou escolar) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Enviar e-mail | Delegado (conta corporativa ou escolar) | E-mail.Enviar | |
| Delegado (conta pessoal da Microsoft) | E-mail.Enviar | ||
| Aplicação | E-mail.Enviar | ||
| Definir resposta automática da caixa de correio | Delegado (conta corporativa ou escolar) | MailboxSettings.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | MailboxSettings.ReadWrite | ||
| Aplicação | MailboxSettings.ReadWrite | ||
| Gestão da caixa de correio | Criar caixa de correio | Essas ações usam cmdlets do powershell e, portanto, não exigem permissões de API. | |
| Excluir caixa de correio | |||
| Habilitar caixa de Correio | |||
| Pesquisar caixa de correio | |||
Agentes de IA disponíveis
Instalar Now Assist Spokes e comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist Para Spokes.
Este spoke fornece agentes de IA autônomos que imitam inteligência semelhante à humana para executar tarefas em seu ServiceNow instância.
- Em ServiceNow Sistema agentic, você pode criar um fluxo de trabalho agentic que compreende um conjunto de instruções de modelo de linguagem grande (LLM) junto com um ou mais agentes de IA autônomos para executar um objetivo. Consulte Create an agentic workflow Para obter informações sobre como adicionar agentes de IA para criar fluxos de trabalho do agente de acordo com sua necessidade e fornecer o gatilho necessário.
Você também pode pesquisar outros agentes de IA disponíveis e adicioná-los ao fluxo de trabalho do agente. Para obter mais informações, consulte Find AI agents.
- Você pode criar um clone do agente de IA do spoke necessário e personalizá-lo de acordo com seu requisito. Consulte Duplicate an AI agent para obter mais informações sobre como criar um clone.
- Consulte Now Assist AI agents Para obter informações sobre agentes de IA.
Os agentes de IA disponíveis incluem:
| Agente de IA | Descrição |
|---|---|
| Microsoft Exchange Online Agente de IA de gestão de calendários | Automatiza fluxos de trabalho relacionados ao calendário no Microsoft Exchange Online como gestão de eventos de calendário, manipulação de anexos e pesquisas de fuso horário. |
| Microsoft Exchange Online Agente de IA de gestão de salas | Automatiza fluxos de trabalho relacionados à gestão de salas no Microsoft Exchange Online Como "Pesquisar fluxo de salas". |
| Microsoft Exchange Online Agente de IA de gestão de recuperação de metadados | Automatiza fluxos de trabalho relacionados ao gerenciamento de metadados da sala no Microsoft Exchange Online como pesquisar metadados da sala e metadados de fuso horário. |
| Microsoft Exchange Online Agente de IA do agendador de reuniões | Automatiza tarefas de gestão de calendários no Microsoft Exchange Online. Ele permite que os usuários encontrem os intervalos de tempo de reunião disponíveis e criem as reuniões de acordo. |
| Microsoft Exchange Online gerenciador de e-mail | Automatiza tarefas de gestão de e-mail no Microsoft Exchange Online como pesquisar pastas e mensagens de e-mail, excluir mensagens e definir respostas automáticas da caixa de correio. |
Procurando um agente de IA?
- Pode haver agentes de IA instalados com o. Now Assistaplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis em sua instância, consulte Encontre agentes de IA .
- Para encontrar agentes que podem não estar instalados em sua instância, visite Mercado de agentes de IA em ServiceNow Store.
Nota:
Certifique-se de que o usuário que executa um agente de IA tenha as funções e permissões necessárias para acessar dados ou executar operações em dados na tabela associada ao agente de IA.
Microsoft requisitos de conta
. Microsoft Exchange Online spokeé necessário registrar uma aplicação usando Microsoft Portal do Azure para gerar tokens OAuth 2,0.
Requisitos de aliases de conexão e credencial
IntegrationHub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.
Para obter informações sobre como configurar o spoke, consulte Configurar Microsoft Exchange Online spoke..
Requisitos do MID Server
Para usar essas ações, sua instância deve ter um MID Server Configurado e configurado para usar o PowerShell. Certifique-se de que o Power Shell com o módulo EXO V2 está instalado. Este módulo é necessário para executar as ações de gestão de caixa de correio. Use o registro de conexão associado ao Alias da caixa de correio para configurar onde as ações são executadas e definidas MID Server atributos de seleção. Para obter mais informações sobre MID Server, consulte MID Server .
Para configurar o. MID Serverpara este spoke, consulte Configurar MID Server para um spoke.