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ç

Bağlı bir Microsoft 365 iş veya okul hesabıyla (connect_m365_account), Microsoft 365 üzerinden bir Microsoft Teams sohbetine metin iletisi gönderir. chat_id aynı hesabın teams_list_chats çıktısından GELMELİDİR; asla uydurma kimlik kullanmayın. Bu bir yazma işlemidir: ilk çağrı, sohbette kimlerin bulunduğunu (veya okunamadıklarını: chat_unresolved) belirten bir önizleme döndürür, ikinci çağrı (confirm=true ile) gerçekten gönderir. Onaylamadan önce bu katılımcıları kullanıcıya gösterin, özellikle participants_state "resolved" değilse veya has_external_members true ise. sent:true Microsoft'un iletiyi kabul ettiği anlamına gelir; teams_search_messages Microsoft'un arama dizinini okur ve bu, gönderimin gerisinde kalabilir, bu yüzden gönderimden hemen sonra sıfır sonuçlu bir arama gönderimin başarısız olduğuna dair kanıt DEĞİLDİR.

Zorunlu girdiler

chat_id
text

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.

Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

İngilizce kanonik teknik şema — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "chat_id": {
      "description": "Chat id from teams_list_chats (e.g. '19:<uuid>_<uuid>@unq.gbl.spaces' for 1:1, '19:<id>@thread.v2' for a group)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually send. Without it, returns a preview and sends nothing: the preview reads who is in the chat (`chat`: title, participants, participant_count, participants_state, has_external_members), or says chat_unresolved when that could not be read.",
      "type": "boolean"
    },
    "text": {
      "description": "Plain-text message body. Max 28000 chars. No formatting / mentions / attachments.",
      "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