← 个人账号版介绍

在自己的环境,持续跟进客户。

个人账号版支持跨天回复和主动联系。登录会话保留在部署机器,已有客户继续在飞书 Thread 回复。

自部署试用版

使用个人账号版发布包中的独立配置与启动文件。它与工作台机器人版分别运行,不能直接在现有机器人版配置中解除 24 小时限制。

你的机器
+--------------------------------------------+
| 飞书连接 <-> 渡桥转发核心 <-> Telegram 账号 |
|               |                  |         |
|           接待与话题映射      本机登录会话   |
+--------------------------------------------+

1. 准备自己的配置

复制 .env.personal.example.env.personal,填写自己的飞书应用、翻译服务与 Telegram 账号编号。去 Telegram 客户端应用管理取得 API ID 和 API Hash。

./duqiao keygen 生成两次不同密钥,填写到 BRIDGE_ENCRYPTION_KEY 与 TELEGRAM_PERSONAL_TOKEN,妥善保管。初次保留 BRIDGE_ENABLED=false。

docker compose --env-file .env.personal -f compose.personal.yaml build

2. 本人完成 Telegram 登录

docker compose --env-file .env.personal -f compose.personal.yaml run --rm --no-deps personal login

本人在部署机器的终端输入手机号、登录验证码及按需输入两步验证密码。验证码和密码不回显;登录后无需每条消息重新授权。

3. 连接飞书与启用接待

飞书自建应用需要普通群消息、发送消息和附件权限。用发现工具取得群和客服编号,配置长连接、发布应用:

docker compose --env-file .env.personal -f compose.personal.yaml run --rm --no-deps bridge discover-feishu

补全客服群与授权客服配置;需要沿用原话题时,先按发布包内 docs/personal-account-edition.md 的指引暂停旧版并迁移映射。核对完毕后设 BRIDGE_ENABLED=true,再启动:

docker compose --env-file .env.personal -f compose.personal.yaml up -d --wait

在部署机器查看 127.0.0.1:18788/status。需分别检查飞书和 Telegram 连接,并通过自己的测试账号核对实际送达。

4. 继续回复或主动联系

已有客户直接在对应 Thread 回复。新客户在客服群发送 /联系 @客户用户名,核对新话题中的身份后,再在话题内发送第一条消息。

请验证三天前的客户会话、新客户首条消息、图片与文件、重启后原话题继续回复。Telegram 的客户隐私、账号状态和限流仍可能影响送达。

发送结果待核对时

先到 Telegram 核对是否已送达,再结束该条处理。此操作不会重发原消息:

docker compose --env-file .env.personal -f compose.personal.yaml exec bridge standalone-events
docker compose --env-file .env.personal -f compose.personal.yaml exec bridge standalone-close-uncertain --event fs:MESSAGE_ID --checked-in-telegram

撤销登录

可以在 Telegram「设置 → 设备」终止 Duqiao Personal 会话,也可以停止连接后运行退出命令:

docker compose --env-file .env.personal -f compose.personal.yaml stop personal
docker compose --env-file .env.personal -f compose.personal.yaml run --rm --no-deps personal logout

服务器管理员可控制运行中的客户端;请使用专用业务账号。飞书与外部翻译服务仍会处理对应消息。