Skip to content

[codex] Add backend WhatsApp demo helper#1

Merged
patrickpassosb merged 1 commit intomasterfrom
codex-backend-demo-helper
Apr 10, 2026
Merged

[codex] Add backend WhatsApp demo helper#1
patrickpassosb merged 1 commit intomasterfrom
codex-backend-demo-helper

Conversation

@patrickpassosb
Copy link
Copy Markdown
Owner

What changed

  • added a Bun helper command at bedside-backend/scripts/evolution-demo.ts
  • exposed it through bun run demo:whatsapp
  • added a short backend demo runbook for QR pairing and seeded patient testing

Why

The backend and Evolution API were already running, but hackathon demo setup still depended on manual API calls for instance status, webhook configuration, and QR export. This makes the pairing flow repeatable from the repo.

Impact

  • faster local setup before a live demo
  • less guesswork when re-pairing the Bedside WhatsApp device
  • clearer handoff for seeded patient test messages

Root cause

Operational setup knowledge lived in ad hoc commands instead of a checked-in helper and runbook.

Validation

  • bun run seed
  • bun run typecheck
  • bun run demo:whatsapp status
  • bun run demo:whatsapp webhook
  • bun run demo:whatsapp qr
  • curl http://localhost:3000/health

Remaining gap

  • full inbound WhatsApp exchange still requires a manual QR scan and phone test

The backend and Evolution API were already healthy, but pairing the demo phone and wiring the webhook still required a manual curl sequence. This adds a Bun helper for instance status, webhook setup, and QR export, plus a short operator runbook for the seeded patient flow.

Constraint: Demo setup must stay fast and repeatable during a live hackathon

Rejected: Configure the webhook implicitly on backend startup | adds hidden side effects to every boot

Confidence: high

Scope-risk: narrow

Reversibility: clean

Directive: Keep the demo helper env-driven and do not store API keys, instance tokens, or QR artifacts in git

Tested: bun run seed, bun run typecheck, bun run demo:whatsapp status, bun run demo:whatsapp webhook, bun run demo:whatsapp qr, curl http://localhost:3000/health

Not-tested: End-to-end inbound WhatsApp exchange after manual QR scan
@patrickpassosb patrickpassosb marked this pull request as ready for review April 10, 2026 14:41
@patrickpassosb patrickpassosb merged commit 8894222 into master Apr 10, 2026
4 checks passed
@patrickpassosb patrickpassosb deleted the codex-backend-demo-helper branch April 10, 2026 14:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant