Panduan Cepat
Panduan ini memandu Anda membuat instance, menghubungkannya, dan mengirim pesan pertama Anda.
Prasyarat
- Akun Wappfy (daftar)
- Nomor WhatsApp untuk dihubungkan
- API key atau token JWT Supabase
Langkah 1: Dapatkan API key Anda
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" }'
Simpan nilai key yang dikembalikan — nilai ini hanya ditampilkan sekali.
Langkah 2: Buat 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"
}'
Simpan id yang dikembalikan — Anda akan menggunakannya di semua permintaan selanjutnya.
Langkah 3: Hubungkan melalui kode QR
# Mulai koneksi
curl -X POST https://api.wappfy.io/api/instances/INSTANCE_ID/connect \
-H "X-Api-Key: YOUR_API_KEY"
# Dapatkan kode QR
curl https://api.wappfy.io/api/instances/INSTANCE_ID/qr \
-H "X-Api-Key: YOUR_API_KEY"
Buka WhatsApp di ponsel Anda, buka Perangkat Tertaut, dan pindai kode QR yang ada di field qr (gambar base64).
Langkah 4: Kirim pesan
Setelah status instance menjadi connected, Anda dapat mengirim pesan pertama:
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!"
}'
Respons
{
"success": true,
"data": {
"message": "Message queued for delivery",
"jobId": "12345"
},
"meta": {
"requestId": "req_abc123",
"timestamp": "2026-02-10T12:00:00.000Z"
}
}
Langkah selanjutnya