API 用途

Telegram 客服系统怎么接入?Bot、Business 与 api_id 的选择

对比 Telegram Bot 客服、用户账号客服与 Business 连接,说明 api_id、api_hash 何时需要,以及 CRM 对接、媒体消息和客服权限如何设计。

GetTGAPI 编辑团队更新于

快速解答: 客户在 Bot 中咨询、员工在管理端回复,通常可以直接使用 Bot API。需要以获授权的用户账号处理会话时,才涉及 api_id、api_hash 与用户会话;Business 连接则需要按账号授予机器人的具体权限处理。

搭建 Telegram 客服或 CRM,首先要回答“客户正在和哪个身份聊天”。这个选择比先购买或申请一组 API 资料更重要。

三条客服接入路线

路线 客户看到的身份 主要凭证和条件
普通 Bot 客服 机器人名称与头像 Bot Token;客户先建立可交互会话
用户账号客服 授权的个人或业务账号 api_id、api_hash、用户会话和账号权限
Business 连接机器人 被连接的业务账号 Bot Token、有效连接和授予的业务权限

Business 的快捷回复、欢迎与离开消息、营业信息等能力有各自条件。官方当前也允许非 Premium 用户使用连接机器人,但不能据此推断所有 Business 功能都没有资格要求。

双向消息如何对应?

客服系统需要保存渠道、Bot 或账号标识、客户会话和消息标识之间的映射。显示名称和头像用于识别界面,不应成为路由的唯一依据,因为客户可以改名,且不同客户可能同名。

客户发图、语音、视频或文件时,管理端应识别类型并受控读取附件。员工回复应关联原会话,记录发送成功、失败或结果不明,避免界面显示成功但客户实际未收到。

工单和 CRM 应怎样接?

建议先实现一个小流程:客户说明问题,系统生成工单,员工回复,客户收到结果。再增加客户标签、指派、常用语和订单关联。

同一客户重发消息或网络重试不应生成重复工单。订单关联应由经过核验的业务信息完成,不因为聊天中出现一个字符串就自动绑定客户身份。员工只应看到自己获准处理的客户数据。

已读和通知能否完全同步?

不能把每条路线都当成官方客户端。普通 Bot API 并不提供所有用户客户端具有的已读能力;管理端“员工已查看”、消息“已发送”与“客户已读”应分别标注,只在接口确有证据时显示后者。

移动推送也应与聊天数据分开考虑。通知预览可仅提示有新消息,打开受保护会话后再读取正文,避免锁屏泄露客户问题。

加密需要描述具体区间

HTTPS、数据库加密和端到端加密解决不同问题。普通 Bot 对话不是 Telegram 秘密聊天。即使管理端和自有服务器之间增加加密,也不能据此宣称“客户到员工的整条链路是 Telegram 端到端加密”。

如产品有更严格的保密需求,应明确密钥由谁持有、哪些服务能解密、附件与备份如何处理。相关区别见 会话与隐私。

需要 api_id、api_hash 时再申请

选定用户账号接入路线后,可从 官方申请教程 开始。门户 ERROR 或资料获取困难时,访问 gettgapi.com/help#contact 联系 GetTGAPI;有授权码可进入 申请页。

如果只做普通 Bot 客服,先通过 BotFather 获取 Token。GetTGAPI 提供应用申请协助,不代替机器人创建或完整 CRM 开发。

官方依据