故障排查与常见问题

快速参考。如果你在列表中没有看到自己的问题，可以在本页搜索（⌘/Ctrl + F）关键词。

登录与引导

• 没收到魔法链接——查看垃圾邮件；该链接会很快过期。请重新申请。
• 每次都把我跳转到引导——你的引导未被标记为完成。请走完向导；最后一步会翻转该标记。
• 工作区加入链接失败——邀请可能已过期、被撤销、已使用，或限定了邮箱；请向所有者索取新链接。

Telegram 账号与会话

• 「重新连接」横幅反复出现——其他位置的重复登录正在使会话失效。请关闭其他设备或联系支持。
• 无法接入第 6 个 Telegram 账号——你已达到每席位 5 个的限制；可购买额外 Telegram 账号附加项（每个 +€5/月）。
• QR 码扫不上——Telegram 大约每 30 秒会让 QR 失效；等待刷新或改用手机号+验证码。
• 账号一直处于「同步中」——首次同步可能需要几分钟到几十分钟，具体取决于历史消息量；如果已持续数小时，请联系支持。
• 文件夹改动没出现——通过 API 写入文件夹可能存在小延迟；如果近期改动尚未反映，请刷新页面。

消息与聊天

• 聊天列表中收不到消息——查看同步指示器；新账号需要等待初次同步完成。
• 自定义列的值保存不了——确认你拥有权限（成员可以编辑值，但不能编辑列本身），并且该列不是没有有效值的 required 列。
• 看不到队友的聊天——这是设计如此——每位用户只能看到自己亲自接入的 Telegram 账号。要共享某个聊天，两位队友需要接入同一个 Telegram 账号。参见队友能看到的内容。

模板

• 斜杠命令插不进模板——确保模板的标签以 / 开头（例如 /intro-message）并已保存。该标签即为斜杠命令。
• 插入时缺少模板附件——确认附件仍小于 3 MB，且模板仍在你 100 MB 总用户存储之内。

群发

• 群发比预期慢——你触达了更高的收件人数量分级；将其拆分为更小的批次有时能缩短墙钟时间，具体取决于 Entergram 如何分配 worker。
• 群发中 {{username}} 显示为空——{{username}} 仅在私聊中解析；群组和频道收件人没有 Telegram 用户名，因此该变量对它们而言为空。如果你的受众混合了私聊和群聊，请使用 {{name}} 或 {{first_name}}。
• 找不到群发选项——群发需要分析功能，该功能在 Pro 上自动启用。如果你在 Basic 上，请从设置 → 套餐升级。

分析

• Basic 上分析页面被锁定或为空——分析仅限 Pro。请从设置 → 套餐升级（或购买 Pro 工作区席位）。Basic 用户可看到「自定义字段分析」回退视图。
• Pro 上图表为空——首次同步可能仍在进行中；页面会显示同步中横幅。首次同步可能需要几分钟到几十分钟，具体取决于历史消息量。
• 工作区成员看不到队友数据——「成员可查看所有分析」处于关闭状态；需所有者/管理员开启。
• 工单分析标签页为空——需要工作区模式且该工作区已启用工单。
• 自定义日期范围不可点——需要付费套餐；试用用户只能看到短范围。
• 某张卡片缺少对比数据——你选择了较长的范围（1 年、全部、自定义）。切换到 7 天 / 30 天即可看到差值。

工单

• 工单页面缺失——要么部署中禁用了工单，要么你的工作区所有者关闭了「启用工单」。
• 「成员不能编辑工单」但我需要编辑——所有者/管理员需在工作区设置中变更「成员可编辑工单」。
• SLA 显示「未设置」——该工作区没有配置默认 SLA；需所有者/管理员设置。
• SLA 预警提醒没收到——确认你已为账号完成提醒机器人的设置。
• 无法删除工单——要么你的角色没有删除权限，要么该工单存在尚在执行中的级联引用（罕见；请重试）。
• 截图中的工单 ID 我打不开——该工单可能属于你不在其中的另一个工作区。

账单

• 套餐变更没生效——升级立即生效，降级安排在周期结束时生效；横幅会显示计划日期。
• 银行卡被拒——状态会变为逾期未付；请在 Stripe 门户更新支付方式。
• 找不到工作区账单标签页——你不是所有者。仅所有者管理席位与账单。

API

• API 调用返回 401——密钥已过期、被撤销，或与该工作区不匹配。
• API 调用返回 403——密钥缺少所需的 scope，或请求来自白名单之外的 IP。
• 关闭对话框后看不到密钥——密钥仅显示一次。请撤销并新建一个。

数据与导出

• 导出被限速——等待 60 秒后重试；限制按数据集、按工作区计。
• 工作区导出缺少某个分类——某些数据集需要相应功能已启用（例如工单）。
• 活动日志没显示我的自定义字段编辑——只有通过 Entergram 进行的变更会被记录；直接写库会绕过日志。

安全相关

• 我怀疑我的 API 密钥泄露了——立即在开发者标签页撤销；新建一个；通过活动日志进行调查。
• 我想在所有地方退出登录——在「设置 → 账号」中断开所有 Telegram 账号、退出 Entergram，并修改你邮箱服务商的密码（因为魔法链接发到该收件箱）。
• 我怀疑发生了未授权的管理员操作——按可疑成员筛选活动日志是你的第一步；更深入的调查需联系支持。

还是没解决？

• Telegram：@hello_entergram
• 邮箱：hello@entergram.com