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.
Observação
Os OnMessageSend
eventos e OnAppointmentSend
foram introduzidos no conjunto de requisitos 1.12. Também foram adicionadas opções adicionais de funcionalidade e personalização aos conjuntos de requisitos subsequentes. Para verificar se o seu cliente do Outlook suporta estes eventos e funcionalidades, veja Clientes e plataformas suportados e as secções específicas nas instruções que descrevem as funcionalidades que pretende implementar.
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.
Cliente | Exchange Online | Exchange 2019 no local (Atualização Cumulativa 12 ou posterior) | Exchange 2016 no local (Atualização Cumulativa 22 ou posterior) |
---|---|---|---|
Browser (IU moderna) | Sim | Não aplicável | Não aplicável |
novo Outlook no Windows | Sim | Não aplicável | Não aplicável |
Windows (clássico) Versão 2206 (Compilação 15330.20196) ou posterior |
Sim | Sim | Sim |
Mac Versão 16.65 (22082700) 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 |
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.
Nome canónico da opção de modo de envio | Nome do manifesto apenas do suplemento | Manifesto unificado para o nome do Microsoft 365 |
---|---|---|
pedir ao utilizador | PromptUser |
promptUser |
bloco suave | SoftBlock |
softBlock |
bloquear | Block |
bloquear |
Dica
A partir do conjunto de requisitos da Caixa de Correio 1.14, o suplemento pode agora substituir a opção de modo de envio no runtime. Para saber mais, consulte Substituir a opção de modo de envio no runtime (opcional).
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.
Importante
Se um suplemento Alertas Inteligentes que implementa a funcionalidade de substituição do modo de envio não conseguir concluir o processamento de um evento devido a um erro ou estiver indisponível quando o evento ocorre, utiliza a opção de modo de envio especificada no manifesto.
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.
No Outlook na Web ou no novo Outlook no Windows, um utilizador tem de permanecer na mensagem que está a ser enviada até que o suplemento Alertas Inteligentes conclua o processamento. Caso contrário, assim que o utilizador sair do item, o suplemento termina a operação Alertas Inteligentes e guarda um rascunho na pasta Rascunhos da caixa de correio. Em seguida, o utilizador é alertado de que tem de reenviar a mensagem a partir da pasta Rascunhos e permanecer na mensagem até que o suplemento conclua o processamento.
Ativar Alertas Inteligentes em aplicações que utilizam MAPI Simples
Observação
Atualmente, esta funcionalidade só é suportada no Outlook clássico no Windows a partir da Versão 2301 (Compilação 17126.20004).
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:
- Baixe a ferramenta de Modelos Administrativos mais recente.
- Abra o Editor de Política de Grupo Local (gpedit.msc).
- Navegue para Configuração do Utilizador\Modelos Administrativos\Microsoft Outlook 2016\Diversos.
- Abra a definição Executar o Outlook para Envio de Correio MAPI Simples .
- Na caixa de diálogo apresentada, selecione Ativado.
- 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.
Pode personalizar o botão Não Enviar na caixa de diálogo para abrir um painel de tarefas ou executar uma função. Para obter orientações sobre os tipos de comandos de suplementos, veja Types of add-in commands (Tipos de comandos de suplementos).
Observação
O suporte para personalizar o botão Não Enviar foi introduzido no conjunto de requisitos da Caixa de Correio 1.14.
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, oOnAppointmentSend
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
Observação
O suporte para Markdown numa caixa de diálogo Alertas Inteligentes está atualmente em pré-visualização no Outlook na Web e no Windows (novo e clássico). As funcionalidades em pré-visualização não devem ser utilizadas em suplementos de produção. Convidamo-lo a experimentar esta funcionalidade em ambientes de teste ou de desenvolvimento e a receber feedback sobre a sua experiência através do GitHub (consulte a secção Feedback no final desta página).
Para testar esta funcionalidade no Outlook clássico no Windows, tem de instalar a Versão 2403 (Compilação 17330.10000) ou posterior. Em seguida, adira ao programa Microsoft 365 Insider e selecione a opção Canal Beta no seu cliente do Outlook para aceder às compilações beta do Office.
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)." });
Dica
Para escapar aos carateres na sua mensagem, como um asterisco, adicione uma barra invertida (\
) antes do caráter.
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 eOnAppointmentSend
com validações pesadas. Para evitar esta situação, pré-processará informações quando ocorrerem outros eventos, como oOnMessageRecipientsChanged
evento ouOnMessageAttachmentsChanged
. 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 ou função 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.
Importante
Os suplementos que utilizam a funcionalidade Alertas Inteligentes só podem ser publicados no AppSource se a propriedade modo de envio do manifesto estiver definida para a opção de utilizador de pedido ou bloqueio suave. Se a propriedade de modo de envio de um suplemento estiver definida para bloquear, só pode ser implementada pelo administrador de uma organização, uma vez que irá falhar a validação do AppSource. Para saber mais sobre como publicar o suplemento baseado em eventos no AppSource, consulte Opções de listagem do AppSource para o seu suplemento do Outlook baseado 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.
Atributo | Alertas Inteligentes | No envio |
---|---|---|
Conjunto mínimo de requisitos suportados | Caixa de correio 1.12 | Caixa de correio 1.8 |
Clientes do Outlook suportados |
|
|
Eventos com suporte |
Manifesto apenas de suplemento
Manifesto unificado para o Microsoft 365
|
Manifesto XML
Manifesto unificado para o Microsoft 365
|
Propriedade da extensão do manifesto |
Manifesto apenas de suplemento
Manifesto unificado para o Microsoft 365
|
Manifesto XML
Manifesto unificado para o Microsoft 365
|
Opções de modo de envio suportadas |
Para saber mais sobre cada opção, consulte Opções de modo de envio disponíveis. |
Bloquear |
Número máximo de eventos suportados num suplemento | Um OnMessageSend e um OnAppointmentSend evento. |
Um ItemSend evento. |
Implementação do suplemento | O suplemento pode ser publicado no AppSource se a respetiva propriedade de modo de envio estiver definida para a opção de utilizador de bloqueio suave ou pedido . Caso contrário, o suplemento tem de ser implementado pelo administrador de uma organização. | Não é possível publicar o suplemento no AppSource. Tem de ser implementado pelo administrador de uma organização. |
Configuração adicional para a instalação do suplemento | Não é necessária nenhuma configuração adicional depois de o manifesto ser carregado para o Centro de administração do Microsoft 365. | Consoante as normas de conformidade da organização e o cliente do Outlook utilizado, determinadas políticas de caixa de correio têm de ser configuradas para instalar o suplemento. |
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