一旦你把某个群组调整到完全满意的状态,就不必在其他每个群组里再手动重建这套配置。Telm 的 REST API 让你可以读取一个群组的设置、审核规则和白名单,并把它们写入另一个群组,这样一套经过验证的配置就变成了可以随处推广的模板。对于代理机构,以及任何用同一套策略管理多个社群的人来说,这都是首选方案。完整 API 在 Pro 及以上套餐中提供;你用在仪表盘中创建的 API 密钥来驱动它。
想设置这个功能吗?直接在你的 Telm 账户里完成吧。
在控制台中打开1为什么要复制配置
把一个群组调好需要花时间——你要设定好反垃圾灵敏度、加入适合你社群的审核规则,并逐步建立一份绝不应被误伤的成员白名单。在下一个群组里手动重建这一切既缓慢又容易出错。
复制配置正好解决了这个问题。你把一套已经生效的配置捕获下来,几秒钟就能在别处重现。它非常适合把一套统一标准策略应用到多个社群的代理机构,适合从模板群组快速创建新聊天,也适合为你所依赖的配置保留一份安全快照。
2你可以复制什么
一个群组的大部分行为由三个部分决定,每一部分都可以从一个群组读取,再写入另一个群组:
- 群组设置——反垃圾灵敏度、欢迎语、语言,以及群组配置中存储的每一个开关。
- 审核规则——每条自定义规则的名称、类型、条件、动作、优先级以及开/关状态。
- 白名单——被免除审核的成员列表。
3它如何通过 API 工作
Telm 在 api.telm.com/api/public/v1 提供了一个纯粹的 REST API。你用普通的 HTTPS 请求从源群组读取、向目标群组写入——可以用任何语言,也可以直接在终端里用 curl。
对于设置,你从源群组获取它们,再用一次 PATCH 发送到目标群组——你发送的值会合并进目标群组的配置。对于规则和白名单,你在源群组上列出各个条目,再在目标群组上创建相同的条目。相关机制、身份验证和配额在 Telm REST API 中有介绍。
4你需要什么
你需要一个 API 密钥(在仪表盘中创建),以及一个包含完整 API 访问权限的套餐——也就是 Pro 及以上。详见 Telm REST API。
该密钥继承你的访问权限,因此它只能操作你已经管理的群组。这样就把配置迁移限定在你自己的账户范围内。
5实用提示
把你从群组读取到的响应保存为纯 JSON 文件——它们是一份快照,你随时可以重新应用,把群组回滚到一个已知良好的状态。
先推广到一个群组并检查无误,再把同一套配置应用到其余群组。在单个聊天里发现意外,要比在二十个聊天里容易得多。
要决定让哪些群组保持同步,请先阅读 管理多个群组。