渠道配置

✦ 多平台接入

多渠道客服接入系统，采用适配器模式统一对接微信、企业微信、钉钉、飞书等主流即时通讯平台，实现跨平台客户服务统一管理。

💬

微信公众号

接入微信公众号消息，访客在公众号发消息即可发起客服对话，支持文本、图片、图文消息。

🏢

企业微信

对接企业微信原生客服能力，坐席可在 LC 平台统一回复企业微信客户消息。

🔶

钉钉

接入钉钉客服消息，支持文本、图片、Markdown、卡片消息，Stream 模式长连接接收。

🕊️

飞书

对接飞书开放平台，支持飞书消息收发、事件回调、卡片消息构建。

架构设计

渠道系统采用适配器设计模式，统一的抽象层屏蔽各平台差异：

CsChannelAdapter（抽象适配器）： 定义渠道接入的统一接口，包括消息接收、消息发送、事件处理等核心方法。
平台适配器： 各平台（WeChat / WeCom / DingTalk / Feishu）实现适配器接口，封装平台特定的 API 调用、消息加解密、签名验证等逻辑。
Bridge Service（桥接服务）： 负责在外部平台和内部客服系统之间做双向消息中转。
ChannelMessageSender： 统一的消息发送器，屏蔽各平台消息格式差异。
CsChannelService： 渠道管理服务，负责渠道配置的 CRUD 和运行状态管理。

支持的渠道

微信公众号

通过微信公众号消息接口接入。用户在公众号发送消息后，消息通过 Webhook 回调进入 LC 客服系统，坐席可在客服工作台统一回复。支持文本、图片等消息类型。

企业微信

对接企业微信「客户联系」功能，支持企业微信用户发起客服咨询。WeComChannelAdapter 处理企业微信消息格式转换，WeComBridgeService 实现消息双向同步。

钉钉

支持钉钉企业内部应用和钉钉客服消息。采用 Stream Mode 长连接接收消息，无需公网回调地址。支持 RichText 卡片消息构建（DingTalkCardMessageBuilder），提升消息展示效果。

飞书（Lark）

对接飞书开放平台，支持飞书应用消息和客服消息。FeishuChannelAdapter 处理飞书特有的消息格式和事件回调机制。

通用功能

功能	说明
统一消息格式	各平台消息统一转换为内部标准格式，坐席无需关注来源平台差异
富文本消息	支持 Markdown、卡片消息、图文混排等多种富文本格式
消息路由	外部消息自动路由到对应技能组/坐席，支持智能分配
会话连续	跨平台保持会话连续性，访客从任意渠道接入均可查看历史
Token 管理	AccessTokenCache 自动管理各平台访问凭证，自动刷新过期 Token

配置步骤

进入「渠道配置」，选择要接入的平台类型（微信 / 企业微信 / 钉钉 / 飞书）
填写平台提供的应用凭证（AppID、AppSecret、Token、EncodingAESKey 等）
配置 Webhook 回调地址或 Stream Mode 连接参数
在对应平台开发者后台配置回调 URL 或事件订阅
启用渠道，系统自动验证配置的有效性
在客服设置中配置该渠道的分配规则和自动回复

统一 Webhook 入口

CsChannelWebhookController 提供统一的 Webhook 回调入口，所有外部平台的消息推送都通过该入口接收：

// Webhook 回调地址示例
POST /api/customer/channel/webhook/{channelType}/{channelId}

// 参数说明
channelType: 渠道类型 (wechat / wecom / dingtalk / feishu)
channelId:   渠道配置 ID

// 系统自动处理
1. 根据 channelType 路由到对应适配器
2. 验证消息签名确保安全性
3. 解析平台特有消息格式为标准格式
4. 转发到内部客服系统处理

注意事项

各平台应用凭证请妥善保管，切勿泄露
配置 Webhook 回调前确保服务器公网可达
钉钉 Stream Mode 无需公网回调地址，推荐优先使用
渠道启用后请测试发送消息确认配置正确