Información general sobre los complementos de Outlook

Los complementos de Outlook son integraciones que terceros crean en Outlook con nuestra plataforma basada en tecnologías web. Los complementos de Outlook tienen tres aspectos principales:

  • La misma lógica de negocios y de complementos funciona en las versiones de escritorio (Outlook para Windows y Mac), web (Microsoft 365 y Outlook.com) y móvil.
  • Los complementos de Outlook están formados por un manifiesto, que describe cómo se integra el complemento en Outlook (por ejemplo, un botón o un panel de tareas), y por código JavaScript y HTML, que compone la lógica de la interfaz de usuario y la lógica empresarial del complemento.
  • Los complementos de Outlook se pueden comprar en la AppSource o los usuarios finales o administradores pueden descargarlos localmente.

Los complementos de Outlook son diferentes de los complementos COM o VSTO, que son integraciones anteriores específicas de Outlook en Windows. A diferencia de los complementos COM, los complementos de Outlook no instalan código físicamente en el dispositivo o en el cliente de Outlook del usuario. Para un complemento de Outlook, Outlook lee el manifiesto y enlaza los controles especificados en la interfaz de usuario, y luego carga el HTML y JavaScript. Los componentes web lo ejecutan siempre en el contexto de un explorador en un espacio aislado.

Entre los elementos de Outlook compatibles con los complementos se incluyen mensajes de correo, convocatorias, respuestas o cancelaciones de reuniones y citas. Cada complemento de Outlook define el contexto en el que está disponible, incluidos los tipos de elementos y si el usuario está leyendo o redactando un elemento.

Nota

Si tiene previsto publicar el complemento en AppSource y hacer que esté disponible en la experiencia de Office, asegúrese de que cumple las directivas de certificación de marketplace comercial. Por ejemplo, para su validación, el complemento debe funcionar en todas las plataformas que admitan los métodos que defina (para obtener más información, consulte la sección 1120.3 y la página de aplicación de complementos y de disponibilidad de Office).

Puntos de extensión

Los puntos de extensión son la forma en que los complementos se integran con Outlook. La integración se puede hacer de las siguientes maneras.

  • Los complementos pueden declarar los botones que aparecen en superficies de comando a través de mensajes y citas. Para obtener más información, vea Comandos de complementos de Outlook.

    Un complemento con botones de comandos en la cinta de opciones

    Forma sin UI de comando de complemento.

  • Los complementos pueden desvincular coincidencias de expresiones regulares o entidades detectadas en mensajes y citas. Para obtener más información, vea Complementos de Outlook contextuales.

    Un complemento contextual para una entidad resaltada (una dirección)

    Muestra una aplicación contextual de una tarjeta.

Elementos del buzón disponibles para los complementos

Los complementos de Outlook se activan cuando el usuario redacta o lee un mensaje o una cita, pero no otros tipos de elementos. Sin embargo, los complementos no se activan si el elemento de mensaje actual, en forma de redacción o lectura, cumple una de las condiciones siguientes:

  • Está protegido por Information Rights Management (IRM) o cifrado de otras formas de protección. Un mensaje firmado digitalmente es un ejemplo, puesto que la firma digital se basa en uno de estos mecanismos.

    Importante

    • Los complementos se activan en los mensajes firmados digitalmente de Outlook asociados con una suscripción de Microsoft 365. En Windows, este soporte se presentó con la compilación 8711,1000.

    • Empezando por la compilación 13229.10000 de Outlook en Windows, los complementos ahora se pueden activar en elementos protegidos por IRM. Para más información sobre esta característica en versión preliminar, consulte Activación de complementos en elementos protegidos por Information Rights Management (IRM).

  • Es un informe o una notificación de entrega que tiene la clase de mensaje IPM.Report.*, como los informes de entrega y los informes de no entrega (NDR) y las notificaciones de leído, no leído y con retraso.

  • Un archivo .msg o .eml que está adjunto a otro mensaje.

  • Un archivo .msg o .eml abierto desde el sistema de archivos.

  • En un buzón de grupo, en un buzón compartido*, en el buzón de otro usuario*, en un buzón de archivo, o en una carpeta pública.

    Importante

    * La compatibilidad con escenarios de acceso delegado (por ejemplo, carpetas compartidas desde el buzón de otro usuario) se introdujo en el conjunto de requisitos 1.8. La compatibilidad con buzones compartidos está ahora en versión preliminar. Para obtener más información, consulte Habilitar carpetas compartidas y escenarios de buzón compartido.

  • Uso de un formulario personalizado.

  • Creado a través de MAPI simple. MAPI simple se usa cuando un usuario de Office crea o envía un correo electrónico desde una aplicación de Office en Windows mientras Outlook está cerrado. Por ejemplo, un usuario puede crear un correo electrónico de Outlook mientras trabaja en Word. Esto desencadena una ventana de redacción de Outlook sin iniciar la aplicación completa de Outlook. Sin embargo, si Outlook ya se ejecuta cuando el usuario cree el correo electrónico desde Word, ya no hablamos de un escenario MAPI simple. En este caso, los complementos de Outlook funcionan en el formulario de redacción siempre que se cumplan otros requisitos de activación.

Por lo general, Outlook puede activar complementos en formularios de lectura para elementos de la carpeta Elementos enviados, excepto los complementos que se activan en función de coincidencias de entidades conocidas. Para obtener más información sobre los motivos por los que esto ocurre, consulte "Compatibilidad con entidades conocidas" en Coincidencia de cadenas en un elemento de Outlook como entidades conocidas.

En este momento, hay otras consideraciones al diseñar e implementar complementos para clientes móviles. Para obtener más información, consulte Agregar compatibilidad móvil a un complemento de Outlook.

Clientes compatibles

Los complementos de Outlook se admiten en Outlook 2013 o versiones posteriores en Windows, Outlook 2016 o versiones posteriores en Mac, Outlook en la Web para Exchange 2013 local y versiones posteriores, Outlook en iOS, Outlook en Android, Outlook en la Web y Outlook.com. No todas las características más recientes se admiten en todos los clientes al mismo tiempo. Consulte esas características en los artículos y referencias de API para conocer en qué aplicaciones se admiten.

Introducción a la compilación de complementos de Outlook

Para comenzar a compilar complementos de Outlook, pruebe lo siguiente:

  • Inicio rápido: cree un sencillo panel de tareas.
  • Tutorial: infórmese sobre cómo crear un complemento que inserte un gist de GitHub en un nuevo mensaje.

Consulte también