¿Es posible enviar mensajes proactivos a todos los usuarios sin que instalen o abran el bot manualmente en Teams?

Joaquin Capdevila Taboada 20 Puntos de reputación
2025-11-25T11:44:21.4366667+00:00

Hola,

Estamos desarrollando un bot para Microsoft Teams que ofrece servicio a múltiples organizaciones (tenants externos) mediante instalación del paquete .zip o publicación en el catálogo privado de cada empresa.

Luego de revisar la documentación más reciente (2024–2025), necesitamos confirmar un punto muy específico:

🔍 Escenario actual

  1. El bot es instalado por un administrador de la organización.
  2. Cada usuario debe abrir el bot manualmente en su Teams (o instalarlo desde el enlace) para que podamos obtener el conversationReference necesario para enviarle mensajes proactivos.
  3. Hasta ese momento, no podemos enviar proactivos, aun teniendo:
    • consentimiento de Graph (User.Read.All / Directory.Read.All)
    • el tenantId
    • la lista completa de usuarios del tenant

❓ Pregunta principal

¿Existe alguna forma soportada oficialmente por Microsoft para que:

  • un administrador instale o asigne el bot a todos los usuarios de la organización,
  • y que el bot pueda enviar mensajes proactivos sin que cada empleado deba abrir o iniciar una conversación con el bot?

Es decir, ¿hay algún mecanismo equivalente a "admin assignment" o "bulk install" que permita a un bot obtener los conversationReferences o iniciar la relación bot→usuario sin interacción previa del usuario?

🧩 Contexto adicional

  • El bot es SingleTenant (recomendación actual).
  • Sabemos que aadObjectId ya no se envía en eventos de Teams.
  • Entendemos que Teams ahora entrega únicamente el ID interno del usuario (29:xxx) y que no es posible vincularlo automáticamente con su identidad del directorio.
  • Proactive messaging funciona correctamente sólo después de que el usuario inicia la conversación.
  • El objetivo es reducir fricción para los usuarios finales y mejorar la adopción.

🙏 Buscamos una confirmación oficial:

  • ¿Existe algún método soportado para permitir envío de proactivos sin interacción previa?
  • ¿Existe alguna API, política de Teams App Setup o mecanismo administrativo que habilite la instalación masiva del bot con capacidad de proactivos?
  • Si no es posible: ¿Microsoft lo tiene previsto o existe algún roadmap relacionado?

Agradecemos cualquier aclaración o referencia oficial.

Muchas gracias.

Microsoft Teams | Microsoft Teams para empresas | Equipos y canales | Otros
0 comentarios

1 respuesta

Ordenar por: Lo más útil
Lo más útil Más reciente Menos reciente
  1. Kudos-Ng 15,055 Puntos de reputación Personal externo de Microsoft Moderador
    2025-11-25T13:17:03.31+00:00

    Nota: Esta respuesta ha sido traducida automáticamente. Como resultado, puede contener errores gramaticales o expresiones incómodas.

    Hola Joaquin Capdevila Taboada

    Gracias por publicar tu pregunta en el foro de preguntas y respuestas de Microsoft

    Sí, Microsoft admite oficialmente esto mediante la instalación proactiva de aplicaciones a través de la API de Microsoft Graph: Instalar aplicación para usuario (Graph API)
    Esto permite que un administrador (o un proceso automatizado con los permisos adecuados) instale el bot como una aplicación personal para los usuarios, activando la configuración necesaria de la conversación sin que los usuarios tengan que abrir o interactuar con el bot previamente.

    Cómo funciona

    • Publica el bot en el catálogo de aplicaciones de tu organización (mediante el Centro de administración de Teams) o en la Tienda de Microsoft Teams. Los bots no publicados o los paquetes .zip cargados manualmente no pueden instalarse mediante Graph.
    • Usa la API de Microsoft Graph para instalar la aplicación para usuarios específicos (o instalar en bloque iterando sobre una lista de usuarios obtenida mediante Graph, utilizando tus permisos existentes User.Read.All y Directory.Read.All).
    • La instalación envía un evento conversationUpdate a tu bot, que incluye los detalles necesarios para almacenar un conversationReference.
    • Con el conversationReference, tu bot puede enviar mensajes proactivos (por ejemplo, notificaciones) inmediatamente.

    Beneficios clave para tu escenario

    • Reduce la fricción del usuario: No es necesario que los usuarios abran el bot manualmente ni lo instalen desde un enlace.
    • Funciona para bots SingleTenant (como en tu caso), donde la aplicación está vinculada a un tenant específico.
    • Los bots solo de notificación (sin respuestas del usuario) están explícitamente soportados para este patrón.

    Limitaciones

    • Los usuarios pueden necesitar reiniciar Teams para ver la aplicación (aunque la mensajería proactiva funciona independientemente).
    • Se aplican límites de velocidad para operaciones masivas (evita instalar para miles de usuarios simultáneamente para prevenir la limitación).
    • No está soportado crear nuevos chats de grupo o canales: solo ámbitos personales o equipos/canales existentes.
    • Si un usuario bloquea o desinstala el bot más adelante, los mensajes proactivos fallarán (con un error 403).

    Espero que la información anterior sea útil. Si tienes cualquier otra pregunta, no dudes en compartirla.

    Si la respuesta es útil, por favor haz clic en "Aceptar respuesta" y dale un voto positivo. Si tienes preguntas adicionales sobre esta respuesta, haz clic en "Comentar".

    Nota: Por favor, siga los pasos en nuestra documentación para habilitar las notificaciones por correo electrónico si desea recibir la notificación correspondiente para este hilo.

    ¿Le resultó útil esta respuesta?

Su respuesta

Las respuestas pueden ser marcadas como Respuestas aceptadas por el autor de la pregunta, lo que indica a los usuarios que la respuesta resolvió su problema.