用户(CRM)
查找客户、查看聊天记录、添加标签、保存电话等资料,并筛选或导出客户列表。
本页内容
用户页面汇集与机器人交谈过的客户。打开一位客户的资料卡,可查看消息、文件和已保存的信息,例如电话、感兴趣的课程或付款状态。系统根据事件自动建立并更新资料卡。这类客户资料库也叫 CRM。标签用于划分群体(如“已付款”),参数保存具体值(如 phone、order_id)。
用户列表
表格显示姓名、Telegram ID、标签和最近活跃状态,也会标示是否屏蔽机器人。可按姓名或 ID 搜索,并选择全部、VIP、已付款、新用户、已退订快速筛选,每项旁边都有用户数。点击一行即可打开对话。
已屏蔽按钮只显示屏蔽机器人的用户,屏蔽日期在资料卡中。导出 CSV会按当前搜索与筛选导出最多 10,000 行,可用电子表格打开。文件列为 tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels;标签以 ; 分隔,日期为 RFC3339,文字单元格会防止被表格软件当作公式执行。达到行数上限时 API 返回 X-Export-Truncated: true。API:GET /api/bots/{botID}/users?is_blocked=true&format=csv;is_blocked=true|false 也适用于 JSON 列表,屏蔽用户的响应含 blocked_at。
保存了哪些用户信息
资料卡包含头像、姓名、@username、“在 Telegram 中打开”链接、消息数、首次和最近对话时间、标签及全局参数,还会标明用户是否屏蔽机器人或正在等待客服回复。
订阅者来源记录用户第一次通过哪条链接启动机器人。例如,给春季广告单独设置链接,就能识别该广告的访客。广告来源值称为 UTM 标签;Telegram 链接 start= 后的部分称为启动参数(payload)。
- Telegram:
t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring。Telegram 只允许字母、数字、_、-;各键值对用__分隔,键与值用第一个-分隔。 - VK:
vk.me/<group>?ref=utm_source=vk&utm_medium=post。 - 邀请链接:
t.me/<bot>?start=ref_<用户 ID>。资料卡和{{referrals.count}}可显示邀请人数;ref=<ID>、ref_<ID>与 UTM 分开解析。
保存的字段有 utm_source、utm_medium、utm_campaign、utm_content、utm_term,每个字段取首个非空值。可在替换内容中使用,也可在分组中使用 attribution.utm_source 等字段。
来源按第一条带非空启动参数的链接固定,称为 first-touch(首次接触)。重复执行 /start 不会更改来源,也不会加入新链接的 UTM。如果第一个参数是普通文字或邀请标记,UTM 保持空白;没有参数的链接不会固定来源。
在受众分组中,启动链接里的 UTM 优先于同名的网站访问标签;链接中缺少的字段可从网站数据补齐,没有 UTM 的链接不会清除网站数据。来源归属于首次启动的渠道,只有渠道和订阅者 ID 对应时,重新计算后才会进入分组。
标签
标签可以标记 VIP、已付款、新用户、已退订等状态,您也可建立自己的标签并选择颜色。可手动添加,或用修改标签动作设置。随后在条件或群发受众中使用。
标签可永久有效,也可设置天数。到期后自动移除,并触发标签到期事件。API:POST /api/bots/{botID}/users/{tgUserID}/labels,使用标准 UUID label_id,可选 ttl_days 范围为 0 至 106751。ttl_days: 0 表示永久标签;临时标签到期时间在用户列表的 label_expires_at 字段。
参数
参数保存与用户绑定的任意值,例如姓名、电子邮件、金额、订单状态或积分。修改参数、保存消息和对话步骤都可写入。后续可用 {{param.键名}} 插入消息,或在条件中检查,无须另建数据库也能维护客户的简要资料。
对话
对话中显示消息、照片、视频、语音、文件、按钮及送达状态。已执行的反应显示为单独卡片。底部可输入回复、附加文件,或从列表中发送反应。
附件
附件按钮打开本对话全部文件的图库,可按照片、文件、语音、链接筛选,或点击全部下载。
对话历史与导入
系统保存与用户的完整对话;向上滚动时分批载入旧消息,打开长对话也无须等待全部历史下载。新消息会实时出现在已打开的对话及客服队列。从 sambot 导入机器人时,可连用户及历史附件一起导入,详见从 sambot 导入。
客户资料卡与批量操作
资料卡整合用户信息、事件时间线、受众分组、对话和客服备注。时间线分批载入,可按类型、来源和时间筛选。修改属性与标签后点击保存;修改会进入操作日志,并触发分组更新。
列表中可选中客户,批量设置属性。操作基于保存的受众快照,最多 5,000 人,重复提交也不会重复应用。CSV 导出是独立的已保存任务,下载前可取消;已经应用的批量修改不会部分回滚。
合并档案
项目所有者可在同一列表页选择两个人,然后选择合并档案。检查联系方式和渠道,选择主档案并确认。历史记录和数据将合并;字段冲突时以主档案为准。合并无法撤销。
请先完成或检查尚未结束的 CRM 同步或 Ozma 操作,并解决冲突的联系方式以及指向不同 CRM 记录的关联。
相同的邮箱不会自动合并档案。使用带签名的 identify 关联网站已登录用户;只有所在区域启用该功能后,才能使用已确认的 Telegram 关联;仅连接渠道并不够。
接下来
- 聊天与客服:客服队列及转接。
- 条件与聊天:按标签与参数筛选。
- 群发:按分组发送。
- 从 sambot 导入:迁移历史对话。
动态受众分组
在分组中以“且”或“或”组合条件。保存前先预览定义;修改后重新计算成员,并在用于群发前确认分组已准备好。仅保存定义不代表人数已经更新。