排查投递问题

Ringhum 每次向已连接的应用发送内容时都会记录结果。如果某通电话没有出现在 Slack 中，或客服工单系统中没有创建工单，最近投递记录列表会告诉您该内容是已发送、被跳过还是被拒绝，以及具体原因。大多数问题是密钥过期、频道或列表被删除，或缺少某项设置。

打开最近投递记录

1. 打开集成并点击已连接。
2. 在该应用的卡片上，点击以上次投递开头的那一行，例如"上次投递 5 分钟前 · 正常"。

最近投递记录窗口会列出该应用最近 25 次尝试，按最新排列。每一行会显示事件、状态、时间，以及消息（如有）。将鼠标悬停在较长的消息上可查看全文。投递记录会保留 30 天。

如果卡片上没有上次投递这一行，说明该应用尚未收到任何内容。

各状态的含义

卡片上的徽标会依据最近一次结果显示：成功或被跳过时显示已连接，失败时显示错误，您暂停该应用时显示已暂停。

各事件名称的含义

常见的"已跳过"消息

以下情况都属正常，除非您预期会有其他结果，否则无需采取任何操作。

修复错误

密钥被拒绝，或消息中提到 401 或 403。 API 密钥或令牌已被撤销、已过期，或权限不足。请在对应应用中按照连接对话框中列出的权限要求创建新密钥，然后在卡片上点击设置，粘贴新密钥并点击保存设置。

连接已过期（登录类应用）。 对于 Google Calendar、Google Sheets、Google Drive 和 HubRise，请在卡片上点击重新连接并重新登录。

"返回了 HTTP 404" 或 "Slack 拒绝了该消息，请检查 webhook 网址。" 该 webhook 网址已失效，通常发生在 Slack webhook、Teams 工作流、Discord 或 Google Chat webhook、Zap、Make 场景或 n8n 工作流被删除或关闭时。请创建一个新的，并在设置下粘贴其网址。

找不到某个列表、项目、看板或数据库。 设置中的 ID 指向已被删除或该密钥无权访问的内容，请检查该 ID 以及密钥在对应应用中的访问权限。

错误只发生过一次。 对方应用的临时故障不会被重试，下一个事件会正常发送。请到对方应用中查看是否漏收了该内容，如需要可手动补充。

排查原因后，点击卡片上的测试或发送测试。测试成功会在列表中显示为一行绿色的 test 记录。

关于应用故障的邮件提醒

如果对同一应用连续三次投递失败，工作区所有者会收到一封标题为"应用名称 集成需要处理"的邮件，附上最近一次错误和集成页面的链接。每个应用每天最多发送一次此类邮件。

对于 Google Calendar，当与 Google 的连接过期时，会单独发送一封题为"Google Calendar 已断开连接——预约可能出现重复"的邮件。参见日历与忙碌时间。

常见问题

某通电话没有显示，但也没有错误。 请检查设置下该事件是否已勾选、仅需要处理的通话是否将其过滤掉了，以及该应用当时是否处于暂停状态。测试通话的通话更新、收件箱事项和订单不会被发送。参见选择发送哪些内容。

我可以重新发送一次失败的投递吗？ 不可以，投递不会被排队等待稍后重试。请修复问题原因，以便后续事件能够正常送达。

在哪里可以查看发送到我自己 webhook 端点的投递记录？ 在开发者下添加的端点会在其上次投递列中显示最近一次结果。参见 Webhook。