본문으로 건너뛰기
모든 도구

teams_send_message

Microsoft Teams · macOS · Windows

효과: 보내기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

연결된 Microsoft 365 회사 또는 학교 계정(connect_m365_account)으로 Microsoft 365를 통해 Microsoft Teams 채팅에 텍스트 메시지를 보냅니다. chat_id는 반드시 같은 계정의 teams_list_chats에서 가져와야 하며, id를 지어내지 마세요. 쓰기 작업입니다. 첫 번째 호출은 채팅에 누가 있는지(또는 읽을 수 없었다는 사실인 chat_unresolved)를 알려 주는 미리보기를 반환하며, 두 번째 호출(confirm=true)이 실제로 전송합니다. 확인하기 전에 사용자에게 해당 참여자를 보여 주세요. 특히 participants_state가 "resolved"가 아니거나 has_external_members가 true일 때 그렇게 하세요. sent:true는 Microsoft가 메시지를 수락했다는 뜻입니다. teams_search_messages는 전송보다 뒤처질 수 있는 Microsoft의 검색 색인을 읽으므로, 전송 직후 검색 결과가 0건이라고 해서 전송이 실패했다는 증거는 아닙니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

teams_send_message 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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

Windows

목적

Graph API를 통해 Microsoft Teams 채팅에 메시지를 보냅니다. connect_m365_account가 필요합니다. chat_id는 teams_list_chats에서 가져와야 합니다. 첫 번째 호출은 채팅에 누가 있는지(또는 읽을 수 없었다는 사실인 chat_unresolved)를 알려 주는 미리보기를 반환하며, confirm=true로 설정하면 전송합니다. 확인하기 전에 사용자에게 해당 참여자를 보여 주세요. 특히 participants_state가 "resolved"가 아니거나 has_external_members가 true일 때 그렇게 하세요.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — Windows
{
  "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",
      "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",
      "type": "string"
    }
  },
  "required": [
    "chat_id",
    "text"
  ],
  "type": "object"
}

문서 예시

teams_send_message 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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