Copy # Send your first message — copy + paste in terminal curl -X POST \ -H "Content-Type: application/json" \ -H "x-api-key: YOUR_API_KEY" \ -d '{"phone":"919876543210","message":"Hello from WA Gateway!"}'

Copy // Request body { "phone": "919876543210", "message": "Hello!" } // Success response { "success": true, "messageId": "ABC123", "sent_by": "username" } // Error response { "error": "WhatsApp not connected" }

Copy // Send message to a single group { "group_id": "123456789-987654321@g.us", "group_name": "My Family Group", "message": "Hello everyone! 👋" } // Success response { "success": true, "messageId": "ABC123", "group_id": "...@g.us" }

Copy // Image via URL (easiest for Apps Script — use public link) { "phone": "919876543210", "type": "image", "media_url": "https://example.com/photo.jpg", "caption": "Check this out! 📸" } // PDF via base64 (for local files) { "phone": "919876543210", "type": "pdf", "media_base64": "JVBERi0xLjQKJ...", "filename": "invoice.pdf", "caption": "Your invoice" } // Same format for groups → use /send-media-group with group_id

Copy { "contacts": [ { "phone": "919876543210", "name": "Rahul" }, { "phone": "918765432109", "name": "Priya" } ], "message": "Hello {{name}}, order ready hai! 🎉", "delay_sec": 3 }

Copy // Broadcast same message to multiple groups { "groups": [ { "id": "123-456@g.us", "name": "Family" }, { "id": "789-012@g.us", "name": "Office" } ], "message": "Important announcement! 📢", "delay_sec": 5 }

Copy // Query params (all optional): ?type=single|group|broadcast&status=sent|failed&limit=200 { "success": true, "stats": { "total":42, "sent":40, "failed":2, "today":12 }, "messages": [ { "id":"m_abc", "type":"single", "to":"919...", "toName":"+919...", "message":"Hi!", "status":"sent", "timestamp":"2026-..." } ] }

Copy // ═══════════════════════════════════ // WA Gateway — Apps Script Library // ═══════════════════════════════════ const WA = { url: , key: "apni_api_key_yahan" }; function _wa(m, p, b) { var o = { method:m, headers:{ "x-api-key":WA.key, "Content-Type":"application/json" }, muteHttpExceptions:true }; if(b) o.payload = JSON.stringify(b); return JSON.parse(UrlFetchApp.fetch(WA.url+"/api/v1"+p, o).getContentText()); } function waStatus() { return _wa("get","/status"); } function waGroups() { return _wa("get","/groups"); } function waMessages() { return _wa("get","/messages"); } function waSend(phone,msg) { return _wa("post","/send-message",{phone,message:msg}); } function waSendImage(phone,url,cap) { return _wa("post","/send-media",{phone,type:"image",media_url:url,caption:cap||""}); } function waSendPDF(phone,url,name,cap){ return _wa("post","/send-media",{phone,type:"pdf",media_url:url,filename:name,caption:cap||""}); } function waSendGroup(gid,msg) { return _wa("post","/send-group",{group_id:gid,message:msg}); } function waBulk(contacts,msg,d) { return _wa("post","/send-bulk",{contacts,message:msg,delay_sec:d||3}); } function waBroadcast(groups,msg,d) { return _wa("post","/broadcast",{groups,message:msg,delay_sec:d||5}); }

Copy function testWA() { var s = waStatus(); Logger.log("Connected: " + s.connected + " | Sent today: " + s.daily_sent); if(!s.connected) { Logger.log("❌ QR scan karo pehle"); return; } var r = waSend("919876543210", "Hello! Test from Apps Script 🎉"); Logger.log(r.success ? "✅ Sent!" : "❌ "+r.error); }

Copy function sendFromSheet() { var rows = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getDataRange().getValues(); var contacts = []; for(var i=1; i<rows.length; i++) { if(rows[i][0]) contacts.push({ phone: rows[i][0].toString().trim(), name: rows[i][1]||"there" }); } Logger.log(contacts.length + " contacts found"); var r = waBulk(contacts, "Hello {{name}}, aapka message ready hai! 🎉", 4); Logger.log("Queued: " + r.queued); }

Copy function setDailyTrigger() { ScriptApp.newTrigger("dailyMsg").timeBased().everyDays(1).atHour(9).create(); Logger.log("Daily trigger set for 9 AM!"); } function dailyMsg() { if(!waStatus().connected) { Logger.log("WA not connected"); return; } waSend("919876543210", "Good morning! Aaj ka update: " + new Date().toLocaleDateString("en-IN")); Logger.log("Daily message sent!"); }

Copy // Every webhook request looks like this: { "event": "message.received", "timestamp": "2026-05-14T10:30:00.000Z", "userId": "usr_abc123", "data": { /* event-specific data */ } } // Headers included with every request: Content-Type: application/json X-Webhook-Event: message.received X-Webhook-Id: wh_abc12345 X-Webhook-Timestamp: 1715680800000 X-Webhook-Signature: sha256=... // only if secret is set

Copy { "event": "message.received", "data": { "message_id": "ABC123", "from": "919876543210", "from_jid": "919876543210@s.whatsapp.net", "from_name": "Rahul", "is_group": false, "group_id": null, "type": "text", "text": "Hello!", "media": null, "received_at": "2026-05-14T10:30:00Z" } }

Copy { "event": "message.sent", "data": { "message_id": "XYZ789", "to": "919876543210", "type": "single", "content": "Hi there!" } }

Copy { "event": "message.read", "data": { "message_id": "XYZ789", "to": "919876543210", "is_group": false } }

Copy { "event": "connection.connected", "data": { "phone_number": "919876543210", "name": "My Name" } }

Copy const crypto = require('crypto'); function verifyWebhook(rawBody, signature, secret) { const expected = 'sha256=' + crypto.createHmac('sha256', secret) .update(rawBody).digest('hex'); return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected)); } // In Express: app.post('/webhook', express.raw({type:'*/*'}), (req, res) => { const sig = req.headers['x-webhook-signature']; if (!verifyWebhook(req.body, sig, 'YOUR_SECRET')) { return res.status(401).send('invalid signature'); } const payload = JSON.parse(req.body); // Handle payload.event... res.json({received: true}); });