Complementos para Outlook en dispositivos móviles

Los complementos ahora funcionan en Outlook en dispositivos móviles, con las mismas API disponibles para otros puntos de conexión de Outlook. Si ya ha creado un complemento para Outlook, es fácil que funcione en Outlook mobile.

Los complementos móviles de Outlook son compatibles con todas las cuentas empresariales de Microsoft 365 y las cuentas de Outlook.com. Sin embargo, el soporte técnico no está disponible actualmente en las cuentas de Gmail.

Un panel de tareas de ejemplo en Outlook en iOS

Un panel de tareas de ejemplo en Outlook en Android

¿Cuál es la diferencia en la versión móvil?

• El tamaño pequeño y las interacciones rápidas hacen que el diseño para dispositivos móviles sea un desafío. Para garantizar experiencias de calidad para los clientes, cualquier complemento que declare soporte técnico móvil debe cumplir determinados criterios de validación para ser aprobado en AppSource.

  • El complemento TIENE que cumplir con las directrices de la interfaz de usuario.
  • El escenario para el complemento DEBEtener sentido en el móvil.
  • Tendrá que aceptar nuestro complemento para desarrolladores para complementos en iOS y debe enviar su id. de desarrollador de Apple para su verificación.

• En general, solo se admite el modo de lectura de mensajes. Esto tiene implicaciones para cómo configurar el manifiesto.

  • Manifiesto unificado para Microsoft 365: "mailRead" es el único elemento que debe declarar en la matriz "extensions.ribbons.contexts".
  • Manifiesto XML: MobileMessageReadCommandSurface es el único ExtensionPoint que debe declarar en la sección móvil del manifiesto.

  Sin embargo, existen excepciones.

  1. El modo Organizador de citas es compatible con los complementos integrados del proveedor de reuniones en línea.

     • Manifiesto unificado para Microsoft 365: "onlineMeetingDetailsOrganizer" está permitido en la matriz "extensions.ribbons.contexts".
     • Manifiesto XML: se permite el punto de extensión MobileOnlineMeetingCommandSurface .

     Para obtener más información sobre este escenario, vea Create un complemento móvil de Outlook para un proveedor de reuniones en línea.

  2. El modo Asistente a citas es compatible con complementos integrados creados por proveedores de aplicaciones de administración de notas y relaciones con el cliente (CRM).

     • Manifiesto unificado para Microsoft 365: "logEventMeetingDetailsAttendee" está permitido en la matriz "extensions.ribbons.contexts".
     • Manifiesto XML: se permite el punto de extensión MobileLogEventAppointmentAttendee .

     Para obtener más información sobre este escenario, vea Registrar notas de citas en una aplicación externa en complementos móviles de Outlook.

  3. Los complementos basados en eventos que se activan en el OnNewMessageCompose evento requieren una excepción.

     • Manifiesto unificado para Microsoft 365: los complementos basados en eventos no se tratan como un contexto en el manifiesto unificado, por lo que no hay ninguna excepción para configurar la matriz "extensions.ribbons.contexts". Pero tenga en cuenta que los complementos basados en eventos requieren una propiedad "extensions.autoRunEvents" en el manifiesto.
     • Manifiesto XML: se debe declarar el punto de extensión LaunchEvent.

     Para obtener más información, vea Implementar la activación basada en eventos en complementos móviles de Outlook.

• La API makeEwsRequestAsync no se admite en dispositivos móviles, ya que la aplicación móvil usa api rest para comunicarse con el servidor. Si el back-end de aplicación necesita conectarse al servidor de Exchange, puede usar el token de devolución de llamada para realizar llamadas a la API de REST. Para obtener información, vea Use the Outlook REST APIs from an Outlook add-in (Usar las API de REST de Outlook desde un complemento de Outlook).

• El manifiesto debe declarar compatibilidad móvil, incluidos controles móviles especiales y tamaños de icono.

  • Manifiesto unificado para Microsoft 365: incluya la cadena "mobile" en la matriz "extensions.ribbons.requirements.formFactors" e incluya una matriz "customMobileRibbonGroups" en el objeto tab de la matriz "extensions.ribbons.tabs". El objeto de esta matriz debe incluir un "controls.buttonType" de "MobileButton" y una matriz "controls.icons".
  • Manifiesto XML: incluya MobileFormFactor<> e incluya los tipos correctos de controles y tamaños de icono.

  Para obtener más información, vea Agregar compatibilidad con comandos de complemento en Outlook en dispositivos móviles.

¿Qué es un buen escenario para los complementos móviles de Outlook?

Recuerde que la longitud media de la sesión de Outlook en un teléfono es mucho más corta que en un equipo PC. Eso significa que su complemento debe ser rápido, y el escenario debe permitir que el usuario entre, salga y continúe con el flujo de trabajo de su correo electrónico.

Estos son ejemplos de escenarios que tienen sentido en Outlook mobile.

• El complemento aporta información valiosa en Outlook, lo que ayuda a los usuarios a evaluar su correo electrónico y responder de manera adecuada. Por ejemplo, un complemento de administración de relaciones con clientes (CRM) que permite al usuario ver la información del cliente y compartir la información adecuada.

• El complemento agrega valor al contenido de correo electrónico del usuario guardando la información en un seguimiento, colaboración o sistema similar. Por ejemplo, un complemento que permite a los usuarios convertir correos electrónicos en elementos de tarea para el seguimiento de proyectos o vales de ayuda para un equipo de soporte técnico.

Un ejemplo de interacción del usuario para crear una tarjeta de Trello desde un mensaje de correo electrónico en iOS

Un ejemplo de interacción del usuario para crear una tarjeta de Trello desde un mensaje de correo electrónico en Android

Probar los complementos en dispositivos móviles

Para probar un complemento en Outlook Mobile, primero descargue localmente un complemento con una cuenta de Microsoft 365 o Outlook.com en Outlook en la Web, en Windows (clásico o nuevo (versión preliminar)) o en Mac. Asegúrese de que el manifiesto tiene el formato correcto para contener MobileFormFactor o no se cargará en Outlook Mobile.

Una vez que el complemento esté funcionando, asegúrese de probarlo en diferentes tamaños de pantalla, incluidos teléfonos y tabletas. Debe asegurarse de que cumple las directrices de accesibilidad respecto al contraste, tamaño de fuente y color, así como su uso con un lector de pantalla como VoiceOver en iOS o TalkBack en Android.

La solución de problemas en dispositivos móviles puede ser difícil, ya que es posible que no tenga las herramientas a las que está acostumbrado. Sin embargo, una opción para solucionar problemas en iOS es usar Fiddler (consulte este tutorial sobre cómo usarlo con un dispositivo iOS).

Nota:

Los Outlook en la Web modernos en teléfonos inteligentes iPhone y Android ya no son necesarios ni están disponibles para probar los complementos de Outlook. Además, los complementos no se admiten en Outlook en Android, en iOS y en la web móvil moderna con cuentas de Exchange locales. Algunos dispositivos iOS siguen siendo compatibles con complementos al usar cuentas de Exchange locales con Outlook en la Web clásicas. Para obtener información acerca de los dispositivos compatibles, consulta Requisitos para ejecutar complementos de Office.

Pasos siguientes

Obtenga información sobre:

• Agregue compatibilidad con comandos de complemento en Outlook en dispositivos móviles.
• Implemente las API de JavaScript de Outlook admitidas.
• Diseñar una excelente experiencia móvil para el complemento.
• Obtener un token de acceso y llamar a las API de REST de Outlook desde el complemento.