Panduan Integrasi API & OtomaX

Petunjuk lengkap menghubungkan link berlangganan ke software server pulsa OtomaX, Winku, atau aplikasi pihak ketiga.

1

Pemasangan di Modul SMS Sender OtomaX / Winku

Pada software server pulsa, buka menu Modul → Web SMS Sender (atau klik kanan pada daftar modul → Tambah Modul SMS). Isi kolom-kolom berikut sesuai panduan:

Web URL / Parsing

Ganti contoh_api_key_anda dengan API Key pelanggan yang bersangkutan.

RegEx Sukses

Sistem kami selalu menyertakan kode 200, OK, dan Success pada respon JSON jika pengiriman berhasil.

RegEx Pesan

Dapat diisi .* untuk menerima semua format pesan SMS balasan transaksi.

Pengaturan Limit & Auto-Off
• Auto-Off di Server VPS: Otomatis nonaktif begitu limit tercapai.
• Auto-Off di OtomaX: Anda juga dapat mengisi kolom Counter / Limit di OtomaX untuk proteksi ganda.
2

Spesifikasi Endpoint API (HTTP GET / POST)

GET / POST https://sms.winku.online//api/send.php
Parameter Tipe Wajib Keterangan
key string Ya API Key langganan pelanggan (juga menerima alias api_key)
to string Ya Nomor tujuan SMS (contoh: 0895325900709, alias: tujuan, destination)
text string Ya Isi pesan SMS (alias: pesan, message)
Contoh cURL CLI:
curl -X GET "https://sms.winku.online//api/send.php?key=contoh_api_key_anda&to=0895325900709&text=Tes+SMS+Gateway"

Respon Sukses (HTTP 200)

{
  "status": "success",
  "code": 200,
  "message": "OK - SMS berhasil diteruskan ke Gateway HP",
  "result": "Success",
  "to": "0895325900709",
  "customer": "Mitra Server Pulsa A",
  "used_sms": 45,
  "limit_sms": 500,
  "sisa_kuota": 455,
  "auto_off": "Aktif"
}

Respon Kuota Habis (HTTP 403 / Auto OFF)

{
  "status": "error",
  "code": 403,
  "message": "Kuota SMS telah habis! Akun otomatis dinonaktifkan (Auto-OFF). Silakan hubungi admin.",
  "customer": "Mitra Server Pulsa A",
  "used_sms": 500,
  "limit_sms": 500,
  "sisa_kuota": 0
}