Compartilhar via

Implementar pastas partilhadas e cenários de caixas de correio partilhadas num suplemento do Outlook

Este artigo descreve como implementar pastas partilhadas (também conhecidas como acesso delegado) e cenários de caixas de correio partilhadas no seu suplemento do Outlook, incluindo as permissões suportadas pela API JavaScript do Office.

Observação

O suporte de pastas partilhadas foi introduzido no conjunto de requisitos 1.8, enquanto o suporte de caixa de correio partilhada foi introduzido no requisito definido 1.13. Para obter informações sobre o suporte de cliente para estas funcionalidades, veja Supported clients and platforms (Clientes e plataformas suportados).

Clientes e plataformas suportados

A tabela seguinte mostra as combinações de cliente/servidor suportadas para esta funcionalidade, incluindo a Atualização Cumulativa mínima necessária, quando aplicável.

Cliente Exchange Online Exchange 2019 no local
(Atualização Cumulativa 1 ou posterior)		 Exchange 2016 no local
(Atualização Cumulativa 6 ou posterior)
Browser (IU moderna do Outlook) Com suporte Não aplicável Não aplicável
Browser (IU clássica do Outlook) Não aplicável
  • Pastas partilhadas: suportado
  • Caixas de correio partilhadas: não aplicável
  • Pastas partilhadas: suportado
  • Caixas de correio partilhadas: não aplicável
novo Outlook no Windows Com suporte Não aplicável Não aplicável
Windows (clássico)
Pastas partilhadas: Versão 1910 (Compilação 12130.20272) ou posterior

Caixas de correio partilhadas: Versão 2304 (Compilação 16327.20248) ou posterior		 Com suporte Suportado* Suportado*
Mac
Versão 16.47 ou posterior		 Com suporte Com suporte Com suporte
Android Não aplicável Não aplicável Não aplicável
iOS Não aplicável Não aplicável Não aplicável

Observação

* O suporte para esta funcionalidade num ambiente do Exchange no local está disponível a partir do Outlook clássico na Versão 2206 do Windows (Compilação 15330.20000) para o Canal Atual e a Versão 2207 (Compilação 15427.20000) para o Canal Empresarial Mensal.

Configurações suportadas

As secções seguintes descrevem configurações para caixas de correio partilhadas e pastas partilhadas que suportam a utilização de suplementos. As APIs de funcionalidade podem não funcionar conforme esperado noutras configurações. Selecione a plataforma que pretende aprender a configurar.

Pastas compartilhadas

O proprietário da caixa de correio tem primeiro de fornecer acesso a um delegado.

Assim que o acesso for fornecido, o delegado tem de seguir as instruções descritas em Aceder à caixa de correio de outra pessoa.

No novo Outlook no Windows, por predefinição, as caixas de correio partilhadas que são automaticamente mapeadas por um administrador são adicionadas como pastas partilhadas. Isto significa que, embora um utilizador possa ler e enviar mensagens a partir da caixa de correio partilhada, não pode gerir as definições da caixa de correio. Para gerir as definições, um utilizador tem de promover a caixa de correio partilhada para uma conta completa. Para obter mais informações, consulte Gerir definições de caixa de correio partilhada no novo Outlook.

Caixas de correio compartilhadas

Uma caixa de correio partilhada permite que um grupo de utilizadores monitorize e envie facilmente mensagens e convites para reuniões através de um endereço de e-mail partilhado.

No Outlook na Web, uma caixa de correio partilhada pode ser aberta no mesmo painel que a caixa de correio principal de um utilizador ou num separador ou janela separador do browser. Para obter orientações, consulte Abrir e utilizar uma caixa de correio partilhada no Outlook na Web.

No novo Outlook no Windows, é acedida uma caixa de correio partilhada a partir do painel de pastas do cliente. Uma caixa de correio partilhada pode ser adicionada automaticamente por um administrador ou adicionada manualmente pelo utilizador. As caixas de correio que são adicionadas manualmente são configuradas automaticamente como contas completas no cliente do Outlook, para que os utilizadores possam gerir as definições da caixa de correio. Por predefinição, as caixas de correio partilhadas adicionadas por um administrador são configuradas como pastas partilhadas. Se um utilizador quiser gerir as definições da caixa de correio, tem de promover a pasta partilhada para uma conta completa no cliente. Para obter mais informações, consulte Gerir definições de caixa de correio partilhada no novo Outlook.

Configurar o manifesto

Para implementar cenários de pastas partilhadas e caixas de correio partilhadas no seu suplemento, primeiro tem de configurar o suporte para a funcionalidade no seu manifesto. A marcação varia consoante o tipo de manifesto utilizado pelo suplemento.

Observação

A implementação de cenários de pastas partilhadas e de caixas de correio partilhadas com um manifesto unificado para o Microsoft 365 só é atualmente suportada no Outlook clássico no Windows. Para outras plataformas suportadas, utilize o manifesto apenas de suplemento.

Adicione um objeto adicional à "authorization.permissions.resourceSpecific" matriz. "name" Defina a respetiva propriedade como e a "Mailbox.SharedFolder" respetiva "type" propriedade como "Delegated".

"authorization": {
  "permissions": {
    "resourceSpecific": [
      ...
      {
        "name": "Mailbox.SharedFolder",
        "type": "Delegated"
      },
    ]
  }
},

Identificar se uma pasta ou caixa de correio é partilhada

Antes de poder executar operações numa pasta partilhada ou numa caixa de correio partilhada, primeiro tem de identificar se a pasta ou caixa de correio atual é partilhada. Para determinar isto, ligue para Office.context.mailbox.item.getSharedPropertiesAsync numa mensagem ou compromisso no modo de composição ou leitura. Se o item estiver numa pasta partilhada ou numa caixa de correio partilhada, o método devolve um objeto SharedProperties que fornece as permissões do utilizador, o endereço de e-mail do proprietário, o URL base da API REST e a localização da caixa de correio de destino.

Observação

No Outlook na Web e no Windows (novo e clássico), dependendo da forma como a pasta ou caixa de correio partilhada é acedida, o getSharedPropertiesAsync método pode exigir que determinadas condições sejam cumpridas no modo Compose mensagens. Para obter mais informações, consulte a secção "Modo de Compose de mensagens" em Limitações.

O exemplo seguinte chama o getSharedPropertiesAsync método para identificar o proprietário da caixa de correio e as permissões do utilizador delegado ou da caixa de correio partilhada.

Office.context.mailbox.item.getSharedPropertiesAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.error("The current folder or mailbox isn't shared.");
    return;
  }
  const sharedProperties = result.value;
  console.log(`Owner: ${sharedProperties.owner}`);
  console.log(`Permissions: ${sharedProperties.delegatePermissions} `);
});

Permissões suportadas

A tabela seguinte descreve as permissões suportadas getSharedPropertiesAsync para delegados e utilizadores de caixas de correio partilhadas.

Permissão Valor Descrição
Leitura 1 (000001) Pode ler itens.
Gravar 2 (000010) Pode criar itens.
DeleteOwn 4 (000100) Só é possível eliminar os itens que criaram.
DeleteAll 8 (001000) Pode eliminar quaisquer itens.
EditArNuar 16 (010000) Só é possível editar os itens que criaram.
EditarTodos 32 (100000) Pode editar quaisquer itens.

Observação

Atualmente, a API suporta a obtenção de permissões existentes, mas não a definição de permissões.

A enumeração DelegatePermissions devolvida pela propriedade delegatePermissions é implementada com uma máscara de bits para indicar as permissões. Cada posição na máscara de bits representa uma permissão específica e, se estiver definida como 1, o utilizador tem a respetiva permissão. Por exemplo, se o segundo bit da direita for 1, o utilizador tem permissão de Escrita .

Executar uma operação como delegado ou utilizador de caixa de correio partilhada

Depois de identificar que o item de correio atual está numa pasta partilhada ou numa caixa de correio partilhada, o seu suplemento pode executar as operações necessárias no item no ambiente partilhado. Para executar operações num item num contexto partilhado, primeiro tem de configurar a permissão do suplemento no manifesto. Em seguida, utilize o Microsoft Graph para concluir as operações.

Observação

  • Os Serviços Web exchange (EWS) não são suportados em cenários de pastas partilhadas e caixas de correio partilhadas.

  • Em cenários delegados ou partilhados, um delegado pode obter as categorias da lista de master do Outlook, mas não pode adicionar ou remover categorias da lista.

Configurar as permissões do suplemento

Para utilizar os serviços do Microsoft Graph, um suplemento tem de configurar a permissão de caixa de correio de leitura/escrita no respetivo manifesto. A marcação varia consoante o tipo de manifesto utilizado pelo suplemento.

  • Manifesto unificado para o Microsoft 365: defina a "name" propriedade de um objeto na "authorization.permissions.resourceSpecific" matriz como "Mailbox.ReadWrite.User".
  • Manifesto apenas de suplemento: defina o elemento Permissões como ReadWriteMailbox.

Usar o Microsoft Graph

Para implementar os seus cenários de pastas partilhadas e caixas de correio partilhadas, utilize o Microsoft Graph para aceder a recursos e informações adicionais da caixa de correio. Por exemplo, pode utilizar o Microsoft Graph para obter o conteúdo de uma mensagem do Outlook anexada a uma mensagem numa caixa de correio onde um utilizador tem acesso delegado. Para obter orientações sobre como utilizar o Microsoft Graph, consulte Descrição geral do Microsoft Graph e da API de correio do Outlook no Microsoft Graph.

Dica

Para aceder às APIs do Microsoft Graph a partir do seu suplemento, utilize MSAL.js autenticação de aplicações aninhadas (NAA). Para saber mais, consulte Ativar o SSO num Suplemento do Office através da autenticação de aplicações aninhadas (pré-visualização).

Suporte de suplementos em cenários de pastas partilhadas e caixas de correio partilhadas

A disponibilidade de suplementos numa pasta partilhada ou caixa de correio partilhada varia consoante o cenário e o cliente do Outlook.

Dica

Para saber mais sobre onde os suplementos fazem e não são ativados em geral, consulte a secção Itens da Caixa de Correio disponíveis para suplementos da página de descrição geral dos suplementos do Outlook.

Suplementos em cenários de pastas partilhadas

A tabela seguinte descreve a disponibilidade de suplementos em cenários de pastas partilhadas.

Cenário Disponibilidade do suplemento
A pasta Caixa de Entrada é partilhada com um delegado Os suplementos estão disponíveis para o delegado no modo de leitura de mensagens.
A pasta Rascunhos é partilhada com um delegado Os suplementos estão disponíveis para o delegado no modo de composição de mensagens.
(Apenas no Novo Outlook no Windows) A caixa de correio partilhada é mapeada automaticamente por um administrador e não é promovida para uma conta completa pelo utilizador Veja os comportamentos descritos na coluna "Web: o mesmo separador ou janela, Windows (novo): caixa de correio não promovida, Windows (clássico) e Mac" de Suplementos em cenários de caixa de correio partilhada.
O calendário é explicitamente partilhado com um delegado (a caixa de correio inteira pode não ser partilhada) Os suplementos estão disponíveis para o delegado nos modos de leitura e composição de compromissos.
O calendário é partilhado com um grupo de utilizadores com acesso diferente (por exemplo, tornou-o editável para uma lista de distribuição específica ou para toda a organização) Os suplementos estão disponíveis para utilizadores com permissões indiretas ou implícitas nos modos de leitura e composição de compromissos.

Suplementos em cenários de caixa de correio partilhada

A tabela seguinte descreve a disponibilidade de suplementos em cenários de caixa de correio partilhada em vários clientes do Outlook. Tenha em atenção que o comportamento no Outlook na Web pode diferir consoante a caixa de correio partilhada esteja aberta no mesmo painel que a caixa de correio principal do utilizador ou num separador ou janela separado utilizando a opção Abrir outra caixa de correio. Da mesma forma, o comportamento no novo Outlook no Windows também pode diferir consoante a caixa de correio partilhada tenha sido adicionada ou promovida como uma conta completa no cliente.

Cenário Clientes do Outlook aplicáveis
  • Web: o mesmo separador ou janela
  • Windows (novo): não promovido
  • Windows (clássico)
  • Mac
 Clientes do Outlook aplicáveis
  • Web: separador ou janela separador
  • Windows (novo): promovido
Suplemento instalado pelo utilizador Os utilizadores não podem instalar suplementos numa caixa de correio partilhada. Os suplementos instalados por um utilizador são adicionados à caixa de correio principal do utilizador. Os utilizadores não podem instalar suplementos numa caixa de correio partilhada. A loja Microsoft 365 e Copilot na aplicação não aparece no friso da caixa de correio.
Suplemento instalado por um administrador Os administradores não devem implementar suplementos numa caixa de correio partilhada. Em vez disso, devem implementar um suplemento na caixa de correio principal do utilizador. Em seguida, o utilizador pode utilizar o suplemento numa caixa de correio partilhada, desde que o suplemento cumpra determinados requisitos (veja os seguintes cenários para disponibilidade de suplementos em modos de leitura e composição). Aplicam-se a mesma limitação e recomendação noutras plataformas (ver coluna anterior).
Suplemento utilizado no modo de leitura O manifesto de um suplemento tem de ser configurado para suportar cenários de caixa de correio partilhada. Para obter mais informações, veja Configurar o manifesto. O suplemento tem de ser instalado na caixa de correio principal do utilizador pelo utilizador ou administrador. Aplicam-se a mesma configuração e comportamento de manifesto noutras plataformas (ver coluna anterior).
Suplemento utilizado no modo de composição No Outlook na Web (caixa de correio aberta na mesma janela) e no Windows (novo e clássico), os suplementos instalados na caixa de correio principal do utilizador que suportam o modo de composição estão disponíveis para utilização. O manifesto de um suplemento não precisa de configuração adicional para suportar cenários de caixa de correio partilhada.

No entanto, no Outlook para Mac, o manifesto de um suplemento tem de ser configurado para suportar cenários de caixa de correio partilhada. Para obter mais informações, veja Configurar o manifesto.		 O manifesto de um suplemento tem de ser configurado para suportar cenários de caixa de correio partilhada. Para obter mais informações, veja Configurar o manifesto. O suplemento tem de ser instalado na caixa de correio principal do utilizador pelo utilizador ou administrador.
Modelos criados com o suplemento Os Meus Modelos Isto aplica-se apenas a Outlook na Web e no Windows (novo e clássico), uma vez que o suplemento Os Meus Modelos não é suportado em caixas de correio partilhadas no Outlook para Mac.

Os modelos criados são guardados na caixa de correio principal do criador. Embora o criador possa utilizar estes modelos nas respetivas caixas de correio principais e partilhadas, os outros utilizadores que têm acesso à caixa de correio partilhada não podem aceder a estes modelos. Para obter mais informações, consulte Criar um modelo de mensagem de e-mail.		 Os modelos criados são guardados na caixa de correio partilhada. Qualquer pessoa com acesso à caixa de correio partilhada pode editar ou utilizar estes modelos se abrir a caixa de correio utilizando Abrir outra caixa de correio no Outlook na Web ou se a caixa de correio for promovida para uma conta completa no novo Outlook no Windows. Estes modelos partilhados não podem ser acedidos por ninguém, incluindo o criador do modelo, a partir de outras plataformas. Isto inclui Outlook na Web, se a caixa de correio partilhada for aberta no mesmo separador que a caixa de correio principal do utilizador e o novo Outlook no Windows, se a caixa de correio partilhada não tiver sido promovida para uma conta completa. Por outro lado, os modelos criados noutras plataformas não podem ser acedidos a partir de uma caixa de correio partilhada aberta utilizando a opção Abrir outra caixa de correio ou a partir de uma caixa de correio partilhada promovida. Para obter mais informações, consulte Criar um modelo de mensagem de e-mail.
Suplementos predefinidos no Outlook No Outlook na Web e no Windows (novo e clássico), os suplementos predefinidos do Outlook estão disponíveis para utilização numa caixa de correio partilhada. Os suplementos predefinidos do Outlook podem incluir Os Meus Modelos, Anular a Subscrição e Itens de Ação. Tenha em atenção que alguns suplementos predefinidos podem não aparecer na sua organização.

No Outlook para Mac, os suplementos predefinidos não estão disponíveis numa caixa de correio partilhada.		 Os suplementos predefinidos estão disponíveis numa caixa de correio partilhada.

Limitações

Consoante os cenários do suplemento, existem algumas limitações a ter em conta ao processar pastas partilhadas ou situações de caixas de correio partilhadas.

Modo de Compose de mensagens

No modo Compose mensagem, getSharedPropertiesAsync não é suportado no Outlook na Web ou no Windows (novo e clássico), a menos que sejam cumpridas as seguintes condições.

  • Delegar acesso/Pastas partilhadas

    1. O proprietário da caixa de correio inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
    2. Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta partilhada com o delegado.
    3. O delegado abre o rascunho a partir da pasta partilhada e, em seguida, continua a compor.

  • Caixa de correio partilhada aberta no mesmo painel que a caixa de correio principal do utilizador (Web, Windows clássico) ou caixa de correio partilhada que não foi promovida para uma conta completa (novo Windows)

    1. Um utilizador de caixa de correio partilhada inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
    2. Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta na caixa de correio partilhada.
    3. Outro utilizador da caixa de correio partilhada abre o rascunho da caixa de correio partilhada e, em seguida, continua a compor.

    Observação

    O getSharedPropertiesAsync método é suportado nas seguintes plataformas sem condições adicionais.

    • Outlook na Web quando a caixa de correio partilhada é aberta num separador ou janela separado utilizando a opção Abrir outra caixa de correio.
    • novo Outlook no Windows quando a caixa de correio partilhada é promovida para uma conta completa.

Assim que estas condições forem cumpridas, a mensagem fica disponível num contexto partilhado e os suplementos que suportam estes cenários partilhados podem obter as propriedades partilhadas do item. Depois de a mensagem ser enviada, normalmente encontra-se na pasta Itens Enviados da caixa de correio pessoal do remetente.

Caixa de correio partilhada ou utilizador oculta de uma lista de endereços

Se um administrador escondeu um endereço de caixa de correio partilhado ou de um utilizador de uma lista de endereços, como a lista de endereços global (GAL), os itens de correio afetados abertos no relatório Office.context.mailbox.item da caixa de correio são nulos. Por exemplo, se o utilizador abrir um item de correio numa caixa de correio partilhada ocultada da GAL, Office.context.mailbox.item representar que o item de correio é nulo.

Sincronizar entre clientes de pastas partilhadas

Normalmente, as atualizações de um delegado à caixa de correio do proprietário são sincronizadas entre caixas de correio imediatamente. No entanto, se as operações do Microsoft Graph fossem utilizadas para definir uma propriedade expandida num item, essas alterações poderiam demorar algum tempo a sincronizar. Para evitar um atraso, recomendamos que utilize o objeto CustomProperties e as APIs relacionadas. Para saber mais, consulte o separador "Propriedades personalizadas" de Obter e definir metadados num suplemento do Outlook.

Confira também