qhkm WhatsApp Blast Skill
Send WhatsApp messages to customers via the official Meta WhatsApp Cloud API. No third-party bridge required.
Setup
- Create a Meta Business app at developers.facebook.com
- Add WhatsApp product → get a test/permanent phone number ID
- Generate a permanent system user token (not the temporary one)
export WHATSAPP_TOKEN="EAAxxxxx..."
export WHATSAPP_PHONE_ID="123456789"
Send a Text Message
curl -s -X POST "https://graph.facebook.com/v19.0/$WHATSAPP_PHONE_ID/messages" \
-H "Authorization: Bearer $WHATSAPP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "60123456789",
"type": "text",
"text": {"body": "Your order #1234 has been shipped! 🚚"}
}' | jq .
Phone numbers must include country code, no + prefix (e.g. 60123456789 for Malaysia).
Send a Template Message
Templates must be pre-approved in Meta Business Manager before use.
curl -s -X POST "https://graph.facebook.com/v19.0/$WHATSAPP_PHONE_ID/messages" \
-H "Authorization: Bearer $WHATSAPP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "60123456789",
"type": "template",
"template": {
"name": "order_confirmation",
"language": {"code": "en"},
"components": [{
"type": "body",
"parameters": [
{"type": "text", "text": "Ahmad"},
{"type": "text", "text": "#ORD-5678"},
{"type": "text", "text": "RM 49.90"}
]
}]
}
}' | jq .
Bulk Send from a List
# numbers.txt — one per line, no + prefix
while IFS= read -r number; do
curl -s -X POST "https://graph.facebook.com/v19.0/$WHATSAPP_PHONE_ID/messages" \
-H "Authorization: Bearer $WHATSAPP_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"messaging_product\":\"whatsapp\",\"to\":\"$number\",\"type\":\"text\",\"text\":{\"body\":\"Hi! Our Raya sale starts tomorrow — up to 50% off!\"}}" | jq -r '.messages[0].id'
sleep 1 # stay within rate limits
done < numbers.txt
Tips
- Free tier: 1,000 conversations/month; paid tiers scale to millions
- Rate limit: ~80 messages/second on Cloud API
- Only send to users who have opted in — spam will get your number banned
- Use templates for first-contact messages; free-form text only in 24h reply window