Compartilhar via


Visão geral dos suplementos do Outlook

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 três aspetos fundamentais.

  • O mesmo suplemento e lógica empresarial funcionam na Web (Microsoft 365 e Outlook.com), ambiente de trabalho (Outlook no Windows e 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 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 Web são executados no contexto de um controlo de browser ou webview num sandbox.

Importante

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. 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.

    Botões de comando do suplemento no friso.

  • 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.

    Importante

    Os suplementos contextuais do Outlook baseados em entidades serão descontinuados no 2.º trimestre de 2024. Os trabalhos para extinguir esta funcionalidade começarão em maio e continuarão até ao final de junho. Após junho, os suplementos contextuais deixarão de conseguir detetar entidades em itens de correio para realizar tarefas nos mesmos. As seguintes APIs também serão descontinuadas.

    Para ajudar a minimizar potenciais interrupções, o seguinte continuará a ser suportado depois de os suplementos contextuais baseados em entidades serem descontinuados.

    • Está a ser desenvolvida uma implementação alternativa do botão Participar , que é ativado por suplementos de reuniões online. Quando o suporte para suplementos contextuais baseados em entidades terminar, os suplementos de reunião online passarão automaticamente para a implementação alternativa para ativar o botão Participar . Durante a transição para esta implementação, o botão Participar pode não estar visível ao utilizar um suplemento de reunião online. Como solução, tem de selecionar a ligação da reunião no corpo do convite para reunião para participar diretamente na reunião.
    • As regras de expressão regular continuarão a ser suportadas depois de os suplementos contextuais baseados em entidades serem descontinuados. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Utilizar regras de ativação de expressões regulares para mostrar um suplemento do Outlook.

    Para obter mais informações, veja Descontinuação dos suplementos contextuais do Outlook baseados em entidades.

    É apresentado um cartão de suplemento contextual a partir de um endereço realçado numa mensagem.

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 Ativar 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.

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 subjacentes, veja Suporte para entidades conhecidas.

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 (pré-visualização)

  • 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 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.827.0

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 no Windows (clássico e novo (pré-visualização)), 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 de funcionalidades em clientes e servidores, veja Conjuntos de requisitos suportados por servidores Exchange e clientes do Outlook e artigos específicos dessas funcionalidades.

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