Visão geral dos suplementos do Outlook

Os suplementos do Outlook são soluções que estendem a funcionalidade do cliente Outlook por meio de uma plataforma baseada na Web. Os suplementos do Outlook têm os seguintes aspectos principais.

  • O mesmo suplemento e lógica de negócios funcionam na Web (Microsoft 365 e Outlook.com), área de trabalho (Outlook no Windows (novo e clássico) e no Mac) e 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, um painel de tarefas ou um evento). Ele também inclui o código JavaScript e HTML, que compõem a interface do usuário e a lógica de negócios do suplemento.
  • Os suplementos do Outlook podem ser adquiridos no Microsoft Marketplace ou carregados em sideload por usuários finais ou administradores.
  • Os suplementos do Outlook exigem uma conexão de rede para serem executados.

Suplementos COM ou VSTO versus suplementos da Web do Outlook

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 navegador ou controle de modo de exibição da Web em uma área restrita.

Importante

  • Não há suporte para suplementos COM e VSTO no novo Outlook no Windows. No entanto, esses suplementos ainda têm suporte no cliente de área de trabalho clássico do Outlook no Windows. Para saber mais, confira Desenvolver suplementos do Outlook para o novo Outlook no Windows.

  • No Outlook clássico no Windows, não é recomendável instalar suplementos COM junto com os suplementos da Web do Office, especialmente se eles operam na mesma superfície ou no mesmo item de email. As operações executadas pelo COM e suplementos da Web podem interferir umas nas outras e levar a um comportamento inesperado. Se você precisar dar suporte a ambas as versões COM e suplemento da Web da sua solução, deverá especificar a solução COM como um suplemento equivalente. Para saber mais, confira Tornar seu suplemento do Office compatível com um suplemento COM ou VSTO existente.

Clientes com suporte

Os suplementos do Outlook têm suporte no Outlook na Web, Outlook no Windows (novo e clássico), Outlook no Mac, 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, consulte Conjuntos de requisitos compatíveis com servidores Exchange e clientes Outlook e artigos específicos para esses recursos.

Contas com suporte

Em clientes Outlook com suporte, os suplementos podem ser executados em contas de caixa de correio Outlook.com (consumidor ou pessoal) e Microsoft 365 business. Para obter mais informações sobre contas Microsoft, consulte Qual é a diferença entre uma conta Microsoft e uma conta corporativa ou de estudante?.

Embora contas de caixa de correio que não são da Microsoft, como Gmail e Yahoo Mail, possam ser adicionadas a determinados clientes do Outlook, nem sempre há suporte para suplementos do Outlook nessas contas. A tabela a seguir descreve o suporte a suplementos em contas que não são da Microsoft para cada cliente Outlook.

Cliente Outlook Suporte a suplementos em contas não Microsoft
Web Sem suporte.
novo Outlook no Windows Sem suporte.
Outlook clássico no Windows Sem suporte.
Mac
  • Se uma conta não Microsoft foi adicionada usando a opção IMAP CloudCache, os suplementos serão suportados.
  • Se uma conta não Microsoft tiver sido adicionada usando a opção IMAP Direct, não haverá suporte para suplementos.
Dispositivo móvel (Android e iOS) Sem suporte.

Ao usar contas que não são da Microsoft que dão suporte a suplementos no Outlook, observe que você deve primeiro selecionar uma pasta ou item na caixa de correio que não seja da Microsoft para carregar o suplemento.

Ativação e compatibilidade de suplementos

Um suplemento define como ele se integra ao Outlook e o contexto em que está disponível, incluindo os tipos de itens de email e os modos do Outlook (ler ou redigir).

Pontos de extensão

Os pontos de extensão definem onde um suplemento se integra ao Outlook. Os suplementos podem ser ativados e executados em mensagens e compromissos no modo de leitura e redação. Veja a seguir cenários específicos.

  • Redigindo uma nova mensagem, solicitação de reunião ou compromisso.
  • Exibir uma mensagem, solicitação de reunião, resposta de reunião ou cancelamento de reunião.
  • Exibição ou edição de compromisso existente, ou item de reunião no qual o usuário seja o organizador.
  • Exibindo um item de reunião do qual o usuário é um participante.
  • Redigindo uma mensagem de resposta embutida ou respondendo a uma mensagem em uma janela separada.
  • Edição de uma resposta (Aceitar, Provisório ou Recusar) a uma solicitação de reunião ou a um item de reunião.
  • Proposição de novo horário para um item de reunião.
  • Encaminhamento ou resposta a uma solicitação de reunião ou a um item de reunião.

Observação

Os suplementos que interagem com o calendário, as reuniões ou os compromissos do usuário estarão disponíveis somente se o usuário abrir o calendário no Outlook, não no Teams. No entanto, você pode criar um aplicativo de reunião do Teams e exibi-lo no Outlook. Para obter mais informações, consulte Estender um aplicativo de reunião do Teams para o Outlook.

Métodos de integração

Os suplementos podem se integrar ao Outlook das seguintes maneiras.

  • Os suplementos podem declarar botões que aparecem nas superfícies de comando em mensagens e compromissos. Os botões do suplemento podem abrir um painel de tarefas ou executar uma função. Para obter mais informações, consulte Comandos de suplemento.

    Botões de comando do suplemento na faixa de opções.

  • Os suplementos podem executar tarefas quando ocorre um evento específico. Para obter mais informações, consulte Ativar suplementos com eventos.

  • Os suplementos podem ser invocados a partir de uma mensagem acionável.

  • Os suplementos podem vincular correspondências de expressões regulares em mensagens e compromissos. Para saber mais, confira Suplementos contextuais do Outlook.

    Importante

    Os suplementos contextuais do Outlook baseados em entidades foram desativados. Como solução alternativa, implemente regras de expressão regular no suplemento contextual. Para obter orientação sobre como implementar essas regras, consulte Suplementos contextuais do Outlook.

Limitações de ativação do suplemento

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 Gerenciamento de Direitos de Informação (IRM) ou criptografado de outras formas para proteção e acessado pelo 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 em suplementos do Outlook, consulte Itens de email protegidos pelo IRM.

  • Um item de email protegido por IRM com um rótulo de confidencialidade que tem a opção de política personalizada Permitir acesso programático definida como false. Para saber mais sobre o suporte ao IRM em suplementos do Outlook, consulte 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 morto ou em uma pasta pública.

    Importante

    * O suporte para cenários de acesso de representante (por exemplo, pastas compartilhadas da caixa de correio de outro usuário) foi introduzido no conjunto de requisitos 1.8, enquanto o suporte à caixa de correio compartilhada foi introduzido no conjunto de requisitos 1.13. Para saber mais, consulte Implementar 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.

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.

Enviar 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 na Web

  • Novo Outlook no Windows

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

    Observação

    A assinatura digital depende de mecanismos de proteção, como o IRM. A partir do Outlook clássico no Windows Versão 1711 (build 8711.1000) associado 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 (23082700)

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

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

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

  • Last updated on