Merge pull request #40 from flashcatcloud/docs/add-zoom-bot-notification

docs: add Zoom webhook troubleshooting and service account recommendation

Author: ysyneu

en/on-call/integration/instant-messaging/zoom.mdx

@@ -13,6 +13,10 @@ Before configuring, you need to create a Chatbot application in the [Zoom Market
 1. **Webhook URL or Token**: The Webhook URL or Token of the Zoom Chatbot.
 2. **Verify Token**: The Verify Token used to authenticate request origins.
 
+<Warning>
+Zoom Incoming Webhook connections are tied to the Zoom account that created them. When that user leaves the organization or their account is deactivated, all Webhook connections they created are automatically invalidated, and Zoom's error response will not indicate the actual cause. **We strongly recommend using a shared team service account** (rather than a personal account) to create Webhook connections, preventing notification disruptions due to personnel changes.
+</Warning>
+
 ## Configuration steps
 
 Add a Zoom bot notification channel in a channel's escalation rule:
@@ -81,4 +85,17 @@ You can find the Verify Token on your Chatbot application's configuration page i
 <Accordion title="How do I create a user mapping table?">
 Go to Platform Management → Mapping Table Management to create a Zoom-type user mapping table. You can also click the **Quick Create Mapping Table** link when configuring the Zoom bot to navigate directly to the creation page.
 </Accordion>
+
+<Accordion title="Notification fails with 'Failed to send bot message'?">
+This error means Zoom cannot send messages through the Webhook. Possible causes include: the Webhook connection has been invalidated, the creator's account was deactivated or removed, or the Webhook was manually deleted. Zoom's error response (HTTP 400 `Failed to send bot message`) does not indicate the specific cause.
+
+**Troubleshooting steps:**
+1. Create a new Incoming Webhook connection in Zoom
+2. Test the new Webhook URL in your Flashduty escalation rule
+3. If the new Webhook works, the original connection has been invalidated (commonly caused by the creator leaving the organization and their account being deactivated) — replace it with the new Webhook
+4. If the new Webhook also fails, check the message content format or contact Zoom support
+
+**Prevention:**
+- Use a shared team service account (rather than a personal account) to create Webhook connections, preventing notification disruptions due to personnel changes
+</Accordion>
 </AccordionGroup>

zh/on-call/integration/instant-messaging/zoom.mdx

@@ -13,6 +13,10 @@ Zoom 机器人是一种群聊通知渠道，您可以在协作空间的分派策
 1. **Webhook 地址或 Token**：Zoom Chatbot 的 Webhook URL 或 Token。
 2. **Verify Token**：用于验证请求来源的 Verify Token。
 
+<Warning>
+Zoom Incoming Webhook 的连接与创建者的 Zoom 账号绑定。当创建者离职或账号被停用时，其创建的所有 Webhook 连接将自动失效，且 Zoom 返回的错误信息不会明确指出原因。**强烈建议使用团队共享的服务账号**（而非个人账号）来创建 Webhook 连接，避免因人员变动导致通知中断。
+</Warning>
+
 ## 配置步骤
 
 在协作空间的分派策略中添加 Zoom 机器人通知渠道：
@@ -81,4 +85,17 @@ Zoom 机器人是一种群聊通知渠道，您可以在协作空间的分派策
 <Accordion title="如何创建用户信息映射表？">
 前往 平台管理 → 映射表管理，创建 Zoom 类型的用户信息映射表。您也可以在配置 Zoom 机器人时，点击 **快速创建映射表** 链接直接跳转创建。
 </Accordion>
+
+<Accordion title="通知发送失败，提示 Failed to send bot message？">
+该错误表示 Zoom 无法通过该 Webhook 发送消息，可能的原因包括：Webhook 连接已失效、创建者账号被停用或离职、Webhook 被手动删除等。Zoom 返回的错误信息（HTTP 400 `Failed to send bot message`）不会明确指出具体原因。
+
+**排查方法：**
+1. 在 Zoom 中创建一个新的 Incoming Webhook 连接
+2. 在 Flashduty 分派策略中使用新的 Webhook 地址进行测试
+3. 如果新 Webhook 发送正常，说明原 Webhook 连接已失效（常见原因是创建者离职导致账号被停用），使用新的 Webhook 替换即可
+4. 如果新 Webhook 同样失败，请检查消息内容格式或联系 Zoom 支持
+
+**预防建议：**
+- 使用团队共享的服务账号（而非个人账号）创建 Webhook 连接，避免因人员变动导致通知中断
+</Accordion>
 </AccordionGroup>