docs: help users self-diagnose "Last delivery: Failed" webhooks#13
Draft
posthog[bot] wants to merge 1 commit into
Draft
docs: help users self-diagnose "Last delivery: Failed" webhooks#13posthog[bot] wants to merge 1 commit into
posthog[bot] wants to merge 1 commit into
Conversation
…tic cross-links Users hitting "Last delivery: Failed" were re-editing event triggers and buffering settings, which cannot affect delivery success — delivery depends only on how the receiving endpoint responds. - Add a troubleshooting section to webhooks-overview.md and webhooks-reference.md naming the real causes (non-200, timeout, signature mismatch, wrong webhook scope) and stating that triggers/buffering do not affect delivery. - Cross-link the webhook editing docs (SKILL.md) to the webhook-deliveries.js diagnostic and the test.js test-delivery flow so users diagnose the endpoint instead of tweaking config. - Note in the Buffering reference that it does not affect delivery success. Generated-By: PostHog Code Task-Id: 430f00fb-8e08-4d83-8ad4-3552290c855b
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
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.
Why
In a flagged session, a user hit "Last delivery: Failed" on a WhatsApp webhook and kept re-editing event triggers and buffering/debouncing settings trying to fix it — but those settings don't affect delivery success at all. Delivery only fails based on how the receiving endpoint responds. A working diagnostic (
webhook-deliveries.js) and a test-delivery flow (test.js) already exist, but the webhook editing docs never pointed to them, so confused users never reached them. This is a repeated-edit pattern seen across many developers.Changes
webhooks-overview.mdandwebhooks-reference.mdnaming the real causes (non-200, timeout, signature mismatch, wrong webhook scope) and making explicit that triggers and buffering don't affect delivery success.integrate-whatsapp/SKILL.md) to thewebhook-deliveries.jsdiagnostic (--errors-only/--status) and thetest.jstest-delivery flow.Docs-only change.
npm run validateandnpm run check:syntaxpass.Created with PostHog Code from an inbox report.