docs(integrate-whatsapp): pre-submit checklist + name-collision recovery for templates#9
Draft
posthog[bot] wants to merge 1 commit into
Draft
Conversation
… recovery for templates Template creation users repeatedly hit late, on-submit validation errors: empty quick-reply button text, the per-WABA "template name already exists" collision, and missing example values / invalid characters. Document these up front so the agent can steer users past them before submit: - templates-reference.md: add "Template naming rules" (lowercase/underscore charset, ≤512 chars, per-WABA uniqueness + recovery options), a "Pre-submit validation checklist", and a "Common creation errors and recovery" table. - SKILL.md: add a creation pre-submit checklist and a troubleshooting block covering the name-collision, missing-examples, invalid-character, and empty-button-text errors. Generated-By: PostHog Code Task-Id: e11e3537-a92c-47a8-aa49-03e3dc522fea
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.
Summary
WhatsApp template creation users keep getting stuck on the create form, hitting a string of late, on-submit validation errors — empty quick-reply button text, the per-WABA "template name already exists" collision, and missing example values / invalid characters. The buggy form lives in the
app.kapso.aiweb app (not this repo); the companion fix here is to document these rules so theintegrate-whatsappskill can steer users past them before they submit.templates-reference.md: new Template naming rules (lowercase/underscore charset, ≤512 chars, per-WABA name uniqueness + how to recover from a collision), a Pre-submit validation checklist, and a Common creation errors and recovery table.SKILL.md: creation pre-submit checklist plus a troubleshooting block for the name-collision, missing-examples, invalid-character, and empty-button errors.Why
Two recorded sessions across two distinct users showed the same friction on
/whatsapp_templates/new: a user was bounced by an unflagged empty quick-reply button, then dead-ended on "template name already exists" (escaping only by switching WhatsApp accounts + renaming), and another repeatedly failed with "Please provide example values for all parameters" and invalid-character errors. The existing reference documented the individual rules but never collated them into a pre-submit checklist, nor mentioned the per-WABA uniqueness rule or how to recover from a collision.Scope note
This is the documentation half of the fix. The primary symptom — late, on-submit validation instead of inline blocking, and the name-collision dead-end — lives in the
app.kapso.aiweb-app create form, which is not in this repo and is not changed here.Test plan
npm run validate✅npm run check:syntax✅Created with PostHog Code from an inbox report.