Visão geral dos suplementos do Outlook

2025-07-02

Os suplementos do Outlook são soluções que expandem a funcionalidade do cliente do Outlook através de uma plataforma baseada na Web. Os suplementos do Outlook têm os seguintes aspetos principais.

O mesmo suplemento e lógica empresarial funcionam na Web (Microsoft 365 e Outlook.com), ambiente de trabalho (Outlook no Windows (novo e clássico) e no Mac) e em dispositivos móveis.
Os suplementos do Outlook consistem num manifesto, que descreve como o suplemento se integra no Outlook (por exemplo, um botão, painel de tarefas ou evento). Também inclui código JavaScript e HTML, que compõem a IU e a lógica de negócio do suplemento.
Os suplementos do Outlook podem ser adquiridos no AppSource ou sideload por utilizadores finais ou administradores.
Os suplementos do Outlook requerem a execução de uma ligação de rede.

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 Web são executados no contexto de um controlo de browser ou webview num sandbox.

Importante

Os suplementos COM e VSTO não são suportados no novo Outlook no Windows. No entanto, estes suplementos continuam a ser suportados no cliente de ambiente de trabalho clássico do Outlook no Windows. Para saber mais, consulte Desenvolver suplementos do Outlook para o novo Outlook no Windows.
No Outlook clássico no Windows, não é recomendado instalar suplementos COM juntamente com suplementos Web do Office, especialmente se funcionarem na mesma superfície ou item de correio. As operações realizadas pelos suplementos COM e Web podem interferir entre si e levar a um comportamento inesperado. Se precisar de suportar as versões dos suplementos COM e Web da sua solução, tem de especificar a solução COM como um suplemento equivalente. Para saber mais, consulte Tornar o seu Suplemento do Office compatível com um suplemento COM existente.

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

Os suplementos que interagem com o calendário, reuniões ou compromissos do utilizador só estão disponíveis se o utilizador abrir o calendário no Outlook e não no Teams. No entanto, pode criar uma aplicação de reunião do Teams e superá-la no Outlook. Para obter mais informações, consulte Expandir uma aplicação de reunião do Teams para o Outlook.

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. Seguem-se as formas como isto pode ser feito.

Os suplementos podem declarar botões que aparecem nas superfícies de comando em mensagens e compromissos. Para obter mais informações, veja Comandos de suplementos.
Os suplementos podem ligar correspondências de expressão regulares em mensagens e compromissos. Para saber mais, confira Suplementos contextuais do Outlook.

Importante

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. Como solução alternativa, implemente regras de expressão regulares no seu suplemento contextual. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.
Os suplementos podem executar tarefas quando ocorre um evento específico. Para obter mais informações, veja Configurar o suplemento do Outlook para ativação baseada em eventos.

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 pela Gestão de Direitos de Informação (IRM) ou encriptado de outras formas para proteção e acesso a partir do Outlook em dispositivos móveis. Uma mensagem assinada digitalmente é um exemplo, uma vez que a assinatura digital depende de um destes mecanismos. Para saber mais sobre o suporte de IRM nos suplementos do Outlook, consulte Mail items protected by IRM (Itens de correio protegidos por IRM).
Um item de correio protegido por IRM com uma etiqueta de confidencialidade que tem a opção de política personalizada Permitir acesso programático definida como false. Para saber mais sobre o suporte de IRM nos suplementos do Outlook, consulte Mail items protected by IRM (Itens de correio protegidos por 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.
Numa caixa de correio de grupo, numa caixa de correio partilhada*, na caixa de correio de outro utilizador*, numa caixa de correio de arquivo ou numa pasta pública.

Importante

* O suporte para cenários de acesso delegado (por exemplo, pastas partilhadas a partir da caixa de correio de outro utilizador) foi introduzido no conjunto de requisitos 1.8, enquanto o suporte de caixa de correio partilhada foi introduzido no conjunto de requisitos 1.13. Para saber mais, consulte Implementar pastas partilhadas e cenários de caixa de correio partilhada.
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, consulte Adicionar suporte para comandos de suplementos no Outlook em dispositivos móveis.

Itens de correio protegidos por IRM

Os suplementos do Outlook são ativados em itens de correio protegidos por IRM quando o item é acedido a partir dos seguintes clientes suportados.

Outlook na Web
Novo Outlook no Windows
Outlook Clássico no Windows a partir da Versão 2009 (Compilação 13229.10000)

Observação

A assinatura digital baseia-se em mecanismos de proteção, como a IRM. A partir do Outlook clássico no Windows Versão 1711 (Compilação 8711.1000) associada a uma subscrição do Microsoft 365, os suplementos são ativados em mensagens assinadas digitalmente.
Outlook para 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 é acedido a partir do Outlook em dispositivos móveis.
O item protegido por IRM tem uma etiqueta de confidencialidade com a opção de política personalizada Permitir acesso programático definida como false. Para obter mais informações sobre as opções de política personalizada, veja Direitos de utilização e descrições.

Clientes com suporte

Os suplementos do Outlook são suportados no Outlook na Web, Outlook no Windows (novo e clássico), Outlook para Mac, Outlook para iOS, Outlook para 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 de funcionalidades em clientes e servidores, veja Conjuntos de requisitos suportados por servidores Exchange e clientes do Outlook e artigos específicos dessas funcionalidades.

Contas suportadas

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

Embora as contas de caixa de correio que não sejam da Microsoft, como o Gmail e o Yahoo Mail, possam ser adicionadas a determinados clientes do Outlook, os suplementos do Outlook nem sempre são suportados nestas contas. A tabela seguinte descreve o suporte de suplementos em contas não Microsoft para cada cliente do Outlook.

Cliente Outlook	Suporte de 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 tiver sido adicionada com a opção IMAP CloudCache, os suplementos são suportados. Se uma conta não Microsoft tiver sido adicionada com a opção IMAP Direct, os suplementos não são suportados.
Dispositivos móveis (Android e iOS)	Sem suporte.

Ao utilizar contas que não sejam da Microsoft que suportam suplementos no Outlook, tenha em atenção que primeiro tem de selecionar uma pasta ou item na caixa de correio que não seja da Microsoft para carregar o suplemento.

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.

Compartilhar via