Присутствие в Teams и набор номера одним нажатием
Части 2 и 3 связи с Teams (часть 1 — Direct Routing, teams-direct-routing.md). Код: pbx/crates/integrations/src/teams/ (ключ коннектора teams), пакет приложения integrations/teams/.
Присутствие в обе стороны
| Teams (доступность / активность Graph) | Статус внутреннего номера |
|---|---|
| Available, AvailableIdle | available |
| Busy, BusyIdle, InACall, InAConferenceCall, InAMeeting | busy |
| DoNotDisturb, Presenting | dnd |
| Away, BeRightBack | away |
| Offline, PresenceUnknown | offline |
Из внутреннего номера в Teams статус передаётся через setPresence (id сессии = client id приложения, один час, продлевается при следующем изменении); offline вызывает clearPresence, и Teams снова показывает собственное состояние пользователя.
Защита от петель. Обе системы сообщают то, что мы записали. Изменение, равное последнему синхронизированному состоянию и пришедшее с другой стороны в пределах окна эха, отбрасывается (Echo), повтор — Unchanged, а идущий звонок на АТС всегда побеждает: изменение из Teams, не равное busy, игнорируется (CallWins), пока внутренний номер в звонке.
Уведомления. Одна подписка Graph на 600 связанных пользователей (/communications/presences?$filter=id in (...), changeType: updated). Подписки на присутствие живут не более часа: планировщик продлевает, когда остаётся 20 минут, пересоздаёт истёкшую или потерянную (продление, на которое ответили 404, переходит к созданию) и удаляет подписку ушедшего пользователя. События жизненного цикла reauthorizationRequired, subscriptionRemoved и missed разбираются, чтобы хост мог на них реагировать. Каждое уведомление несёт общий client_state; запрос без него отклоняется целиком.
Регистрация приложения Entra (работа владельца)
Права приложения Presence.Read.All, Presence.ReadWrite.All и User.Read.All с согласием администратора, client secret и публичный https-адрес уведомлений. Секреты (client_secret, client_state) запечатываются в установке без возможности чтения. Все вызовы Graph идут через защищённый исходящий клиент.
Набор номера одним нажатием из Teams
integrations/teams/manifest.json — приложение Teams (манифест 1.17) с личной вкладкой Phone, которую обслуживает АТС по адресу /integrations/teams/tab. Замените {{PBX_HOST}} хостом АТС, упакуйте манифест в zip вместе с color.png и outline.png и загрузите его (или опубликуйте в каталоге организации). Вкладка вызывает POST /api/v1/calls/click-to-call (click-to-call.md) от имени вошедшего пользователя: сначала звонит телефон пользователя, номер набирается, когда он ответит, с его собственными правами на звонки и ограничениями защиты от мошенничества. Тест teams_app_manifest_is_valid проверяет манифест.
Вкладка. АТС обслуживает её сама: GET /integrations/teams/tab (страница), /integrations/teams/tab/end (перенаправление OAuth во всплывающем окне входа) и два скрипта в /integrations/teams/tab/ со своей политикой Content Security Policy (политика веб-клиента запрещает встраивание; эта разрешает frame-ancestors только для хостов Teams и Microsoft 365 и загружает Teams JS SDK с res.cdn.office.net). Настройка: зарегистрируйте публичного клиента OAuth через POST /oauth/register, единственный URI перенаправления которого — https://<PBX_HOST>/integrations/teams/tab/end, и укажите его id в манифесте как {{MPBX_CLIENT_ID}} (это параметр client_id в contentUrl вкладки). При первом использовании вкладка показывает Sign in to MonoPbx: Teams SDK (authentication.authenticate) открывает страницу согласия АТС во всплывающем окне (код авторизации с PKCE S256, область только self:read), перенаправление окна возвращает code и state во вкладку, а вкладка обменивает код в /oauth/token со своим верификатором. Токен остаётся в памяти вкладки (никогда не в cookie и не в хранилище); когда он истекает или АТС отвечает 401, кнопка входа появляется снова. Ошибки показываются фиксированными сообщениями приложения Jira. Исходники и тесты: pbx/bin/mpbx/assets/teams_tab/ и cd integrations/teams && npm test (node, против имитации АТС). Ещё предстоит подтвердить в тенанте Microsoft 365: поток во всплывающем окне и версию SDK из CDN.
Инструменты ИИ
int_teams_get_presence и int_teams_set_presence (предлагаются только если список разрешённых установки их называет).