Cómo transferir localmente un complemento de Outlook Mobile en un dispositivo iOS administrado

Si administra dispositivos iOS a través de una solución MDM como Microsoft Intune o Jamf, es posible que necesite implementar un complemento interno o personalizado de Outlook Mobile sin publicarlo en la Tienda Office pública. La implementación estándar de complementos a través del centro de administración de Microsoft 365 no inserta complementos en la aplicación Outlook Mobile en iOS. Este artículo explica cómo transferir localmente un complemento de Outlook Mobile en un dispositivo iOS administrado mediante un archivo de manifiesto XML y una directiva MDM. Aprenderá los pasos exactos para preparar el manifiesto, configurar el perfil MDM y verificar que el complemento aparezca en Outlook.

Qué significa la transferencia local para los complementos de Outlook Mobile

Transferir localmente un complemento significa instalarlo directamente desde un archivo de manifiesto en lugar de hacerlo a través de la Tienda Office pública o el centro de administración de Microsoft 365. Para Outlook Mobile en iOS, el manifiesto del complemento debe entregarse como parte de un perfil de configuración MDM. El MDM inserta el manifiesto en el dispositivo y Outlook lo lee al iniciarse. El complemento aparece entonces en la cinta de redacción o lectura según el punto de extensión definido en el manifiesto.

Antes de comenzar, necesita tres cosas:

• Un archivo XML de manifiesto de complemento dirigido a factores de forma móviles.
• Un MDM que admita cargas útiles de configuración personalizadas para iOS. Microsoft Intune es la opción más común.
• Outlook para iOS versión 4.21 o posterior instalado en el dispositivo administrado.

Pasos para preparar e implementar el manifiesto del complemento

1. Cree o actualice el manifiesto del complemento
   Abra su archivo XML de manifiesto de complemento existente. Agregue un elemento con el atributo xmlns establecido en http://schemas.microsoft.com/office/mailappversionoverrides/1.1. Dentro de él, agregue un elemento secundario con xmlns establecido en http://schemas.microsoft.com/office/mailappversionoverrides/1.1/mobile. Defina un elemento que contenga . Dentro del host, agregue un bloque para escritorio y un bloque independiente para iOS y Android. El bloque MobileFormFactor debe incluir los elementos y que coincidan con la lógica de su complemento. Guarde el archivo con extensión .xml.
2. Valide el manifiesto
   Vaya al centro de administración de Microsoft 365 y navegue a Configuración > Aplicaciones integradas. Seleccione Complementos y haga clic en Cargar complemento personalizado. Cargue su archivo de manifiesto. La herramienta de validación comprueba el esquema e informa errores. Corrija cualquier problema antes de continuar. Elimine el complemento cargado después de la validación; no lo implementará a través del centro de administración para dispositivos móviles.
3. Inicie sesión en Microsoft Intune
   Abra el centro de administración de Intune en https://intune.microsoft.com. Vaya a Dispositivos > Perfiles de configuración. Haga clic en Crear perfil. Para Plataforma, seleccione iOS/iPadOS. Para Tipo de perfil, seleccione Plantillas y luego Personalizado. Haga clic en Crear.
4. Configure la carga útil del perfil personalizado
   En la pestaña Aspectos básicos, escriba un nombre como Outlook Mobile Add-In Sideload. En la pestaña Configuración, haga clic en Agregar. Para Nombre, escriba OutlookAddInManifest. Para Descripción, escriba el nombre del complemento. Para URL de carga útil, déjelo en blanco a menos que su manifiesto esté alojado en un servidor HTTPS seguro. Para el contenido real del manifiesto, debe codificar el archivo XML en base64. Use una herramienta como el comando de terminal de macOS base64 -i manifest.xml o un codificador en línea. Copie la cadena base64 y péguela en el campo Carga útil. Para Identificador, escriba com.microsoft.outlook.mobileaddins. Haga clic en Aceptar.
5. Asigne el perfil a un grupo de dispositivos
   En la pestaña Asignaciones, seleccione Incluir grupos y elija el grupo de Azure AD que contiene los dispositivos iOS administrados. Haga clic en Siguiente, revise la configuración y haga clic en Crear. Intune inserta el perfil en los dispositivos dentro del siguiente ciclo de sincronización.
6. Verifique el complemento en el dispositivo iOS
   En un iPhone o iPad administrado, abra Outlook para iOS. Toque el icono más (+) en un mensaje nuevo o una respuesta para abrir la cinta de complementos. El complemento transferido localmente aparece como un icono. Tóquelo para probar su funcionalidad. Si el complemento no aparece, compruebe que el dispositivo recibió el perfil yendo a Ajustes > General > VPN y gestión de dispositivos. Toque el perfil de administración y confirme que la carga útil Outlook Add-In esté listada. También confirme que Outlook para iOS sea la versión 4.21 o posterior en Ajustes > Acerca de.

Fallos comunes de transferencia local y cómo solucionarlos

El complemento no aparece en la cinta

La causa más frecuente es un esquema de manifiesto incorrecto. Verifique que el elemento exista y que el use un valor compatible como MessageReadCommandSurface o MessageComposeCommandSurface. También confirme que la cadena codificada en base64 en la carga útil de Intune esté completa y no contenga saltos de línea. Outlook ignora silenciosamente las cargas útiles mal formadas.

El perfil aparece como no compatible en Intune

Esto generalmente significa que el dispositivo no se ha sincronizado con Intune. Pida al usuario que abra la aplicación Portal de empresa y toque Comprobar estado. Si el dispositivo está supervisado, el perfil se inserta automáticamente. En un dispositivo no supervisado, el usuario debe aceptar manualmente el perfil en Ajustes > General > VPN y gestión de dispositivos.

El complemento funciona en escritorio pero no en iOS

Es posible que el manifiesto defina puntos de extensión solo para DesktopFormFactor. Agregue un bloque MobileFormFactor independiente con el mismo archivo de función y puntos de extensión. El complemento móvil no puede usar el mismo archivo JavaScript si hace referencia a API específicas de escritorio como Office.context.mailbox.item.getRegExMatches. Cree un archivo de función específico para móvil que use solo las API enumeradas en la documentación de complementos de Outlook Mobile.

Perfil personalizado MDM vs implementación centralizada: diferencias clave

Elemento	Perfil personalizado MDM (transferencia local)	Implementación centralizada (centro de administración)
Método de implementación	Carga útil de configuración insertada a través de Intune o Jamf	Manifiesto XML cargado en el centro de administración de Microsoft 365
Clientes de Outlook compatibles	Solo Outlook para iOS (Android requiere una carga útil independiente)	Outlook en Windows, Mac y web
Origen del manifiesto	XML codificado en base64 almacenado en la carga útil del perfil	URL directa a un manifiesto alojado o archivo cargado
Proceso de actualización	Reemplace la carga útil del perfil con una nueva cadena base64	Actualice el manifiesto en el centro de administración o vuelva a publicar la aplicación
Aceptación del usuario	Requerida en dispositivos no supervisados	No se necesita acción del usuario

Este artículo le guio a través de la creación de un manifiesto compatible con móviles, su codificación y su implementación a través de Intune como un perfil de configuración personalizado. Ahora puede transferir localmente complementos internos de Outlook a dispositivos iOS administrados sin publicarlos en la Tienda Office. Como siguiente paso, pruebe el mismo manifiesto en Android creando un perfil de Intune independiente con el identificador com.microsoft.office.outlook.mobileaddins. Para escenarios avanzados, use la herramienta de diagnóstico de complementos de Office en Outlook para iOS para capturar registros cuando el complemento no se cargue.