docs: add Zoom webhook troubleshooting and service account recommendation#40
Merged
docs: add Zoom webhook troubleshooting and service account recommendation#40
Conversation
Zoom incoming webhook connections are tied to the creator's account. When that user leaves the org, all their webhooks silently break with a vague HTTP 400 "Failed to send bot message" error. Add a Warning block in prerequisites recommending shared service accounts, and a new FAQ entry explaining the failure and how to recover. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Reframe the FAQ to not assume resignation as the only cause. Add a step-by-step troubleshooting flow: create a new webhook, test it, then confirm whether the old one is invalid before concluding root cause. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
<Warning>block in prerequisites recommending shared service accounts for creating Zoom incoming webhooksContext
Zoom incoming webhook connections are bound to the creator's account. When that user resigns and their account is deactivated, all webhook connections they created are silently invalidated — Zoom returns an unhelpful HTTP 400
"Failed to send bot message"with no indication of the actual cause.Test plan
🤖 Generated with Claude Code