Presencia de Teams y llamada con un clic
Partes 2 y 3 del enlace con Teams (la parte 1 es Direct Routing, teams-direct-routing.md). Código: pbx/crates/integrations/src/teams/ (clave de conector teams), paquete de la app integrations/teams/.
Presencia en ambos sentidos
| Teams (disponibilidad / actividad de Graph) | Estado de la extensión |
|---|---|
| Available, AvailableIdle | available |
| Busy, BusyIdle, InACall, InAConferenceCall, InAMeeting | busy |
| DoNotDisturb, Presenting | dnd |
| Away, BeRightBack | away |
| Offline, PresenceUnknown | offline |
De la extensión a Teams se usa setPresence (id de sesión = el client id de la app, una hora, se renueva en el siguiente cambio); offline llama a clearPresence, de modo que Teams vuelve a mostrar el estado propio del usuario.
Protección contra bucles. Ambos sistemas informan lo que escribimos. Un cambio igual al último estado sincronizado que llega del otro lado dentro de la ventana de eco se descarta (Echo), una repetición es Unchanged, y una llamada en curso en la PBX siempre gana: un cambio de Teams que no sea busy se ignora (CallWins) mientras la extensión está en llamada.
Notificaciones. Una suscripción de Graph por cada 600 usuarios vinculados (/communications/presences?$filter=id in (...), changeType: updated). Las suscripciones de presencia duran como máximo una hora: el planificador renueva cuando faltan 20 minutos, recrea una vencida o perdida (una renovación respondida con 404 pasa a crear) y elimina la de un usuario que se fue. Los eventos de ciclo de vida reauthorizationRequired, subscriptionRemoved y missed se interpretan para que el host actúe. Cada notificación lleva el client_state compartido; una publicación sin él se rechaza completa.
Registro de la app en Entra (trabajo del propietario)
Permisos de aplicación Presence.Read.All, Presence.ReadWrite.All y User.Read.All con consentimiento del administrador, un client secret y la dirección https pública de notificaciones. Los secretos (client_secret, client_state) se sellan en la instalación sin posibilidad de lectura. Todas las llamadas a Graph pasan por el cliente de salida protegido.
Llamada con un clic desde Teams
integrations/teams/manifest.json es una app de Teams (manifiesto 1.17) con una pestaña personal Phone que sirve la PBX en /integrations/teams/tab. Sustituya {{PBX_HOST}} por el host de la PBX, comprima el manifiesto con color.png y outline.png en un zip y cárguelo (o publíquelo en el catálogo de la organización). La pestaña llama a POST /api/v1/calls/click-to-call (click-to-call.md) como el usuario que inició sesión: primero suena el teléfono del usuario, el número se marca cuando contesta, con sus propios permisos de llamada y límites contra fraude telefónico. La prueba teams_app_manifest_is_valid revisa el manifiesto.
La pestaña. La PBX la sirve ella misma: GET /integrations/teams/tab (la página), /integrations/teams/tab/end (la redirección OAuth dentro de la ventana de inicio de sesión) y los dos scripts bajo /integrations/teams/tab/, con su propia Content Security Policy (la del cliente web prohíbe incrustar; esta permite frame-ancestors solo para los hosts de Teams y Microsoft 365 y carga el Teams JS SDK desde res.cdn.office.net). Configuración: registre un cliente OAuth público con POST /oauth/register cuyo único URI de redirección sea https://<PBX_HOST>/integrations/teams/tab/end y ponga su id en el manifiesto como {{MPBX_CLIENT_ID}} (es el parámetro client_id del contentUrl de la pestaña). En el primer uso la pestaña muestra Sign in to MonoPbx: el SDK de Teams (authentication.authenticate) abre la página de consentimiento de la PBX en una ventana emergente (código de autorización con PKCE S256, alcance solo self:read), la redirección de la ventana devuelve code y state a la pestaña, y la pestaña canjea el código en /oauth/token con su verificador. El token se queda en la memoria de la pestaña (nunca en una cookie ni en almacenamiento); cuando vence, o la PBX responde 401, vuelve el botón de inicio de sesión. Los errores se muestran con los mensajes fijos de la app de Jira. Código y pruebas: pbx/bin/mpbx/assets/teams_tab/ y cd integrations/teams && npm test (node, contra una PBX simulada). Falta confirmar en un tenant de Microsoft 365: el flujo de la ventana emergente y la versión del SDK desde el CDN.
Herramientas de IA
int_teams_get_presence e int_teams_set_presence (se ofrecen solo si la lista de permitidos de la instalación las nombra).