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.

Current runtime

Mode: stub. Timezone default: America/Detroit. Token present: no. Phone number ID: not set.

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
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
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
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
Submit message templates
Copy the names and bodies from /templates. Utility templates (reminders, order updates, FAQ) usually clear review faster than marketing.
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
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.