모든 도구

teams_send_message

Microsoft Teams · macOS · Windows

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

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

macOS

목적

Microsoft Teams 채팅 또는 채널에 텍스트 메시지를 보냅니다. Microsoft Teams가 실행 중이고 로그인되어 있어야 하며 호출마다 Teams 로컬 쿠키에서 토큰을 새로 읽습니다. chat_id는 반드시 이전 teams_list_chats 호출에서 받아야 하며 만들어 내면 안 됩니다. 쓰기 작업이므로 첫 호출은 미리보기, confirm=true인 두 번째 호출은 실제 전송입니다. sent:true는 대화에서 메시지를 다시 읽어 전송이 확인되었다는 뜻이므로 이 필드를 신뢰하세요. 후속 읽기는 신뢰하지 마세요. teams_search_messages와 teams_read_chat_messages는 Teams 자체 로컬 동기화 인덱스를 읽어 확인된 전송보다 몇 분 늦을 수 있습니다(관찰 사례 1건: 3분, #2285). 전송 직후 관련 읽기 결과가 0건이어도 실패 증거가 아닙니다. status가 "sent_unconfirmed"이면 서버가 POST를 수락했지만 메시지를 확인하지 못한 것입니다. 수신자에게 알림이 갔다고 가정하기 전에 사용자에게 Teams에서 직접 확인하라고 안내하세요.

필수 입력

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

권한 및 확인

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

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

문서 예시

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에서 받아야 합니다. 첫 호출은 미리보기를 반환하고 confirm=true로 실제 전송합니다.

필수 입력

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

권한 및 확인

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

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

문서 예시

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

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