त्वरित शुरुआत
यह guide आपको एक instance बनाने, उसे connect करने, और अपना पहला message भेजने की प्रक्रिया बताती है।
आवश्यकताएं
एक Wappfy account (sign up करें )
Connect करने के लिए एक WhatsApp number
एक API key या Supabase JWT token
Step 1: अपनी API key प्राप्त करें
curl -X POST https://api.wappfy.io/api/api-keys \
-H "Authorization: Bearer YOUR_SUPABASE_JWT" \
-H "Content-Type: application/json" \
-d '{ "name": "My First Key" }'
लौटाए गए key value को सुरक्षित रखें — यह केवल एक बार दिखाया जाता है।
Step 2: एक instance बनाएं
curl -X POST https://api.wappfy.io/api/instances \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Production WhatsApp",
"instance_type": "waha"
}'
लौटाए गए id को save करें — आप इसे सभी अगले requests में उपयोग करेंगे।
Step 3: QR code से connect करें
# Connection शुरू करें
curl -X POST https://api.wappfy.io/api/instances/INSTANCE_ID/connect \
-H "X-Api-Key: YOUR_API_KEY"
# QR code प्राप्त करें
curl https://api.wappfy.io/api/instances/INSTANCE_ID/qr \
-H "X-Api-Key: YOUR_API_KEY"
अपने phone पर WhatsApp खोलें, Linked Devices में जाएं, और qr field में लौटाए गए QR code (base64 image) को scan करें।
Step 4: एक message भेजें
जब instance का status connected हो जाए, तब आप अपना पहला message भेज सकते हैं:
curl -X POST https://api.wappfy.io/api/instances/INSTANCE_ID/messages/send \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "5511999999999",
"type": "text",
"body": "Hello from Wappfy!"
}'
Response
{
"success" : true ,
"data" : {
"message" : "Message queued for delivery" ,
"jobId" : "12345"
},
"meta" : {
"requestId" : "req_abc123" ,
"timestamp" : "2026-02-10T12:00:00.000Z"
}
}
अगले कदम
सभी message types भेजें Images, videos, polls, contacts, और बहुत कुछ
Webhooks सेट अप करें Incoming messages और delivery status प्राप्त करें