WaWaReady

Docs

Demo stub

Connect Meta WhatsApp Cloud API later

Checklist only. V1 does not run OAuth, does not send messages, and does not require these values to run locally. WaReady is a Washboard Labs product.

  1. 1
    Create a Meta Business account
    Use the same legal name you entered in WaReady setup. You will need a verified business and an admin who can accept WhatsApp terms.
  2. 2
    Add a WhatsApp Business app in Meta Developers
    Create an app, add the WhatsApp product, and note the Phone number ID. That maps to WHATSAPP_PHONE_NUMBER_ID.
  3. 3
    Generate a permanent system user token
    Do not put a short-lived user token in production. Store WHATSAPP_TOKEN only on the server. V1 never sends it to the browser.
  4. 4
    Verify the display name and phone
    The display name should match the storefront customers already know. Complete the SMS/voice verification for the business number.
  5. 5
    Submit message templates
    Copy the names and bodies from /templates. Utility templates (reminders, order updates, FAQ) usually clear review faster than marketing.
  6. 6
    Register a webhook (later)
    WaReady V1 has no webhook. When live send is added, Meta will POST inbound messages to an HTTPS callback. Keep that off this demo.
  7. 7
    Stay inside the 24-hour window
    Free-form replies are allowed for 24 hours after a customer messages you. Outside that window, use an approved template.
Where the stub lives
Swap the factory later. Do not call Graph from client components.

Interface: src/lib/whatsapp/types.ts

Stub: src/lib/whatsapp/stub.ts

Factory: src/lib/whatsapp/client.ts — always returns the stub in V1.

Back to setupOpen templates