ForcePilot/backend/package/yuxi/channel/extensions/ringcentral/session.py
Kris 7a9031ea53 feat(channel): 添加 RingCentral 渠道扩展
新增 RingCentral 渠道扩展,支持在 Yuxi 平台中集成 RingCentral 统一通信平台。

包含以下功能模块:
- sdk: RingCentral SDK 封装
- config: 渠道配置管理
- gateway: SSE/WebSocket 网关接入
- webhook: Webhook 事件处理
- subscription: 事件订阅
- outbound: 外发消息管理
- streaming: 流式消息处理
- pairing: 用户配对与绑定
- security: 安全校验
- dedupe: 消息去重
- monitor: 渠道状态监控
- status: 会话状态管理
- session: 会话管理
- events: 事件处理
- adaptive_cards: 自适应卡片
- formatting: 格式化
- media: 媒体资源处理
- mentions: @提及
- notes: 笔记功能
- reactions: 表情反应
- tasks: 任务管理
- teams: 团队管理
- types: 类型定义
2026-05-21 11:37:49 +08:00

48 lines
1.5 KiB
Python

from __future__ import annotations
from yuxi.channel.protocols import SessionResolution
class RingCentralSessionAdapter:
def resolve_session(self, msg) -> SessionResolution:
from yuxi.channel.routing.models import PeerKind
if hasattr(msg, "sender") and hasattr(msg.sender, "kind"):
if msg.sender.kind == PeerKind.DIRECT:
chat_id = _extract_chat_id(msg)
return SessionResolution(
kind="direct",
conversation_id=chat_id or msg.sender.id,
)
chat_id = _extract_chat_id(msg)
if chat_id:
return SessionResolution(kind="group", conversation_id=chat_id)
if msg.group and msg.group.id:
return SessionResolution(kind="group", conversation_id=msg.group.id)
return SessionResolution(kind="group", conversation_id="unknown")
@staticmethod
def build_dm_session_key(agent_id: str, account_id: str, chat_id: str) -> str:
return f"agent:{agent_id}:ringcentral:direct:{chat_id}"
@staticmethod
def build_group_session_key(agent_id: str, account_id: str, chat_id: str) -> str:
return f"agent:{agent_id}:ringcentral:group:{chat_id}"
def _extract_chat_id(msg) -> str | None:
metadata = getattr(msg, "metadata", {}) or {}
if metadata.get("chat_id"):
return metadata["chat_id"]
raw = getattr(msg, "raw_payload", {}) or {}
body = raw.get("body", raw)
group_id = body.get("groupId", "")
if group_id:
return group_id
return None