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:

  • 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.The same add-in and business logic works across desktop (Outlook on Windows and Mac), web (Microsoft 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

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.If you plan to publish your add-in to AppSource and make it available within the Office experience, make sure that you conform to the Commercial marketplace certification policies.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). 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 1120.3 and the Office Add-in application 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

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

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.Outlook add-ins activate when the user is composing or reading a message or appointment, but not other item types. 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:However, add-ins are not activated 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.

    Importante

    • Os suplementos são ativados em mensagens assinadas digitalmente no Outlook associadas a uma assinatura do Microsoft 365.Add-ins activate on digitally signed messages in Outlook associated with a Microsoft 365 subscription. No Windows, esse suporte foi introduzido com a compilação 8711.1000.On Windows, this support was introduced with build 8711.1000.

    • A partir do Outlook, build 13229.10000, no Windows, os suplementos agora podem ser ativados nos itens protegidos por IRM.Starting with Outlook build 13229.10000 on Windows, add-ins can now activate on items protected by IRM. Para obter mais informações sobre esse recurso na visualização, consulte Ativação de suplementos em itens protegidos pela Gestão de Direitos de Informação (IRM).For more information about this feature in preview, see Add-in activation on items protected by Information Rights Management (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.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.

Clientes com suporteSupported clients

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 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 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 aplicativos eles podem ou não ter compatibilidade.Please refer to articles and API references for those features to see which applications 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