Visão geral dos suplementos do OutlookOutlook add-ins overview

Os suplementos do Outlook são integrações criadas por terceiros para o Outlook usando nossa plataforma baseada na Web.Outlook add-ins are integrations built by third parties into Outlook by using our web-based platform. Os suplementos do Outlook têm três aspectos principais:Outlook add-ins have three key aspects:

  • A mesma lógica de suplemento e de negócios funciona na área de trabalho (Outlook no Windows e Mac), na Web (Office 365 e Outlook.com) e em dispositivos móveis.The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Office 365 and Outlook.com), and mobile.
  • 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.Outlook add-ins consist of a manifest, which describes how the add-in integrates into Outlook (for example, a button or a task pane), and JavaScript/HTML code, which makes up the UI and business logic of the add-in.
  • Os suplementos do Outlook podem ser adquiridos na AppSource ou sideloaded por usuários finais ou administradores.Outlook add-ins can be acquired from AppSource or sideloaded by end-users or administrators.

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.Outlook add-ins are different from COM or VSTO add-ins, which are older integrations specific to Outlook running on 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.Unlike COM add-ins, Outlook add-ins don't have any code physically installed on the user's device or Outlook client. 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.For an Outlook add-in, Outlook reads the manifest and hooks up the specified controls in the UI, and then loads the JavaScript and HTML. Todos os componentes Web são executados no contexto do navegador em uma área restrita.The web components all run in the context of a browser in a sandbox.

Os itens do Outlook que dão suporte a suplementos incluem mensagens de email, compromissos, solicitações, respostas e cancelamentos de reunião.The Outlook items that support add-ins include email messages, meeting requests, responses and cancellations, and appointments. 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.Each Outlook add-in defines the context in which it is available, including the types of items and if the user is reading or composing an item.

Observação

Caso pretenda publicar o suplemento no AppSource depois de criá-lo, verifique se você está em conformidade com as Políticas de validação do AppSource. Por exemplo, para passar na validação, seu suplemento deve funcionar em todas as plataformas com suporte aos métodos que você definir (para mais informações, confira a seção 4.12 e a Página de hospedagem e disponibilidade do suplemento do Office).When you build your add-in, if you plan to publish your add-in to AppSource, make sure that you conform to the AppSource validation policies. For example, to pass validation, your add-in must work across all platforms that support the methods that you define (for more information, see section 4.12 and the Office Add-in host and availability page).

Pontos de extensãoExtension points

Pontos de extensão são as formas usadas pelos suplementos para se integrar ao Outlook. Estas são as maneiras de fazer isso:Extension points are the ways that add-ins integrate with Outlook. The following are the ways this can be done:

  • Os suplementos podem declarar botões que aparecem nas superfícies de comando em mensagens e compromissos. Para saber mais, confira Comandos de suplemento para o Outlook.Add-ins can declare buttons that appear in command surfaces across messages and appointments. For more information, see Add-in commands for Outlook.

    Suplemento com botões de comando na Faixa de OpçõesAn add-in with command buttons on the ribbon

    Comando de suplemento de forma sem interface do usuário

  • Os suplementos podem desvincular correspondências de expressões regulares ou entidades detectadas em mensagens e compromissos. Para saber mais, confira Suplementos contextuais do Outlook.Add-ins can link off regular expression matches or detected entities in messages and appointments. For more information, see Contextual Outlook add-ins.

    Suplemento contextual para uma entidade realçada (um endereço)A contextual add-in for a highlighted entity (an address)

    Mostra um aplicativo contextual em um cartão

Observação

Os painéis personalizados foram preteridos, portanto certifique-se de que você está usando um ponto de extensão com suporte.Custom panes have been deprecated so please ensure that you're using a supported extension point.

Itens de caixa de correio disponíveis para suplementosMailbox items available to add-ins

Os suplementos do Outlook estão disponíveis nas mensagens ou compromissos durante a redação ou leitura, mas não em outros tipos de itens. O Outlook não ativa os suplementos se o item de mensagem atual, em um formato de redação ou de leitura, estiver em uma das seguintes situações:Outlook add-ins are available on messages or appointments while composing or reading, but not other item types. Outlook does not activate add-ins if the current message item, in a compose or read form, is one of the following:

  • Protegido por IRM (Gerenciamento de Direitos de Informação) ou criptografado de outras maneiras para proteção. Uma mensagem assinada digitalmente é um exemplo, já que a assinatura digital se baseia em um desses mecanismos.Protected by Information Rights Management (IRM) or encrypted in other ways for protection. A digitally signed message is an example since digital signing relies on one of these mechanisms.

  • 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.A delivery report or notification that has the message class IPM.Report.*, including delivery and Non-Delivery Report (NDR) reports, and read, non-read, and delay notifications.

  • Um rascunho (não tem um remetente atribuído a ele) ou está na pasta Rascunhos do Outlook.A draft (does not have a sender assigned to it), or in the Outlook Drafts folder.

  • Um arquivo .msg que é um anexo de outra mensagem.A .msg or .eml file which is an attachment to another message.

  • Um arquivo .msg aberto no sistema de arquivos.A .msg or .eml file opened from the file system.

  • 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.In a shared mailbox, in another user's mailbox, in an archive mailbox, or in a public folder.

  • Usando um formulário personalizado.Using a custom form.

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.In general, Outlook can activate add-ins in read form for items in the Sent Items folder, with the exception of add-ins that activate based on string matches of well-known entities. Para saber mais sobre os motivos por trás disso, confira "Suporte para entidades conhecidas" em Corresponder cadeias em um item do Outlook como entidades conhecidas.For more information about the reasons behind this, see "Support for well-known entities" in Match strings in an Outlook item as well-known entities.

Hosts compatíveisSupported hosts

Suplementos do Outlook são compatíveis com o Outlook 2013 ou posterior no Windows, Outlook 2016 ou posterior no Mac, Outlook na Web para Exchange 2013 no local e versões posteriores, Outlook no iOS, Outlook no Android e Outlook na Web no Office 365 e Outlook.com.Outlook add-ins are supported in Outlook 2013 or later on Windows, Outlook 2016 or later on Mac, Outlook on the web for Exchange 2013 on-premises and later versions, Outlook on iOS, Outlook on Android, and Outlook on the web in Office 365 and Outlook.com. Nem todos os recursos mais recentes são compatíveis com todos os clientes ao mesmo tempo.Not all of the newest features are supported in all clients at the same time. Confira os artigos e as referências de API para esses recursos e saiba com quais hosts eles podem ou não ter compatibilidade.Please refer to articles and API references for those features to see which hosts they may or may not be supported in.

Introdução à criação de suplementos do OutlookGet started building Outlook add-ins

Para começar a criar suplementos do Outlook, experimente o seguinte.To get started building Outlook add-ins, try the following.

  • Início Rápido - Criar um painel de tarefas simples.Quick start - Build a simple task pane.
  • Tutorial : saiba como criar um suplemento que insere gists do GitHub em uma nova mensagem.Tutorial - Learn how to create an add-in that inserts GitHub gists into a new message.

Confira tambémSee also