Processar eventos OnMessageSend e OnAppointmentSend no seu suplemento do Outlook com Alertas Inteligentes

Os OnMessageSend eventos e OnAppointmentSend tiram partido dos Alertas Inteligentes, o que lhe permite executar lógica depois de um utilizador selecionar Enviar na mensagem ou compromisso do Outlook. Com os Alertas Inteligentes, os utilizadores do seu suplemento podem aproveitar a oportunidade para melhorar o conteúdo do respetivo e-mail, adicionar uma etiqueta de confidencialidade em falta ou incluir um destinatário importante num convite para reunião.

Os Alertas Inteligentes estão disponíveis através da funcionalidade de ativação baseada em eventos. Para compreender como configurar o suplemento para utilizar esta funcionalidade, utilize outros eventos disponíveis, depure o seu suplemento e muito mais, consulte Configurar o suplemento do Outlook para ativação baseada em eventos.

Clientes e plataformas suportados

A tabela seguinte lista as combinações de cliente/servidor suportadas para a funcionalidade Alertas Inteligentes, incluindo o mínimo necessário Exchange Server Atualização Cumulativa, quando aplicável. As combinações excluídas não são suportadas.

Experimentar Alertas Inteligentes num suplemento baseado em eventos

Para ver Os Alertas Inteligentes em ação, experimente as instruções. Irá criar um suplemento que verifica se um documento ou imagem está anexado a uma mensagem antes de ser enviado.

Cenários e comportamento de funcionalidades de Alertas Inteligentes

As secções seguintes incluem orientações sobre as opções de modo de envio e o comportamento da funcionalidade em determinados cenários.

Opções de modo de envio disponíveis

Quando configurar o suplemento para responder ao OnMessageSend evento ou OnAppointmentSend , tem de incluir a propriedade modo de envio no manifesto. A marcação varia consoante o tipo de manifesto utilizado pelo suplemento.

• Manifesto apenas de suplemento: 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 cumpridas ou se o suplemento não estiver disponível quando o evento ocorrer, será apresentada uma caixa de diálogo ao utilizador para alertá-lo de que poderão ser necessárias ações adicionais antes de o item de correio poder ser enviado. A propriedade modo de envio determina as opções disponíveis para o utilizador na caixa de diálogo.

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

pedir ao utilizador

Se o item não cumprir as condições do suplemento, o utilizador pode selecionar Enviar Mesmo Assim no alerta ou resolver o problema e, em seguida, tentar enviar o item novamente. Se o suplemento estiver a demorar muito tempo a processar o item, será pedido ao utilizador que pare de executar o suplemento e selecione Enviar Mesmo Assim. Caso o suplemento não esteja disponível (por exemplo, se ocorrer um erro ao carregar o suplemento), o item será enviado.

Utilize a opção de utilizador de pedido no seu suplemento se se aplicar uma das seguintes opções.

• A condição verificada pelo suplemento não é obrigatória, mas é bom ter na mensagem ou compromisso que está a ser enviado.
• Gostaria de recomendar uma ação e permitir que o utilizador decida se pretende aplicá-la à mensagem ou compromisso que está a ser enviado.

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

bloco suave

Opção predefinida se a propriedade de modo de envio do manifesto não estiver configurada. O utilizador é alertado de que o item que está a enviar não cumpre as condições do suplemento e tem de resolver o problema antes de tentar enviar o item novamente. No entanto, se o suplemento não estiver disponível (por exemplo, se ocorrer um erro ao carregar o suplemento), o item será enviado.

Utilize a opção de bloqueio suave no seu suplemento quando quiser que uma condição seja cumprida antes de uma mensagem ou compromisso poder ser enviado, mas não quer que o utilizador 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 bloco suave é utilizada incluem pedir ao utilizador para definir um nível de importância de mensagem ou compromisso e verificar se a assinatura adequada é aplicada antes do envio do item.

bloquear

O item não é enviado se ocorrer alguma das seguintes situações.

• O item não cumpre as condições do suplemento.
• O suplemento não consegue ligar ao servidor.
• Ocorreu um erro ao carregar o suplemento.

Utilize a opção bloquear se as condições do suplemento forem obrigatórias, mesmo que o suplemento não esteja disponível. Por exemplo, a opção bloquear é ideal quando os utilizadores têm de aplicar uma etiqueta de confidencialidade a uma mensagem ou compromisso antes de poderem ser enviados.

O suplemento não está disponível

Se o suplemento não estiver disponível quando uma mensagem ou compromisso está a ser enviado (por exemplo, ocorre um erro que impede o carregamento do suplemento), o utilizador é alertado. As opções disponíveis para o utilizador diferem consoante a opção de modo de envio aplicada ao suplemento.

Se for utilizada a opção de pedido do utilizador ou do bloco suave , o utilizador pode selecionar Enviar Mesmo Assim para enviar o item sem que o suplemento o verifique ou Tente Mais Tarde para permitir que o item seja verificado pelo suplemento quando ficar novamente disponível.

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

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

Se o suplemento for executado durante mais de cinco segundos, mas menos de cinco minutos, o utilizador será alertado de que o suplemento está a demorar mais tempo do que o esperado para processar a mensagem ou compromisso.

Se a opção de utilizador de pedido for utilizada, o utilizador pode selecionar Enviar Mesmo Assim para enviar o item sem que o suplemento concenchisse o respetivo marcar. Em alternativa, o utilizador pode selecionar Não Enviar para impedir o processamento do suplemento.

No entanto, se for utilizada a opção de bloco suave ou bloco , o utilizador 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 simples. Para evitar a caixa de diálogo de operação de execução prolongada, utilize outros eventos para processar verificações condicionais antes de o OnMessageSend evento ou OnAppointmentSend ser ativado. Por exemplo, se o utilizador for obrigado a encriptar anexos para cada mensagem ou compromisso, considere utilizar o OnMessageAttachmentsChanged evento ou OnAppointmentAttachmentsChanged para executar o marcar.

O suplemento excedeu o tempo limite

Se o suplemento for executado durante cinco minutos ou mais, excederá o tempo limite. Se a opção de utilizador de pedido for utilizada, o utilizador pode selecionar Enviar Mesmo Assim para enviar o item sem que o suplemento concenchisse o respetivo marcar. Em alternativa, o utilizador pode escolher Não Enviar.

Se for utilizada a opção de bloco suave ou bloco, o utilizador não poderá enviar o item até que o suplemento conclua o respetivo marcar. O utilizador tem de tentar enviar o item novamente para reativar o suplemento.

Cliente do Outlook no modo Trabalhar Offline

No Outlook no Windows (cliente clássico a partir da Versão 2310 (Compilação 16913.10000)) e no Mac (a partir da Versão 16.80 (23121017)), um suplemento Alertas Inteligentes que implementa a opçãode bloqueio ou bloqueio suave só pode processar um item de correio enquanto o cliente outlook estiver online. Se o modo Trabalhar Offline estiver ativado no cliente do Outlook quando um item de correio é enviado, o item não é guardado na pasta Caixa de Saída e o utilizador é alertado de que tem de desativar o modo Trabalhar Offline antes de poder tentar enviar o item.

Se o suplemento Alertas Inteligentes implementar a opção de utilizador de pedido, não processa itens de correio enquanto o modo Trabalhar Offline estiver ativado. Em vez disso, o item é guardado na pasta Caixa de Saída .

O utilizador navega para fora da mensagem atual

Quando um utilizador navega para fora da mensagem que está a enviar (por exemplo, para ler uma mensagem na respetiva caixa de entrada), o comportamento de um suplemento Alertas Inteligentes difere entre clientes do Outlook. Selecione o separador do cliente do Outlook no qual o suplemento está a ser executado.

Ativar Alertas Inteligentes em aplicações que utilizam MAPI Simples

Os utilizadores podem enviar itens de correio através de determinadas aplicações que utilizam a MAPI Simples, mesmo que o cliente do Outlook não esteja em execução no momento em que o item é enviado. Quando isto ocorre, qualquer suplemento de Alertas Inteligentes instalado não será ativado para marcar o item de correio para conformidade.

Para garantir que os itens de saída cumprem as condições do suplemento Alertas Inteligentes antes de serem enviados, tem de ativar a definição Executar o Outlook para Envio de Correio MAPI Simples Política de Grupo em todos os computadores aplicáveis na sua organização.

Comportamento quando a definição está ativada

Quando a definição Executar o Outlook para Envio de Correio MAPI Simples está definida como Ativado, os utilizadores têm de ter o cliente do Outlook em execução no momento em que um item de correio é enviado nos seguintes cenários.

• Um ficheiro é enviado como um anexo através da opção Partilhar>Anexar uma cópia no Excel, Word ou PowerPoint.

  

• Um ficheiro é enviado como um anexo através da opção Enviar para>o destinatário do Correio no Explorador de Arquivos.

  

• Um ficheiro é enviado através de uma aplicação que utiliza a MAPI Simples, que abre uma nova janela do Outlook.

Se o cliente outlook de um utilizador não estiver em execução no momento em que o item de correio é enviado, é apresentada uma caixa de diálogo para notificá-lo de que tem de abrir o cliente para enviar o item.

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

Quando a definição Executar o Outlook para Envio de Correio MAPI Simples estiver definida como Desativado ou Não Configurado na sua organização, qualquer utilizador que utilize aplicações que implementem MAPI Simples para enviar itens de correio poderá fazê-lo sem ativar o suplemento Alertas Inteligentes para verificações de conformidade.

Configurar a definição de Política de Grupo

Por predefinição, a definição Executar o Outlook para Envio de Correio MAPI Simples está definida como Não Configurado. Para ativar a definiçã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 para Configuração do Utilizador\Modelos Administrativos\Microsoft Outlook 2016\Diversos.
4. Abra a definição Executar o Outlook para Envio de Correio MAPI Simples .
5. Na caixa de diálogo apresentada, selecione Ativado.
6. Selecione OK ou Aplicar para guardar a alteração.

Limitações

Uma vez que os OnMessageSend eventos e OnAppointmentSend são suportados através da funcionalidade de ativação baseada em eventos, as mesmas limitações de funcionalidade aplicam-se aos suplementos que são ativados como resultado destes eventos. Para obter uma descrição destas limitações, veja Comportamento e limitações da ativação baseada em eventos.

Além destas restrições, apenas uma instância de OnMessageSend cada evento e OnAppointmentSend pode ser declarada no manifesto. Se precisar de vários OnMessageSend eventos, OnAppointmentSend tem de declarar cada um deles num suplemento separado.

Embora possa alterar a mensagem de diálogo Alertas Inteligentes e o botão Não Enviar para se adequar ao seu cenário de suplemento, não é possível personalizar o seguinte.

• A barra de título da caixa de diálogo. O nome do seu suplemento é sempre apresentado aí.
• O tipo de letra ou a cor da mensagem de diálogo. No entanto, pode utilizar Markdown para formatar determinados elementos da sua mensagem. Para obter uma lista de elementos suportados, veja Limitações à formatação da mensagem de caixa de diálogo com Markdown.
• O ícone junto à mensagem de diálogo.
• Caixas de diálogo que fornecem informações sobre o processamento e o progresso dos eventos. Por exemplo, o texto e as opções que aparecem nas caixas de diálogo de tempo limite e operação de execução prolongada não podem ser alterados.

Se personalizar o botão Não Enviar na caixa de diálogo, só pode atribuir um comando do painel de tarefas ao mesmo. Os comandos de função não são suportados. Se selecionar um botão Não Enviar com um comando de função atribuído, o comando é ignorado e o suplemento cancela a operação de envio e fecha a caixa de diálogo. Quando isto ocorre, não é apresentado ou registado nenhum erro. Para obter orientações sobre os tipos de comandos de suplementos, veja Types of add-in commands (Tipos de comandos de suplementos).

No Outlook na Web e no novo Outlook no Windows:

• O OnAppointmentSend evento só ocorre quando a reunião que está a ser enviada foi criada através da opção Novo Evento . Se a reunião que está a ser enviada tiver sido criada ao selecionar uma data e hora diretamente a partir do calendário, o OnAppointmentSend evento não ocorre.
• Ao reencaminhar uma reunião, o OnAppointmentSend evento só ocorre se o organizador reencaminhar a reunião. Não ocorre se um participante reencaminhar a reunião para a qual é convidado.

Limitações à formatação da mensagem de caixa de diálogo com Markdown

Pode utilizar Markdown para formatar a mensagem de uma caixa de diálogo Alertas Inteligentes. No entanto, apenas os seguintes elementos são suportados.

• Texto negrito, itálico ou negrito e itálico. Os formatos asterisco (*) e caráter de sublinhado (_) são suportados .

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

  

• Listas com marcas ou não ordenadas. Para criar um item na lista, comece com um travessão (-) ou asterisco (*), adicione o conteúdo e, em seguida, acrescente \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 de um ponto final, adicione o conteúdo e, em seguida, acrescente \r para significar a conclusão do item. O primeiro item da lista tem de começar com o número um (1.) e os números seguintes têm de estar por 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 uma ligação, coloque o texto da ligação entre parênteses retos ([]) e, em seguida, coloque o URL HTTPS entre parênteses (()). Tem de fornecer um URL HTTPS, caso contrário, não será composto como uma ligação que um utilizador pode selecionar na caixa de diálogo. O formato dos parênteses angulares (<>) não é suportado.

  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. Utilize \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)."
  });
  

  

Práticas recomendadas

A funcionalidade Alertas Inteligentes garante que todos os itens de correio enviados estão em conformidade com as políticas de proteção de informações de uma organização e ajuda os utilizadores a melhorar as suas mensagens através de recomendações. Para garantir que o seu suplemento proporciona sempre aos utilizadores uma experiência de envio suave e eficiente, observe as seguintes diretrizes.

• Não deixe que o suplemento atrase ainda mais a operação de envio. Os suplementos de Alertas Inteligentes têm de ser simples e de execução curta. Evite sobrecarregar os OnMessageSend processadores de eventos e OnAppointmentSend com validações pesadas. Para evitar esta situação, pré-processará informações quando ocorrerem outros eventos, como o OnMessageRecipientsChanged evento ou OnMessageAttachmentsChanged . Para determinar a que eventos o seu suplemento pode responder, veja a secção "Eventos suportados" de Configurar o suplemento do Outlook para ativação baseada em eventos.
• Não implemente caixas de diálogo adicionais. Evite sobrecarregar os seus utilizadores com demasiadas caixas de diálogo. Em vez disso, personalize o texto na caixa de diálogo Alertas Inteligentes para transmitir informações. Se necessário, também pode personalizar o botão Não Enviar para fornecer aos utilizadores informações e funcionalidades adicionais através de um painel de tarefas.
• Ative as definições de Política de Grupo adequadas na sua organização. Para garantir que o suplemento Alertas Inteligentes é ativado em cada item de correio, incluindo os enviados através de aplicações que implementam o MAPI Simples, configure a definição Executar o Outlook para Envio MAPI Simples . Para saber mais sobre esta definição, consulte Ativar Alertas Inteligentes em aplicações que utilizam MAPI Simples.

Depurar o suplemento

Para obter orientações sobre como resolver problemas com o suplemento Alertas Inteligentes, veja Resolver problemas de suplementos baseados em eventos e relatórios de spam.

Implementar em utilizadores

À semelhança de outros suplementos baseados em eventos, os suplementos que utilizam a funcionalidade Alertas Inteligentes têm de ser implementados pelo administrador de uma organização. Para obter orientações sobre como implementar o suplemento através do Centro de administração do Microsoft 365, consulte a secção "Implementar para utilizadores" em Configurar o suplemento do Outlook para ativação baseada em eventos.

Diferenças entre Os Alertas Inteligentes e a funcionalidade de envio

Embora os Alertas Inteligentes e a funcionalidade de envio forneçam aos seus utilizadores a oportunidade de melhorar as suas mensagens e convites para reuniões antes de serem enviados, os Alertas Inteligentes são uma funcionalidade mais recente que lhe oferece mais flexibilidade com a forma como pede aos seus utilizadores mais ações adicionais. As principais diferenças entre as duas funcionalidades estão descritas na tabela seguinte.

Confira também

• Configurar o suplemento do Outlook para ativação baseada em eventos
• Opções de listagem do AppSource para o seu suplemento do Outlook baseado em eventos
• 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 com Alertas Inteligentes
• Exemplo de código dos Suplementos do Office: Verificar a etiqueta de confidencialidade de uma mensagem