Lidar com eventos OnMessageSend e OnAppointmentSend no suplemento do Outlook com Alertas Inteligentes

Os OnMessageSend eventos and OnAppointmentSend tiram proveito dos Alertas Inteligentes, que permitem executar a lógica depois que um usuário seleciona Enviar sua mensagem ou compromisso do Outlook. Com os Alertas Inteligentes, os usuários do seu suplemento podem aproveitar a oportunidade para melhorar o conteúdo do email, adicionar um rótulo de confidencialidade ausente ou incluir um destinatário importante em um convite de reunião.

Os Alertas Inteligentes estão disponíveis por meio do recurso de ativação baseada em eventos. Para saber como configurar seu suplemento para usar esse recurso, usar outros eventos disponíveis, depurar seu suplemento e muito mais, consulte Ativar suplementos com eventos.

Observação

Os OnMessageSend eventos e OnAppointmentSend foram introduzidos no conjunto de requisitos 1.12. Funcionalidades adicionais e opções de personalização também foram adicionadas aos conjuntos de requisitos subsequentes. Para verificar se o cliente do Outlook dá suporte a esses eventos e recursos, confira Clientes e plataformas com suporte e as seções específicas no passo a passo que descrevem os recursos que você deseja implementar.

Clientes e plataformas com suporte

A tabela a seguir lista as combinações cliente-servidor com suporte para o recurso Alertas Inteligentes, incluindo a Atualização Cumulativa mínima necessária do Exchange Server, quando aplicável. Não há suporte para combinações excluídas.

Cliente	Exchange Online	Exchange Server Subscription Edition (SE)	Exchange 2019 local (Atualização Cumulativa 12 ou posterior)	Exchange 2016 local (Atualização Cumulativa 22 ou posterior)
Navegador da Web (interface do usuário moderna)	Sim	Não aplicável	Não aplicável	Não aplicável
novo Outlook no Windows	Sim	Não aplicável	Não aplicável	Não aplicável
Windows (clássico) Versão 2206 (Build 15330.20196) ou posterior	Sim	Sim	Sim	Sim
Mac Versão 16.65 (22082700) ou posterior	Sim	Não aplicável	Não aplicável	Não aplicável
Android	Não aplicável	Não aplicável	Não aplicável	Não aplicável
iOS	Não aplicável	Não aplicável	Não aplicável	Não aplicável

Importante

Aprimoramentos no recurso Alertas Inteligentes foram introduzidos em conjuntos de requisitos posteriores. Por isso, a versão e o build mínimos com suporte do Outlook podem variar. Os conjuntos de requisitos e as versões necessárias para um recurso são mencionados nas seções passo a passo e aplicáveis deste artigo.

Experimente os Alertas Inteligentes em um suplemento baseado em eventos

Para ver os Alertas Inteligentes em ação, experimente o passo a passo. Você criará um suplemento que verifica se um documento ou imagem está anexado a uma mensagem antes de ser enviada. Além de implementar um suplemento básico de Alertas Inteligentes, você também aprenderá sobre as seguintes funcionalidades para aprimorar ainda mais a experiência do usuário do seu suplemento.

• Personalizar a mensagem de diálogo de Alertas Inteligentes usando Markdown
• Personalizar o texto de um botão de diálogo
• Abrir um painel de tarefas ou executar uma função a partir da caixa de diálogo
• Substituir a opção de modo de envio em runtime
• Enviar programaticamente o item de email assim que ele atender às condições do suplemento

Comportamentos e cenários de recursos de Alertas Inteligentes

As seções a seguir incluem orientações sobre as opções do modo de envio e o comportamento do recurso em determinados cenários.

Opções de modo de envio disponíveis

Ao configurar seu suplemento para responder ao OnMessageSend evento or OnAppointmentSend , você deve incluir a propriedade send mode no manifesto. Sua marcação varia dependendo do tipo de manifesto que seu suplemento usa.

• Manifesto somente do suplemento: defina a propriedade SendMode do elemento LaunchEvent .
• Manifesto unificado para Microsoft 365: Defina a "sendMode" opção do objeto de evento na "autoRunEvents" matriz.

Se as condições implementadas pelo seu suplemento não forem atendidas ou se o suplemento não estiver disponível quando o evento ocorrer, uma caixa de diálogo será exibida para o usuário para alertá-lo de que ações adicionais podem ser necessárias antes que o item de email possa ser enviado. A propriedade do modo de envio determina as opções disponíveis para o usuário na caixa de diálogo.

A tabela a seguir lista as opções de modo de envio disponíveis.

Nome canônico da opção de modo de envio	Nome do manifesto somente do suplemento	Nome do manifesto unificado para o Microsoft 365
Solicitar ao usuário	PromptUser	promptUser
Bloco macio	SoftBlock	softBlock
bloquear	Block	bloquear

Dica

A partir do conjunto de requisitos de caixa de correio 1.14, seu suplemento agora pode substituir sua opção de modo de envio em tempo de execução. Para saber mais, consulte Substituir a opção de modo de envio em runtime (opcional).

Solicitar ao usuário

Se o item não atender às condições do suplemento, o usuário pode escolher Enviar Mesmo Assim no alerta ou resolver o problema e tentar enviar o item novamente. Se o suplemento estiver demorando muito para processar o item, o usuário será solicitado com a opção de parar de executar o suplemento e escolher Enviar Mesmo Assim. Caso o suplemento não esteja disponível (por exemplo, há um erro ao carregar o suplemento), o item será enviado.

Use a opção avisar usuário em seu suplemento se uma das seguintes opções se aplicar.

• A condição verificada pelo suplemento não é obrigatória, mas é bom ter na mensagem ou no compromisso que está sendo enviado.
• Você gostaria de recomendar uma ação e permitir que o usuário decida se deseja aplicá-la à mensagem ou ao compromisso que está sendo enviado.

Alguns cenários em que a opção de usuário de prompt é aplicada incluem sugerir a marcação da mensagem ou compromisso como de baixa ou alta importância e recomendar a aplicação de uma categoria de cores ao item.

Bloco macio

Opção padrão se a propriedade send mode do manifesto não estiver configurada. O usuário é alertado de que o item que está enviando não atende às condições do suplemento e ele deve resolver o problema antes de tentar enviar o item novamente. No entanto, se o suplemento não estiver disponível (por exemplo, se houver um erro ao carregar o suplemento), o item será enviado.

Use a opção de bloqueio flexível em seu suplemento quando quiser que uma condição seja atendida antes que uma mensagem ou compromisso possa ser enviado, mas não quiser que o usuário seja impedido de enviar o item se o suplemento não estiver disponível. Os cenários de exemplo em que a opção de bloqueio temporário é usada incluem solicitar que o usuário defina o nível de importância de uma mensagem ou compromisso e verificar se a assinatura apropriada é aplicada antes que o item seja enviado.

bloquear

O item não será enviado se qualquer uma das situações a seguir ocorrer.

• O item não atende às condições do suplemento.
• O suplemento não consegue se conectar ao servidor.
• Ocorreu um erro ao carregar o suplemento.

Use a opção de bloqueio se as condições do suplemento forem obrigatórias, mesmo que o suplemento não esteja disponível. Por exemplo, a opção de bloqueio é ideal quando é solicitado que os usuários apliquem um rótulo de confidencialidade a uma mensagem ou compromisso antes de enviá-lo.

A mensagem de erro personalizada não é especificada na chamada event.completed

Quando uma mensagem ou compromisso não atende às condições de um suplemento, uma caixa de diálogo de Alertas Inteligentes é mostrada para o usuário. Você pode personalizar a mensagem na caixa de diálogo especificando-a na propriedade errorMessage da chamada do event.completed suplemento. A propriedade do errorMessage é opcional. Se você não especificar uma mensagem personalizada na propriedade, a seguinte mensagem padrão será exibida: "<O nome> do suplemento está impedindo que este email seja enviado".

O suplemento não está disponível

Se o suplemento não estiver disponível quando uma mensagem ou compromisso estiver sendo enviado (por exemplo, ocorrerá um erro que impede o carregamento do suplemento), o usuário será alertado. As opções disponíveis para o usuário diferem dependendo da opção de modo de envio aplicada ao suplemento.

Se a opção de prompt user ou soft block for usada, o usuário poderá escolher Enviar Mesmo Assim para enviar o item sem que o suplemento o verifique ou Tentar Mais Tarde para permitir que o item seja verificado pelo suplemento quando ficar disponível novamente.

Se a opção de bloqueio for usada, o usuário não poderá enviar o item até que o suplemento esteja disponível.

Importante

Se um suplemento de Alertas inteligentes que implementa o recurso de substituição do modo de envio não puder concluir o processamento de um evento devido a um erro ou não estiver disponível quando o evento ocorrer, ele usará a opção de modo de envio especificada no manifesto.

Operações de suplemento de longa execução

Se o suplemento for executado por mais de cinco segundos, mas menos de cinco minutos, o usuário será alertado de que o suplemento está demorando mais do que o esperado para processar a mensagem ou o compromisso.

Se a opção de prompt de usuário for usada, o usuário poderá escolher Enviar Mesmo Assim para enviar o item sem que o suplemento conclua sua marcação. Como alternativa, o usuário pode selecionar Não enviar para interromper o processamento do suplemento.

No entanto, se a opção de bloqueio flexível ou bloqueio for usada, o usuário não poderá enviar o item até que o suplemento conclua seu processamento.

OnMessageSend e OnAppointmentSend os suplementos devem ser de curta duração e leves. Para evitar a caixa de diálogo de operação de longa duração, use outros eventos para processar verificações condicionais antes que o OnMessageSend evento ou OnAppointmentSend seja ativado. Por exemplo, se for necessário criptografar anexos para cada mensagem ou compromisso, considere usar o OnMessageAttachmentsChanged evento ou OnAppointmentAttachmentsChanged para executar a marcar.

O suplemento atingiu o tempo limite

Se o suplemento for executado por cinco minutos ou mais, o tempo limite será atingido. Se a opção de prompt de usuário for usada, o usuário poderá escolher Enviar Mesmo Assim para enviar o item sem que o suplemento conclua sua marcação. Como alternativa, o usuário pode escolher Não Enviar.

Se a opção de bloqueio flexível ou bloqueio for usada, o usuário não poderá enviar o item até que o suplemento conclua sua marca. O usuário deve tentar enviar o item novamente para reativar o suplemento.

Conexão intermitente ou sem conexão com a internet

Suplementos baseados em eventos, incluindo suplementos de Alertas Inteligentes, exigem uma conexão com a Internet para serem iniciados. Esta seção descreve como um suplemento se comporta quando o Outlook é iniciado sem conectividade, quando o Outlook experimenta conectividade intermitente e quando o modo Trabalhar Offline, se aplicável ao cliente Outlook, está ativado.

Offline quando o Outlook é iniciado

Quando o Outlook é iniciado sem conectividade com a Internet, não é possível determinar quais suplementos estão instalados. Por causa disso, os suplementos de Alertas Inteligentes não podem ser ativados quando ocorrem eventos OnMessageSend ou OnAppointmentSend . Nesse cenário, para garantir que todos os itens de email sejam verificados quanto à conformidade antes de serem enviados, os administradores podem configurar políticas em sua organização. A política a ser definida varia dependendo do cliente Outlook.

Web/Windows (novo)

Observação

Quando a política OnSendAddinsEnabled estiver habilitada, ela será aplicada a todos os suplementos instalados, não apenas aos suplementos de Alertas Inteligentes. Se a política estiver configurada e os suplementos instalados não forem carregados, o usuário não poderá enviar itens quando estiver offline. Os administradores só devem habilitar essa política para usuários em sua organização se eles tiverem suplementos obrigatórios de Alertas inteligentes instalados.

Para o Outlook na Web e o novo Outlook no Windows, configure a política de caixa de correio OnSendAddinsEnabled no Exchange Online PowerShell. Isso garante que os suplementos instalados sempre sejam executados em mensagens de saída enquanto estiver offline.

1. Conectar-se ao Exchange Online PowerShell.

2. Criar uma nova política de caixa de correio.

    New-OwaMailboxPolicy OWAOnSendAddinAllUserPolicy
   

   Observação

   Os administradores também podem usar uma política existente.

3. Defina o sinalizador OnSendAddinsEnabled como true.

    Get-OwaMailboxPolicy OWAOnSendAddinAllUserPolicy | Set-OwaMailboxPolicy -OnSendAddinsEnabled:$true
   

4. Atribua a política às caixas de correio dos usuários.

    Get-User -Filter {RecipientTypeDetails -eq 'UserMailbox'} | Set-CASMailbox -OwaMailboxPolicy OWAOnSendAddinAllUserPolicy
   

Quando a política OnSendAddinsEnabled está habilitada e um usuário tenta enviar uma mensagem sem conectividade, a mensagem é salva na pasta Rascunhos e uma caixa de diálogo é exibida notificando-os para se reconectarem.

Windows (clássico)

O Outlook no Windows (clássico) pode carregar e executar suplementos mesmo se o usuário iniciar o Outlook enquanto estiver offline. Para saber mais sobre o comportamento dos suplementos de Alertas inteligentes enquanto estiver offline, consulte Conexão intermitente.

Mac

Para o Outlook no Mac, a chave de caixa de correio OnSendAddinsWaitForLoad deve ser configurada no computador de cada usuário. Essa chave garante que os suplementos sejam carregados do Exchange e estejam disponíveis para executar verificações nos itens de saída. Como a chave OnSendAddinsWaitForLoad é compatível com CFPreference, ela pode ser definida por qualquer software de gerenciamento empresarial para Mac, como o Jamf Pro.

Observação

A OnSendAddinsWaitForLoad política se aplica a todos os suplementos instalados, não apenas aos suplementos de Alertas Inteligentes. Se a política estiver configurada e os suplementos instalados não forem carregados, o usuário não poderá enviar itens quando estiver offline. Os administradores só devem habilitar essa política para usuários em sua organização se eles tiverem suplementos obrigatórios de Alertas inteligentes instalados.

A tabela a seguir fornece detalhes sobre a chave.

Campo	Valor
Domínio	com.microsoft.outlook
Chave	OnSendAddinsWaitForLoad
DataType	Booliano
Valores possíveis	false (padrão): os manifestos baixados atualmente dos suplementos de Alertas inteligentes (não necessariamente as versões mais recentes) são executados em itens de email de saída. true: depois que os manifestos mais recentes dos suplementos de Alertas Inteligentes forem baixados do Exchange, os suplementos serão executados em itens de email de saída. Caso contrário, o item será bloqueado e o botão Enviar ficará indisponível.
Disponibilidade	16.27
Comentários	Essa chave cria uma política para garantir que os itens de email de saída sejam verificados quanto à conformidade antes de serem enviados.

Conexão intermitente

Observação

No Outlook clássico no Windows e no Mac, o comportamento de um suplemento de Alertas Inteligentes é diferente no modo Trabalhar Offline. Para obter mais informações, consulte Cliente Outlook no modo Trabalhar Offline.

Se o Outlook foi capaz de carregar qualquer suplemento de Alertas inteligentes instalados, mas perde a conexão quando ocorre um evento de envio, o comportamento é diferente dependendo da opção de modo de envio implementada pelo suplemento.

Se a opção de prompt user ou soft block for usada, o comportamento a seguir será aplicado.

• A opção Enviar Mesmo Assim está selecionada: A mensagem é movida para a pasta Caixa de Saída . Quando uma conexão é restabelecida, a mensagem é enviada automaticamente.
• A opção Não Enviar está selecionada: A mensagem é salva na pasta Rascunhos . Isso impede que a mensagem seja enviada automaticamente quando uma conexão é restabelecida. Quando o Outlook estiver online novamente e o usuário selecionar Enviar, o suplemento Alertas Inteligentes será ativado.

Se a opção de bloco for usada, a mensagem será salva na pasta Rascunhos e uma caixa de diálogo será exibida para o usuário notificando-o para se reconectar. Isso impede que a mensagem seja enviada automaticamente quando uma conexão é restabelecida. Quando o Outlook estiver online novamente e o usuário selecionar Enviar, o suplemento Alertas Inteligentes será ativado.

Cliente Outlook em modo Trabalhar Offline

No Outlook no Windows (cliente clássico a partir da Versão 2310 (Build 16913.10000)) e no Mac (a partir da Versão 16.80 (23121017)), um suplemento de Alertas Inteligentes que implementa o bloqueio flexível ou a opção de bloqueio só pode processar um item de email enquanto o cliente Outlook estiver online. Se o modo Trabalhar Offline estiver ativado no cliente Outlook quando um item de email for enviado, o item não será salvo na pasta Caixa de Saída e o usuário será alertado de que deve desativar o modo Trabalhar Offline antes de tentar enviar o item.

Se o suplemento Alertas inteligentes implementar a opção prompt ao usuário , ele não processará itens de email enquanto o modo Trabalhar Offline estiver ativado. Em vez disso, o item é salvo na pasta Caixa de Saída .

O usuário navega para sair da mensagem atual

Quando um usuário sai da mensagem que está enviando (por exemplo, para ler uma mensagem na caixa de entrada), o comportamento de um suplemento de Alertas Inteligentes é diferente entre os clientes do Outlook. Selecione a guia do cliente Outlook no qual o suplemento está sendo executado.

Web / Windows

Mensagem composta em uma janela

Observação

No Outlook clássico no Windows, o comportamento descrito nesta seção se aplica à versão 2402 (build 17310.10000) e posterior.

Se uma mensagem estiver sendo composta em uma janela separada, como uma nova mensagem, e um usuário sair dela depois de selecionar Enviar, o suplemento de Alertas Inteligentes continuará a processar a mensagem em segundo plano. Se forem necessárias ações adicionais antes que a mensagem possa ser enviada, a caixa de diálogo Smart Alerts apropriada será mostrada ao usuário (consulte Opções disponíveis do modo de envio).

Mensagem composta no Painel de Leitura

Se uma resposta, um encaminhamento ou um rascunho existente estiver sendo redigido no Painel de Leitura do Outlook e um usuário sair dele depois de selecionar Enviar, uma caixa de diálogo com opções será exibida para o usuário. As opções disponíveis dependem da opção de modo de envio implementada pelo suplemento.

Se a opção de modo de envio do prompt ao usuário for implementada, as opções a seguir serão mostradas.

• Aguardar: Essa opção abre a mensagem que está sendo composta em uma nova janela, para que o suplemento Alertas inteligentes possa continuar a processá-la. Se o usuário sair da janela recém-aberta durante o processamento, o suplemento continuará a processar a mensagem em segundo plano (para saber mais, consulte Mensagem composta em uma janela). Se ações adicionais forem necessárias antes que uma mensagem possa ser enviada, a caixa de diálogo Smart Alerts apropriada será exibida para o usuário.

• Enviar Mesmo assim: Essa opção encerra a operação do suplemento e envia a mensagem.

  Importante

  No Outlook na Web e no novo Outlook no Windows, a opção Enviar Mesmo Assim poderá não aparecer na caixa de diálogo de opção de item, mesmo que o suplemento em execução implemente a opção de modo de envio imediato para o usuário. Isso ocorre porque a opção Enviar Mesmo Assim será mostrada somente se todos os suplementos de Alertas inteligentes instalados implementarem a opção de modo de envio do prompt ao usuário . Caso contrário, somente as opções Aguardar e Salvar como rascunho serão exibidas. Isso ajuda a proporcionar uma experiência mais segura, já que vários suplementos de Alertas Inteligentes podem ser iniciados em qualquer ordem (para obter mais informações sobre esse comportamento, consulte Comportamento e limitações de ativação baseada em eventos).

• Salvar como Rascunho: essa opção encerra o suplemento e envia operações e salva um rascunho da mensagem na pasta Rascunhos da caixa de correio.

Outlook na Web e novo Outlook no Windows

Outlook clássico no Windows

Se a opção de bloco flexível ou modo de envio de bloco for implementada, somente as opções Aguardar e Salvar como rascunho serão mostradas.

Outlook na Web e novo Outlook no Windows

Outlook clássico no Windows

Mac

No Outlook no Mac, quando um usuário sai de uma mensagem depois de selecionar Enviar, o suplemento Alertas inteligentes continuará a processar o item em segundo plano. Se o item não atender às condições do suplemento, uma caixa de diálogo será mostrada ao usuário para alertá-lo de que ações adicionais podem ser necessárias antes que o item possa ser enviado. Por outro lado, se o item atender às condições do suplemento, o item será enviado assim que o suplemento concluir o processamento.

Ativar alertas inteligentes em aplicativos que usam MAPI simples

Observação

Atualmente, esse recurso só tem suporte no Outlook clássico no Windows a partir da versão 2301 (build 17126.20004).

Os usuários podem enviar itens de email por meio de determinados aplicativos que usam MAPI Simples, mesmo que o cliente Outlook não esteja em execução no momento em que o item é enviado. Quando isso ocorre, qualquer suplemento de Alertas Inteligentes instalado não é ativado para marcar a conformidade do item de email.

Para garantir que os itens de saída atendam às condições do seu suplemento de Alertas Inteligentes antes de serem enviados, você deve ativar a configuração Executando a Política de Grupo do Outlook para Envio de Email MAPI Simples em cada computador aplicável em sua organização.

Comportamento quando a configuração é ativada

Quando a configuração Executar o Outlook para Envio de Correio MAPI Simples está definida como Habilitada, os usuários precisam ter seu cliente Outlook em execução no momento em que um item de email é enviado nos cenários a seguir.

• Um arquivo é enviado como anexo por meio da opção Compartilhar>e anexar uma cópia em vez disso no Excel, no Word ou no PowerPoint.

  

• Um arquivo é enviado como anexo por meio da opção de destinatário Enviar para>Email no Explorador de Arquivos.

  

• Um arquivo é enviado por meio de um aplicativo que usa MAPI Simples, que abre uma nova janela de mensagem do Outlook.

Se o cliente Outlook de um usuário não estiver em execução no momento em que o item de email for enviado, uma caixa de diálogo será exibida para notificá-lo de que ele deve abrir o cliente para enviar o item.

Comportamento quando a configuração está desativada ou não configurada

Quando a configuração Executando o Outlook para Envio de Emails MAPI Simples estiver definida como Desabilitada ou Não Configurada em sua organização, qualquer usuário que use aplicativos que implementem MAPI Simples para enviar itens de email poderá fazer isso sem ativar seu suplemento de Alertas Inteligentes para verificações de conformidade.

Definir a configuração da Política de Grupo

Por padrão, a configuração Executando o Outlook para Envio de Correio MAPI Simples está definida como Não configurada. Para ativar a configuração, execute o seguinte:

1. Baixe a ferramenta de Modelos Administrativos mais recente.
2. Abra o Editor de Política de Grupo Local (gpedit.msc).
3. Navegue até Configuração do Usuário\Modelos Administrativos\Microsoft Outlook 2016\Diversos.
4. Abra a configuração Executando o Outlook para Envio de Email MAPI Simples .
5. Na caixa de diálogo exibida, selecione Habilitado.
6. Selecione OK ou Aplicar para salvar sua alteração.

Limitações

Como os OnMessageSend eventos and OnAppointmentSend têm suporte por meio do recurso de ativação baseada em eventos, as mesmas limitações de recursos se aplicam aos suplementos ativados como resultado desses eventos. Para obter uma descrição dessas limitações, consulte Comportamento e limitações de ativação baseada em evento.

Além dessas restrições, lembre-se do seguinte:

• Apenas uma instância de cada um dos OnMessageSend eventos and OnAppointmentSend pode ser declarada no manifesto. Se você precisar de vários OnMessageSend eventos OU OnAppointmentSend , deverá declarar cada um deles em um suplemento separado.

• A mensagem de diálogo de Alertas Inteligentes deve ter 500 caracteres ou menos. Embora você possa alterar a mensagem e certos aspectos de um botão na caixa de diálogo Alertas inteligentes, o seguinte não pode ser personalizado.

  • A barra de título da caixa de diálogo. O nome do seu suplemento é sempre exibido lá.
  • A fonte ou a cor da mensagem da caixa de diálogo. No entanto, você pode usar o Markdown para formatar determinados elementos da sua mensagem. Para obter uma lista de elementos com suporte, consulte Limitações para formatar a mensagem de diálogo usando Markdown.
  • O ícone ao lado da mensagem de diálogo.
  • Caixas de diálogo que fornecem informações sobre o processamento e o progresso do evento. Por exemplo, o texto e as opções que aparecem nas caixas de diálogo tempo limite e operação de longa duração não podem ser alterados.

• No Outlook na Web e no novo Outlook no Windows, o OnAppointmentSend evento ocorre somente quando uma reunião é enviada de uma janela separada. O evento não ocorre quando uma reunião é enviada de um formulário de reunião incorporado ou quando uma reunião é encaminhada.

Limitações para formatar a mensagem de diálogo usando Markdown

Observação

• O suporte para Markdown em uma caixa de diálogo de Alertas Inteligentes foi introduzido no conjunto de requisitos 1.15. Saiba mais sobre as plataformas e clientes com suporte.
• A errorMessageMarkdown opção da event.completed chamada está disponível para visualização no Outlook no Mac a partir da Versão 16.103 (Build 25102433). Para testar a propriedade, ingresse no programa Microsoft 365 Insider e selecione a opção Canal Beta para acessar as builds beta do Office.

Você pode usar Markdown event.completed para formatar a mensagem de uma caixa de diálogo de Alertas Inteligentes através da errorMessageMarkdown opção da chamada. No entanto, apenas os elementos a seguir são suportados.

• Negrito, itálico ou texto em negrito e itálico. Os formatos de asterisco (*) e sublinhado (_) são suportados.

  event.completed({
    allowEvent: false,
    ...
    errorMessageMarkdown: "**Important**: Apply the appropriate sensitivity label to your message before sending."
  });
  

  

• Listas com marcadores ou não ordenadas. Para criar um item na lista, comece com um traço (-) ou asterisco (*), adicione o conteúdo e anexe \r para significar a conclusão do item.

  event.completed({
    allowEvent: false,
    ...
    errorMessageMarkdown: "Your email doesn't meet company guidelines.\n\nFor additional assistance, contact the IT Service Desk:\n\n- Phone number: 425-555-0102\r- Email: it@contoso.com\r- Website: [Contoso IT Service Desk](https://www.contoso.com/it-service-desk)\r"
  });
  

  

• Listas numeradas ou ordenadas. Para criar um item na lista, comece com um número seguido por um ponto, adicione o conteúdo e anexe \r para significar a conclusão do item. O primeiro item da lista deve começar com o número um (1.) e os números seguintes devem estar em ordem numérica.

  event.completed({
    allowEvent: false,
    ...
    errorMessageMarkdown: "Help your recipients know your intentions when you send a mail item. To set the sensitivity level of an item:\n\n1. Select **File** > **Properties**.\r2. From the **Sensitivity** dropdown, select **Normal**, **Personal**, **Private**, or **Confidential**.\r3. Select **Close**.\r"
  });
  

  

• Ligações. Para criar um link, coloque o texto do link entre colchetes ([]) e, em seguida, coloque a URL HTTPS entre parênteses (()). Você deve fornecer uma URL HTTPS, caso contrário, ela não será renderizada como um link que um usuário pode selecionar na caixa de diálogo. Não há suporte para o formato de colchetes angulares (<>).

  event.completed({
    allowEvent: false,
    ...
    errorMessageMarkdown: "Need onsite assistance on the day of your meeting? Visit the [Contoso Facilities](https://www.contoso.com/facilities/meetings) page to learn more."
  });
  

  

• Novas linhas. Use \n\n para criar uma nova linha.

  event.completed({
    allowEvent: false,
    ...
    errorMessageMarkdown: "Add a personalized user avatar to your signature today!\n\nTo customize your signature, visit [Customize my email signature](https://www.fabrikam.com/marketing/customize-email-signature)."
  });
  

  

Dica

Para escapar caracteres em sua mensagem, como um asterisco, adicione uma barra invertida (\) antes do caractere.

Práticas recomendadas

O recurso Alertas Inteligentes garante que todos os itens de email de saída estejam em conformidade com as políticas de proteção de informações de uma organização e ajuda os usuários a melhorar suas mensagens por meio de recomendações. Para garantir que o suplemento sempre forneça aos usuários uma experiência de envio suave e eficiente, observe as diretrizes a seguir.

• Não deixe que seu suplemento atrase ainda mais a operação de envio. Os suplementos de Alertas inteligentes devem ser de curta duração e leves. Evite sobrecarregar os OnMessageSend manipuladores de eventos e OnAppointmentSend com validações pesadas. Para evitar isso, pré-processe as informações quando outros eventos ocorrerem, como o OnMessageRecipientsChanged evento ou OnMessageAttachmentsChanged . Para determinar a quais eventos seu suplemento pode responder, consulte a seção "Eventos com suporte" de Ativar suplementos com eventos.
• Não implemente caixas de diálogo adicionais. Evite sobrecarregar seus usuários com muitos diálogos. Em vez disso, personalize o texto na caixa de diálogo Alertas inteligentes para transmitir informações. Se necessário, você também pode personalizar o texto e a funcionalidade de determinados botões de diálogo para fornecer aos usuários informações e funcionalidades adicionais por meio de um painel de tarefas ou função.
• Habilite as configurações de Política de Grupo apropriadas em sua organização. Para garantir que seu suplemento de Alertas Inteligentes seja ativado em cada item de email, incluindo aqueles enviados usando aplicativos que implementam MAPI Simples, defina a configuração Executando o Outlook para Envio MAPI Simples . Para saber mais sobre essa configuração, consulte Ativar alertas inteligentes em aplicativos que usam MAPI Simples.

Depurar o suplemento

Para obter orientação sobre como solucionar problemas do suplemento Alertas Inteligentes, confira Solução de problemas de suplementos baseados em eventos e de relatórios de spam.

Implantar para usuários

Para obter orientações sobre como implantar seu suplemento de Alertas Inteligentes, consulte a seção "Implantar para usuários" em Ativar suplementos com eventos.

Importante

Os suplementos que usam o recurso Alertas inteligentes só poderão ser publicados no Microsoft Marketplace se a propriedade do modo de envio do manifesto estiver definida como bloqueio flexível ou opção de prompt de usuário . Se a propriedade do modo de envio de um suplemento estiver definida como bloqueado, ela só poderá ser implantada pelo administrador de uma organização, pois falhará na validação do Microsoft Marketplace. Para saber mais sobre como publicar seu suplemento baseado em evento no Microsoft Marketplace, consulte Opções de listagem do Microsoft Marketplace para seu suplemento baseado em evento.

Diferenças entre os Alertas Inteligentes e o recurso ao enviar

Embora os Alertas Inteligentes e o recurso de envio forneçam aos usuários a oportunidade de melhorar suas mensagens e convites de reunião antes de serem enviados, os Alertas Inteligentes são um recurso mais recente que oferece mais flexibilidade com a forma como você solicita aos usuários mais ações. As principais diferenças entre os dois recursos são descritas na tabela a seguir.

Atributo	Alertas inteligentes	Ao enviar
Requisito mínimo com suporte definido	Caixa de correio 1.12	Caixa de correio 1.8
Clientes do Outlook com suporte	Windows (novo e clássico) Navegador da Web (interface do usuário moderna) Mac (nova interface do usuário)	Windows (novo e clássico) Navegador da Web (interface do usuário moderna e clássica) Mac (interface do usuário nova e clássica)
Tipos de manifesto com suporte	Manifesto unificado para o Microsoft 365 Manifesto somente do suplemento	Manifesto somente do suplemento
Eventos com suporte	Manifesto somente do suplemento OnMessageSend OnAppointmentSend Manifesto unificado para o Microsoft 365 "messageSending" "appointmentSending"	ItemSend
Propriedade de extensão de manifesto	Manifesto somente do suplemento LaunchEvent Manifesto unificado para o Microsoft 365 "autoRunEvents"	Events
Opções de modo de envio com suporte	Solicitar ao usuário Bloco macio bloquear Para saber mais sobre cada opção, consulte Opções disponíveis do modo de envio.	Bloquear
Número máximo de eventos com suporte em um suplemento	Um OnMessageSend e um OnAppointmentSend evento.	Um ItemSend evento.
Implantação de suplemento	O suplemento poderá ser publicado no Microsoft Marketplace se a propriedade do modo de envio estiver definida como bloqueio flexível ou opção de prompt para o usuário . Caso contrário, o suplemento deverá ser implantado pelo administrador de uma organização.	O suplemento não pode ser publicado no Microsoft Marketplace. Ele deve ser implantado pelo administrador de uma organização.
Configuração adicional para instalação de suplemento	Nenhuma configuração adicional é necessária depois que o manifesto é carregado no Centro de administração do Microsoft 365.	Dependendo dos padrões de conformidade da organização e do cliente Outlook usado, determinadas políticas de caixa de correio devem ser configuradas para instalar o suplemento.

Confira também

• Ativar suplementos com eventos
• Opções de listagem do Microsoft Marketplace para seu suplemento baseado em evento
• Exemplo de código de Suplementos do Office: Exemplo de código de Suplementos do Office: Verifique as categorias de cores de uma mensagem ou compromisso antes de enviá-la usando Alertas Inteligentes
• Exemplo de código de suplementos do Office: Verificar o rótulo de confidencialidade de uma mensagem