Gerbang API WhatsApp

SMKN 1 Mas Ubud · mandiri, tanpa penyedia pihak ketiga

API pengiriman pesan WhatsApp milik sekolah sendiri, bentuknya sama seperti Whacenter / Wablas — bedanya perangkat sudah tertaut di server sekolah, jadi tidak ada biaya per pesan dan tidak ada data yang keluar ke pihak lain. Mesin di belakangnya jembatan Baileys Hermes (127.0.0.1:3000).

Setiap permintaan wajib membawa dua kredensial: device_id + api_key. Keduanya sederajat kata sandi. Jangan ditulis di repo publik atau dikirim lewat chat umum.

Perangkat terdaftar

NamaNomordevice_idapi_keyJembatanStatus
SMKN 1 Mas Ubud—d79aab…818c64_3i_…Ziu_http://127.0.0.1:3000aktif
Nomor Notifikasi (belum tertaut)6281112223333dec0b…8e40XqKYV4…DbBGhttp://127.0.0.1:3001aktif

Kredensial perangkat pertama — device_id: d79aab…818c · api_key: 64_3…Ziu_ — disamarkan; kredensial penuh hanya tampil bila halaman dibuka dari dalam server

Endpoint

MetodeJalurFungsi
POST/api/sendKirim pesan text. Field: device_id, api_key, number, message
GET/api/statusDeviceStatus perangkat terhubung
POST/api/setWebhookSimpan URL webhook (field url)
GET/api/getWebhookBaca URL webhook
GET/api/logsRiwayat kirim (batas=50)
GET/healthHealth check (tanpa kredensial)

Kredensial boleh di body (form-urlencoded seperti contoh Whacenter, atau JSON) maupun lewat header X-Device-Id + X-API-Key (atau Authorization: Bearer <api_key>). Nomor boleh 08xx, +62xx, 628xx. Tambahkan ?uji=1 pada /api/send untuk menguji tanpa mengirim sungguhan.

Unduh koleksi Postman

Contoh PHP (curl)

<?php
$url = 'https://wa.matan.ai.id/api/send';
$data = array(
    'device_id' => 'd79aab…818c',
    'api_key'   => '64_3…Ziu_',
    'number'    => '085640206067',
    'message'   => 'halo bos',
);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);

Contoh curl

curl -X POST https://wa.matan.ai.id/api/send \
  -H 'X-Device-Id: d79aab…818c' -H 'X-API-Key: 64_3…Ziu_' \
  -d number=085640206067 -d message='halo bos'

Contoh Python

import requests
r = requests.post("https://wa.matan.ai.id/api/send", data={
    "device_id": "d79aab…818c", "api_key": "64_3…Ziu_",
    "number": "085640206067", "message": "halo bos",
})
print(r.json())

Nomor lain / perangkat tambahan

Satu perangkat = satu nomor WhatsApp tertaut = satu jembatan Baileys di port sendiri. Untuk mengirim dari nomor kedua (mis. nomor khusus notifikasi), tautkan sesi baru lalu daftarkan: python3 wa_gateway.py --tambah-perangkat "Nama" 628xxx --bridge-url http://127.0.0.1:3001. Perintah itu mencetak device_id + api_key baru untuk nomor tersebut.

Catatan jujur

Gerbang ini memakai jembatan Baileys (WhatsApp Web, bukan API resmi Meta). Kirim pesan sehari-hari aman, tapi hindari blast ribuan nomor beruntun — pola seperti itu yang memicu pembatasan akun. QR penautan perangkat tidak lewat halaman ini; pairing dilakukan di terminal server dengan hermes whatsapp.