Vercel Connect добавил управляемый коннектор для Microsoft Teams

Коротко: что появилось и зачем это нужно

Vercel Connect получил управляемый коннектор для Microsoft Teams. После создания коннектора ваша организация получает Teams‑бота, которым управляет код в проекте Vercel: бот принимает упоминания в каналах и личные сообщения, а ваш код получает эти активности и может отправлять ответы от имени бота через Bot Framework.

Практическая польза в том, что команды разработки могут запускать приложения и агенты, реагирующие на сообщения Teams, без ручного управления приложением в Azure и без необходимости хранить client secret в проекте. Это упрощает интеграцию чатов Teams с backend‑логикой, CI/CD и существующими агентами на Vercel.

Как это работает технически

Как Managed Connector, Vercel сам регистрирует Entra app и Azure Bot resource в вашем тенанте. На этапе настройки требуется администратор тенанта с подпиской Azure — он завершает единовременную конфигурацию. После этого входящие активности из Teams проверяются и пересылаются в ваш проект как Connect trigger.

Создать коннектор можно из панели управления Vercel или через CLI. Пример команды из исходника: vc connect create microsoft-teams --name acme-teams --triggers. После настройки ваш код запрашивает токен только по требованию — вызов getToken из @vercel/connect возвращает scoped токен для Bot Framework API (в исходнике указан scope https://api.botframework.com/.default).

В примере показан простой обработчик POST: получение forwarded activity, запрос токена через @vercel/connect и отправка ответа через Bot Framework API с заголовком Authorization: Bearer <token>. Токены ограничены запрошенными scope и обновляются автоматически.

Практический контекст и управление

Подключённый Teams‑бот подходит для сценариев, где код проекта должен оперативно реагировать на сообщения: команды и агенты могут обрабатывать запросы пользователей, отправлять уведомления в каналы и поддерживать диалог, оставаясь в рамках инфраструктуры Vercel.

Поскольку Vercel регистрирует приложения в тенанте, разработчики избавляются от необходимости хранить client secret вручную. Токены выдаются на запрос и автоматически обновляются, что снижает операционную нагрузку по ротации ключей. При этом доступ коннектора ограничен средами (environments), к которым вы его прикрепляете — коннектор работает только в тех окружениях, где он установлен.

Управлять доступом и отзывом можно из CLI: исходник указывает команду vc connect revoke-tokens для отзыва прав. Кроме того, в документации Vercel Connect и в каталоге коннекторов доступны подробные инструкции и детали конфигурации, включая информацию о том, как интегрировать SDK‑вызовы в существующие обработчики.

Ограничения

Настройка требует участия администратора тенанта с действующей подпиской Azure — без этого регистрация Entra app и Azure Bot не завершится. Это не автономный процесс для обычного пользователя или разработчика без соответствующих прав.

Коннекторы работают только в тех средах Vercel, к которым они прикреплены. Если нужно тестировать или развертывать в отдельной среде, коннектор необходимо добавить туда отдельно.

Хотя токены обновляются автоматически и нет необходимости вручную хранить client secret, интеграция всё равно опирается на инфраструктуру Microsoft Bot Framework и Entra. В случаях сложной логики авторизации или особых требований к правам доступа придётся сверяться с документацией Vercel и Azure, чтобы корректно сопоставить права и области доступа.

Где смотреть дальше

Чтобы начать, используйте консоль Vercel или CLI‑команду для создания Teams‑коннектора и следуйте инструкциям по предоставлению прав администратором тенанта. В исходнике доступны ссылки на документацию Vercel Connect и на карточку Teams‑коннектора в каталоге.

Авторы релиза — Hedi Zandi и Dima Voytenko — подготовили пост с примером кода и командами для быстрого старта. Ознакомьтесь с документацией, чтобы понять нюансы scope‑запросов и работу с Bot Framework API.