跳转到主要内容

Wati API 安全更新(安全密钥轮换):您需要了解的内容

摘要

我们执行了安全密钥轮换,以增强 API 和访问安全性。此更改可能会影响部分客户,特别是那些 API 集成处于非活动或休眠状态的客户。

此操作上次完成是在 2026 年 2 月。

说明

了解流程

Wati 做了什么?

我们执行了安全密钥轮换

目标:此操作是为了增强我们的 API 和访问安全性。

我们引入了“录制阶段”,以便在安全密钥轮换过程中自动保存活动会话。这有助于最大限度地减少对活跃客户的影响。

对客户的影响

活跃客户

如果您是活跃客户,那么您不会受到此更改的影响。如果您在录制期间定期登录或使用您的 API 集成,我们的系统将识别并记录您的连接,确保其在整个过程中保持活动状态。

非活跃/休眠客户

如果您的 API 集成已关闭或在录制期间未发出请求,则不会被保存。更新完成后,该特定集成将停止工作,直到重新激活。

注意:受影响的客户是那些集成处于休眠或非活动状态的客户。如果您是活跃用户,您的连接和 API 密钥保持不变。

如果您的 API 处于非活动状态(在此安全操作期间未发出任何请求),您的先前令牌将已过期,您需要生成一个新令牌才能重新连接。

如何生成新令牌

如果您在此操作期间未进行任何 API 调用且令牌已过期,请按照以下步骤生成新令牌:

  • 复制您的访问令牌。

  • 用新令牌替换您代码中的旧令牌。

注意:如果您在 Wati 账户中有活动集成或定期运行 API 调用,则无需进一步操作。

接下来该怎么做?

  • 继续像往常一样使用您的 API 集成。

  • 安全密钥轮换过程已完成。

  • 如果您在使用集成时遇到问题,请按照上述步骤生成新的 API 令牌。

  • 如果在更新令牌后问题仍然存在,请联系我们的支持团队寻求进一步帮助。

常见问题解答 (FAQ)

1. 我被登出了仪表盘吗?

大多数活跃客户都没有注意到任何变化。他们的令牌已自动记录并列入白名单,得以继续工作。只有在录制期间完全不活跃的用户失去了访问权限,需要重新登录。

2. 我现有的 API 集成停止工作了吗?

如果您的集成在过渡期间至少发送了一个请求,它会自动列入白名单并继续工作。在此期间保持非活动的集成将在操作完成后停止工作——直到生成新令牌。

3. 我需要生成新的 API 令牌吗?

  • 如果在录制期间您的集成处于活动状态,您的令牌将继续有效。

  • 如果您的集成处于非活动状态且在操作完成后令牌已过期,您需要从仪表盘生成新令牌。

4. 我看到“401 Unauthorized”错误。我该怎么办?

如果您的集成或账户在此安全操作期间处于非活动状态,在安全轮换最终确定之前,您的令牌未被捕获在白名单数据库中。

修复方法:

  • 对于仪表盘用户(如果您已退出登录):只需重新登录即可创建新会话。

  • 对于 API 用户:转到仪表盘,生成新的 API 令牌,并在您的代码中替换旧令牌。

这是否解答了您的问题?