Controlar eventos OnMessageSend y OnAppointmentSend en el complemento de Outlook con alertas inteligentes
Los OnMessageSend
eventos y OnAppointmentSend
aprovechan las alertas inteligentes, lo que le permite ejecutar la lógica después de que un usuario seleccione Enviar en su mensaje o cita de Outlook. Con alertas inteligentes, los usuarios del complemento pueden aprovechar la oportunidad de mejorar el contenido de su correo electrónico, agregar una etiqueta de confidencialidad que falta o incluir un destinatario importante en una invitación a la reunión.
Alertas inteligentes está disponible a través de la característica de activación basada en eventos. Para comprender cómo configurar el complemento para usar esta característica, use otros eventos disponibles, depure el complemento y mucho más, consulte Configuración del complemento de Outlook para la activación basada en eventos.
Nota:
Los OnMessageSend
eventos y OnAppointmentSend
se introdujeron en el conjunto de requisitos 1.12. También se agregaron opciones adicionales de funcionalidad y personalización a los conjuntos de requisitos posteriores. Para comprobar que el cliente de Outlook admite estos eventos y características, consulte Clientes y plataformas compatibles y las secciones específicas del tutorial que describen las características que desea implementar.
Plataformas y clientes admitidos
En la tabla siguiente se enumeran las combinaciones de cliente y servidor admitidas para la característica Alertas inteligentes, incluida la actualización acumulativa mínima necesaria Exchange Server cuando corresponda. No se admiten combinaciones excluidas.
Cliente | Exchange Online | Exchange 2019 local (actualización acumulativa 12 o posterior) | Exchange 2016 local (actualización acumulativa 22 o posterior) |
---|---|---|---|
Explorador web (interfaz de usuario moderna) | Yes | No aplicable | No aplicable |
nuevo Outlook en Windows | Yes | No aplicable | No aplicable |
Windows (clásico) Versión 2206 (compilación 15330.20196) o posterior |
Sí | Sí | Sí |
Mac Versión 16.65 (22082700) o posterior |
Yes | No aplicable | No aplicable |
Android | No aplicable | No aplicable | No aplicable |
iOS | No aplicable | No aplicable | No aplicable |
Probar alertas inteligentes en un complemento basado en eventos
Para ver alertas inteligentes en acción, pruebe el tutorial. Creará un complemento que comprueba si un documento o imagen está adjunto a un mensaje antes de enviarlo.
Comportamiento y escenarios de características de Alertas inteligentes
En las secciones siguientes se incluyen instrucciones sobre las opciones del modo de envío y el comportamiento de la característica en determinados escenarios.
Opciones de modo de envío disponibles
Al configurar el complemento para responder al OnMessageSend
evento o OnAppointmentSend
, debe incluir la propiedad send mode en el manifiesto. Su marcado varía en función del tipo de manifiesto que use el complemento.
- Manifiesto de solo complemento: establezca la propiedad SendMode del elemento LaunchEvent .
- Manifiesto unificado para Microsoft 365: establezca la opción "sendMode" del objeto de evento en la matriz "autoRunEvents".
Si no se cumplen las condiciones implementadas por el complemento o el complemento no está disponible cuando se produce el evento, se muestra un cuadro de diálogo al usuario para avisarle de que es posible que se necesiten acciones adicionales antes de que se pueda enviar el elemento de correo. La propiedad de modo de envío determina las opciones disponibles para el usuario en el cuadro de diálogo.
En la tabla siguiente se enumeran las opciones de modo de envío disponibles.
Nombre canónico de la opción de modo de envío | Nombre del manifiesto de solo complemento | Manifiesto unificado para el nombre de Microsoft 365 |
---|---|---|
preguntar al usuario | PromptUser |
promptUser |
bloque suave | SoftBlock |
softBlock |
Bloquear | Block |
Bloquear |
Sugerencia
A partir del conjunto de requisitos de buzón 1.14, el complemento ahora puede invalidar su opción de modo de envío en tiempo de ejecución. Para más información, consulte Invalidación de la opción de modo de envío en tiempo de ejecución (opcional).
preguntar al usuario
Si el elemento no cumple las condiciones del complemento, el usuario puede elegir Enviar de todos modos en la alerta o solucionar el problema e intentar enviar el elemento de nuevo. Si el complemento tarda mucho tiempo en procesar el elemento, se le pedirá al usuario que deje de ejecutar el complemento y elija Enviar de todos modos. En caso de que el complemento no esté disponible (por ejemplo, se produce un error al cargar el complemento), se enviará el elemento.
Use la opción de usuario del símbolo del sistema en el complemento si se aplica una de las siguientes opciones.
- La condición que comprueba el complemento no es obligatoria, pero es agradable tenerla en el mensaje o la cita que se va a enviar.
- Le gustaría recomendar una acción y permitir que el usuario decida si quiere aplicarla al mensaje o a la cita que se va a enviar.
Algunos escenarios en los que se aplica la opción de usuario de aviso incluyen sugerir etiquetar el mensaje o la cita como de baja o alta importancia y recomendar aplicar una categoría de color al elemento.
bloque suave
Opción predeterminada si la propiedad de modo de envío del manifiesto no está configurada. Al usuario se le avisa de que el elemento que envía no cumple las condiciones del complemento y debe solucionar el problema antes de intentar enviar el elemento de nuevo. Sin embargo, si el complemento no está disponible (por ejemplo, se produce un error al cargar el complemento), se enviará el elemento.
Use la opción de bloque temporal en el complemento cuando desee que se cumpla una condición antes de que se pueda enviar un mensaje o una cita, pero no quiere que el usuario no pueda enviar el elemento si el complemento no está disponible. Los escenarios de ejemplo en los que se usa la opción de bloque temporal incluyen pedir al usuario que establezca el nivel de importancia de un mensaje o cita y comprobar que se aplica la firma adecuada antes de enviar el elemento.
Bloquear
El elemento no se envía si se produce alguna de las situaciones siguientes.
- El elemento no cumple las condiciones del complemento.
- El complemento no puede conectarse al servidor.
- Se produce un error al cargar el complemento.
Use la opción de bloque si las condiciones del complemento son obligatorias, incluso si el complemento no está disponible. Por ejemplo, la opción de bloque es ideal cuando los usuarios deben aplicar una etiqueta de confidencialidad a un mensaje o una cita antes de que se pueda enviar.
El complemento no está disponible
Si el complemento no está disponible cuando se envía un mensaje o una cita (por ejemplo, se produce un error que impide que se cargue el complemento), se alerta al usuario. Las opciones disponibles para el usuario varían en función de la opción de modo de envío aplicada al complemento.
Si se usa la opción de usuario de aviso o bloque temporal , el usuario puede elegir Enviar de todos modos para enviar el elemento sin que el complemento lo compruebe, o bien intentar más adelante para permitir que el complemento compruebe el elemento cuando vuelva a estar disponible.
Si se usa la opción de bloque , el usuario no puede enviar el elemento hasta que el complemento esté disponible.
Importante
Si un complemento alertas inteligentes que implementa la característica de invalidación de modo de envío no puede completar el procesamiento de un evento debido a un error o no está disponible cuando se produce el evento, usa la opción de modo de envío especificada en el manifiesto.
Operaciones de complemento de ejecución prolongada
Si el complemento se ejecuta durante más de cinco segundos, pero menos de cinco minutos, se avisa al usuario de que el complemento tarda más de lo esperado en procesar el mensaje o la cita.
Si se usa la opción de usuario del aviso , el usuario puede elegir Enviar de todos modos para enviar el elemento sin que el complemento complete su comprobación. Como alternativa, el usuario puede seleccionar No enviar para impedir que el complemento se procese.
Sin embargo, si se usa la opción de bloque temporal o bloque , el usuario no podrá enviar el elemento hasta que el complemento termine de procesarlo.
OnMessageSend
y OnAppointmentSend
los complementos deben ser ligeros y de ejecución corta. Para evitar el cuadro de diálogo de operación de ejecución prolongada, use otros eventos para procesar comprobaciones condicionales antes de activar el OnMessageSend
evento o OnAppointmentSend
. Por ejemplo, si el usuario tiene que cifrar los datos adjuntos para cada mensaje o cita, considere la posibilidad de usar el OnMessageAttachmentsChanged
evento o OnAppointmentAttachmentsChanged
para realizar la comprobación.
Tiempo de espera de complemento agotado
Si el complemento se ejecuta durante cinco minutos o más, se agotará el tiempo de espera. Si se usa la opción de usuario del aviso , el usuario puede elegir Enviar de todos modos para enviar el elemento sin que el complemento complete su comprobación. Como alternativa, el usuario puede elegir No enviar.
Si se usa la opción de bloque temporal o bloque , el usuario no puede enviar el elemento hasta que el complemento complete su comprobación. El usuario debe intentar volver a enviar el elemento para reactivar el complemento.
Cliente de Outlook en modo de trabajo sin conexión
En Outlook en Windows (cliente clásico a partir de la versión 2310 (compilación 16913.10000)) y en Mac (a partir de la versión 16.80 (23121017)), un complemento de alertas inteligentes que implementa la opción de bloque temporal o bloque solo puede procesar un elemento de correo mientras el cliente de Outlook está en línea. Si el modo Trabajo sin conexión está activado en el cliente de Outlook cuando se envía un elemento de correo, el elemento no se guarda en la carpeta Bandeja de salida y se le avisa al usuario de que debe desactivar el modo Trabajo sin conexión antes de que pueda intentar enviar su elemento.
Si el complemento Alertas inteligentes implementa la opción de usuario de aviso , no procesa los elementos de correo mientras el modo Trabajo sin conexión está activado. En su lugar, el elemento se guarda en la carpeta Bandeja de salida .
El usuario se aleja del mensaje actual
Cuando un usuario se aleja del mensaje que envía (por ejemplo, para leer un mensaje en su bandeja de entrada), el comportamiento de un complemento alertas inteligentes difiere entre los clientes de Outlook. Seleccione la pestaña del cliente de Outlook en el que se ejecuta el complemento.
En Outlook en la Web o en el nuevo Outlook en Windows, un usuario debe permanecer en el mensaje que se envía hasta que el complemento Alertas inteligentes termine de procesarlo. De lo contrario, una vez que el usuario se aleja del elemento, el complemento finaliza la operación Alertas inteligentes y guarda un borrador en la carpeta Borradores del buzón. A continuación, se alerta al usuario de que debe volver a enviar el mensaje desde la carpeta Borradores y permanecer en el mensaje hasta que el complemento complete el procesamiento.
Activación de alertas inteligentes en aplicaciones que usan MAPI simple
Nota:
Esta característica solo se admite actualmente en Outlook clásico en Windows a partir de la versión 2301 (compilación 17126.20004).
Los usuarios pueden enviar elementos de correo a través de determinadas aplicaciones que usan MAPI simple, incluso si el cliente de Outlook no se ejecuta en el momento en que se envía el elemento. Cuando esto ocurre, cualquier complemento de alertas inteligentes instalado no se activará para comprobar el cumplimiento del elemento de correo.
Para asegurarse de que los elementos salientes cumplen las condiciones del complemento alertas inteligentes antes de que se envíen, debe activar la opción Running Outlook for Simple MAPI Mail Sending directiva de grupo (Ejecución de Outlook para envío simple de correo MAPI directiva de grupo) en todas las máquinas aplicables de su organización.
Comportamiento cuando la configuración está activada
Cuando la opción Running Outlook for Simple MAPI Mail Sending (Ejecución de Outlook para envío de correo MAPI simple ) está establecida en Habilitado, los usuarios deben tener su cliente de Outlook en ejecución en el momento en que se envía un elemento de correo en los escenarios siguientes.
Un archivo se envía como datos adjuntos a través de la opción Asociar>una copia en su lugar en Excel, Word o PowerPoint.
Un archivo se envía como datos adjuntos a través de la opción Enviar al>destinatario de correo en Explorador de archivos.
Un archivo se envía a través de una aplicación que usa MAPI simple, que abre una nueva ventana de Outlook de mensaje.
Si el cliente de Outlook de un usuario no se ejecuta en el momento en que se envía el elemento de correo, se muestra un cuadro de diálogo para notificarle que debe abrir su cliente para enviar el elemento.
Comportamiento cuando la configuración está desactivada o no configurada
Cuando la opción Running Outlook for Simple MAPI Mail Sending (Ejecución de Outlook para envío de correo MAPI simple ) se establece en Deshabilitado o No configurado en su organización, cualquier usuario que use aplicaciones que implementen MAPI simple para enviar elementos de correo podrá hacerlo sin activar su complemento alertas inteligentes para comprobaciones de cumplimiento.
Configuración de la configuración de directiva de grupo
De forma predeterminada, la opción Running Outlook for Simple MAPI Mail Sending (Ejecución de Outlook para envío de correo MAPI simple ) está establecida en No configurado. Para activar la configuración, realice lo siguiente:
- Descargue la herramienta de plantillas administrativas más recientes.
- Abra el Editor de directivas de grupo local (gpedit.msc).
- Vaya a Configuración de usuario\Plantillas administrativas\Microsoft Outlook 2016\Varios.
- Abra la opción Running Outlook for Simple MAPI Mail Sending (Ejecución de Outlook para envío de correo MAPI simple ).
- En el cuadro de diálogo que aparece, seleccione Habilitado.
- Seleccione Aceptar o Aplicar para guardar el cambio.
Limitaciones
Dado que los OnMessageSend
eventos y OnAppointmentSend
se admiten a través de la característica de activación basada en eventos, se aplican las mismas limitaciones de características a los complementos que se activan como resultado de estos eventos. Para obtener una descripción de estas limitaciones, consulte Comportamiento y limitaciones de activación basada en eventos.
Además de estas restricciones, solo se puede declarar una instancia de OnMessageSend
cada evento y OnAppointmentSend
en el manifiesto. Si necesita varios OnMessageSend
eventos o OnAppointmentSend
, debe declarar cada uno en un complemento independiente.
Aunque puede cambiar el mensaje de diálogo Alertas inteligentes y el botón No enviar para adaptarse al escenario del complemento, no se puede personalizar lo siguiente.
- Barra de título del cuadro de diálogo. El nombre del complemento siempre se muestra allí.
- Fuente o color del mensaje de diálogo. Sin embargo, puede usar Markdown para dar formato a determinados elementos del mensaje. Para obtener una lista de los elementos admitidos, vea Limitaciones para dar formato al mensaje de diálogo mediante Markdown.
- Icono situado junto al mensaje de diálogo.
- Cuadros de diálogo que proporcionan información sobre el procesamiento y el progreso de eventos. Por ejemplo, el texto y las opciones que aparecen en los cuadros de diálogo de tiempo de espera y operación de ejecución prolongada no se pueden cambiar.
Puede personalizar el botón No enviar en el cuadro de diálogo para abrir un panel de tareas o ejecutar una función. Para obtener instrucciones sobre los tipos de comandos de complemento, vea Tipos de comandos de complemento.
Nota:
La compatibilidad para personalizar el botón No enviar se introdujo en el conjunto de requisitos de buzón 1.14.
En Outlook en la Web y en el nuevo Outlook en Windows:
- El
OnAppointmentSend
evento solo se produce cuando la reunión que se envía se creó a través de la opción Nuevo evento . Si la reunión que se envía se creó seleccionando una fecha y hora directamente desde el calendario, elOnAppointmentSend
evento no se produce. - Al reenviar una reunión, el
OnAppointmentSend
evento solo se produce si el organizador reenvía la reunión. No se produce si un asistente reenvía la reunión a la que se le invita.
Limitaciones para dar formato al mensaje de diálogo mediante Markdown
Nota:
La compatibilidad con Markdown en un cuadro de diálogo Alertas inteligentes está actualmente en versión preliminar en Outlook en la Web y en Windows (nuevo y clásico). Las características de la versión preliminar no deben usarse en complementos de producción. Le invitamos a probar esta característica en entornos de desarrollo o pruebas y recibir comentarios sobre su experiencia a través de GitHub (consulte la sección Comentarios al final de esta página).
Para probar esta característica en Outlook clásico en Windows, debe instalar la versión 2403 (compilación 17330.10000) o posterior. A continuación, únase al programa Microsoft 365 Insider y seleccione la opción Canal beta en el cliente de Outlook para acceder a las compilaciones beta de Office.
Puede usar Markdown para dar formato al mensaje de un cuadro de diálogo Alertas inteligentes. Sin embargo, solo se admiten los siguientes elementos.
Texto en negrita, cursiva o negrita y cursiva. Se admiten los formatos de asterisco (*) y de subrayado (_ ).
event.completed({ allowEvent: false, ... errorMessageMarkdown: "**Important**: Apply the appropriate sensitivity label to your message before sending." });
Listas con viñetas o desordenadas. Para crear un elemento en la lista, comience con un guión (
-
) o un asterisco (*
), agregue el contenido y, a continuación, anexe\r
para indicar la finalización del elemento.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 o ordenadas. Para crear un elemento en la lista, comience con un número seguido de un punto, agregue el contenido y, a continuación, anexe
\r
para indicar la finalización del elemento. El primer elemento de la lista debe comenzar con el número uno (1.
) y los números correctos deben estar en orden numérico.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" });
Enlaces. Para crear un vínculo, incluya el texto del vínculo entre corchetes (
[]
) y, a continuación, incluya la dirección URL HTTPS entre paréntesis (()
). Debe proporcionar una dirección URL HTTPS; de lo contrario, no se representará como un vínculo que un usuario puede seleccionar en el cuadro de diálogo. No se admite el formato de corchetes 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." });
Líneas nuevas. Use
\n\n
para crear una nueva línea.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)." });
Sugerencia
Para obtener caracteres de escape en el mensaje, como un asterisco, agregue una barra diagonal inversa (\
) antes del carácter.
Procedimientos recomendados
La característica Alertas inteligentes garantiza que todos los elementos de correo saliente cumplen las directivas de protección de la información de una organización y ayuda a los usuarios a mejorar sus mensajes mediante recomendaciones. Para asegurarse de que el complemento siempre proporciona a los usuarios una experiencia de envío fluida y eficaz, observe las siguientes directrices.
-
No permita que el complemento retrase aún más la operación de envío. Los complementos de alertas inteligentes deben ser ligeros y de ejecución corta. Evite sobrecargar los
OnMessageSend
controladores de eventos yOnAppointmentSend
con validaciones pesadas. Para evitarlo, preprocese información cuando se produzcan otros eventos, como elOnMessageRecipientsChanged
evento oOnMessageAttachmentsChanged
. Para determinar a qué eventos puede responder el complemento, consulte la sección "Eventos admitidos" de Configuración del complemento de Outlook para la activación basada en eventos. - No implemente diálogos adicionales. Evite saturar a los usuarios con demasiados diálogos. En su lugar, personalice el texto en el cuadro de diálogo Alertas inteligentes para transmitir información. Si es necesario, también puede personalizar el botón No enviar para proporcionar a los usuarios información y funcionalidad adicionales a través de un panel de tareas o una función.
- Habilite la configuración de directiva de grupo adecuada en su organización. Para asegurarse de que el complemento Alertas inteligentes se activa en cada elemento de correo, incluidos los enviados mediante aplicaciones que implementan MAPI simple, configure la configuración Running Outlook for Simple MAPI Sending (Ejecución de Outlook para envío MAPI simple ). Para obtener más información sobre esta configuración, vea Activar alertas inteligentes en aplicaciones que usan MAPI simple.
Depurar el complemento
Para obtener instrucciones sobre cómo solucionar problemas del complemento alertas inteligentes, consulte Solución de problemas de complementos de informes de correo no deseado y basados en eventos.
Implementación en usuarios
De forma similar a otros complementos basados en eventos, los complementos que usan la característica Alertas inteligentes deben ser implementados por el administrador de una organización. Para obtener instrucciones sobre cómo implementar el complemento a través de la Centro de administración de Microsoft 365, vea la sección "Implementar en los usuarios" en Configurar el complemento de Outlook para la activación basada en eventos.
Importante
Los complementos que usan la característica Alertas inteligentes solo se pueden publicar en AppSource si la propiedad de modo de envío del manifiesto está establecida en el bloque temporal o en la opción preguntar al usuario . Si la propiedad de modo de envío de un complemento está establecida en bloquear, solo la puede implementar el administrador de una organización, ya que no se realizará la validación de AppSource. Para obtener más información sobre cómo publicar el complemento basado en eventos en AppSource, consulte Opciones de lista de AppSource para el complemento de Outlook basado en eventos.
Diferencias entre las alertas inteligentes y la característica de envío
Aunque las alertas inteligentes y la característica de envío proporcionan a los usuarios la oportunidad de mejorar sus mensajes y las invitaciones a reuniones antes de que se envíen, Alertas inteligentes es una característica más reciente que ofrece más flexibilidad con la forma en que solicita a los usuarios una acción adicional. En la tabla siguiente se describen las diferencias clave entre las dos características.
Atributo | Alertas inteligentes | Al enviar |
---|---|---|
Conjunto mínimo de requisitos admitidos | Buzón 1.12 | Mailbox 1.8 |
Clientes de Outlook admitidos |
|
|
Eventos admitidos |
Manifiesto de solo complemento
Manifiesto unificado para Microsoft 365
|
Manifiesto XML
Manifiesto unificado para Microsoft 365
|
Propiedad de extensión de manifiesto |
Manifiesto de solo complemento
Manifiesto unificado para Microsoft 365
|
Manifiesto XML
Manifiesto unificado para Microsoft 365
|
Opciones de modo de envío admitidas |
Para obtener más información sobre cada opción, consulte Opciones de modo de envío disponibles. |
Bloquear |
Número máximo de eventos admitidos en un complemento | Uno OnMessageSend y un OnAppointmentSend evento. |
Un ItemSend evento. |
Implementación de complementos | El complemento se puede publicar en AppSource si su propiedad de modo de envío está establecida en el bloque temporal o en la opción del usuario de aviso . De lo contrario, el administrador de una organización debe implementar el complemento. | El complemento no se puede publicar en AppSource. El administrador de una organización debe implementarlo. |
Configuración adicional para la instalación del complemento | No se necesita ninguna configuración adicional una vez cargado el manifiesto en el Centro de administración de Microsoft 365. | En función de los estándares de cumplimiento de la organización y del cliente de Outlook usado, se deben configurar determinadas directivas de buzón de correo para instalar el complemento. |
Recursos adicionales
- Configuración del complemento de Outlook para la activación basada en eventos
- Opciones de lista de AppSource para el complemento de Outlook basado en eventos
- Ejemplo de código de complementos de Office: ejemplo de código de complementos de Office: compruebe las categorías de color de un mensaje o cita antes de enviarlo mediante alertas inteligentes
- Ejemplo de código de complementos de Office: comprobar la etiqueta de confidencialidad de un mensaje