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. Vea clientes y plataformas compatibles con este conjunto de requisitos.

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) nuevo Outlook en Windows (versión preliminar)	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.827.0 o posterior	Yes	No aplicable	No aplicable
Android	No aplicable	No aplicable	No aplicable
iOS	No aplicable	No aplicable	No aplicable

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 XML: establezca la propiedad SendMode del elemento LaunchEvent .
• Manifiesto unificado para Microsoft 365 (versión preliminar): 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 XML	Manifiesto unificado para el nombre de Microsoft 365
preguntar al usuario	PromptUser	promptUser
bloque suave	SoftBlock	Softblock
Bloquear	Block	Bloquear

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 (a partir de la versión 2310 (compilación 16913.10000)), un complemento 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.

En Outlook en Mac, la opción Enviar deja de estar disponible mientras está en modo Trabajo sin conexión. Una vez que el modo Trabajo sin conexión está desactivado, el usuario puede seleccionar Enviar y activar el complemento Alertas inteligentes.

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.

Web/Nuevo Outlook en Windows (versión preliminar)

En Outlook en la Web o en el nuevo Outlook en Windows (versión preliminar), un usuario debe permanecer en el mensaje que se envía hasta que el complemento Alertas inteligentes complete el procesamiento. 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.

Windows (clásico)

Mensaje compuesto en una ventana

A partir de la versión 2402 (compilación 17310.10000), si un mensaje se compone en una ventana independiente, como un mensaje nuevo, y un usuario se aleja de él después de seleccionar Enviar, el complemento Alertas inteligentes seguirá procesando el mensaje en segundo plano. Si se necesitan acciones adicionales antes de que se pueda enviar el mensaje, se muestra al usuario el cuadro de diálogo Alertas inteligentes adecuado (consulte Opciones del modo de envío disponible).

Mensaje compuesto en el panel de lectura

A partir de la versión 2402 (compilación 17310.10000), si se está redactando una respuesta, un avance o un borrador existente en el panel de lectura de Outlook y un usuario se aleja de él después de seleccionar Enviar, se muestra al usuario un cuadro de diálogo con opciones. Las opciones disponibles dependen de la opción de modo de envío implementada por el complemento.

Si se implementa la opción del modo de envío del usuario del aviso , se muestran las siguientes opciones.

• Esperar: esta opción abre el mensaje que se está redactando en una nueva ventana, para que el complemento Alertas inteligentes pueda continuar procesándolo. Si el usuario se aleja de la ventana recién abierta durante el procesamiento, el complemento seguirá procesando el mensaje en segundo plano (para obtener más información, consulte Mensaje compuesto en una ventana). Si se necesitan acciones adicionales antes de que se pueda enviar un mensaje, se muestra al usuario el cuadro de diálogo Alertas inteligentes adecuado.
• Enviar de todos modos: esta opción finaliza la operación del complemento y envía el mensaje.
• Guardar como borrador: esta opción finaliza las operaciones de envío y complemento y guarda un borrador del mensaje en la carpeta Borradores del buzón.

Si se implementa la opción de modo de envío de bloque temporal o bloque , solo se muestran las opciones Esperar y Guardar como borrador .

Mac

En Outlook en Mac, cuando un usuario se aleja de un mensaje después de seleccionar Enviar, el complemento Alertas inteligentes seguirá procesando el elemento en segundo plano. Si el elemento no cumple las condiciones del complemento, 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. Por el contrario, si el elemento cumple las condiciones del complemento, el elemento se envía una vez que el complemento finaliza su procesamiento.

Activación de alertas inteligentes en aplicaciones que usan MAPI simple

Nota:

Esta característica solo se admite actualmente en Outlook 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:

1. Descargue la herramienta de plantillas administrativas más recientes.
2. Abra el Editor de directivas de grupo local (gpedit.msc).
3. Vaya a Configuración de usuario\Plantillas administrativas\Microsoft Outlook 2016\Varios.
4. Abra la opción Running Outlook for Simple MAPI Mail Sending (Ejecución de Outlook para envío de correo MAPI simple ).
5. En el cuadro de diálogo que aparece, seleccione Habilitado.
6. 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í.
• El formato del mensaje. Por ejemplo, no puede cambiar el tamaño y el color de fuente del texto ni insertar una lista con viñetas.
• 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.

Si personaliza el botón No enviar en el cuadro de diálogo, solo puede asignarle un comando de panel de tareas. No se admiten los comandos de función. Si selecciona un botón No enviar con un comando de función asignado, el comando se omite y el complemento cancela la operación de envío y cierra el cuadro de diálogo. Cuando esto ocurre, no se muestra o registra ningún error. Para obtener instrucciones sobre los tipos de comandos de complemento, vea Tipos de comandos de complemento.

En Outlook en la Web y en el nuevo Outlook en Windows (versión preliminar):

• 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, el OnAppointmentSend 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.

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 y OnAppointmentSend con validaciones pesadas. Para evitarlo, preprocese información cuando se produzcan otros eventos, como el OnMessageRecipientsChanged evento o OnMessageAttachmentsChanged . 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 (versión preliminar) para proporcionar a los usuarios información y funcionalidad adicionales a través de un panel de tareas.
• 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	Windows (clásico y nuevo (versión preliminar)) Explorador web (interfaz de usuario moderna) Mac (nueva interfaz de usuario)	Windows (clásico) Explorador web (interfaz de usuario clásica y moderna) Mac (interfaz de usuario clásica y nueva)
Eventos admitidos	Manifiesto XML OnMessageSend OnAppointmentSend Manifiesto unificado para Microsoft 365 (versión preliminar) "messageSending" "appointmentSending"	Manifiesto XML ItemSend Manifiesto unificado para Microsoft 365 (versión preliminar) No se admite
Propiedad de extensión de manifiesto	Manifiesto XML LaunchEvent Manifiesto unificado para Microsoft 365 (versión preliminar) “autoRunEvents”	Manifiesto XML Events Manifiesto unificado para Microsoft 365 (versión preliminar) No se admite
Opciones de modo de envío admitidas	preguntar al usuario bloque suave Bloquear 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.

Probar alertas inteligentes en un complemento basado en eventos

¿Listo para implementar alertas inteligentes en un complemento basado en eventos? Pruebe el tutorial en el que creará un complemento que comprueba si un documento o imagen está adjunto a un mensaje antes de enviarlo.

Consulte también

• Controlar eventos OnMessageSend y OnAppointmentSend en el complemento de Outlook con alertas inteligentes
• 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