Microsoft Teams

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Plugin bawaan

openclaw plugins install @openclaw/msteams

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

​

Penyiapan cepat

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"

• Membuat aplikasi Entra ID (Azure AD)
• Menghasilkan client secret
• Membangun dan mengunggah manifest aplikasi Teams (dengan ikon)
• Mendaftarkan bot (dikelola Teams secara default - tidak perlu langganan 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>

​

Tujuan

• Berbicara dengan OpenClaw melalui DM Teams, obrolan grup, atau channel.
• Menjaga routing tetap deterministik: balasan selalu kembali ke channel tempat balasan diterima.
• Secara default menggunakan perilaku channel yang aman (mention diperlukan kecuali dikonfigurasi lain).

​

Penulisan konfigurasi

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

​

Kontrol akses (DM + grup)

• Default: channels.msteams.dmPolicy = "pairing". Pengirim tidak dikenal diabaikan hingga disetujui.
• channels.msteams.allowFrom harus menggunakan ID objek AAD yang stabil atau grup akses pengirim statis seperti accessGroup:core-team.
• Jangan mengandalkan pencocokan UPN/nama tampilan untuk allowlist - keduanya dapat berubah. OpenClaw menonaktifkan pencocokan nama langsung secara default; ikut serta secara eksplisit dengan channels.msteams.dangerouslyAllowNameMatching: true.
• Wizard dapat menyelesaikan nama menjadi ID melalui Microsoft Graph saat kredensial mengizinkan.

• Default: channels.msteams.groupPolicy = "allowlist" (diblokir kecuali Anda menambahkan groupAllowFrom). Gunakan channels.defaults.groupPolicy untuk menimpa default saat belum ditetapkan.
• channels.msteams.groupAllowFrom mengontrol pengirim atau grup akses pengirim statis mana yang dapat memicu dalam obrolan grup/channel (fallback ke channels.msteams.allowFrom).
• Tetapkan groupPolicy: "open" untuk mengizinkan anggota mana pun (tetap dibatasi mention secara default).
• Untuk tidak mengizinkan channel apa pun, tetapkan channels.msteams.groupPolicy: "disabled".

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

• Batasi cakupan balasan grup/channel dengan mencantumkan teams dan channel di bawah channels.msteams.teams.
• Key harus menggunakan ID percakapan Teams yang stabil dari tautan Teams, bukan nama tampilan yang dapat berubah.
• Saat groupPolicy="allowlist" dan allowlist teams ada, hanya teams/channel yang tercantum yang diterima (dibatasi mention).
• Wizard konfigurasi menerima entri Team/Channel dan menyimpannya untuk Anda.
• Saat startup, OpenClaw menyelesaikan nama allowlist team/channel dan pengguna menjadi ID (saat izin Graph mengizinkan) dan mencatat pemetaan; nama team/channel yang tidak terselesaikan disimpan sebagaimana diketik tetapi diabaikan untuk routing secara default kecuali channels.msteams.dangerouslyAllowNameMatching: true diaktifkan.

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

​

Autentikasi terfederasi (sertifikat plus managed identity)

Ditambahkan pada 2026.4.11

​

Opsi A: Autentikasi berbasis sertifikat

1. Buat atau dapatkan sertifikat (format PEM dengan private key).
2. Di Entra ID → App Registration → Certificates & secrets → Certificates → Unggah sertifikat publik.

{
  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

​

Opsi B: Azure Managed Identity

1. Pod/VM bot memiliki managed identity (ditetapkan sistem atau ditetapkan pengguna).
2. Kredensial identitas terfederasi menautkan managed identity ke pendaftaran aplikasi Entra ID.
3. Saat runtime, OpenClaw menggunakan @azure/identity untuk memperoleh token dari endpoint Azure IMDS (169.254.169.254).
4. Token diteruskan ke Teams SDK untuk autentikasi bot.

• Infrastruktur Azure dengan managed identity diaktifkan (identitas workload AKS, App Service, VM)
• Kredensial identitas terfederasi dibuat pada pendaftaran aplikasi Entra ID
• Akses jaringan ke IMDS (169.254.169.254:80) dari 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> (hanya untuk yang ditetapkan pengguna)

​

Penyiapan AKS Workload Identity

1. Aktifkan workload identity pada kluster AKS Anda.
2. Buat kredensial identitas federasi pada pendaftaran aplikasi 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. Anotasikan akun layanan Kubernetes dengan ID klien aplikasi:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. Beri label pada pod untuk injeksi workload identity:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Pastikan akses jaringan ke IMDS (169.254.169.254) - jika menggunakan NetworkPolicy, tambahkan aturan egress yang mengizinkan lalu lintas ke 169.254.169.254/32 pada port 80.

​

Perbandingan jenis autentikasi

​

Pengembangan lokal (tunneling)

# 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"

​

Menguji Bot

teams app doctor <teamsAppId>

1. Instal aplikasi Teams (gunakan tautan instal dari teams app get <id> --install-link)
2. Temukan bot di Teams dan kirim DM
3. Periksa log Gateway untuk aktivitas masuk

​

Variabel lingkungan

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (opsional: "secret" atau "federated")
• MSTEAMS_CERTIFICATE_PATH (federated + sertifikat)
• MSTEAMS_CERTIFICATE_THUMBPRINT (opsional, tidak diperlukan untuk autentikasi)
• MSTEAMS_USE_MANAGED_IDENTITY (federated + managed identity)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (hanya MI yang ditetapkan pengguna)

​

Tindakan info anggota

• Izin RSC Member.Read.Group (sudah ada dalam manifes yang direkomendasikan)
• Untuk lookup lintas tim: izin Graph Application User.Read.All dengan persetujuan admin

​

Konteks riwayat

• channels.msteams.historyLimit mengontrol berapa banyak pesan channel/grup terbaru yang dibungkus ke dalam prompt.
• Fallback ke messages.groupChat.historyLimit. Atur 0 untuk menonaktifkan (default 50).
• Riwayat thread yang diambil difilter berdasarkan daftar izin pengirim (allowFrom / groupAllowFrom), sehingga penyemaian konteks thread hanya menyertakan pesan dari pengirim yang diizinkan.
• Konteks lampiran yang dikutip (ReplyTo* yang diturunkan dari HTML balasan Teams) saat ini diteruskan sebagaimana diterima.
• Dengan kata lain, daftar izin mengatur siapa yang dapat memicu agent; hanya jalur konteks tambahan tertentu yang difilter saat ini.
• Riwayat DM dapat dibatasi dengan channels.msteams.dmHistoryLimit (giliran pengguna). Override per pengguna: channels.msteams.dms["<user_id>"].historyLimit.

​

Izin RSC Teams saat ini (manifes)

• ChannelMessage.Read.Group (Application) - menerima semua pesan channel tanpa @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) - menerima semua pesan chat grup tanpa @mention

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Contoh manifes Teams (disunting)

{
  $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" },
      ],
    },
  },
}

​

Catatan manifes (kolom wajib)

• bots[].botId harus cocok dengan ID Aplikasi Azure Bot.
• webApplicationInfo.id harus cocok dengan ID Aplikasi Azure Bot.
• bots[].scopes harus menyertakan permukaan yang Anda rencanakan untuk digunakan (personal, team, groupChat).
• bots[].supportsFiles: true diperlukan untuk penanganan file dalam cakupan personal.
• authorization.permissions.resourceSpecific harus menyertakan baca/kirim channel jika Anda menginginkan lalu lintas channel.

​

Memperbarui aplikasi yang ada

# 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

​

Kemampuan: hanya RSC vs Graph

​

Dengan hanya Teams RSC (aplikasi terinstal, tanpa izin Graph API)

• Membaca konten teks pesan channel.
• Mengirim konten teks pesan channel.
• Menerima lampiran file personal (DM).

• Isi gambar atau file channel/grup (payload hanya menyertakan stub HTML).
• Mengunduh lampiran yang disimpan di SharePoint/OneDrive.
• Membaca riwayat pesan (di luar event Webhook langsung).

​

Dengan Teams RSC + izin Microsoft Graph Application

• Mengunduh konten yang di-host (gambar yang ditempelkan ke pesan).
• Mengunduh lampiran file yang disimpan di SharePoint/OneDrive.
• Membaca riwayat pesan channel/chat melalui Graph.

​

RSC vs Graph API

​

Media + riwayat yang diaktifkan Graph (diperlukan untuk channel)

1. Di Entra ID (Azure AD) App Registration, tambahkan izin Application Microsoft Graph:
   • ChannelMessage.Read.All (lampiran channel + riwayat)
   • Chat.Read.All atau ChatMessage.Read.All (chat grup)
2. Berikan persetujuan admin untuk tenant.
3. Naikkan versi manifes aplikasi Teams, unggah ulang, dan instal ulang aplikasi di Teams.
4. Keluar sepenuhnya lalu luncurkan ulang Teams untuk menghapus metadata aplikasi yang di-cache.

​

Batasan yang diketahui

​

Timeout Webhook

• Timeout Gateway
• Teams mencoba ulang pesan (menyebabkan duplikasi)
• Balasan yang terlewat

​

Pemformatan

• Pemformatan dasar berfungsi: tebal, miring, code, tautan
• Markdown kompleks (tabel, daftar bertingkat) mungkin tidak dirender dengan benar
• Adaptive Cards didukung untuk jajak pendapat dan pengiriman presentasi semantik (lihat di bawah)

​

Konfigurasi

• channels.msteams.enabled: aktifkan/nonaktifkan channel.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: kredensial bot.
• channels.msteams.webhook.port (default 3978)
• channels.msteams.webhook.path (default /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (default: pairing)
• channels.msteams.allowFrom: daftar yang diizinkan untuk DM (ID objek AAD direkomendasikan). Wizard menyelesaikan nama menjadi ID saat penyiapan ketika akses Graph tersedia.
• channels.msteams.dangerouslyAllowNameMatching: toggle darurat untuk mengaktifkan kembali pencocokan UPN/nama tampilan yang dapat berubah dan perutean nama tim/channel langsung.
• channels.msteams.textChunkLimit: ukuran potongan teks keluar.
• channels.msteams.chunkMode: length (default) atau newline untuk memisahkan pada baris kosong (batas paragraf) sebelum pemotongan berdasarkan panjang.
• channels.msteams.mediaAllowHosts: daftar host yang diizinkan untuk lampiran masuk (default ke domain Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: daftar host yang diizinkan untuk melampirkan header Authorization pada percobaan ulang media (default ke host Graph + Bot Framework).
• channels.msteams.requireMention: wajibkan @mention di channel/grup (default true).
• channels.msteams.replyStyle: thread | top-level (lihat Gaya Balasan).
• channels.msteams.teams.<teamId>.replyStyle: override per tim.
• channels.msteams.teams.<teamId>.requireMention: override per tim.
• channels.msteams.teams.<teamId>.tools: override kebijakan tool default per tim (allow/deny/alsoAllow) yang digunakan saat override channel tidak ada.
• channels.msteams.teams.<teamId>.toolsBySender: override kebijakan tool default per tim per pengirim ("*" wildcard didukung).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: override per channel.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: override per channel.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: override kebijakan tool per channel (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: override kebijakan tool per channel per pengirim ("*" wildcard didukung).
• Kunci toolsBySender sebaiknya menggunakan prefiks eksplisit: channel:, id:, e164:, username:, name: (kunci lama tanpa prefiks masih hanya dipetakan ke id:).
• channels.msteams.actions.memberInfo: aktifkan atau nonaktifkan aksi info anggota yang didukung Graph (default: diaktifkan ketika kredensial Graph tersedia).
• channels.msteams.authType: jenis autentikasi - "secret" (default) atau "federated".
• channels.msteams.certificatePath: path ke file sertifikat PEM (federated + autentikasi sertifikat).
• channels.msteams.certificateThumbprint: thumbprint sertifikat (opsional, tidak diperlukan untuk autentikasi).
• channels.msteams.useManagedIdentity: aktifkan autentikasi managed identity (mode federated).
• channels.msteams.managedIdentityClientId: ID klien untuk managed identity yang ditetapkan pengguna.
• channels.msteams.sharePointSiteId: ID situs SharePoint untuk unggahan file dalam obrolan grup/channel (lihat Mengirim file dalam obrolan grup).

​

Perutean dan sesi

• Kunci sesi mengikuti format agen standar (lihat /concepts/session):
  • Pesan langsung berbagi sesi utama (agent:<agentId>:<mainKey>).
  • Pesan channel/grup menggunakan ID percakapan:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Gaya balasan: thread vs postingan

• thread di channel bergaya Thread → balasan muncul bertingkat dengan canggung
• top-level di channel bergaya Postingan → balasan muncul sebagai postingan tingkat atas terpisah, bukan di dalam thread

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

​

Prioritas resolusi

1. Per channel — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Per tim — channels.msteams.teams.<teamId>.replyStyle
3. Global — channels.msteams.replyStyle
4. Default implisit — diturunkan dari requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Pelestarian konteks thread

​

Lampiran dan gambar

• DM: Gambar dan lampiran file berfungsi melalui API file bot Teams.
• Channel/grup: Lampiran berada di penyimpanan M365 (SharePoint/OneDrive). Payload Webhook hanya menyertakan stub HTML, bukan byte file aktual. Izin Graph API diperlukan untuk mengunduh lampiran channel.
• Untuk pengiriman eksplisit yang mendahulukan file, gunakan action=upload-file dengan media / filePath / path; message opsional menjadi teks/komentar pendamping, dan filename mengganti nama unggahan.

​

Mengirim file dalam obrolan grup

​

Mengapa obrolan grup memerlukan SharePoint

​

Penyiapan

1. Tambahkan izin Graph API di Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) - mengunggah file ke SharePoint
   • Chat.Read.All (Application) - opsional, mengaktifkan tautan berbagi per pengguna
2. Berikan persetujuan admin untuk tenant.
3. Dapatkan ID situs SharePoint Anda:
   # 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. Konfigurasikan OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Perilaku berbagi

​

Perilaku fallback

​

Lokasi file tersimpan

​

Jajak pendapat (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Suara dicatat oleh Gateway di ~/.openclaw/msteams-polls.json.
• Gateway harus tetap online untuk mencatat suara.
• Polling belum memposting ringkasan hasil secara otomatis (periksa file store jika diperlukan).

​

Kartu presentasi

{
  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!"}]}'

​

Format target

# 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" }],
  },
}

​

Pesan proaktif

• Pesan proaktif hanya mungkin setelah pengguna berinteraksi, karena kami menyimpan referensi percakapan pada titik tersebut.
• Lihat /gateway/configuration untuk dmPolicy dan gating allowlist.

​

ID Tim dan Channel (Jebakan Umum)

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)

• Kunci tim = segmen path setelah /team/ (di-URL-decode, misalnya, 19:Bk4j...@thread.tacv2; tenant lama mungkin menampilkan @thread.skype, yang juga valid)
• Kunci channel = segmen path setelah /channel/ (di-URL-decode)
• Abaikan parameter kueri groupId untuk routing OpenClaw. Itu adalah ID grup Microsoft Entra, bukan ID percakapan Bot Framework yang digunakan dalam aktivitas Teams yang masuk.

​

Channel privat

1. Gunakan channel standar untuk interaksi bot
2. Gunakan DM - pengguna selalu dapat mengirim pesan langsung ke bot
3. Gunakan Graph API untuk akses historis (memerlukan ChannelMessage.Read.All)

​

Pemecahan masalah

​

Masalah umum

• Gambar tidak muncul di channel: Izin Graph atau persetujuan admin hilang. Instal ulang aplikasi Teams dan tutup sepenuhnya/buka kembali Teams.
• Tidak ada respons di channel: mention diperlukan secara default; atur channels.msteams.requireMention=false atau konfigurasikan per tim/channel.
• Ketidakcocokan versi (Teams masih menampilkan manifes lama): hapus + tambahkan ulang aplikasi dan tutup Teams sepenuhnya untuk menyegarkan.
• 401 Unauthorized dari webhook: Diharapkan saat menguji secara manual tanpa Azure JWT - berarti endpoint dapat dijangkau tetapi autentikasi gagal. Gunakan Azure Web Chat untuk menguji dengan benar.

​

Kesalahan unggah manifes

• “Icon file cannot be empty”: Manifes merujuk file ikon yang berukuran 0 byte. Buat ikon PNG yang valid (32x32 untuk outline.png, 192x192 untuk color.png).
• “webApplicationInfo.Id already in use”: Aplikasi masih terpasang di tim/chat lain. Temukan dan copot pemasangannya terlebih dahulu, atau tunggu 5-10 menit untuk propagasi.
• “Something went wrong” saat mengunggah: Unggah melalui https://admin.teams.microsoft.com sebagai gantinya, buka DevTools browser (F12) → tab Network, dan periksa body respons untuk kesalahan sebenarnya.
• Sideload gagal: Coba “Upload an app to your org’s app catalog” alih-alih “Upload a custom app” - ini sering melewati pembatasan sideload.

​

Izin RSC tidak berfungsi

1. Verifikasi webApplicationInfo.id sama persis dengan App ID bot Anda
2. Unggah ulang aplikasi dan instal ulang di tim/chat
3. Periksa apakah admin organisasi Anda telah memblokir izin RSC
4. Konfirmasi Anda menggunakan scope yang tepat: ChannelMessage.Read.Group untuk tim, ChatMessage.Read.Chat untuk chat grup

​

Referensi

• Buat Azure Bot - panduan penyiapan Azure Bot
• Teams Developer Portal - buat/kelola aplikasi Teams
• Skema manifes aplikasi Teams
• Terima pesan channel dengan RSC
• Referensi izin RSC
• Penanganan file bot Teams (channel/grup memerlukan Graph)
• Pesan proaktif
• @microsoft/teams.cli - Teams CLI untuk manajemen bot

​

Terkait

• Ikhtisar Channel - semua channel yang didukung
• Pairing - autentikasi DM dan alur pairing
• Grup - perilaku chat grup dan gating mention
• Routing Channel - routing sesi untuk pesan
• Keamanan - model akses dan hardening