OneGate

WhatsApp API untuk mengirim pesan dari sistem kamu

Satu endpoint REST untuk mengirim notifikasi pesanan, kode OTP, dan pengingat tagihan ke WhatsApp pelanggan. Pakai nomor WhatsApp yang sudah ada, hubungkan dengan scan QR, lalu panggil API dari bahasa pemrograman apa pun.

Daftar & hubungkan nomorTanya tim OneGate
  • Satu endpoint untuk teks & media
  • Webhook pesan masuk
  • Nomor dari negara mana pun
Kirim pesan teks
curl -X POST https://api.onegate.id/onegate/v1/messages/send \
  -H "X-API-Key: og_dev_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to":"6281234567890","text":"Kode OTP kamu 482913"}'
Respons
{ "success": true, "data": { "messageId": "3EB0…" } }

Yang bisa dikirim lewat WhatsApp API OneGate

Semua jenis pesan memakai endpoint yang sama, POST /v1/messages/send, dengan respons JSON.

  • Pesan teksIsi field to dan text. Nomor ditulis dengan kode negara, misalnya 6281234567890.
  • Gambar, video, audio, dokumenIsi type dan mediaUrl berupa URL publik, tambahkan caption bila perlu.
  • Template dengan variabelKirim templateId dan variables. {{nama}} dan kolom kontak terisi otomatis, dan satu variasi kalimat dipilih acak per pesan.
  • Posting ke Channel WhatsAppKirim teks, gambar, atau video ke channel milik kamu dengan API key device. Lihat fitur Channel.
  • Nomor internasionalHubungkan nomor dari negara mana pun dan kirim ke nomor luar negeri.
  • Cek status API keyGET /v1/me menampilkan jenis key, status koneksi nomor, dan jumlah nomor online di grup.

API key per nomor atau per grup nomor

Setiap nomor WhatsApp yang kamu hubungkan menjadi satu device dengan API key sendiri (og_dev_…). Pesan yang dikirim dengan key ini selalu keluar dari nomor tersebut, cocok untuk memisahkan nomor notifikasi, nomor CS, dan nomor marketing.

Butuh kapasitas lebih besar? Gabungkan beberapa nomor dalam satu grup dan pakai API key grup (og_grp_…). Pengirim digilir otomatis di antara nomor yang sedang online, dan nomor yang terputus dilewati sehingga pengiriman tidak berhenti.

API key bisa dikirim lewat header X-API-Key, header apikey, atau field apikey di body JSON, jadi tetap bisa dipakai dari tool yang tidak bisa mengatur header.

Kirim pakai template
{
  "to": "6281234567890",
  "templateId": "tagihan-spp",
  "variables": {
    "nama": "Ahmad",
    "tagihan": "Rp350.000"
  }
}

Webhook untuk pesan masuk dan status pengiriman

Isi URL webhook di pengaturan device. OneGate meneruskan event dari WhatsApp, seperti pesan masuk, status koneksi, dan tanda dibaca, ke server kamu lewat POST JSON. Bila server kamu sedang error, pengiriman event diulang hingga 3 kali.

Dengan webhook, sistem kamu bisa mencatat balasan pelanggan, menandai konfirmasi pembayaran, atau membalas otomatis berdasarkan data sendiri. Untuk balasan berbasis kata kunci tanpa menulis kode, pakai auto reply dengan data API.

Kode respons yang jelas

Setiap kegagalan mengembalikan HTTP status dan pesan error yang bisa dibaca sistem kamu:

  • 400 – input tidak valid, misalnya nomor, type, mediaUrl, atau variabel template belum diisi.
  • 401 – API key tidak ada atau tidak valid.
  • 409 – nomor belum terhubung, atau tidak ada nomor online di grup.
  • 429 – melebihi batas request per menit untuk API key tersebut.
  • 502 – WhatsApp menolak atau gagal mengirim pesan.

Dokumentasi lengkap dengan contoh cURL, PHP, JavaScript, dan Python, plus formulir untuk mencoba request sungguhan, tersedia di dashboard setelah kamu masuk.

Mulai pakai WhatsApp API dalam tiga langkah

  1. Daftar dan pilih paket

    Daftar dengan email, verifikasi kode OTP, lalu bayar paket lewat QRIS atau virtual account.

  2. Hubungkan nomor

    Tambah device di dashboard dan scan QR dari WhatsApp di HP, sama seperti menautkan WhatsApp Web.

  3. Panggil API

    Salin API key device, kirim request ke /v1/messages/send, dan isi URL webhook bila perlu menerima balasan.

Contoh pemakaian WhatsApp API

Notifikasi toko online
Konfirmasi pesanan, pembayaran diterima, dan nomor resi terkirim otomatis saat status berubah.
OTP dan verifikasi akun
Kode login atau pendaftaran dikirim ke WhatsApp, lebih hemat dibanding SMS.
Tagihan dan pengingat
Pengingat jatuh tempo SPP, cicilan, langganan internet, atau sewa langsung dari sistem keuangan kamu.
Sistem sekolah dan kampus
Info absensi, nilai, dan pengumuman dikirim ke wali murid dari sistem akademik.
Aplikasi internal
Peringatan dari ERP, POS, atau sistem monitoring dikirim ke grup atau nomor tim.
Otomasi tanpa kode
Hubungkan dengan n8n atau tool otomasi lain lewat HTTP request.

Pertanyaan seputar WhatsApp API

Apakah WhatsApp API OneGate memakai WhatsApp Business API resmi dari Meta?

Saat ini belum. OneGate menghubungkan nomor WhatsApp kamu lewat fitur perangkat tertaut (multi-device), sama seperti WhatsApp Web, sehingga nomor yang sudah ada bisa langsung dipakai dengan scan QR. Jalur resmi WhatsApp Business Platform dari Meta sedang dalam proses pengajuan dan akan tersedia sebagai paket terpisah.

Bahasa pemrograman apa yang bisa dipakai?

Semua bahasa yang bisa mengirim HTTP request, termasuk PHP, Laravel, Node.js, Go, Python, dan Java. Dokumentasi di dashboard menyertakan contoh cURL, PHP, JavaScript, dan Python.

Bagaimana cara menerima balasan dari pelanggan?

Isi URL webhook di pengaturan device. Setiap pesan masuk dan perubahan status diteruskan ke server kamu lewat POST JSON, dengan pengulangan hingga 3 kali bila server kamu error.

Apakah bisa mengirim ke nomor luar negeri?

Bisa. Tulis nomor tujuan lengkap dengan kode negara. Nomor yang dihubungkan ke OneGate juga boleh nomor dari negara mana pun.

Apa bedanya API key device dan API key grup?

API key device selalu mengirim dari satu nomor tertentu. API key grup menggilir pengirim di antara beberapa nomor yang sedang online, dan melewati nomor yang terputus.

Apakah ada batas jumlah request?

Setiap API key punya batas request per menit untuk melindungi nomor kamu. Request yang melewati batas mendapat respons HTTP 429 dan bisa dicoba lagi sesaat kemudian.

Fitur OneGate lainnya

Lihat semua fitur OneGate

Kirim pesan WhatsApp pertama dari sistem kamu hari ini

Daftar sendiri dalam 2 menit, atau tanya dulu ke tim OneGate soal integrasi dengan sistem kamu.

Daftar sekarangKonsultasi via WhatsApp