Visão geral dos suplementos do Outlook

  • Artigo

Os suplementos do Outlook são integrações criadas por terceiros para o Outlook usando nossa plataforma baseada na Web. Os suplementos do Outlook têm três aspectos principais:

  • O mesmo suplemento e lógica de negócios funcionam em desktop (Outlook no Windows e Mac), na Web (Microsoft 365 e Outlook.com) e em dispositivos móveis.
  • Os suplementos do Outlook consistem em um manifesto, que descreve como o suplemento se integra ao Outlook (por exemplo, um botão ou um painel de tarefas), e o código JavaScript/HTML, que compõe a interface do usuário e lógica de negócios do suplemento.
  • Os suplementos do Outlook podem ser adquiridos na AppSource ou sideloaded por usuários finais ou administradores.

Os suplementos do Outlook são diferentes dos suplementos de COM ou VSTO, que são integrações mais antigas específicas do Outlook para Windows. Diferentemente dos suplementos de COM, os suplementos do Outlook não têm qualquer código fisicamente instalado no dispositivo do usuário ou no cliente do Outlook. No caso de um suplemento do Outlook, o Outlook lê o manifesto, conecta os controles especificados na interface do usuário e carrega o HTML e o JavaScript. Todos os componentes da Web são executados no contexto de um controle de navegador ou webview em uma área restrita.

Importante

Suplementos COM e VSTO não têm suporte no novo Outlook no Windows que está atualmente em versão prévia. Esses suplementos ainda têm suporte no cliente clássico do Outlook na área de trabalho do Windows. Para saber mais, confira Desenvolver suplementos do Outlook para novo Outlook no Windows (versão prévia).

Os itens do Outlook que dão suporte a suplementos incluem mensagens de email, compromissos, solicitações, respostas e cancelamentos de reunião. Cada suplemento do Outlook define o contexto no qual está disponível, incluindo os tipos de itens e se o usuário está lendo ou redigindo um item.

Observação

Se você planeja publicar o seu suplemento no AppSource e disponibilizá-lo na experiência do Office, certifique-se de que está em conformidade com as políticas de certificação do Marketplace Comercial. Por exemplo, para passar na validação, o suplemento deve funcionar em todas as plataformas com suporte para os métodos definidos (saiba mais na seção 1120.3 e na página de aplicativo e disponibilidade do Suplemento do Office).

Pontos de extensão

Pontos de extensão são as formas usadas pelos suplementos para se integrar ao Outlook. Veja a seguir as maneiras pelas quais isso pode ser feito.

Itens de caixa de correio disponíveis para suplementos

Os suplementos do Outlook são ativados quando o usuário está redigindo ou lendo uma mensagem ou compromisso, mas não em outros tipos de item. Entretanto, os suplementos não são ativados se o item de mensagem atual, em um formulário de redação ou de leitura, estiver em uma das seguintes situações:

  • Protegido pelo IRM (Information Rights Management) ou criptografado de outras formas de proteção e acessado do Outlook em dispositivos móveis. Uma mensagem assinada digitalmente é um exemplo, pois a assinatura digital depende de um desses mecanismos. Para saber mais sobre o suporte ao IRM nos suplementos do Outlook, confira itens de email protegidos pelo IRM.

  • Um item de email protegido por IRM com um rótulo de confidencialidade que tem a opção Permitir política personalizada de acesso programático definida como false. Para saber mais sobre o suporte ao IRM nos suplementos do Outlook, confira itens de email protegidos pelo IRM.

  • Um relatório de entrega ou notificação que tem a classe de mensagem IPM.Report.*, incluindo NDRs (notificações de falha na entrega) e notificações de leitura, falha na leitura e atraso.

  • Um arquivo .msg que é um anexo de outra mensagem.

  • Um arquivo .msg aberto no sistema de arquivos.

  • Em uma caixa de correio de grupo, em uma caixa de correio compartilhada*, na caixa de correio de outro usuário*, em uma caixa de correio de arquivo ou em uma pasta pública.

    Importante

    * O suporte para cenários de acesso de delegado (por exemplo, pastas compartilhadas da caixa de correio de outro usuário) foi introduzido no conjunto de requisitos 1.8, enquanto o suporte de caixa de correio compartilhada foi introduzido no conjunto de requisitos 1.13. Para saber mais, confira Habilitar pastas compartilhadas e cenários de caixa de correio compartilhada.

  • Usando um formulário personalizado.

  • Criado através de MAPI simples. O MAPI simples é usado quando um usuário do Office cria ou envia um email de um aplicativo do Office no Windows com o Outlook fechado. Por exemplo, um usuário pode criar um email do Outlook enquanto trabalha no Word, o que dispara uma janela de composição do Outlook sem iniciar o aplicativo Outlook completo. No entanto, se o Outlook já estiver em execução quando o usuário criar o email a partir do Word, esse não será um cenário MAPI simples para que os suplementos do Outlook funcionem no formulário de composição, desde que outros requisitos de ativação sejam atendidos.

Em geral, o Outlook pode ativar suplementos no formato de leitura para itens na pasta Itens Enviados, com exceção dos suplementos que são ativados baseados em cadeias de correspondências de entidades conhecidas. Para obter mais informações sobre os motivos por trás disso, consulte Suporte para entidades conhecidas.

Atualmente, há considerações adicionais ao projetar e implementar suplementos para clientes móveis. Para saber mais, confira Adicionar suporte para comandos de suplemento no Outlook em dispositivos móveis.

Itens de email protegidos pelo IRM

Os suplementos do Outlook são ativados em itens de email protegidos por IRM quando o item é acessado dos seguintes clientes com suporte.

  • Outlook no Windows a partir da versão 2009 (Build 13229.10000)

    Observação

    A assinatura digital depende de mecanismos de proteção, como IRM. Começando no Outlook na Versão 1711 do Windows (Build 8711.1000) associada a uma assinatura do Microsoft 365, os suplementos são ativados em mensagens assinadas digitalmente.

  • Outlook no Mac a partir da versão 16.77.827.0

  • Outlook na Web

  • novo Outlook no Windows (versão prévia)

No entanto, os suplementos não serão ativados em itens protegidos pelo IRM quando:

  • O item protegido pelo IRM é acessado do Outlook em dispositivos móveis.
  • O item protegido pelo IRM tem um rótulo de confidencialidade com a opção Permitir política personalizada de acesso programático definida como false. Para obter mais informações sobre opções de política personalizada, consulte Direitos de uso e descrições.

Clientes com suporte

Há suporte para suplementos do Outlook no Windows (clássico e novo (versão prévia),Outlook no Mac, Outlook na Web, Outlook no iOS, Outlook no Android e Outlook.com. Nem todos os recursos mais recentes têm suporte em todos os clientes ao mesmo tempo. Para obter detalhes sobre o suporte a recursos em clientes e servidores, confira Conjuntos de requisitos compatíveis com servidores do Exchange e clientes do Outlook e artigos específicos para esses recursos.

Introdução à criação de suplementos do Outlook

Para começar a construir suplementos do Outlook, tente o seguinte:

  • Início Rápido - Criar um painel de tarefas simples.
  • Tutorial : saiba como criar um suplemento que insere gists do GitHub em uma nova mensagem.

Confira também