Documentation

Setup Guide

Complete guide to configure the WhatsApp Cloud API messenger.

1
Create a Meta Developer Account
Visit developers.facebook.com and sign in with your Facebook account. Go to My Apps → Create App → Select "Business" type → Add WhatsApp product.
2
Get Your API Credentials
In your app dashboard → WhatsApp → API Setup:
Access Token: EAAxxxx... (copy the temporary or permanent token) Phone Number ID: Found under "From" section Business Account ID: Found in your WhatsApp Business account settings
3
Deploy the API Server
The Fastify API server handles webhook verification, message proxying, and SSE.
cd apps/api vercel --prod # Set these environment variables in Vercel dashboard: WEBHOOK_VERIFY_TOKEN=your_secret_token WA_APP_SECRET=your_meta_app_secret
4
Configure the Webhook in Meta Console
Go to your Meta app → WhatsApp → Configuration → Webhook:
Callback URL: https://api.waqly.com/webhook/whatsapp Verify Token: (same as WEBHOOK_VERIFY_TOKEN) Subscribe to fields: messages, message_deliveries, message_reads
5
Deploy the Web App
Deploy the Vite + React messenger app:
cd apps/webapp # Set in Vercel dashboard: VITE_API_BASE=https://api.waqly.com vercel --prod
6
Configure in the App
Open the messenger app → click Settings (⚙️) → Accounts tab → Add Account. Enter your Access Token, Phone Number ID, and optionally Business Account ID. Add contacts and start messaging!
7
Mobile App (Optional)
Run the Expo mobile app:
cd apps/mobile # Set EXPO_PUBLIC_API_BASE=https://api.waqly.com npx expo start # Scan QR code with Expo Go app
⚠️ Important Notes