Microsoft Teams

​

Вбудований plugin

openclaw plugins install @openclaw/msteams

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

​

Швидке налаштування

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

• Створює застосунок Entra ID (Azure AD)
• Генерує клієнтський секрет
• Збирає та завантажує маніфест застосунку Teams (з іконками)
• Реєструє бота (за замовчуванням керований Teams - передплата Azure не потрібна)

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

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

Цілі

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

​

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

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

​

Контроль доступу (DM + групи)

• За замовчуванням: channels.msteams.dmPolicy = "pairing". Невідомі відправники ігноруються, доки їх не буде схвалено.
• channels.msteams.allowFrom має використовувати стабільні object ID AAD або статичні групи доступу відправників, як-от accessGroup:core-team.
• Не покладайтеся на зіставлення UPN/display-name для allowlist - вони можуть змінюватися. OpenClaw вимикає пряме зіставлення імен за замовчуванням; увімкніть його явно через channels.msteams.dangerouslyAllowNameMatching: true.
• Майстер може зіставляти імена з ID через Microsoft Graph, коли облікові дані це дозволяють.

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

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

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

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

​

Федеративна автентифікація (сертифікат плюс керована ідентичність)

Додано в 2026.4.11

​

Варіант A: автентифікація на основі сертифіката

1. Згенеруйте або отримайте сертифікат (формат PEM із приватним ключем).
2. В Entra ID → App Registration → Certificates & secrets → Certificates → завантажте публічний сертифікат.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

Варіант B: Azure Managed Identity

1. Pod/VM бота має керовану ідентичність (system-assigned або user-assigned).
2. Облікові дані федеративної ідентичності пов’язують керовану ідентичність із реєстрацією застосунку Entra ID.
3. Під час виконання OpenClaw використовує @azure/identity, щоб отримати токени з Azure IMDS endpoint (169.254.169.254).
4. Токен передається в Teams SDK для автентифікації бота.

• Інфраструктура Azure з увімкненою керованою ідентичністю (AKS workload identity, App Service, VM)
• Облікові дані федеративної ідентичності, створені в реєстрації застосунку Entra ID
• Мережевий доступ до IMDS (169.254.169.254:80) з pod/VM

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

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      managedIdentityClientId: "<MI_CLIENT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (лише для призначеної користувачем)

​

Налаштування AKS Workload Identity

1. Увімкніть workload identity у своєму кластері AKS.
2. Створіть облікові дані федеративної ідентичності у реєстрації застосунку Entra ID:
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. Додайте анотацію до сервісного облікового запису Kubernetes з ID клієнта застосунку:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. Додайте мітку до pod для ін’єкції workload identity:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Переконайтеся в наявності мережевого доступу до IMDS (169.254.169.254) - якщо використовується NetworkPolicy, додайте правило egress, яке дозволяє трафік до 169.254.169.254/32 на порту 80.

​

Порівняння типів автентифікації

​

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

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

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

teams app doctor <teamsAppId>

1. Установіть застосунок Teams (скористайтеся посиланням для встановлення з teams app get <id> --install-link)
2. Знайдіть бота в Teams і надішліть DM
3. Перевірте журнали Gateway на вхідну активність

​

Змінні середовища

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (необов’язково: "secret" або "federated")
• MSTEAMS_CERTIFICATE_PATH (federated + certificate)
• MSTEAMS_CERTIFICATE_THUMBPRINT (необов’язково, не потрібно для автентифікації)
• MSTEAMS_USE_MANAGED_IDENTITY (federated + managed identity)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (лише MI, призначена користувачем)

​

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

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

​

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

• channels.msteams.historyLimit керує тим, скільки останніх повідомлень каналу/групи загортається в prompt.
• Повертається до messages.groupChat.historyLimit. Установіть 0, щоб вимкнути (типово 50).
• Отримана історія thread фільтрується за allowlist відправників (allowFrom / groupAllowFrom), тому початкове наповнення контексту thread включає лише повідомлення від дозволених відправників.
• Контекст цитованих вкладень (ReplyTo*, отриманий із HTML-відповіді Teams) наразі передається як отримано.
• Іншими словами, allowlist визначають, хто може запускати агента; сьогодні фільтруються лише окремі додаткові шляхи контексту.
• Історію 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 app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

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

​

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

# Download, edit, and re-upload the manifest
teams app manifest download <teamsAppId> manifest.json
# Edit manifest.json locally...
teams app manifest upload manifest.json <teamsAppId>
# Version is auto-bumped if content changed

​

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

​

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

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

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

​

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

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

​

RSC проти Graph API

​

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

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

​

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

​

Тайм-аути Webhook

• Тайм-аути Gateway
• Teams повторно надсилає повідомлення (спричиняючи дублікати)
• Відкинуті відповіді

​

Підтримка хмари Teams і URL сервісу

• channels.msteams.cloud вибирає хмарний пресет Teams SDK для автентифікації, перевірки JWT, сервісів токенів і області Graph.
• channels.msteams.serviceUrl вибирає межу кінцевої точки Bot Connector, яка використовується для перевірки збережених посилань на розмови перед проактивними надсиланнями, редагуваннями, видаленнями, картками, опитуваннями, повідомленнями з consent для файлів і поставленими в чергу довготривалими відповідями. Це обов’язково для хмар USGov і DoD SDK. Для China/21Vianet OpenClaw використовує пресет SDK China і приймає збережені/налаштовані URL сервісу лише на хостах каналів Azure China Bot Framework.

{
  "channels": {
    "msteams": {
      "serviceUrl": "https://smba.infra.gcc.teams.microsoft.com/teams"
    }
  }
}

{
  "channels": {
    "msteams": {
      "cloud": "USGov",
      "serviceUrl": "https://smba.infra.gov.teams.microsoft.us/teams"
    }
  }
}

​

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

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

​

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

• channels.msteams.enabled: увімкнути/вимкнути канал.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: облікові дані бота.
• channels.msteams.cloud: хмарне середовище Teams SDK (Public, USGov, USGovDoD або China; стандартно Public). Задавайте це разом із serviceUrl для хмар USGov/DoD SDK; China використовує пресет SDK і збережені посилання на розмови Azure China Bot Framework, а допоміжні функції на базі Graph вимкнено, доки не буде реалізовано маршрутизацію Azure China Graph.
• channels.msteams.serviceUrl: межа URL сервісу Bot Connector для проактивних операцій SDK. Публічна хмара використовує стандартне значення SDK; задайте це для GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High або DoD. China приймає хости каналів Azure China Bot Framework, коли збережене посилання на розмову надходить із Teams, яким керує 21Vianet.
• channels.msteams.webhook.port (стандартно 3978)
• channels.msteams.webhook.path (стандартно /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (стандартно: pairing)
• channels.msteams.allowFrom: allowlist DM (рекомендовано AAD object IDs). Майстер під час налаштування перетворює імена на IDs, коли доступний доступ до Graph.
• channels.msteams.dangerouslyAllowNameMatching: аварійний перемикач для повторного ввімкнення зіставлення змінних UPN/display-name і прямої маршрутизації за іменами team/channel.
• channels.msteams.textChunkLimit: розмір фрагмента вихідного тексту.
• channels.msteams.chunkMode: length (стандартно) або newline, щоб розділяти за порожніми рядками (межами абзаців) перед фрагментацією за довжиною.
• channels.msteams.mediaAllowHosts: allowlist для хостів вхідних вкладень (стандартно домени Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: allowlist для додавання заголовків 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: стандартні перевизначення політики інструментів для команди за відправником (підтримується wildcard "*").
• 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: перевизначення політики інструментів для каналу за відправником (підтримується wildcard "*").
• Ключі toolsBySender мають використовувати явні префікси: channel:, id:, e164:, username:, name: (застарілі ключі без префікса все ще зіставляються лише з id:).
• channels.msteams.actions.memberInfo: увімкнути або вимкнути дію інформації про учасника на базі Graph (стандартно: увімкнено, коли доступні облікові дані Graph).
• channels.msteams.authType: тип автентифікації - "secret" (стандартно) або "federated".
• channels.msteams.certificatePath: шлях до файлу PEM-сертифіката (federated + certificate auth).
• channels.msteams.certificateThumbprint: відбиток сертифіката (необов’язково, не потрібно для auth).
• channels.msteams.useManagedIdentity: увімкнути автентифікацію керованої ідентичності (режим federated).
• channels.msteams.managedIdentityClientId: client ID для user-assigned managed identity.
• channels.msteams.sharePointSiteId: SharePoint site ID для завантажень файлів у групових чатах/каналах (див. Надсилання файлів у групових чатах).

​

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

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

​

Стиль відповіді: гілки проти дописів

• thread у каналі зі стилем гілок → відповіді виглядають незручно вкладеними
• top-level у каналі зі стилем дописів → відповіді з’являються як окремі дописи верхнього рівня замість відповідей у гілці

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

​

Пріоритет розв’язання

1. Для каналу — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Для команди — channels.msteams.teams.<teamId>.replyStyle
3. Глобально — channels.msteams.replyStyle
4. Неявне стандартне значення — виводиться з requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Збереження контексту гілки

​

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

• DM: Зображення та файлові вкладення працюють через файлові API бота Teams.
• Канали/групи: Вкладення зберігаються в сховищі M365 (SharePoint/OneDrive). Корисне навантаження Webhook містить лише 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. Надайте згоду адміністратора для орендаря.
3. Отримайте ID вашого сайту SharePoint:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Налаштуйте OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

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

​

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

​

Розташування збережених файлів

​

Опитування (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Голоси записуються Gateway у SQLite стану Plugin OpenClaw за адресою state/openclaw.sqlite.
• Наявні файли msteams-polls.json імпортуються командою openclaw doctor --fix, а не запущеним Plugin.
• Gateway має залишатися онлайн, щоб записувати голоси.
• Опитування ще не публікують автоматично підсумки результатів, і підтримуваного CLI для результатів опитувань ще немає.

​

Картки презентації

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello!"}]}'

​

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

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

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

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

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

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

​

ID команд і каналів (поширена помилка)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team conversation ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• Ключ команди = сегмент шляху після /team/ (декодований з URL, наприклад 19:Bk4j...@thread.tacv2; старіші орендарі можуть показувати @thread.skype, що також є дійсним)
• Ключ каналу = сегмент шляху після /channel/ (декодований з URL)
• Ігноруйте параметр запиту groupId для маршрутизації OpenClaw. Це ID групи Microsoft Entra, а не ID розмови Bot Framework, який використовується у вхідних активностях Teams.

​

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

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

​

Усунення несправностей

​

Поширені проблеми

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

​

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

• “Icon file cannot be empty”: маніфест посилається на файли іконок розміром 0 байтів. Створіть дійсні PNG-іконки (32x32 для outline.png, 192x192 для color.png).
• “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. Перевірте, чи адміністратор вашої організації не заблокував дозволи RSC
4. Переконайтеся, що використовуєте правильну область: ChannelMessage.Read.Group для команд, ChatMessage.Read.Chat для групових чатів

​

Посилання

• Створення Azure Bot - посібник із налаштування Azure Bot
• Портал розробника Teams - створення застосунків Teams і керування ними
• Схема маніфесту застосунку Teams
• Отримання повідомлень каналу за допомогою RSC
• Довідник дозволів RSC
• Обробка файлів ботом Teams (для каналу/групи потрібен Graph)
• Проактивні повідомлення
• @microsoft/teams.cli - Teams CLI для керування ботами

​

Пов’язане

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