ForcePilot/backend/package/yuxi/channel/extensions/msteams/graph_messages.py
Kris 94444ced96 feat(channel): 添加 Microsoft Teams 渠道扩展
新增 Microsoft Teams 渠道扩展,支持在 Yuxi 平台中集成 Microsoft Teams 协作平台。

包含以下功能模块:
- sdk: Bot Framework SDK 封装
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- webhook: Webhook 事件处理
- outbound: 外发消息管理
- streaming: 流式消息处理
- pairing: 用户配对与绑定
- security: 安全校验
- auth: JWT 认证
- jwks: JWKS 密钥管理
- dedupe: 消息去重
- monitor: 渠道状态监控
- status: 会话状态管理
- session: 会话管理
- state: 状态管理
- runtime: 运行时管理
- actions: 动作处理
- adaptive_card: 自适应卡片
- task_modules: 任务模块
- message_extension: 消息扩展
- proactive: Proactive Messaging
- graph: Microsoft Graph API 集成
- graph_teams: Teams 操作
- graph_members: 成员管理
- graph_messages: 消息获取
- graph_thread: 线程管理
- graph_users: 用户管理
- graph_upload: 文件上传
- files: 文件处理
- file_consent: 文件授权
- conversations: 会话存储
- mentions: @提及处理
- threading: 线程管理
- reactions: 表情反应
- polls: 投票功能
- meetings: 会议集成
- feedback: 反馈处理
- sso: 单点登录
- deep_links: 深层链接
- incoming_webhook: 入站 Webhook
- localization: 本地化
- user_agent: 用户代理
- sent_message_cache: 消息缓存
- types: 类型定义
2026-05-21 11:28:42 +08:00

138 lines
4.1 KiB
Python

from __future__ import annotations
import logging
from .graph import MSTeamsGraphClient
logger = logging.getLogger(__name__)
async def get_message(
graph_client: MSTeamsGraphClient,
chat_id: str,
message_id: str,
) -> dict | None:
path = f"/chats/{chat_id}/messages/{message_id}"
try:
data = await graph_client.fetch_json(path)
return _parse_message(data)
except Exception as e:
logger.warning("Failed to get message %s from chat %s: %s", message_id, chat_id, e)
return None
async def search_messages(
graph_client: MSTeamsGraphClient,
chat_id: str,
query: str,
*,
limit: int = 20,
) -> list[dict]:
path = f'/chats/{chat_id}/messages?$search="{query}"&$top={limit}'
try:
data = await graph_client.fetch_json(path)
return _parse_messages(data)
except Exception as e:
logger.warning("Failed to search messages in chat %s: %s", chat_id, e)
return []
async def pin_message(
graph_client: MSTeamsGraphClient,
chat_id: str,
message_id: str,
) -> bool:
path = f"/chats/{chat_id}/pinnedMessages"
body = {"message@odata.bind": f"https://graph.microsoft.com/v1.0/chats/{chat_id}/messages/{message_id}"}
try:
await graph_client.fetch_json(path, method="POST", body=body)
return True
except Exception as e:
logger.warning("Failed to pin message %s in chat %s: %s", message_id, chat_id, e)
return False
async def unpin_message(
graph_client: MSTeamsGraphClient,
chat_id: str,
pinned_message_id: str,
) -> bool:
path = f"/chats/{chat_id}/pinnedMessages/{pinned_message_id}"
try:
await graph_client.fetch_json(path, method="DELETE")
return True
except Exception as e:
logger.warning("Failed to unpin message %s in chat %s: %s", pinned_message_id, chat_id, e)
return False
async def list_pinned_messages(
graph_client: MSTeamsGraphClient,
chat_id: str,
) -> list[dict]:
path = f"/chats/{chat_id}/pinnedMessages?$expand=message"
try:
data = await graph_client.fetch_json(path)
return data.get("value", [])
except Exception as e:
logger.warning("Failed to list pinned messages in chat %s: %s", chat_id, e)
return []
async def set_reaction(
graph_client: MSTeamsGraphClient,
chat_id: str,
message_id: str,
reaction_type: str,
user_id: str | None = None,
) -> bool:
path = f"/chats/{chat_id}/messages/{message_id}/setReaction"
body = {"reactionType": reaction_type}
try:
await graph_client.fetch_json(path, method="POST", body=body)
return True
except Exception as e:
logger.warning("Failed to set reaction on message %s: %s", message_id, e)
return False
async def unset_reaction(
graph_client: MSTeamsGraphClient,
chat_id: str,
message_id: str,
reaction_type: str,
user_id: str | None = None,
) -> bool:
path = f"/chats/{chat_id}/messages/{message_id}/unsetReaction"
body = {"reactionType": reaction_type}
try:
await graph_client.fetch_json(path, method="POST", body=body)
return True
except Exception as e:
logger.warning("Failed to unset reaction on message %s: %s", message_id, e)
return False
def _parse_message(data: dict) -> dict:
body = data.get("body", {})
from_info = data.get("from", {})
return {
"id": data.get("id", ""),
"text": body.get("content", ""),
"content_type": body.get("contentType", "text"),
"created_at": data.get("createdDateTime", ""),
"last_modified_at": data.get("lastModifiedDateTime", ""),
"from": from_info,
"from_name": from_info.get("user", {}).get("displayName", ""),
"message_type": data.get("messageType", "message"),
"importance": data.get("importance", "normal"),
"subject": data.get("subject", ""),
"attachments": data.get("attachments", []),
"reactions": data.get("reactions", []),
}
def _parse_messages(data: dict) -> list[dict]:
messages = data.get("value", [])
return [_parse_message(msg) for msg in messages]