Memulai dengan WhatsApp Business API di Velora

Mengapa WhatsApp Business API?

WhatsApp adalah kanal komunikasi paling populer di Indonesia dengan tingkat keterbacaan pesan yang jauh melampaui email atau SMS. Dengan WhatsApp Business API melalui Velora, Anda dapat mengirim dan menerima pesan secara programatik, membangun chatbot, serta melakukan broadcast ke ribuan pelanggan — semua dari satu dasbor terpusat.

API resmi ini berbeda dengan WhatsApp pribadi: nomor Anda terdaftar sebagai Bisnis, mendapatkan badge hijau opsional, dan tunduk pada kebijakan Meta untuk menjaga kualitas pengiriman.

Langkah 1 — Hubungkan Nomor Bisnis

Buka menu Channels → Tambah Channel → WhatsApp, lalu:

• Pilih tipe koneksi: Cloud API (Meta) atau Provider Eksternal.
• Masukkan nomor telepon format internasional, misalnya +62812xxxxxxx.
• Verifikasi kepemilikan via kode OTP atau login bisnis Meta.
• Tunggu status channel berubah menjadi ACTIVE (biasanya < 5 menit).

Catatan: nomor yang sudah terdaftar di WhatsApp Web/Desktop harus di-logout lebih dulu, karena satu nomor hanya bisa aktif di satu backend API.

Langkah 2 — Dapatkan API Key

Setelah channel aktif, buka Settings → API Keys dan klik Generate Key. Simpan X-API-Key di tempat aman — key hanya ditampilkan satu kali. Key ini dipakai untuk semua permintaan REST ke Velora.

Langkah 3 — Kirim Pesan Pertama

Coba kirim pesan teks sederhana dengan curl:

curl -X POST https://api.velora.dev/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: vlr_live_xxxxxxxxxxxx" \
  -d '{
    "to": "+6281234567890",
    "type": "text",
    "text": { "body": "Halo dari Velora! Pesan pertama Anda berhasil 🎉" }
  }'

Anda akan menerima respons JSON berisi messageId dan status queued. Pesan biasanya terkirim dalam 1–3 detik.

Tips Awal

• Mulai dari template: pesan pertama ke pelanggan baru harus menggunakan template yang sudah disetujui Meta (24-hour window).
• Pantau webhook: pasang endpoint webhook untuk menerima event message.received dan message.delivered.
• Jaga rating kualitas: hindari mengirim pesan ke nomor yang tidak merespons, karena dapat menurunkan tier kualitas nomor Anda.

Dengan tiga langkah di atas, kanal WhatsApp Anda sudah siap menerima dan membalas pesan otomatis. Selanjutnya, coba integrasikan dengan AI Assistant Velora untuk auto-reply yang lebih cerdas.