​

Microsoft Teams

“Полиште всі надії, ті, хто входить сюди.”

​

Вбудований плагін

openclaw plugins install @openclaw/msteams

openclaw plugins install ./path/to/local/msteams-plugin

​

Швидке налаштування (для початківців)

1. Переконайтеся, що плагін Microsoft Teams доступний.
   • У поточних пакетних випусках OpenClaw він уже вбудований.
   • У старіших/власних установленнях його можна додати вручну за допомогою команд вище.
2. Створіть Azure Bot (App ID + client secret + tenant ID).
3. Налаштуйте OpenClaw із цими обліковими даними.
4. Відкрийте /api/messages (порт 3978 типово) через публічний URL або тунель.
5. Установіть пакет застосунку Teams і запустіть gateway.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      appPassword: "<APP_PASSWORD>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

​

Цілі

• Спілкуватися з OpenClaw через DM, групові чати або канали Teams.
• Зберігати детерміновану маршрутизацію: відповіді завжди повертаються в той канал, з якого вони надійшли.
• Типово використовувати безпечну поведінку каналів (потрібні згадки, якщо не налаштовано інакше).

​

Записи конфігурації

{
  channels: { msteams: { configWrites: false } },
}

​

Керування доступом (DM + групи)

• Типово: channels.msteams.dmPolicy = "pairing". Невідомі відправники ігноруються до схвалення.
• У channels.msteams.allowFrom слід використовувати стабільні AAD object ID.
• UPN/відображувані імена можуть змінюватися; пряме зіставлення типово вимкнене й вмикається лише через channels.msteams.dangerouslyAllowNameMatching: true.
• Майстер може розв’язувати імена в ID через Microsoft Graph, якщо облікові дані це дозволяють.

• Типово: channels.msteams.groupPolicy = "allowlist" (заблоковано, доки ви не додасте groupAllowFrom). Використовуйте channels.defaults.groupPolicy, щоб перевизначити типове значення, якщо його не задано.
• channels.msteams.groupAllowFrom визначає, які відправники можуть активувати в групових чатах/каналах (з резервним переходом до channels.msteams.allowFrom).
• Установіть groupPolicy: "open", щоб дозволити будь-якого учасника (згадка все одно типово обов’язкова).
• Щоб заборонити всі канали, установіть channels.msteams.groupPolicy: "disabled".

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["user@org.com"],
    },
  },
}

• Обмежуйте відповіді в групах/каналах, перелічуючи команди й канали в channels.msteams.teams.
• Ключі мають використовувати стабільні team ID і conversation ID каналу.
• Коли groupPolicy="allowlist" і задано список дозволених teams, приймаються лише перелічені команди/канали (із перевіркою згадки).
• Майстер конфігурації приймає записи Team/Channel і зберігає їх для вас.
• Під час запуску OpenClaw розв’язує назви team/channel і списку дозволених користувачів в ID (коли це дозволяють права Graph) і записує відповідність у журнали; нерозв’язані назви team/channel зберігаються як введені, але типово ігноруються для маршрутизації, якщо не ввімкнено channels.msteams.dangerouslyAllowNameMatching: true.

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

Як це працює

1. Переконайтеся, що плагін Microsoft Teams доступний.
   • У поточних пакетних випусках OpenClaw він уже вбудований.
   • У старіших/власних установленнях його можна додати вручну за допомогою команд вище.
2. Створіть Azure Bot (App ID + secret + tenant ID).
3. Створіть пакет застосунку Teams, який посилається на бота та містить наведені нижче дозволи RSC.
4. Завантажте/установіть застосунок Teams у команду (або в особисту область для DM).
5. Налаштуйте msteams у ~/.openclaw/openclaw.json (або через змінні середовища) і запустіть gateway.
6. Gateway типово слухає трафік вебхуків Bot Framework на /api/messages.

​

Налаштування Azure Bot (передумови)

​

Крок 1: Створіть Azure Bot

1. Перейдіть на Create Azure Bot
2. Заповніть вкладку Basics:

   Поле	Значення
   Bot handle	Назва вашого бота, наприклад openclaw-msteams (має бути унікальною)
   Subscription	Виберіть свою підписку Azure
   Resource group	Створіть нову або використайте наявну
   Pricing tier	Free для розробки/тестування
   Type of App	Single Tenant (рекомендовано — див. примітку нижче)
   Creation type	Create new Microsoft App ID

Повідомлення про застарівання: створення нових multi-tenant bot було застаріло після 2025-07-31. Для нових ботів використовуйте Single Tenant.

3. Натисніть Review + create → Create (зачекайте ~1-2 хвилини)

​

Крок 2: Отримайте облікові дані

1. Перейдіть до свого ресурсу Azure Bot → Configuration
2. Скопіюйте Microsoft App ID → це ваш appId
3. Натисніть Manage Password → перейдіть до App Registration
4. У розділі Certificates & secrets → New client secret → скопіюйте Value → це ваш appPassword
5. Перейдіть до Overview → скопіюйте Directory (tenant) ID → це ваш tenantId

​

Крок 3: Налаштуйте кінцеву точку обміну повідомленнями

1. У Azure Bot → Configuration
2. Установіть Messaging endpoint на URL свого вебхука:
   • Продуктивне середовище: https://your-domain.com/api/messages
   • Локальна розробка: використовуйте тунель (див. Локальна розробка нижче)

​

Крок 4: Увімкніть канал Teams

1. У Azure Bot → Channels
2. Натисніть Microsoft Teams → Configure → Save
3. Прийміть Terms of Service

​

Локальна розробка (тунелювання)

ngrok http 3978
# Скопіюйте https URL, наприклад https://abc123.ngrok.io
# Установіть messaging endpoint на: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Використайте свій URL Tailscale funnel як messaging endpoint

​

Teams Developer Portal (альтернатива)

1. Натисніть + New app
2. Заповніть основну інформацію (назва, опис, інформація про розробника)
3. Перейдіть до App features → Bot
4. Виберіть Enter a bot ID manually і вставте App ID свого Azure Bot
5. Позначте області: Personal, Team, Group Chat
6. Натисніть Distribute → Download app package
7. У Teams: Apps → Manage your apps → Upload a custom app → виберіть ZIP

​

Тестування бота

1. У Azure Portal → ваш ресурс Azure Bot → Test in Web Chat
2. Надішліть повідомлення — ви маєте побачити відповідь
3. Це підтверджує, що ваша кінцева точка вебхука працює до налаштування Teams

1. Установіть застосунок Teams (sideload або каталог організації)
2. Знайдіть бота в Teams і надішліть DM
3. Перевірте журнали gateway на вхідну активність

​

Налаштування (мінімальне, лише текст)

1. Переконайтеся, що плагін Microsoft Teams доступний
   • У поточних пакетних випусках OpenClaw він уже вбудований.
   • У старіших/власних установленнях його можна додати вручну:
     • З npm: openclaw plugins install @openclaw/msteams
     • З локального checkout: openclaw plugins install ./path/to/local/msteams-plugin
2. Реєстрація бота
   • Створіть Azure Bot (див. вище) і занотуйте:
     • App ID
     • Client secret (App password)
     • Tenant ID (single-tenant)
3. Маніфест застосунку Teams
   • Додайте запис bot з botId = <App ID>.
   • Області: personal, team, groupChat.
   • supportsFiles: true (потрібно для обробки файлів в особистій області).
   • Додайте дозволи RSC (нижче).
   • Створіть значки: outline.png (32x32) і color.png (192x192).
   • Заархівуйте всі три файли разом: manifest.json, outline.png, color.png.
4. Налаштуйте OpenClaw
   {
     channels: {
       msteams: {
         enabled: true,
         appId: "<APP_ID>",
         appPassword: "<APP_PASSWORD>",
         tenantId: "<TENANT_ID>",
         webhook: { port: 3978, path: "/api/messages" },
       },
     },
   }
   
   Ви також можете використовувати змінні середовища замість ключів конфігурації:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. Кінцева точка бота
   • Установіть Azure Bot Messaging Endpoint на:
     • https://<host>:3978/api/messages (або вибраний вами шлях/порт).
6. Запустіть gateway
   • Канал Teams запускається автоматично, коли доступний вбудований або встановлений вручну плагін і конфігурація msteams існує разом з обліковими даними.

​

Дія інформації про учасника

• Дозвіл RSC Member.Read.Group (уже є в рекомендованому маніфесті)
• Для міжкомандних пошуків: дозвіл Graph Application User.Read.All з admin consent

​

Контекст історії

• channels.msteams.historyLimit визначає, скільки останніх повідомлень каналу/групи загортається в prompt.
• Має резервний перехід до messages.groupChat.historyLimit. Установіть 0, щоб вимкнути (типово 50).
• Отримана історія ланцюжка фільтрується списками дозволених відправників (allowFrom / groupAllowFrom), тому початкове наповнення контексту ланцюжка містить лише повідомлення від дозволених відправників.
• Контекст цитованих вкладень (ReplyTo*, похідний від HTML-відповідей Teams) наразі передається як отримано.
• Іншими словами, списки дозволених визначають, хто може активувати агента; сьогодні фільтруються лише окремі додаткові шляхи контексту.
• Історію DM можна обмежити через channels.msteams.dmHistoryLimit (ходи користувача). Перевизначення для окремих користувачів: channels.msteams.dms["<user_id>"].historyLimit.

​

Поточні дозволи Teams RSC (маніфест)

• ChannelMessage.Read.Group (Application) - отримання всіх повідомлень каналу без @mention
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) - отримання всіх повідомлень групового чату без @mention

​

Приклад маніфесту Teams (з редагуванням)

{
  $schema: "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  manifestVersion: "1.23",
  version: "1.0.0",
  id: "00000000-0000-0000-0000-000000000000",
  name: { short: "OpenClaw" },
  developer: {
    name: "Your Org",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw in Teams", full: "OpenClaw in Teams" },
  icons: { outline: "outline.png", color: "color.png" },
  accentColor: "#5B6DEF",
  bots: [
    {
      botId: "11111111-1111-1111-1111-111111111111",
      scopes: ["personal", "team", "groupChat"],
      isNotificationOnly: false,
      supportsCalling: false,
      supportsVideo: false,
      supportsFiles: true,
    },
  ],
  webApplicationInfo: {
    id: "11111111-1111-1111-1111-111111111111",
  },
  authorization: {
    permissions: {
      resourceSpecific: [
        { name: "ChannelMessage.Read.Group", type: "Application" },
        { name: "ChannelMessage.Send.Group", type: "Application" },
        { name: "Member.Read.Group", type: "Application" },
        { name: "Owner.Read.Group", type: "Application" },
        { name: "ChannelSettings.Read.Group", type: "Application" },
        { name: "TeamMember.Read.Group", type: "Application" },
        { name: "TeamSettings.Read.Group", type: "Application" },
        { name: "ChatMessage.Read.Chat", type: "Application" },
      ],
    },
  },
}

​

Застереження щодо маніфесту (обов’язкові поля)

• bots[].botId має точно збігатися з App ID Azure Bot.
• webApplicationInfo.id має точно збігатися з App ID Azure Bot.
• bots[].scopes мають включати поверхні, які ви плануєте використовувати (personal, team, groupChat).
• bots[].supportsFiles: true потрібне для обробки файлів в особистій області.
• authorization.permissions.resourceSpecific має включати читання/надсилання каналів, якщо ви хочете трафік каналу.

​

Оновлення наявного застосунку

1. Оновіть свій manifest.json новими налаштуваннями
2. Збільште поле version (наприклад, 1.0.0 → 1.1.0)
3. Повторно заархівуйте маніфест зі значками (manifest.json, outline.png, color.png)
4. Завантажте новий zip:
   • Варіант A (Teams Admin Center): Teams Admin Center → Teams apps → Manage apps → знайдіть свій застосунок → Upload new version
   • Варіант B (Sideload): У Teams → Apps → Manage your apps → Upload a custom app
5. Для командних каналів: перевстановіть застосунок у кожній команді, щоб нові дозволи набули чинності
6. Повністю вийдіть і знову запустіть Teams (а не просто закрийте вікно), щоб очистити кешовані метадані застосунку

​

Можливості: лише RSC проти Graph

​

З лише Teams RSC (застосунок установлено, без дозволів Graph API)

• Читання текстового вмісту повідомлень каналу.
• Надсилання текстового вмісту повідомлень каналу.
• Отримання особистих (DM) файлових вкладень.

• Зображення чи вміст файлів у каналах/групах (payload містить лише HTML-заглушку).
• Завантаження вкладень, що зберігаються в SharePoint/OneDrive.
• Читання історії повідомлень (поза поточною подією вебхука).

​

З Teams RSC + дозволами Microsoft Graph Application

• Завантаження розміщеного вмісту (зображення, вставлені в повідомлення).
• Завантаження файлових вкладень, що зберігаються в SharePoint/OneDrive.
• Читання історії повідомлень каналів/чатів через Graph.

​

RSC проти Graph API

​

Медіа + історія з Graph (потрібно для каналів)

1. У Entra ID (Azure AD) App Registration додайте дозволи Microsoft Graph Application permissions:
   • ChannelMessage.Read.All (вкладення каналів + історія)
   • Chat.Read.All або ChatMessage.Read.All (групові чати)
2. Надайте admin consent для tenant.
3. Збільште версію маніфесту застосунку Teams, повторно завантажте його та перевстановіть застосунок у Teams.
4. Повністю вийдіть і знову запустіть Teams, щоб очистити кешовані метадані застосунку.

​

Відомі обмеження

​

Тайм-аути вебхуків

• тайм-аути gateway
• повторну спробу надсилання повідомлення з боку Teams (що спричиняє дублікати)
• втрачені відповіді

​

Форматування

• Базове форматування працює: жирний, курсив, code, посилання
• Складний Markdown (таблиці, вкладені списки) може відображатися некоректно
• Adaptive Cards підтримуються для Polls і довільного надсилання карток (див. нижче)

​

Конфігурація

• channels.msteams.enabled: увімкнути/вимкнути канал.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: облікові дані бота.
• channels.msteams.webhook.port (типово 3978)
• channels.msteams.webhook.path (типово /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (типово: pairing)
• channels.msteams.allowFrom: список дозволених для DM (рекомендовано AAD object ID). Майстер під час налаштування розв’язує імена в ID, коли доступний Graph.
• channels.msteams.dangerouslyAllowNameMatching: аварійний перемикач, який знову вмикає зіставлення за змінними UPN/відображуваними іменами та пряму маршрутизацію за назвами team/channel.
• channels.msteams.textChunkLimit: розмір вихідного текстового блока.
• channels.msteams.chunkMode: length (типово) або newline для розбиття за порожніми рядками (межі абзаців) перед розбиттям за довжиною.
• channels.msteams.mediaAllowHosts: список дозволених хостів для вхідних вкладень (типово домени Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: список дозволених хостів для додавання заголовків Authorization під час повторних спроб медіа (типово хости Graph + Bot Framework).
• channels.msteams.requireMention: вимагати @mention у каналах/групах (типово true).
• channels.msteams.replyStyle: thread | top-level (див. Стиль відповіді).
• channels.msteams.teams.<teamId>.replyStyle: перевизначення для окремої команди.
• channels.msteams.teams.<teamId>.requireMention: перевизначення для окремої команди.
• channels.msteams.teams.<teamId>.tools: типові перевизначення політики інструментів для окремої команди (allow/deny/alsoAllow), що використовуються, коли перевизначення каналу відсутнє.
• channels.msteams.teams.<teamId>.toolsBySender: типові перевизначення політики інструментів для окремої команди й окремого відправника (підтримується шаблон "*").
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: перевизначення для окремого каналу.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: перевизначення для окремого каналу.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: перевизначення політики інструментів для окремого каналу (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: перевизначення політики інструментів для окремого каналу й окремого відправника (підтримується шаблон "*").
• Ключі toolsBySender мають використовувати явні префікси: id:, e164:, username:, name: (застарілі ключі без префікса все ще зіставляються лише з id:).
• channels.msteams.actions.memberInfo: увімкнути або вимкнути дію member info через Graph (типово: увімкнено, коли доступні облікові дані Graph).
• channels.msteams.sharePointSiteId: ID сайту SharePoint для вивантаження файлів у групових чатах/каналах (див. Надсилання файлів у групових чатах).

​

Маршрутизація та сесії

• Ключі сесій дотримуються стандартного формату агента (див. /concepts/session):
  • Прямі повідомлення використовують основну сесію (agent:<agentId>:<mainKey>).
  • Повідомлення каналів/груп використовують ID розмови:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Стиль відповіді: ланцюжки проти дописів

• thread у каналі стилю Threads → відповіді виглядають незграбно вкладеними
• top-level у каналі стилю Posts → відповіді відображаються як окремі дописи верхнього рівня, а не в ланцюжку

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

Вкладення та зображення

• DM: зображення та файлові вкладення працюють через файлові API ботів Teams.
• Канали/групи: вкладення живуть у сховищі M365 (SharePoint/OneDrive). Payload вебхука містить лише HTML-заглушку, а не реальні байти файлу. Для завантаження вкладень каналів потрібні дозволи Graph API.
• Для явних надсилань, де файл є основним, використовуйте action=upload-file з media / filePath / path; необов’язкове message стає супровідним текстом/коментарем, а filename перевизначає назву вивантаженого файлу.

​

Надсилання файлів у групових чатах

​

Чому для групових чатів потрібен SharePoint

​

Налаштування

1. Додайте дозволи Graph API у Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) - вивантаження файлів у SharePoint
   • Chat.Read.All (Application) - необов’язково, вмикає посилання для доступу на рівні користувача
2. Надайте admin consent для tenant.
3. Отримайте ID свого сайту SharePoint:
   # Через Graph Explorer або curl із дійсним токеном:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Приклад: для сайту за адресою "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Відповідь містить: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Налаштуйте OpenClaw:
   {
     channels: {
       msteams: {
         // ... інша конфігурація ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Поведінка спільного доступу

​

Поведінка резервного переходу

​

Де зберігаються файли

​

Polls (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Голоси записуються gateway у ~/.openclaw/msteams-polls.json.
• Щоб записувати голоси, gateway має залишатися онлайн.
• Polls поки що не публікують підсумки результатів автоматично (за потреби переглядайте файл сховища).

​

Adaptive Cards (довільні)

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  card: {
    type: "AdaptiveCard",
    version: "1.5",
    body: [{ type: "TextBlock", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

​

Формати цілей

# Надіслати користувачу за ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Надіслати користувачу за відображуваним ім’ям (запускає пошук через Graph API)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Надіслати в груповий чат або канал
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Надіслати Adaptive Card у розмову
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Hello!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  card: {
    type: "AdaptiveCard",
    version: "1.5",
    body: [{ type: "TextBlock", text: "Hello" }],
  },
}

​

Проактивні повідомлення

• Проактивні повідомлення можливі лише після того, як користувач уже взаємодіяв, оскільки саме тоді ми зберігаємо посилання на розмову.
• Параметри dmPolicy і перевірку списку дозволених див. у /gateway/configuration.

​

ID команд і каналів (типова пастка)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team ID (URL-декодуйте це)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-декодуйте це)

• Team ID = сегмент шляху після /team/ (URL-декодований, наприклад 19:Bk4j...@thread.tacv2)
• Channel ID = сегмент шляху після /channel/ (URL-декодований)
• Параметр запиту groupId ігноруйте

​

Приватні канали

1. Використовуйте стандартні канали для взаємодії з ботом
2. Використовуйте DM — користувачі завжди можуть писати боту напряму
3. Використовуйте Graph API для історичного доступу (потрібен ChannelMessage.Read.All)

​

Усунення проблем

​

Типові проблеми

• Зображення не показуються в каналах: бракує дозволів Graph або admin consent. Перевстановіть застосунок Teams і повністю закрийте/відкрийте Teams.
• Немає відповідей у каналі: типово потрібні згадки; установіть channels.msteams.requireMention=false або налаштуйте для окремої команди/каналу.
• Невідповідність версій (Teams усе ще показує старий маніфест): видаліть і знову додайте застосунок та повністю перезапустіть Teams для оновлення.
• 401 Unauthorized від вебхука: це очікувано під час ручного тестування без Azure JWT — означає, що кінцева точка доступна, але автентифікація не пройшла. Для коректного тестування використовуйте Azure Web Chat.

​

Помилки завантаження маніфесту

• “Icon file cannot be empty”: маніфест посилається на файли значків розміром 0 байт. Створіть коректні значки PNG (outline.png 32x32, color.png 192x192).
• “webApplicationInfo.Id already in use”: застосунок усе ще встановлений в іншій команді/чаті. Спочатку знайдіть і видаліть його або зачекайте 5-10 хвилин на поширення змін.
• “Something went wrong” під час завантаження: натомість завантажуйте через https://admin.teams.microsoft.com, відкрийте DevTools браузера (F12) → вкладка Network і перевірте тіло відповіді, щоб побачити фактичну помилку.
• Не вдається sideload: спробуйте “Upload an app to your org’s app catalog” замість “Upload a custom app” — це часто обходить обмеження sideload.

​

Дозволи RSC не працюють

1. Переконайтеся, що webApplicationInfo.id точно збігається з App ID вашого бота
2. Повторно завантажте застосунок і перевстановіть його в команді/чаті
3. Перевірте, чи адміністратор вашої org не заблокував дозволи RSC
4. Підтвердьте, що ви використовуєте правильну область: ChannelMessage.Read.Group для команд, ChatMessage.Read.Chat для групових чатів

​

Посилання

• Create Azure Bot - посібник із налаштування Azure Bot
• Teams Developer Portal - створення/керування застосунками Teams
• Схема маніфесту застосунку Teams
• Отримання повідомлень каналу через RSC
• Довідник дозволів RSC
• Обробка файлів ботом Teams (для каналу/групи потрібен Graph)
• Проактивні повідомлення

​

Пов’язане

• Огляд каналів — усі підтримувані канали
• Парування — автентифікація DM і потік парування
• Групи — поведінка групового чату й перевірка згадки
• Маршрутизація каналів — маршрутизація сесій для повідомлень
• Безпека — модель доступу та зміцнення безпеки