Tüm araçlar

teams_send_message

Microsoft Teams · macOS · Windows

Etki: gönderme. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Bir Microsoft Teams sohbetine veya kanalına metin iletisi gönderir. Microsoft Teams'in çalışıyor ve oturum açılmış olması gerekir (belirteç her çağrıda Teams'in yerel çerezlerinden yeniden okunur). chat_id MUTLAKA önceki bir teams_list_chats çağrısından gelmelidir; kimlikleri asla uydurmayın. Bu bir yazma işlemidir: ilk çağrı önizleme döndürür, ikinci çağrı (confirm=true ile) gerçekten gönderir. sent:true, iletinin konuşmadan geri okunduğu (teslimatın doğrulandığı) anlamına gelir; takip okumasına değil, BU alana güvenin: teams_search_messages ve teams_read_chat_messages, Teams'in kendi yerel eşitleme dizinini okur ve bu dizin doğrulanmış bir gönderimin birkaç dakika gerisinde kalabilir (gözlenen tek vaka: 3 dk., #2285). Gönderimin hemen ardından kardeş okumada sıfır sonuç alınması, gönderimin başarısız olduğuna dair kanıt DEĞİLDİR. status "sent_unconfirmed" yanıtı, sunucunun POST isteğini kabul ettiği ancak iletinin doğrulanamadığı anlamına gelir; alıcının bilgilendirildiğini varsaymadan önce kullanıcıya Teams'i açıp kontrol etmesini söyleyin.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — macOS
{
  "properties": {
    "chat_id": {
      "description": "Thread id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<uuid>@thread.tacv2' for group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview without making any network call.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments in v1.",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Belge örneği

teams_send_message için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Amaç

Graph API üzerinden bir Microsoft Teams sohbetine ileti gönderir. connect_m365_account gerektirir. chat_id, teams_list_chats aracından gelmelidir. İlk çağrı önizleme döndürür; göndermek için confirm=true ayarlayın.

Zorunlu girdiler

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

İngilizce kanonik teknik şema — Windows
{
  "properties": {
    "chat_id": {
      "description": "Chat ID from teams_list_chats",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

Belge örneği

teams_send_message için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "chat_id": "demo-chat-001",
  "confirm": false,
  "text": "Can we review the launch checklist on Tuesday?"
}