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.

​

Birlikte gelen Plugin

openclaw plugins install @openclaw/msteams

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

​

Hızlı kurulum

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"

• Bir Entra ID (Azure AD) uygulaması oluşturur
• Bir istemci gizli anahtarı üretir
• Bir Teams uygulama manifesti oluşturur ve yükler (simgelerle birlikte)
• Botu kaydeder (varsayılan olarak Teams tarafından yönetilir - Azure aboneliği gerekmez)

{
  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>

​

Hedefler

• Teams DM’leri, grup sohbetleri veya kanalları üzerinden OpenClaw ile konuşun.
• Yönlendirmeyi belirleyici tutun: yanıtlar her zaman geldikleri kanala geri gider.
• Varsayılan olarak güvenli kanal davranışı kullanın (aksi yapılandırılmadıkça bahsetmeler gerekir).

​

Yapılandırma yazmaları

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

​

Erişim denetimi (DM’ler + gruplar)

• Varsayılan: channels.msteams.dmPolicy = "pairing". Bilinmeyen gönderenler onaylanana kadar yok sayılır.
• channels.msteams.allowFrom, kararlı AAD nesne kimlikleri veya accessGroup:core-team gibi statik gönderen erişim grupları kullanmalıdır.
• İzin listeleri için UPN/görünen ad eşleştirmesine güvenmeyin; bunlar değişebilir. OpenClaw, doğrudan ad eşleştirmesini varsayılan olarak devre dışı bırakır; channels.msteams.dangerouslyAllowNameMatching: true ile açıkça etkinleştirin.
• Sihirbaz, kimlik bilgileri izin verdiğinde Microsoft Graph üzerinden adları kimliklere çözebilir.

• Varsayılan: channels.msteams.groupPolicy = "allowlist" (groupAllowFrom eklemediğiniz sürece engellenir). Ayarlanmamışsa varsayılanı geçersiz kılmak için channels.defaults.groupPolicy kullanın.
• channels.msteams.groupAllowFrom, grup sohbetlerinde/kanallarda hangi gönderenlerin veya statik gönderen erişim gruplarının tetikleyebileceğini denetler (channels.msteams.allowFrom değerine geri düşer).
• Herhangi bir üyeye izin vermek için groupPolicy: "open" ayarlayın (varsayılan olarak yine bahsetme kapılıdır).
• Hiçbir kanala izin vermemek için channels.msteams.groupPolicy: "disabled" ayarlayın.

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

• Ekipleri ve kanalları channels.msteams.teams altında listeleyerek grup/kanal yanıtlarının kapsamını belirleyin.
• Anahtarlar, değişebilir görünen adlar yerine Teams bağlantılarındaki kararlı Teams konuşma kimliklerini kullanmalıdır.
• groupPolicy="allowlist" olduğunda ve bir ekip izin listesi mevcut olduğunda yalnızca listelenen ekipler/kanallar kabul edilir (bahsetme kapılı).
• Yapılandırma sihirbazı Team/Channel girdilerini kabul eder ve sizin için saklar.
• Başlangıçta OpenClaw, ekip/kanal ve kullanıcı izin listesi adlarını kimliklere çözer (Graph izinleri izin verdiğinde) ve eşlemeyi günlüğe yazar; çözülemeyen ekip/kanal adları yazıldığı gibi tutulur ancak channels.msteams.dangerouslyAllowNameMatching: true etkinleştirilmediği sürece varsayılan olarak yönlendirme için yok sayılır.

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

​

Federe kimlik doğrulaması (sertifika artı yönetilen kimlik)

2026.4.11’de eklendi

​

Seçenek A: Sertifika tabanlı kimlik doğrulaması

1. Bir sertifika üretin veya edinin (özel anahtarlı PEM biçimi).
2. Entra ID → Uygulama Kaydı → Sertifikalar ve gizli anahtarlar → Sertifikalar → Açık sertifikayı yükleyin.

{
  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

​

Seçenek B: Azure Yönetilen Kimlik

1. Bot pod’u/VM’si bir yönetilen kimliğe sahiptir (sistem tarafından atanan veya kullanıcı tarafından atanan).
2. Bir federe kimlik bilgisi, yönetilen kimliği Entra ID uygulama kaydına bağlar.
3. Çalışma zamanında OpenClaw, Azure IMDS uç noktasından (169.254.169.254) token almak için @azure/identity kullanır.
4. Token, bot kimlik doğrulaması için Teams SDK’ya geçirilir.

• Yönetilen kimliğin etkin olduğu Azure altyapısı (AKS iş yükü kimliği, App Service, VM)
• Entra ID uygulama kaydında oluşturulmuş federe kimlik bilgisi
• Pod/VM’den IMDS’ye (169.254.169.254:80) ağ erişimi

{
  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> (yalnızca kullanıcı tarafından atanan için)

​

AKS İş Yükü Kimliği Kurulumu

1. AKS kümenizde iş yükü kimliğini etkinleştirin.
2. Entra ID uygulama kaydında federe kimlik kimlik bilgisi oluşturun:
   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 hizmet hesabına uygulama istemci kimliğiyle açıklama ekleyin:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. İş yükü kimliği enjeksiyonu için pod’a etiket ekleyin:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS’ye (169.254.169.254) ağ erişimi sağlayın - NetworkPolicy kullanıyorsanız, 80 numaralı bağlantı noktasında 169.254.169.254/32 adresine trafiğe izin veren bir çıkış kuralı ekleyin.

​

Kimlik doğrulama türü karşılaştırması

​

Yerel geliştirme (tünelleme)

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

​

Botu Test Etme

teams app doctor <teamsAppId>

1. Teams uygulamasını yükleyin (teams app get <id> --install-link komutundan yükleme bağlantısını kullanın)
2. Teams içinde botu bulun ve DM gönderin
3. Gelen etkinlik için Gateway günlüklerini kontrol edin

​

Ortam değişkenleri

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (isteğe bağlı: "secret" veya "federated")
• MSTEAMS_CERTIFICATE_PATH (federe + sertifika)
• MSTEAMS_CERTIFICATE_THUMBPRINT (isteğe bağlı, kimlik doğrulama için gerekli değil)
• MSTEAMS_USE_MANAGED_IDENTITY (federe + yönetilen kimlik)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (yalnızca kullanıcı tarafından atanan MI)

​

Üye bilgisi eylemi

• Member.Read.Group RSC izni (önerilen manifestte zaten var)
• Takımlar arası aramalar için: yönetici onayıyla User.Read.All Graph Application izni

​

Geçmiş bağlamı

• channels.msteams.historyLimit, kaç son kanal/grup iletisinin isteme sarılacağını denetler.
• messages.groupChat.historyLimit değerine geri döner. Devre dışı bırakmak için 0 olarak ayarlayın (varsayılan 50).
• Getirilen konu geçmişi, gönderen izin listelerine (allowFrom / groupAllowFrom) göre filtrelenir; bu nedenle konu bağlamı tohumlama yalnızca izin verilen gönderenlerden gelen iletileri içerir.
• Alıntılanan ek bağlamı (Teams yanıt HTML’sinden türetilen ReplyTo*) şu anda alındığı gibi geçirilir.
• Başka bir deyişle, izin listeleri aracıyı kimin tetikleyebileceğini kapılar; bugün yalnızca belirli ek bağlam yolları filtrelenir.
• DM geçmişi channels.msteams.dmHistoryLimit (kullanıcı dönüşleri) ile sınırlandırılabilir. Kullanıcı başına geçersiz kılmalar: channels.msteams.dms["<user_id>"].historyLimit.

​

Geçerli Teams RSC izinleri (manifest)

• ChannelMessage.Read.Group (Application) - @mention olmadan tüm kanal iletilerini al
• 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 olmadan tüm grup sohbeti iletilerini al

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

​

Örnek Teams manifesti (redakte edilmiş)

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

​

Manifest uyarıları (olması zorunlu alanlar)

• bots[].botId, Azure Bot App ID ile eşleşmelidir.
• webApplicationInfo.id, Azure Bot App ID ile eşleşmelidir.
• bots[].scopes, kullanmayı planladığınız yüzeyleri (personal, team, groupChat) içermelidir.
• Kişisel kapsamda dosya işleme için bots[].supportsFiles: true gereklidir.
• Kanal trafiği istiyorsanız authorization.permissions.resourceSpecific, kanal okuma/gönderme izinlerini içermelidir.

​

Mevcut bir uygulamayı güncelleme

# 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

​

Yetenekler: yalnızca RSC ve Graph karşılaştırması

​

Yalnızca Teams RSC ile (uygulama yüklü, Graph API izinleri yok)

• Kanal iletisi metin içeriğini okuma.
• Kanal iletisi metin içeriği gönderme.
• Kişisel (DM) dosya eklerini alma.

• Kanal/grup görüntü veya dosya içerikleri (yük yalnızca HTML yer tutucusu içerir).
• SharePoint/OneDrive içinde depolanan ekleri indirme.
• İleti geçmişini okuma (canlı Webhook olayının ötesinde).

​

Teams RSC + Microsoft Graph Application izinleri ile

• Barındırılan içerikleri indirme (iletilere yapıştırılan görüntüler).
• SharePoint/OneDrive içinde depolanan dosya eklerini indirme.
• Graph aracılığıyla kanal/sohbet ileti geçmişini okuma.

​

RSC ve Graph API karşılaştırması

​

Graph etkin medya + geçmiş (kanallar için gerekli)

1. Entra ID (Azure AD) Uygulama Kaydı içinde Microsoft Graph Application izinleri ekleyin:
   • ChannelMessage.Read.All (kanal ekleri + geçmiş)
   • Chat.Read.All veya ChatMessage.Read.All (grup sohbetleri)
2. Kiracı için yönetici onayı verin.
3. Teams uygulaması manifest sürümünü artırın, yeniden yükleyin ve uygulamayı Teams içinde yeniden yükleyin.
4. Önbelleğe alınmış uygulama meta verilerini temizlemek için Teams’i tamamen kapatıp yeniden başlatın.

​

Bilinen sınırlamalar

​

Webhook zaman aşımları

• Gateway zaman aşımları
• Teams’in iletiyi yeniden denemesi (yinelenenlere neden olur)
• Düşen yanıtlar

​

Biçimlendirme

• Temel biçimlendirme çalışır: kalın, italik, code, bağlantılar
• Karmaşık markdown (tablolar, iç içe listeler) doğru işlenmeyebilir
• Adaptive Cards, anketler ve anlamsal sunum gönderimleri için desteklenir (aşağıya bakın)

​

Yapılandırma

• channels.msteams.enabled: kanalı etkinleştir/devre dışı bırak.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: bot kimlik bilgileri.
• channels.msteams.webhook.port (varsayılan 3978)
• channels.msteams.webhook.path (varsayılan /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (varsayılan: pairing)
• channels.msteams.allowFrom: DM izin listesi (AAD nesne kimlikleri önerilir). Sihirbaz, Graph erişimi mevcut olduğunda kurulum sırasında adları kimliklere çözümler.
• channels.msteams.dangerouslyAllowNameMatching: değiştirilebilir UPN/görünen ad eşleştirmesini ve doğrudan ekip/kanal adı yönlendirmesini yeniden etkinleştirmek için acil durum anahtarı.
• channels.msteams.textChunkLimit: giden metin parçası boyutu.
• channels.msteams.chunkMode: uzunluğa göre parçalamadan önce boş satırlara (paragraf sınırlarına) göre bölmek için length (varsayılan) veya newline.
• channels.msteams.mediaAllowHosts: gelen ek ana makineleri için izin listesi (varsayılan olarak Microsoft/Teams etki alanları).
• channels.msteams.mediaAuthAllowHosts: medya yeniden denemelerinde Authorization üstbilgilerini eklemek için izin listesi (varsayılan olarak Graph + Bot Framework ana makineleri).
• channels.msteams.requireMention: kanallarda/gruplarda @bahsetmeyi zorunlu kıl (varsayılan true).
• channels.msteams.replyStyle: thread | top-level (Yanıt Stili bölümüne bakın).
• channels.msteams.teams.<teamId>.replyStyle: ekip bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.requireMention: ekip bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.tools: kanal geçersiz kılması eksik olduğunda kullanılan varsayılan ekip bazlı araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.toolsBySender: varsayılan ekip bazlı, gönderici bazlı araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: kanal bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: kanal bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: kanal bazlı araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: kanal bazlı, gönderici bazlı araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• toolsBySender anahtarları açık önekler kullanmalıdır: channel:, id:, e164:, username:, name: (eski öneksiz anahtarlar hâlâ yalnızca id: ile eşlenir).
• channels.msteams.actions.memberInfo: Graph destekli üye bilgisi eylemini etkinleştir veya devre dışı bırak (varsayılan: Graph kimlik bilgileri mevcut olduğunda etkin).
• channels.msteams.authType: kimlik doğrulama türü - "secret" (varsayılan) veya "federated".
• channels.msteams.certificatePath: PEM sertifika dosyasının yolu (federated + sertifika kimlik doğrulaması).
• channels.msteams.certificateThumbprint: sertifika parmak izi (isteğe bağlı, kimlik doğrulama için gerekli değildir).
• channels.msteams.useManagedIdentity: yönetilen kimlik doğrulamasını etkinleştir (federated modu).
• channels.msteams.managedIdentityClientId: kullanıcı tarafından atanan yönetilen kimlik için istemci kimliği.
• channels.msteams.sharePointSiteId: grup sohbetlerinde/kanallarda dosya yüklemeleri için SharePoint site kimliği (Grup sohbetlerinde dosya gönderme bölümüne bakın).

​

Yönlendirme ve oturumlar

• Oturum anahtarları standart aracı biçimini izler (/concepts/session bölümüne bakın):
  • Doğrudan iletiler ana oturumu paylaşır (agent:<agentId>:<mainKey>).
  • Kanal/grup iletileri konuşma kimliğini kullanır:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Yanıt stili: konular ile gönderiler

• Konular tarzı bir kanalda thread → yanıtlar garip şekilde iç içe görünür
• Gönderiler tarzı bir kanalda top-level → yanıtlar konu içinde değil, ayrı üst düzey gönderiler olarak görünür

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

​

Çözümleme önceliği

1. Kanal bazında — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Ekip bazında — channels.msteams.teams.<teamId>.replyStyle
3. Genel — channels.msteams.replyStyle
4. Örtük varsayılan — requireMention değerinden türetilir:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Konu bağlamını koruma

​

Ekler ve görseller

• DM’ler: Görseller ve dosya ekleri Teams bot dosya API’leri üzerinden çalışır.
• Kanallar/gruplar: Ekler M365 depolamasında (SharePoint/OneDrive) bulunur. Webhook yükü gerçek dosya baytlarını değil, yalnızca bir HTML taslağını içerir. Kanal eklerini indirmek için Graph API izinleri gereklidir.
• Açık dosya öncelikli gönderimler için action=upload-file değerini media / filePath / path ile kullanın; isteğe bağlı message eşlik eden metin/yorum olur ve filename yüklenen adı geçersiz kılar.

​

Grup sohbetlerinde dosya gönderme

​

Grup sohbetleri neden SharePoint gerektirir?

​

Kurulum

1. Entra ID (Azure AD) → Uygulama Kaydı bölümünde Graph API izinleri ekleyin:
   • Sites.ReadWrite.All (Uygulama) - dosyaları SharePoint’e yükle
   • Chat.Read.All (Uygulama) - isteğe bağlı, kullanıcı bazlı paylaşım bağlantılarını etkinleştirir
2. Kiracı için yönetici onayı verin.
3. SharePoint site kimliğinizi alın:
   # Graph Explorer veya geçerli bir belirteçle curl üzerinden:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Örnek: "contoso.sharepoint.com/sites/BotFiles" konumundaki bir site için
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Yanıt şunu içerir: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. OpenClaw’ı yapılandırın:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Paylaşım davranışı

​

Geri dönüş davranışı

​

Dosyaların saklandığı konum

​

Anketler (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Oylar gateway tarafından ~/.openclaw/msteams-polls.json içinde kaydedilir.
• Oyları kaydetmek için gateway çevrimiçi kalmalıdır.
• Anketler henüz sonuç özetlerini otomatik olarak yayımlamaz (gerekirse depo dosyasını inceleyin).

​

Sunum kartları

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

​

Hedef biçimleri

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

​

Proaktif mesajlaşma

• Proaktif mesajlar yalnızca bir kullanıcı etkileşim kurduktan sonra mümkündür, çünkü bu noktada konuşma referanslarını saklarız.
• dmPolicy ve izin listesi kapısı için /gateway/configuration bölümüne bakın.

​

Ekip ve Kanal ID’leri (Yaygın Tuzak)

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)

• Ekip anahtarı = /team/ sonrasındaki yol segmenti (URL kodu çözülmüş, ör. 19:Bk4j...@thread.tacv2; eski kiracılar @thread.skype gösterebilir, bu da geçerlidir)
• Kanal anahtarı = /channel/ sonrasındaki yol segmenti (URL kodu çözülmüş)
• OpenClaw yönlendirmesi için groupId sorgu parametresini yok sayın. Bu, gelen Teams etkinliklerinde kullanılan Bot Framework konuşma ID’si değil, Microsoft Entra grup ID’sidir.

​

Özel kanallar

1. Bot etkileşimleri için standart kanalları kullanın
2. DM’leri kullanın - kullanıcılar bota her zaman doğrudan mesaj gönderebilir
3. Geçmiş erişimi için Graph API kullanın (ChannelMessage.Read.All gerektirir)

​

Sorun giderme

​

Yaygın sorunlar

• Görüntüler kanallarda görünmüyor: Graph izinleri veya yönetici onayı eksik. Teams uygulamasını yeniden kurun ve Teams’den tamamen çıkıp yeniden açın.
• Kanalda yanıt yok: varsayılan olarak bahsetmeler gereklidir; channels.msteams.requireMention=false ayarlayın veya ekip/kanal bazında yapılandırın.
• Sürüm uyuşmazlığı (Teams hâlâ eski manifest’i gösteriyor): uygulamayı kaldırıp yeniden ekleyin ve yenilemek için Teams’den tamamen çıkın.
• Webhook’tan 401 Unauthorized: Azure JWT olmadan manuel test yaparken beklenir - uç noktanın erişilebilir olduğu ancak kimlik doğrulamanın başarısız olduğu anlamına gelir. Doğru test için Azure Web Chat kullanın.

​

Manifest yükleme hataları

• “Icon file cannot be empty”: Manifest, 0 bayt olan simge dosyalarına başvuruyor. Geçerli PNG simgeleri oluşturun (outline.png için 32x32, color.png için 192x192).
• “webApplicationInfo.Id already in use”: Uygulama hâlâ başka bir ekipte/sohbette kurulu. Önce bulup kaldırın veya yayılma için 5-10 dakika bekleyin.
• Yükleme sırasında “Something went wrong”: Bunun yerine https://admin.teams.microsoft.com üzerinden yükleyin, tarayıcı DevTools’u (F12) → Network sekmesini açın ve gerçek hata için yanıt gövdesini kontrol edin.
• Sideload başarısız: “Upload a custom app” yerine “Upload an app to your org’s app catalog” deneyin; bu genellikle sideload kısıtlamalarını aşar.

​

RSC izinleri çalışmıyor

1. webApplicationInfo.id değerinin botunuzun App ID’siyle tam olarak eşleştiğini doğrulayın
2. Uygulamayı yeniden yükleyin ve ekipte/sohbette yeniden kurun
3. Kuruluş yöneticinizin RSC izinlerini engelleyip engellemediğini kontrol edin
4. Doğru kapsamı kullandığınızı doğrulayın: ekipler için ChannelMessage.Read.Group, grup sohbetleri için ChatMessage.Read.Chat

​

Referanslar

• Azure Bot oluşturma - Azure Bot kurulum kılavuzu
• Teams Developer Portal - Teams uygulamaları oluşturma/yönetme
• Teams uygulama manifest şeması
• RSC ile kanal mesajlarını alma
• RSC izinleri başvurusu
• Teams bot dosya işleme (kanal/grup Graph gerektirir)
• Proaktif mesajlaşma
• @microsoft/teams.cli - bot yönetimi için Teams CLI

​

İlgili

• Kanallar Genel Bakışı - desteklenen tüm kanallar
• Eşleştirme - DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar - grup sohbeti davranışı ve bahsetme kapısı
• Kanal Yönlendirme - mesajlar için oturum yönlendirme
• Güvenlik - erişim modeli ve güçlendirme