Manipular eventos OnMessageSend e OnAppointmentSend no suplemento do Outlook com alertas inteligentes

Os OnMessageSend eventos e OnAppointmentSend aproveitam alertas inteligentes, o que permite que você execute a lógica depois que um usuário seleciona Enviar sua mensagem ou compromisso do Outlook. Com alertas inteligentes, os usuários do suplemento podem aproveitar a oportunidade para melhorar o conteúdo de seu 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 baseado em evento. Para entender como configurar o suplemento para usar esse recurso, use outros eventos disponíveis, depure seu suplemento e muito mais, consulte Configurar o suplemento do Outlook para ativação baseada em eventos.

Observação

Os OnMessageSend eventos e OnAppointmentSend foram introduzidos no conjunto de requisitos 1.12. Opções adicionais de funcionalidade e 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, consulte 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 combinações cliente-servidor com suporte para o recurso Alertas Inteligentes, incluindo o mínimo necessário Exchange Server Atualização Cumulativa, quando aplicável. Não há suporte para combinações excluídas.

Cliente	Exchange Online	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
novo Outlook no Windows (versão prévia)	Sim	Não aplicável	Não aplicável
Windows (clássico) Versão 2206 (Build 15330.20196) ou posterior	Sim	Sim	Sim
Mac Versão 16.65.827.0 ou posterior	Sim	Não aplicável	Não aplicável
Android	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

Comportamento e cenários de recursos de Alertas Inteligentes

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

Opções de modo de envio disponíveis

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

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

Se as condições implementadas pelo suplemento não forem atendidas ou seu suplemento não estiver disponível quando o evento ocorrer, uma caixa de diálogo será mostrada ao usuário para alertá-los de que ações adicionais podem ser necessárias antes que o item de email possa ser enviado. A propriedade 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 Enviar modo	Nome do manifesto XML	Manifesto unificado para o nome do Microsoft 365
usuário prompt	PromptUser	promptUser
bloco soft	SoftBlock	softBlock
Bloco	Block	Bloco

Dica

Começando no conjunto de requisitos da caixa de correio 1.14, seu suplemento agora pode substituir sua opção de modo de envio no runtime. Para saber mais, consulte Substituir a opção de modo de envio no runtime (opcional).

usuário prompt

Se o item não atender às condições do suplemento, o usuário poderá escolher Enviar De qualquer maneira 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 De qualquer maneira. No caso de o suplemento não estar disponível (por exemplo, há um erro no carregamento do suplemento), o item será enviado.

Use a opção de usuário prompt em seu suplemento se um dos seguintes se aplicar.

• A condição verificada pelo suplemento não é obrigatória, mas é bom ter na mensagem ou 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 prompt é aplicada incluem sugerir marcar a mensagem ou o compromisso como de baixa ou alta importância e recomendar a aplicação de uma categoria de cor ao item.

bloco soft

Opção padrão se a propriedade de modo de envio 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 deve resolver o problema antes de tentar enviar o item novamente. No entanto, se o suplemento não estiver disponível (por exemplo, há um erro no carregamento do suplemento), o item será enviado.

Use a opção de bloco macio no suplemento quando quiser que uma condição seja atendida antes que uma mensagem ou compromisso possa ser enviado, mas você não deseja que o usuário seja impedido de enviar o item se o suplemento não estiver disponível. Cenários de exemplo em que a opção de bloco macio é 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 do item ser enviado.

Bloco

O item não será enviado se alguma 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.
• Há um erro ao carregar o suplemento.

Use a opção de bloco se as condições do suplemento forem obrigatórias, mesmo que o suplemento não esteja disponível. Por exemplo, a opção de bloco é ideal quando os usuários são obrigados a aplicar um rótulo de confidencialidade a uma mensagem ou compromisso antes que ele possa ser 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 prompt user ou soft block for usada, o usuário poderá escolher Enviar De qualquer maneira para enviar o item sem que o suplemento o verifique ou Tente Posteriormente para permitir que o item seja verificado pelo suplemento quando ele ficar disponível novamente.

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

Importante

Se um suplemento 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 execução longa

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 usuário prompt for usada, o usuário poderá escolher Enviar De qualquer maneira para enviar o item sem que o suplemento conclua seu marcar. Como alternativa, o usuário pode selecionar Não Enviar para impedir o processamento do suplemento.

No entanto, se a opção soft block ou block for usada, o usuário não poderá enviar o item até que o suplemento conclua o processamento.

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

Tempo limite de complemento

Se o suplemento for executado por cinco minutos ou mais, ele terá um tempo limite. Se a opção de usuário prompt for usada, o usuário poderá escolher Enviar De qualquer maneira para enviar o item sem que o suplemento conclua seu marcar. Como alternativa, o usuário pode escolher Não Enviar.

Se a opção de bloco ou bloco macio for usada, o usuário não poderá enviar o item até que o suplemento conclua seu marcar. O usuário deve tentar enviar o item novamente para reativar o suplemento.

Cliente do Outlook no modo Offline do Trabalho

No Outlook no Windows (começando na versão 2310 (Build 16913.10000)), um suplemento alertas inteligentes que implementa a opção de bloco oubloco macio só pode processar um item de email enquanto o cliente do Outlook estiver online. Se o modo Offline do Trabalho estiver ativado no cliente do Outlook quando um item de email for enviado, o item não será salvo na pasta Outbox e o usuário será alertado de que deve desativar o modo Offline do Trabalho antes de tentar enviar o item.

No Outlook no Mac, a opção Enviar fica indisponível enquanto estiver no modo Offline do Trabalho. Depois que o modo Offline do Trabalho for desativado, o usuário poderá selecionar Enviar e ativar o suplemento Alertas Inteligentes.

O usuário navega para longe da mensagem atual

Quando um usuário navega para longe da mensagem que está enviando (por exemplo, para ler uma mensagem em sua caixa de entrada), o comportamento de um suplemento de Alertas Inteligentes difere entre os clientes do Outlook. Selecione a guia para o cliente do Outlook no qual o suplemento está em execução.

Web/Novo Outlook no Windows (versão prévia)

No Outlook na Web ou no novo Outlook no Windows (versão prévia), um usuário deve permanecer na mensagem que está sendo enviada até que o suplemento Alertas Inteligentes conclua o processamento. Caso contrário, depois que o usuário navega para longe do item, o suplemento encerra a operação Alertas Inteligentes e salva um rascunho na pasta Rascunhos da caixa de correio. Em seguida, o usuário é alertado de que deve reenviar a mensagem da pasta Rascunhos e permanecer na mensagem até que o suplemento conclua o processamento.

Windows (clássico)

Mensagem composta em uma janela

A partir da versão 2402 (Build 17310.10000), se uma mensagem estiver sendo composta em uma janela separada, como uma nova mensagem, e um usuário navegar para longe dela depois de selecionar Enviar, o suplemento Alertas Inteligentes continuará processando a mensagem em segundo plano. Se ações adicionais forem necessárias antes que a mensagem possa ser enviada, a caixa de diálogo Alertas Inteligentes apropriados será mostrada ao usuário (consulte Opções de modo de envio disponíveis).

Mensagem composta no Painel de Leitura

A partir da versão 2402 (Build 17310.10000), se uma resposta, encaminhamento ou rascunho existente estiver sendo composta no Painel de Leitura do Outlook, e um usuário navegar para longe dele depois de selecionar Enviar, uma caixa de diálogo com opções será mostrada ao 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 usuário prompt for implementada, as seguintes opções serão mostradas.

• Aguarde: 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 navegar para longe da janela recém-aberta durante o processamento, o suplemento continuará processando 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 Alertas Inteligentes apropriados será mostrada ao usuário.
• Enviar De qualquer maneira: essa opção encerra a operação de suplemento e envia a mensagem.
• Salvar como Rascunho: essa opção encerra o suplemento e envia operações e salva um rascunho da mensagem para a pasta Rascunhos da caixa de correio.

Se a opção de modo de envio de blocos oublocos for implementada, apenas as opções Esperar e Salvar como Rascunho serão mostradas.

Mac

No Outlook no Mac, quando um usuário navega para longe de uma mensagem após 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á-los 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 depois 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 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 do Outlook não esteja em execução no momento em que o item é enviado. Quando isso ocorrer, qualquer suplemento de Alertas Inteligentes instalado não será ativado para marcar o item de email para conformidade.

Para garantir que os itens de saída atendam às condições do suplemento Alertas Inteligentes antes de serem enviados, você deve ativar a configuração de Envio Política de Grupo de Emails mapi simples do Outlook para 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 Emails MAPI Simples é definida como Habilitada, os usuários são obrigados a ter seu cliente do Outlook em execução no momento em que um item de email é enviado nos cenários a seguir.

• Um arquivo é enviado como um anexo por meio da opção Compartilhar>Anexar uma cópia no Excel, Word ou PowerPoint.

  

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

  

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

Se o cliente do 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á mostrada para notificá-los de que ele deve abrir seu cliente para enviar o item.

Comportamento quando a configuração é desativada ou não configurada

Quando a configuração Executar o Outlook para Envio de Emails MAPI Simples estiver definida como Desabilitada ou Não Configurada em sua organização, qualquer usuário que usar aplicativos que implementem o MAPI Simples para enviar itens de email poderá fazê-lo sem ativar o suplemento alertas inteligentes para verificações de conformidade.

Configurar a configuração Política de Grupo

Por padrão, a configuração Executando o Outlook para Envio de Emails 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 Emails 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 e OnAppointmentSend têm suporte por meio do recurso de ativação baseado em evento, as mesmas limitações de recurso se aplicam a suplementos que são ativados como resultado desses eventos. Para obter uma descrição dessas limitações, consulte Comportamento e limitações de ativação baseados em eventos.

Além dessas restrições, apenas uma instância do OnMessageSend evento e OnAppointmentSend pode ser declarada no manifesto. Se você precisar de vários OnMessageSend eventos ou OnAppointmentSend , você deve declarar cada um em um suplemento separado.

Embora você possa alterar a mensagem de diálogo Alertas Inteligentes e o botão Não Enviar para se adequar ao cenário de suplemento, o seguinte não pode ser personalizado.

• A barra de título da caixa de diálogo. O nome do suplemento sempre é exibido lá.
• O formato da mensagem. Por exemplo, você não pode alterar o tamanho e a cor da fonte do texto ou inserir uma lista com marcadores.
• O ícone ao lado da mensagem de diálogo.
• Caixas de diálogo que fornecem informações sobre processamento e progresso de eventos. Por exemplo, o texto e as opções que aparecem nas caixas de diálogo de operação de tempo limite e de longa execução não podem ser alteradas.

Se você personalizar o botão Não Enviar na caixa de diálogo, só poderá atribuir um comando de painel de tarefas a ele. Não há suporte para comandos de função. Se você selecionar um botão Não Enviar com um comando de função atribuído, o comando será ignorado e o suplemento cancelará a operação de envio e fechará a caixa de diálogo. Quando isso ocorre, nenhum erro é mostrado ou registrado. Para obter diretrizes sobre os tipos de comandos de suplemento, consulte Tipos de comandos de suplemento.

Observação

O suporte para personalizar o botão Não Enviar foi introduzido no conjunto de requisitos da caixa de correio 1.14.

Em Outlook na Web e no novo Outlook no Windows (versão prévia):

• O OnAppointmentSend evento só ocorre quando a reunião que está sendo enviada foi criada por meio da opção Novo Evento . Se a reunião que está sendo enviada foi criada selecionando uma data e hora diretamente do calendário, o OnAppointmentSend evento não ocorrerá.
• Ao encaminhar uma reunião, o OnAppointmentSend evento só ocorrerá se o organizador encaminhar a reunião. Isso não ocorre se um participante encaminhar a reunião para a qual foi convidado.

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 execução curta e leve. Evite sobrecarregar os OnMessageSend manipuladores de eventos e OnAppointmentSend com validações pesadas. Para evitar isso, pré-processar informações quando outros eventos ocorrem, como o ou OnMessageAttachmentsChanged eventoOnMessageRecipientsChanged. Para determinar a quais eventos seu suplemento pode responder, consulte a seção "Eventos com suporte" de Configurar o suplemento do Outlook para ativação baseada em eventos.
• Não implemente caixas de diálogo adicionais. Evite sobrecarregar seus usuários com muitas caixas de diálogo. 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 botão Não Enviar para fornecer aos usuários informações e funcionalidades adicionais por meio de um painel de tarefas.
• Habilite as configurações de Política de Grupo apropriadas em sua organização. Para garantir que o suplemento Alertas Inteligentes seja ativado em cada item de email, incluindo aqueles enviados usando aplicativos que implementam o MAPI Simples, configure a configuração Executando o Outlook para Envio DE MAPI Simples . Para saber mais sobre essa configuração, consulte Ativar alertas inteligentes em aplicativos que usam MAPI Simples.

Depurar o suplemento

Para obter diretrizes sobre como solucionar problemas do suplemento alertas inteligentes, confira Solucionar problemas de suplementos baseados em eventos e de relatório de spam.

Implantar em usuários

Semelhante a outros suplementos baseados em eventos, os suplementos que usam o recurso Alertas Inteligentes devem ser implantados pelo administrador de uma organização. Para obter diretrizes sobre como implantar seu suplemento por meio do Centro de administração do Microsoft 365, consulte a seção "Implantar para usuários" em Configurar seu suplemento do Outlook para ativação baseada em eventos.

Importante

Os suplementos que usam o recurso Alertas Inteligentes só poderão ser publicados no AppSource se a propriedade de modo de envio do manifesto estiver definida como a opção de usuário soft block ou prompt . Se a propriedade de modo de envio de um suplemento estiver definida como bloqueada, ela só poderá ser implantada pelo administrador de uma organização, pois falhará na validação do AppSource. Para saber mais sobre como publicar seu suplemento baseado em evento no AppSource, confira Opções de listagem do AppSource para seu suplemento do Outlook baseado em eventos.

Diferenças entre alertas inteligentes e o recurso de envio

Embora alertas inteligentes e o recurso de envio forneçam aos seus usuários a oportunidade de melhorar suas mensagens e convites de reunião antes de serem enviados, 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	Em envio
Conjunto de requisitos com suporte mínimo	Caixa de correio 1.12	Caixa de correio 1.8
Clientes do Outlook com suporte	Windows (clássico e novo (versão prévia)) Navegador da Web (interface do usuário moderna) Mac (nova interface do usuário)	Windows (clássico) Navegador da Web (interface do usuário clássica e moderna) Mac (interface do usuário clássica e nova)
Eventos com suporte	Manifesto XML OnMessageSend OnAppointmentSend Manifesto unificado para o Microsoft 365 (versão prévia) "messageSending" "appointmentSending"	Manifesto XML ItemSend Manifesto unificado para o Microsoft 365 (versão prévia) Sem suporte
Propriedade de extensão manifest	Manifesto XML LaunchEvent Manifesto unificado para o Microsoft 365 (versão prévia) "autoRunEvents"	Manifesto XML Events Manifesto unificado para o Microsoft 365 (versão prévia) Sem suporte
Opções de modo de envio com suporte	usuário prompt bloco soft Bloco Para saber mais sobre cada opção, consulte Opções de modo de envio disponíveis.	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 AppSource se sua propriedade de modo de envio estiver definida como a opção de usuáriosoft block ou prompt. Caso contrário, o suplemento deve ser implantado pelo administrador de uma organização.	O suplemento não pode ser publicado no AppSource. 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 do Outlook usado, determinadas políticas de caixa de correio devem ser configuradas para instalar o suplemento.

Experimentar alertas inteligentes em um suplemento baseado em evento

Pronto para implementar alertas inteligentes em um suplemento baseado em evento? Experimente o passo a passo em que você criará um suplemento que verifica se um documento ou imagem está anexado a uma mensagem antes de ser enviada.

Confira também

• Manipular eventos OnMessageSend e OnAppointmentSend no suplemento do Outlook com alertas inteligentes
• Configurar o suplemento do Outlook para ativação baseada em eventos
• Opções de listagem do AppSource para seu suplemento do Outlook 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 ser enviado usando alertas inteligentes
• Exemplo de código de suplementos do Office: verifique o rótulo de confidencialidade de uma mensagem