Langsung ke konten utama

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