Cara Kirim WhatsApp dari PHP dengan REST API Kirimore

Endpoint pesan teks

Untuk pesan teks, REST API v2 Kirimore menggunakan endpoint /apiv2/send-message.php. Payload utama terdiri dari api_key, sender, number, dan message. API memverifikasi akses REST API akun dan memastikan sender yang dipakai memang milik akun tersebut.

Contoh request JSON dengan PHP cURL

Contoh berikut dapat ditempatkan pada service atau helper backend Anda.

<?php
$payload = [
    'api_key' => getenv('KIRIMORE_API_KEY'),
    'sender'   => '971017',
    'number'   => '081234567890',
    'message'  => 'Halo, pembayaran Anda sudah kami terima.'
];

$ch = curl_init('https://kirimore.com/apiv2/send-message.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT => 30,
]);

$raw = curl_exec($ch);
$curlError = curl_error($ch);
curl_close($ch);

if ($curlError) {
    throw new RuntimeException($curlError);
}

$result = json_decode($raw, true);
if (!is_array($result) || empty($result['status'])) {
    // Tangani kegagalan sesuai workflow aplikasi Anda.
}

Format nomor tujuan

Endpoint Kirimore menormalkan nomor private. Nomor yang diawali 0 dapat dikonversi ke format 62, dan nomor internasional Indonesia dapat dikirim sebagai 628xxxxxxxxxx. Untuk integrasi yang konsisten, lebih baik simpan nomor pelanggan dalam format internasional sejak awal.

Endpoint juga mengenali target grup dengan ID yang berakhiran @g.us. Namun gunakan pengiriman grup hanya jika workflow Anda memang membutuhkannya dan device memiliki akses ke grup tersebut.

Response yang perlu Anda periksa

Jangan hanya menganggap HTTP request sukses berarti pesan sudah sesuai harapan. Periksa:

• Field status dari response JSON.
• Pesan error seperti API key salah, akses REST API tidak aktif, sender bukan milik akun, atau format target tidak valid.
• Riwayat pesan API di dashboard untuk audit setelah pengiriman.
• Log aplikasi Anda sendiri agar event bisnis dapat ditelusuri kembali.

Jangan expose API key di frontend

Request REST API harus dilakukan dari server. Jangan memanggil endpoint Kirimore langsung dari JavaScript browser menggunakan API key asli, karena kredensial dapat terlihat melalui Developer Tools atau source aplikasi.

Pola penggunaan yang disarankan

Bungkus fungsi kirim WhatsApp dalam satu service, misalnya WhatsAppNotifier. Dengan begitu order, deposit, tiket, dan fitur lain cukup memanggil service yang sama. Jika suatu hari sender atau gateway berubah, Anda hanya perlu memperbarui satu lokasi kode.