Microsoft Teams

​

Paketle 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   # oturum açtığınızı doğrulayın ve kiracı bilgilerinizi görüntüleyin

# Tek seferlik kurulum (oturumlar arasında kalıcı URL):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Her geliştirme oturumunda:
devtunnel host my-openclaw-bot
# Uç noktanız: https://<tunnel-id>.devtunnels.ms/api/messages

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

{
  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ı aracılığıyla OpenClaw ile konuşun.
• Yönlendirmeyi deterministik tutun: yanıtlar her zaman geldikleri kanala geri gider.
• Varsayılan olarak güvenli kanal davranışını kullanın (aksi yapılandırılmadıkça bahsetme gerekir).

​

Yapılandırma yazımları

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

​

Erişim denetimi (DM’ler + gruplar)

• Varsayılan: channels.msteams.dmPolicy = "pairing". Bilinmeyen göndericiler onaylanana kadar yok sayılır.
• channels.msteams.allowFrom, kararlı AAD nesne kimliklerini veya accessGroup:core-team gibi statik gönderici erişim gruplarını 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; etkinleştirmek için channels.msteams.dangerouslyAllowNameMatching: true kullanın.
• Sihirbaz, kimlik bilgileri izin verdiğinde Microsoft Graph aracılığıyla adları kimliklere çözümleyebilir.

• Varsayılan: channels.msteams.groupPolicy = "allowlist" (groupAllowFrom eklemediğiniz sürece engellenir). channels.msteams.groupPolicy ayarlanmamışsa channels.defaults.groupPolicy, paylaşılan varsayılanı geçersiz kılabilir.
• channels.msteams.groupAllowFrom, grup sohbetlerinde/kanallarda hangi göndericilerin veya statik gönderici erişim gruplarının tetikleme yapabileceğini denetler (channels.msteams.allowFrom ayarına geri döner).
• Herhangi bir üyeye izin vermek için groupPolicy: "open" ayarını belirleyin (varsayılan olarak yine bahsetme koşulludur).
• Tüm kanalları engellemek için channels.msteams.groupPolicy: "disabled" ayarını belirleyin.

{
  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.
• Anahtar olarak değiştirilebilir görünen adları değil, Teams bağlantılarındaki kararlı Teams konuşma kimliklerini kullanın (bkz. Ekip ve Kanal Kimlikleri).
• groupPolicy="allowlist" ve bir ekip izin listesi mevcut olduğunda yalnızca listelenen ekipler/kanallar kabul edilir (bahsetme koşuluyla).
• Yapılandırma sihirbazı Team/Channel girdilerini kabul eder ve bunları sizin için saklar.
• Başlatma sırasında OpenClaw, ekip/kanal ve kullanıcı izin listesindeki adları kimliklere çözümler (Graph izinleri elverdiğinde) ve eşlemeyi günlüğe kaydeder. Çözümlenemeyen adlar yazıldığı hâliyle tutulur ancak channels.msteams.dangerouslyAllowNameMatching: true ayarlanmadıkça yönlendirme için yok sayılır.

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

​

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

​

A Seçeneği: Sertifika tabanlı kimlik doğrulaması

1. Bir sertifika oluşturun veya edinin (özel anahtar içeren PEM biçimi).
2. Entra ID → App Registration → Certificates & secrets → Certificates → ortak 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

​

B Seçeneği: Azure Managed Identity

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

• Yönetilen kimliğin etkinleştirildiği Azure altyapısı (AKS iş yükü kimliği, App Service, VM).
• Entra ID uygulama kaydında oluşturulmuş federasyon 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" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (yalnızca kullanıcı tarafından atanan)

​

AKS İş Yükü Kimliği kurulumu

1. AKS kümenizde iş yükü kimliğini etkinleştirin.
2. Entra ID uygulama kaydında bir federasyon 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. Uygulama istemci kimliğiyle Kubernetes hizmet hesabına ek 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 ekleme işlemi için pod’u etiketleyin:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. IMDS’ye (169.254.169.254) ağ erişimine izin verin: NetworkPolicy kullanılıyorsa 80 numaralı bağlantı noktasında 169.254.169.254/32 için bir çıkış kuralı ekleyin.

​

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

​

Yerel geliştirme (tünelleme)

# Tek seferlik kurulum:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Her geliştirme oturumunda:
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 içindeki yükleme bağlantısı).
2. Teams’de botu bulun ve doğrudan ileti gönderin.
3. Gelen etkinlik için Gateway günlüklerini denetleyin.

​

Ortam değişkenleri

​

Üye bilgisi eylemi

• ChannelSettings.Read.Group ve TeamMember.Read.Group RSC izinleri (önerilen manifestte zaten bulunur).

​

Geçmiş bağlamı

• channels.msteams.historyLimit, isteme kaç adet yakın tarihli kanal/grup iletisinin dahil edileceğini denetler. Önce messages.groupChat.historyLimit değerine geri döner, ardından varsayılan olarak 50 değerini kullanır. Devre dışı bırakmak için 0 ayarlayın.
• Getirilen ileti dizisi geçmişi, gönderen izin listelerine (allowFrom / groupAllowFrom) göre filtrelenir; dolayısıyla ileti dizisi bağlamının başlangıç verileri yalnızca izin verilen gönderenlerin iletilerini içerir.
• Alıntılanan ek bağlamı (bir yanıtın kendi eklerindeki Skype Reply şeması HTML’sinden ayrıştırılır) filtrelenmeden aktarılır; gönderen izin listesi filtresi şu anda yalnızca ileti dizisi geçmişinin başlangıç verilerine uygulanır.
• Doğrudan ileti geçmişi, channels.msteams.dmHistoryLimit (kullanıcı sıraları) 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) - tüm kanal iletilerini @bahsetme olmadan alır
• 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) - tüm grup sohbeti iletilerini @bahsetme olmadan alır

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

​

Örnek Teams manifesti (bilgileri gizlenmiş)

{
  $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ı (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.
• authorization.permissions.resourceSpecific, kanal trafiği için kanal okuma/gönderme izinlerini içermelidir.

​

Mevcut bir uygulamayı güncelleme

# Manifesti indirin, düzenleyin ve yeniden yükleyin
teams app manifest download <teamsAppId> manifest.json
# manifest.json dosyasını yerel olarak düzenleyin...
teams app manifest upload manifest.json <teamsAppId>
# İçerik değiştiyse sürüm otomatik olarak artırılır

​

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

​

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

• Kanal iletilerinin metin içeriğini okuma.
• Kanal iletilerinin metin içeriğini gönderme.
• Kişisel (doğrudan ileti) dosya eklerini alma.

• Kanal/grup görüntü veya dosya içerikleri (yük yalnızca bir HTML taslağı içerir).
• SharePoint/OneDrive’da depolanan ekleri indirme.
• Canlı Webhook olayının ötesindeki ileti geçmişini okuma.

​

Teams RSC + Microsoft Graph Application izinleri ile

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

​

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

​

Graph destekli medya + geçmiş

1. Entra ID (Azure AD) App Registration → Graph Application permissions ekleyin:
   • Kanal ekleri ve kanal geçmişi için ChannelMessage.Read.All.
   • Grup sohbeti ekleri ve grup sohbeti geçmişi için Chat.Read.All.
   • Ek baytlarının SharePoint/OneDrive depolama alanından indirilmesi gerektiğinde Files.Read.All; yalnızca geçmiş kullanan kurulumlarda buna gerek yoktur.
2. Kiracı için Grant admin consent işlemini uygulayın.
3. Teams uygulamasının manifest sürümünü artırın, yeniden yükleyin ve uygulamayı Teams’e yeniden kurun.
4. Önbelleğe alınmış uygulama meta verilerini temizlemek için Teams’i tamamen kapatıp yeniden başlatın.

​

Kanal/grup dosyası kurtarma (graphMediaFallback)

{
  channels: {
    msteams: {
      graphMediaFallback: true,
    },
  },
}

​

Bilinen sınırlamalar

​

Webhook zaman aşımları

​

Teams bulutu ve hizmet URL’si desteği

• channels.msteams.cloud; kimlik doğrulama, JWT doğrulaması, token hizmetleri ve Graph kapsamı için Teams SDK bulut ön ayarını seçer.
• channels.msteams.serviceUrl; proaktif gönderimler, düzenlemeler, silmeler, kartlar, anketler, dosya onayı iletileri ve kuyruğa alınmış uzun süreli yanıtlar öncesinde depolanan konuşma referanslarını doğrulamak için kullanılan Bot Connector uç noktası sınırını seçer. USGov ve DoD SDK bulutları için gereklidir. China/21Vianet için OpenClaw, SDK China ön ayarını kullanır ve depolanan/yapılandırılan hizmet URL’lerini yalnızca Azure China Bot Framework kanal ana makinelerinde kabul eder.

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

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

​

Biçimlendirme

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

​

Yapılandırma

• channels.msteams.enabled: kanalı etkinleştirin/devre dışı bırakın.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: bot kimlik bilgileri.
• channels.msteams.cloud: Teams SDK bulut ortamı (Public, USGov, USGovDoD veya China; varsayılan Public). USGov/DoD SDK bulutları için serviceUrl ile ayarlayın; Çin, SDK ön ayarını ve depolanan Azure China Bot Framework konuşma referanslarını kullanır; Azure China Graph yönlendirmesi kullanıma sunulana kadar Graph destekli yardımcılar devre dışıdır.
• channels.msteams.serviceUrl: SDK proaktif işlemleri için Bot Connector hizmet URL’si sınırı. Genel bulut SDK varsayılanını kullanır; GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High veya DoD için ayarlayın. Depolanan konuşma referansı 21Vianet tarafından işletilen Teams’den geldiğinde Çin, Azure China Bot Framework kanal ana makinelerini kabul eder.
• 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). Graph erişimi kullanılabilir olduğunda sihirbaz, 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ştiren acil durum anahtarı.
• channels.msteams.textChunkLimit: karakter cinsinden giden metin parçası boyutu (varsayılan 4000; yapılandırılan değer daha yüksek olsa bile kesin üst sınır 4000).
• channels.msteams.streaming.chunkMode: uzunluğa göre parçalara ayırmadan önce boş satırlardan (paragraf sınırlarından) bölmek için length (varsayılan) veya newline.
• channels.msteams.mediaAllowHosts: gelen eklerin ana makineleri için izin listesi (varsayılan olarak Microsoft/Teams etki alanları: Graph, SharePoint/OneDrive, Teams CDN, Bot Framework, Azure Media Services).
• channels.msteams.mediaAuthAllowHosts: medya yeniden denemelerinde Authorization üstbilgilerinin eklenmesine yönelik izin listesi (varsayılan olarak Graph + Bot Framework ana makineleri).
• channels.msteams.graphMediaFallback: kanal/grup HTML’si dosya işaretçilerini içermediğinde Graph ileti aramalarını etkinleştirin (varsayılan false; bkz. Kanal/grup dosya kurtarma).
• channels.msteams.mediaMaxMb: kanal başına medya boyutu sınırını MB cinsinden geçersiz kılma. Ayarlanmadığında agents.defaults.mediaMaxMb değerine geri döner.
• channels.msteams.requireMention: kanallarda/gruplarda @bahsetme gerektirir (varsayılan true).
• channels.msteams.replyStyle: thread | top-level (bkz. Yanıt biçimi).
• channels.msteams.teams.<teamId>.replyStyle: ekip başına geçersiz kılma.
• channels.msteams.teams.<teamId>.requireMention: ekip başına geçersiz kılma.
• channels.msteams.teams.<teamId>.tools: kanal geçersiz kılması eksik olduğunda kullanılan varsayılan ekip başına araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.toolsBySender: ekip başına ve gönderen başına varsayılan araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: kanal başına geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: kanal başına geçersiz kılma.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: kanal başına araç politikası geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: kanal başına ve gönderen başına araç politikası geçersiz kılmaları ("*" joker karakteri desteklenir).
• toolsBySender anahtarları açık önekler kullanmalıdır: channel:, id:, e164:, username:, name: (önek içermeyen eski anahtarlar hâlâ yalnızca id: ile eşlenir).
• channels.msteams.authType: kimlik doğrulama türü - "secret" (varsayılan) veya "federated".
• channels.msteams.certificatePath: PEM sertifika dosyasının yolu (federe + sertifika kimlik doğrulaması).
• channels.msteams.certificateThumbprint: sertifika parmak izi; kabul edilir, kimlik doğrulaması için zorunlu değildir.
• channels.msteams.useManagedIdentity: yönetilen kimlik doğrulamasını etkinleştirin (federe mod).
• 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 (bkz. Grup sohbetlerinde dosya gönderme).
• channels.msteams.welcomeCard, channels.msteams.groupWelcomeCard, channels.msteams.promptStarters: ilk DM/grup iletişiminde gösterilen karşılama Adaptive Card’ı ve önerilen istem düğmeleri.
• channels.msteams.responsePrefix: giden yanıtların başına eklenen metin.
• channels.msteams.feedbackEnabled (varsayılan true), channels.msteams.feedbackReflection (varsayılan true), channels.msteams.feedbackReflectionCooldownMs: yanıtlarda başparmak yukarı/aşağı geri bildirimi ve olumsuz geri bildirim üzerine düşünme takibi.
• channels.msteams.sso, channels.msteams.delegatedAuth: SSO destekli akışlar için Bot Framework OAuth bağlantısı ve devredilmiş Graph kapsamları; sso.enabled: true, sso.connectionName gerektirir.

​

Yönlendirme ve oturumlar

• Oturum anahtarları standart aracı biçimini izler (bkz. /concepts/session):
  • 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 biçimi: ileti dizileri ve gönderiler

• İleti dizisi biçimindeki bir kanalda thread → yanıtlar uygunsuz biçimde iç içe görünür.
• Gönderi biçimindeki bir kanalda top-level → yanıtlar ileti dizisi içinde olmak yerine 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 başına - channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Ekip başına - channels.msteams.teams.<teamId>.replyStyle
3. Genel - channels.msteams.replyStyle
4. Örtük varsayılan - requireMention üzerinden türetilir:
   • requireMention: true → thread
   • requireMention: false → top-level

​

İleti dizisi bağlamını koruma

​

Ekler ve görüntüler

• DM’ler: görüntüler ve dosya ekleri Teams bot dosya API’leri üzerinden çalışır.
• Kanallar/gruplar: ekler M365 depolama alanı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ça önce dosya göndermek 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 (veya title) yüklenen adı geçersiz kılar.

​

Grup sohbetlerinde dosya gönderme

​

Grup sohbetleri neden SharePoint gerektirir?

​

Kurulum

1. Entra ID (Azure AD) → App Registration içinde Graph API izinlerini ekleyin:
   • Sites.ReadWrite.All (Uygulama) - SharePoint’e dosya yükleyin.
   • ChatMember.Read.All (Uygulama) - grup sohbeti dosya gönderimleri için en az ayrıcalıklı, kiracı genelinde izin. Chat.Read.All de çalışır ve grup sohbeti geçmişi etkinleştirildiğinde bunu zaten kapsar. Sohbet başına alternatif olarak ChatMember.Read.Chat kaynağa özgü onay iznini kullanın.
2. Kiracı için yönetici onayı verin.
3. SharePoint site kimliğinizi alın:
   # Graph Explorer veya geçerli bir belirteçle curl aracılığıyla:
   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: {
         // ... diğer yapılandırmalar ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Paylaşım davranışı

​

Geri dönüş davranışı

​

Dosyaların depolandığı konum

​

Anketler (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> --poll-question "..." --poll-option "..." --poll-option "...".
• Oylar, Gateway tarafından OpenClaw Plugin durumu SQLite veritabanında state/openclaw.sqlite altında kaydedilir.
• Mevcut msteams-polls.json dosyaları, çalışan Plugin tarafından değil, openclaw doctor --fix tarafından içe aktarılır.
• Oyların kaydedilmesi için Gateway çevrimiçi kalmalıdır.
• Anketler sonuç özetlerini otomatik olarak yayımlamaz ve henüz bir anket sonuçları CLI’si yoktur.

​

Sunum kartları

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

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

​

Hedef biçimleri

# Kimliğe göre bir kullanıcıya gönder
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Merhaba"

# Görünen ada göre bir kullanıcıya gönder (Graph API sorgulamasını tetikler)
openclaw message send --channel msteams --target "user:John Smith" --message "Merhaba"

# Bir grup sohbetine veya kanala gönder
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Merhaba"

# Bir konuşmaya sunum kartı gönder
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Merhaba","blocks":[{"type":"text","text":"Merhaba"}]}'

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

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

​

Proaktif mesajlaşma

• OpenClaw konuşma başvurularını bu noktada depoladığı için proaktif mesajlar yalnızca bir kullanıcı etkileşimde bulunduktan sonra gönderilebilir.
• dmPolicy ve izin verilenler listesi denetimi için /gateway/configuration bölümüne bakın.

​

Ekip ve Kanal Kimlikleri (Yaygın Sorun)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Ekip konuşması kimliği (bunun URL kodunu çözün)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Kanal kimliği (bunun URL kodunu çözün)

• Ekip anahtarı = /team/ sonrasındaki yol bölümü (URL kodu çözülmüş, ör. 19:Bk4j...@thread.tacv2; eski kiracılarda yine geçerli olan @thread.skype görünebilir).
• Kanal anahtarı = /channel/ sonrasındaki yol bölümü (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 kimliği değil, Microsoft Entra grup kimliğidir.

​

Özel kanallar

1. Bot etkileşimleri için standart kanalları kullanın.
2. DM’leri kullanın; kullanıcılar her zaman bota doğrudan mesaj gönderebilir.
3. Geçmiş erişimi için Graph API’yi 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 yükleyin ve Teams’i tamamen kapatıp yeniden açın.
• Kanalda yanıt yok: varsayılan olarak bahsetmeler gereklidir; channels.msteams.requireMention=false ayarını belirleyin veya ekip/kanal başına yapılandırın.
• Sürüm uyuşmazlığı (Teams hâlâ eski manifesti gösteriyor): uygulamayı kaldırıp yeniden ekleyin ve yenilemek için Teams’i tamamen kapatın.
• Webhook’tan 401 Unauthorized: Azure JWT olmadan elle test yaparken beklenen bir durumdur; uç noktaya erişilebildiğini ancak kimlik doğrulamanın başarısız olduğunu gösterir. Doğru şekilde test etmek için Azure Web Chat’i kullanın.

​

Manifest yükleme hataları

• “Icon file cannot be empty”: manifest, 0 bayt boyutundaki 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 yüklü. Önce uygulamayı bulup kaldırın veya yayılım 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 denetleyin.
• Sideload başarısız oluyor: “Upload a custom app” yerine “Upload an app to your org’s app catalog” seçeneğini 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 denetleyin.
4. Doğru kapsamı kullandığınızı doğrulayın: ekipler için ChannelMessage.Read.Group, grup sohbetleri için ChatMessage.Read.Chat.

​

Kaynaklar

• Azure Bot oluşturma - Azure Bot kurulum kılavuzu
• Teams Developer Portal - Teams uygulamaları oluşturma/yönetme
• Teams uygulama manifesti ş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 içerikler

• Kanallara Genel Bakış - desteklenen tüm kanallar
• Eşleştirme - DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar - grup sohbeti davranışı ve bahsetme koşulu
• Kanal Yönlendirme - iletiler için oturum yönlendirmesi
• Güvenlik - erişim modeli ve güvenlik sıkılaştırması