​

Microsoft Teams

“Buraya girenler, bütün umutlarını bıraksın.”

​

Paketlenmiş plugin

openclaw plugins install @openclaw/msteams

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

​

Hızlı kurulum (başlangıç)

1. Microsoft Teams plugin’inin kullanılabilir olduğundan emin olun.
   • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten içerir.
   • Eski/özel kurulumlar yukarıdaki komutlarla bunu manuel olarak ekleyebilir.
2. Bir Azure Bot oluşturun (App ID + istemci gizli anahtarı + tenant ID).
3. OpenClaw’ı bu kimlik bilgileriyle yapılandırın.
4. /api/messages uç noktasını (varsayılan olarak 3978 portu) herkese açık bir URL veya tünel üzerinden erişilebilir hale getirin.
5. Teams uygulama paketini yükleyin ve gateway’i başlatın.

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

​

Hedefler

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

​

Yapılandırma yazımları

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

​

Erişim denetimi (DM’ler + gruplar)

• Varsayılan: channels.msteams.dmPolicy = "pairing". Onaylanana kadar bilinmeyen göndericiler yok sayılır.
• channels.msteams.allowFrom, kararlı AAD nesne kimliklerini kullanmalıdır.
• UPN’ler/görünen adlar değiştirilebilir; doğrudan eşleştirme varsayılan olarak devre dışıdır ve yalnızca channels.msteams.dangerouslyAllowNameMatching: true ile etkinleştirilir.
• Sihirbaz, kimlik bilgileri izin verdiğinde adları Microsoft Graph aracılığıyla kimliklere çözümleyebilir.

• Varsayılan: channels.msteams.groupPolicy = "allowlist" (groupAllowFrom eklemediğiniz sürece engellenir). Ayarlanmadığında varsayılanı geçersiz kılmak için channels.defaults.groupPolicy kullanın.
• channels.msteams.groupAllowFrom, grup sohbetlerinde/kanallarda hangi göndericilerin tetikleyebileceğini kontrol eder (channels.msteams.allowFrom’a geri düşer).
• Herhangi bir üyeye izin vermek için groupPolicy: "open" ayarlayın (varsayılan olarak yine mention kapılıdır).
• Hiç kanala izin vermemek için channels.msteams.groupPolicy: "disabled" ayarlayın.

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

• Takımları ve kanalları channels.msteams.teams altında listeleyerek grup/kanal yanıtlarının kapsamını belirleyin.
• Anahtarlar kararlı takım kimliklerini ve kanal konuşma kimliklerini kullanmalıdır.
• groupPolicy="allowlist" olduğunda ve bir takım izin listesi bulunduğunda, yalnızca listelenen takımlar/kanallar kabul edilir (mention kapılı).
• Yapılandırma sihirbazı Team/Channel girdilerini kabul eder ve bunları sizin için depolar.
• Başlangıçta OpenClaw, takım/kanal ve kullanıcı izin listesi adlarını kimliklere çözümler (Graph izinleri izin verdiğinde) ve eşlemeyi günlüğe kaydeder; çözümlenemeyen takım/kanal adları yazıldığı gibi korunur ancak varsayılan olarak yönlendirme için yok sayılır; channels.msteams.dangerouslyAllowNameMatching: true etkinleştirilirse bu davranış değişir.

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

​

Nasıl çalışır

1. Microsoft Teams plugin’inin kullanılabilir olduğundan emin olun.
   • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten içerir.
   • Eski/özel kurulumlar yukarıdaki komutlarla bunu manuel olarak ekleyebilir.
2. Bir Azure Bot oluşturun (App ID + secret + tenant ID).
3. Bot’a referans veren ve aşağıdaki RSC izinlerini içeren bir Teams uygulama paketi oluşturun.
4. Teams uygulamasını bir takıma yükleyin/kurun (veya DM’ler için kişisel kapsamda).
5. ~/.openclaw/openclaw.json içinde (veya ortam değişkenleriyle) msteams yapılandırmasını yapın ve gateway’i başlatın.
6. Gateway varsayılan olarak /api/messages üzerinde Bot Framework webhook trafiğini dinler.

​

Azure Bot Kurulumu (Ön koşullar)

​

Adım 1: Azure Bot oluşturun

1. Azure Bot Oluştur sayfasına gidin
2. Basics sekmesini doldurun:

   Alan	Değer
   Bot handle	Bot adınız, örn. openclaw-msteams (benzersiz olmalıdır)
   Subscription	Azure aboneliğinizi seçin
   Resource group	Yeni oluşturun veya mevcut olanı kullanın
   Pricing tier	Geliştirme/test için Free
   Type of App	Single Tenant (önerilir - aşağıdaki nota bakın)
   Creation type	Create new Microsoft App ID

Kullanımdan kaldırma bildirimi: Yeni multi-tenant botların oluşturulması 2025-07-31 sonrasında kullanımdan kaldırıldı. Yeni botlar için Single Tenant kullanın.

3. Review + create → Create seçeneğine tıklayın (yaklaşık 1-2 dakika bekleyin)

​

Adım 2: Kimlik bilgilerini alın

1. Azure Bot kaynağınıza gidin → Configuration
2. Microsoft App ID değerini kopyalayın → bu sizin appId değerinizdir
3. Manage Password seçeneğine tıklayın → App Registration sayfasına gidin
4. Certificates & secrets altında → New client secret → Value değerini kopyalayın → bu sizin appPassword değerinizdir
5. Overview sayfasına gidin → Directory (tenant) ID değerini kopyalayın → bu sizin tenantId değerinizdir

​

Adım 3: Mesajlaşma uç noktasını yapılandırın

1. Azure Bot → Configuration
2. Messaging endpoint değerini webhook URL’nize ayarlayın:
   • Üretim: https://your-domain.com/api/messages
   • Yerel geliştirme: Bir tünel kullanın (aşağıda Yerel Geliştirme bölümüne bakın)

​

Adım 4: Teams Kanalını Etkinleştirin

1. Azure Bot → Channels
2. Microsoft Teams seçeneğine tıklayın → Configure → Save
3. Hizmet Koşullarını kabul edin

​

Yerel Geliştirme (Tünelleme)

ngrok http 3978
# https URL'sini kopyalayın, örn. https://abc123.ngrok.io
# Mesajlaşma uç noktasını şuna ayarlayın: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Tailscale funnel URL'nizi mesajlaşma uç noktası olarak kullanın

​

Teams Developer Portal (Alternatif)

1. + New app seçeneğine tıklayın
2. Temel bilgileri doldurun (ad, açıklama, geliştirici bilgileri)
3. App features → Bot bölümüne gidin
4. Enter a bot ID manually seçeneğini seçin ve Azure Bot App ID’nizi yapıştırın
5. Kapsamları işaretleyin: Personal, Team, Group Chat
6. Distribute → Download app package seçeneğine tıklayın
7. Teams’te: Apps → Manage your apps → Upload a custom app → ZIP dosyasını seçin

​

Botu test etme

1. Azure Portal → Azure Bot kaynağınız → Test in Web Chat
2. Bir mesaj gönderin - bir yanıt görmelisiniz
3. Bu, Teams kurulumundan önce webhook uç noktanızın çalıştığını doğrular

1. Teams uygulamasını kurun (sideload veya kuruluş kataloğu)
2. Botu Teams içinde bulun ve bir DM gönderin
3. Gelen etkinlik için gateway günlüklerini kontrol edin

​

Kurulum (yalnızca en düşük metin desteği)

1. Microsoft Teams plugin’inin kullanılabilir olduğundan emin olun
   • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten içerir.
   • Eski/özel kurulumlar bunu manuel olarak ekleyebilir:
     • npm üzerinden: openclaw plugins install @openclaw/msteams
     • Yerel bir checkout üzerinden: openclaw plugins install ./path/to/local/msteams-plugin
2. Bot kaydı
   • Bir Azure Bot oluşturun (yukarıya bakın) ve şunları not edin:
     • App ID
     • İstemci gizli anahtarı (App password)
     • Tenant ID (single-tenant)
3. Teams uygulama manifesti
   • botId = <App ID> olacak şekilde bir bot girdisi ekleyin.
   • Kapsamlar: personal, team, groupChat.
   • supportsFiles: true (kişisel kapsamda dosya işleme için gereklidir).
   • RSC izinlerini ekleyin (aşağıda).
   • Simgeleri oluşturun: outline.png (32x32) ve color.png (192x192).
   • Üç dosyayı birlikte zipleyin: manifest.json, outline.png, color.png.
4. OpenClaw’ı yapılandırın
   {
     channels: {
       msteams: {
         enabled: true,
         appId: "<APP_ID>",
         appPassword: "<APP_PASSWORD>",
         tenantId: "<TENANT_ID>",
         webhook: { port: 3978, path: "/api/messages" },
       },
     },
   }
   
   Yapılandırma anahtarları yerine ortam değişkenlerini de kullanabilirsiniz:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. Bot uç noktası
   • Azure Bot Messaging Endpoint değerini şuna ayarlayın:
     • https://<host>:3978/api/messages (veya seçtiğiniz yol/port).
6. Gateway’i çalıştırın
   • Paketlenmiş veya manuel olarak yüklenmiş plugin kullanılabilir olduğunda ve msteams yapılandırması kimlik bilgileriyle mevcut olduğunda Teams kanalı otomatik olarak başlar.

​

Üye bilgisi eylemi

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

​

Geçmiş bağlamı

• channels.msteams.historyLimit, en son kaç kanal/grup mesajının prompt içine sarılacağını kontrol eder.
• messages.groupChat.historyLimit değerine geri düşer. Devre dışı bırakmak için 0 ayarlayın (varsayılan 50).
• Alınan iş parçacığı geçmişi, gönderici izin listelerine göre (allowFrom / groupAllowFrom) filtrelenir; bu nedenle iş parçacığı bağlamı tohumlama yalnızca izin verilen göndericilerden gelen mesajları içerir.
• Alıntılanan ek bağlamı (ReplyTo*, Teams yanıt HTML’sinden türetilir) şu anda alındığı gibi iletilir.
• Başka bir deyişle, izin listeleri ajanın kim tarafından tetiklenebileceğini kapılar; bugün yalnızca belirli ek bağlam yolları filtrelenmektedir.
• DM geçmişi channels.msteams.dmHistoryLimit ile sınırlandırılabilir (kullanıcı dönüşleri). Kullanıcı bazlı geçersiz kılmalar: channels.msteams.dms["<user_id>"].historyLimit.

​

Mevcut Teams RSC İzinleri (Manifest)

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

​

Ö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ı (zorunlu alanlar)

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

​

Mevcut bir uygulamayı güncelleme

1. manifest.json dosyanızı yeni ayarlarla güncelleyin
2. version alanını artırın (örn. 1.0.0 → 1.1.0)
3. Manifesti simgelerle birlikte yeniden zipleyin (manifest.json, outline.png, color.png)
4. Yeni zip dosyasını yükleyin:
   • Seçenek A (Teams Admin Center): Teams Admin Center → Teams apps → Manage apps → uygulamanızı bulun → Upload new version
   • Seçenek B (Sideload): Teams içinde → Apps → Manage your apps → Upload a custom app
5. Takım kanalları için: yeni izinlerin etkili olması için uygulamayı her takıma yeniden yükleyin
6. Önbelleğe alınmış uygulama meta verilerini temizlemek için Teams’i tamamen kapatıp yeniden başlatın (yalnızca pencereyi kapatmak yeterli değildir)

​

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

​

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

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

• Kanal/grup görsel veya dosya içerikleri (payload yalnızca HTML stub içerir).
• SharePoint/OneDrive içinde saklanan ekleri indirme.
• Mesaj geçmişini okuma (canlı webhook etkinliğinin ötesinde).

​

Teams RSC + Microsoft Graph Application izinleri ile

• Barındırılan içerikleri indirme (mesajlara yapıştırılmış görseller).
• SharePoint/OneDrive içinde saklanan dosya eklerini indirme.
• Kanal/sohbet mesaj geçmişini Graph üzerinden okuma.

​

RSC ve Graph API

​

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

1. Entra ID (Azure AD) App Registration içinde Microsoft Graph Application permissions ekleyin:
   • ChannelMessage.Read.All (kanal ekleri + geçmiş)
   • Chat.Read.All veya ChatMessage.Read.All (grup sohbetleri)
2. Tenant 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 kurun.
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 mesajı yeniden denemesi (yinelenmelere 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 şekilde render edilmeyebilir
• Adaptive Cards, anketler ve rastgele kart 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 mevcutsa 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 takım/kanal adı yönlendirmesini yeniden etkinleştiren acil durum anahtarı.
• channels.msteams.textChunkLimit: giden metin parça boyutu.
• channels.msteams.chunkMode: uzunluk parçalamadan önce boş satırlarda (paragraf sınırları) bölmek için length (varsayılan) veya newline.
• channels.msteams.mediaAllowHosts: gelen ek ana makine izin listesi (varsayılan olarak Microsoft/Teams alanları).
• channels.msteams.mediaAuthAllowHosts: medya yeniden denemelerinde Authorization üstbilgileri eklemek için ana makine izin listesi (varsayılan olarak Graph + Bot Framework ana makineleri).
• channels.msteams.requireMention: kanallarda/gruplarda @mention gerektirir (varsayılan true).
• channels.msteams.replyStyle: thread | top-level (bkz. Yanıt Stili).
• channels.msteams.teams.<teamId>.replyStyle: takım bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.requireMention: takım bazında geçersiz kılma.
• channels.msteams.teams.<teamId>.tools: kanal geçersiz kılması eksik olduğunda kullanılan varsayılan takım bazlı araç ilkesi geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.toolsBySender: varsayılan takım bazlı gönderici başına araç ilkesi 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 bazında araç ilkesi geçersiz kılmaları (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: kanal bazında gönderici başına araç ilkesi geçersiz kılmaları ("*" joker karakteri desteklenir).
• toolsBySender anahtarları açık önekler kullanmalıdır: id:, e164:, username:, name: (eski öneksiz anahtarlar yalnızca id: ile eşlenmeye devam eder).
• channels.msteams.actions.memberInfo: Graph destekli üye bilgisi eylemini etkinleştir veya devre dışı bırak (varsayılan: Graph kimlik bilgileri kullanılabilir olduğunda etkindir).
• channels.msteams.sharePointSiteId: grup sohbetlerinde/kanallarda dosya yüklemeleri için SharePoint site kimliği (bkz. Grup sohbetlerinde dosya gönderme).

​

Yönlendirme ve Oturumlar

• Oturum anahtarları standart ajan biçimini izler (bkz. /concepts/session):
  • Doğrudan mesajlar ana oturumu paylaşır (agent:<agentId>:<mainKey>).
  • Kanal/grup mesajları konuşma kimliğini kullanır:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Yanıt Stili: İş parçacıkları ve Gönderiler

• Threads stilindeki bir kanalda thread → yanıtlar rahatsız edici biçimde iç içe görünür
• Posts stilindeki bir kanalda top-level → yanıtlar iş parçacığında 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",
            },
          },
        },
      },
    },
  },
}

​

Ekler ve Görseller

• DM’ler: Görseller ve dosya ekleri, Teams bot dosya API’leri aracılığıyla çalışır.
• Kanallar/gruplar: Ekler M365 depolamasında (SharePoint/OneDrive) bulunur. Webhook payload’ı gerçek dosya baytlarını değil, yalnızca bir HTML stub içerir. Kanal eklerini indirmek için Graph API izinleri gerekir.
• Açık dosya öncelikli gönderimler için media / filePath / path ile action=upload-file 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 sohbetlerinin neden SharePoint’e ihtiyaç duyduğu

​

Kurulum

1. Entra ID (Azure AD) → App Registration içinde Graph API izinleri ekleyin:
   • Sites.ReadWrite.All (Application) - dosyaları SharePoint’e yüklemek için
   • Chat.Read.All (Application) - isteğe bağlı, kullanıcı bazlı paylaşım bağlantılarını etkinleştirir
2. Tenant için yönetici onayı verin.
3. SharePoint site kimliğinizi alın:
   # Graph Explorer veya geçerli token ile curl üzerinden:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Örnek: "contoso.sharepoint.com/sites/BotFiles" adresindeki 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 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 paylaşmaz (gerekirse depolama dosyasını inceleyin).

​

Adaptive Cards (rastgele)

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

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

​

Hedef biçimleri

# Bir kullanıcıya ID ile gönder
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Bir kullanıcıya görünen ad ile gönder (Graph API aramasını tetikler)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

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

# Bir konuşmaya Adaptive Card gönder
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

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

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

​

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ı depolarız.
• dmPolicy ve izin listesi kapılaması için /gateway/configuration bölümüne bakın.

​

Takım ve Kanal Kimlikleri (Yaygın Tuzak)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Takım Kimliği (bunu URL-decode edin)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Kanal Kimliği (bunu URL-decode edin)

• Takım Kimliği = /team/ sonrasındaki yol parçası (URL-decode edilmiş, ör. 19:Bk4j...@thread.tacv2)
• Kanal Kimliği = /channel/ sonrasındaki yol parçası (URL-decode edilmiş)
• groupId sorgu parametresini yok sayın

​

Ö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 kullanın (ChannelMessage.Read.All gerekir)

​

Sorun giderme

​

Yaygın sorunlar

• Kanallarda görseller görünmüyor: Graph izinleri veya yönetici onayı eksik. Teams uygulamasını yeniden kurun ve Teams’i tamamen kapatıp yeniden açın.
• Kanalda yanıt yok: mention varsayılan olarak gereklidir; channels.msteams.requireMention=false ayarlayın veya takım/kanal bazında 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 manuel test yaparken beklenir - uç noktanın erişilebilir olduğunu ancak kimlik doğrulamanın başarısız olduğunu gösterir. Doğru test için Azure Web Chat kullanın.

​

Manifest yükleme hataları

• “Icon file cannot be empty”: Manifest 0 baytlık 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 takım/sohbette kurulu. Önce onu bulun ve 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 kontrol edin.
• 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 takım/sohbete yeniden kurun
3. Kuruluş yöneticinizin RSC izinlerini engelleyip engellemediğini kontrol edin
4. Doğru kapsamı kullandığınızı doğrulayın: takımlar için ChannelMessage.Read.Group, grup sohbetleri için ChatMessage.Read.Chat

​

Referanslar

• Create Azure Bot - Azure Bot kurulum kılavuzu
• Teams Developer Portal - Teams uygulamalarını oluşturun/yönetin
• Teams app manifest schema
• Receive channel messages with RSC
• RSC permissions reference
• Teams bot file handling (kanal/grup için Graph gerekir)
• Proactive messaging

​

İlgili

• Channels Overview — desteklenen tüm kanallar
• Pairing — DM kimlik doğrulaması ve eşleştirme akışı
• Groups — grup sohbeti davranışı ve mention kapılaması
• Channel Routing — mesajlar için oturum yönlendirmesi
• Security — erişim modeli ve sağlamlaştırma