DRWhatsapp CRM

Metode GET atau POST (JSON). Alias param: e|email_enc, phone|to, text|message, account (opsional bila email tertaut >1 nomor).

Daftar endpoint

Semua memakai otentikasi yang sama (?e=<token>) dan otomatis dibatasi ke nomor yang tertaut ke email tersebut. Param account (id atau nomor) opsional untuk mempersempit ke satu nomor; wajib bila email tertaut ke >1 nomor pada endpoint kirim/QR.

Endpoint baca & QR TIDAK memakai API key dashboard — jadi aplikasi lain tak perlu diberi akses penuh ke server ini.

Contoh: notifikasi pesan masuk & tampilkan barcode

// 1) NOTIFIKASI REALTIME (SSE) — pesan masuk langsung sampai ke server Anda
const es = new EventSource(`https://wa.drwapp.com/api/stream?e=${token}`);
es.onmessage = (ev) => {
  const m = JSON.parse(ev.data);
  if (m.direction === 'in') simpanKeInboxAnda(m); // { phone, name, body, account_id, at }
};

// 2) ATAU POLLING (lebih tahan putus) — simpan last_id sebagai kursor
let lastId = bacaKursorTersimpan() || 0;
setInterval(async () => {
  const r = await fetch(`https://wa.drwapp.com/api/messages?e=${token}&since_id=${lastId}&direction=in`);
  const d = await r.json();
  for (const m of d.rows) simpanKeInboxAnda(m);
  lastId = d.last_id; simpanKursor(lastId);  // hanya yang BARU di panggilan berikutnya
}, 10000);

// 3) RIWAYAT SATU KONTAK (untuk halaman detail di aplikasi Anda)
const riwayat = await (await fetch(
  `https://wa.drwapp.com/api/messages?e=${token}&phone=628123456789&limit=100`)).json();

// 4) STATISTIK PER NOMOR (monitoring & evaluasi) — rumus sama dgn kartu Ringkasan
const st = await (await fetch(
  `https://wa.drwapp.com/api/stats?e=${token}&range=month&include=timeseries`)).json();
for (const a of st.accounts)  // + st.total = konsolidasi semua nomor
  console.log(a.phone, a.messages.outPeriod, 'terkirim,', a.messages.inPeriod, 'masuk,', a.rates.replyRate + '% membalas', a.leads);

// 5) TAMPILKAN BARCODE KONEKSI DI SERVER LAIN
async function tampilkanQR(account) {
  const d = await (await fetch(`https://wa.drwapp.com/api/qr?e=${token}&account=${account}`)).json();
  if (d.connected) return tampilkanStatus('Nomor sudah tersambung ✅');
  if (d.qr) document.querySelector('#qr').src = d.qr; // data URL PNG, langsung tampil
  setTimeout(() => tampilkanQR(account), 3000);       // QR berganti berkala
}

Token berumur pendek (). Untuk SSE/polling jangka panjang, generate ulang token di server Anda sebelum tiap koneksi/permintaan baru.

Uji cepat: generate token

Hanya untuk uji coba: buat token untuk email tertentu agar bisa mencoba endpoint tanpa menulis kode enkripsi. Di produksi, server lain membuat token sendiri dengan INTEGRATION_SECRET. Dibatasi ke super-admin karena siapa pun yang bisa membuat token bisa bertindak atas nama email tersebut.

Contoh: enkripsi email & kirim (Node.js)

import crypto from 'node:crypto';

const SECRET = process.env.INTEGRATION_SECRET; // SAMA dgn server WA
const key = crypto.createHash('sha256').update(SECRET).digest();

function encryptEmail(email) {
  const iv = crypto.randomBytes(12);
  const c = crypto.createCipheriv('aes-256-gcm', key, iv);
  const payload = Buffer.from(JSON.stringify({ e: email.toLowerCase(), t: Math.floor(Date.now()/1000) }));
  const ct = Buffer.concat([c.update(payload), c.final()]);
  return Buffer.concat([iv, c.getAuthTag(), ct]).toString('base64url');
}

const token = encryptEmail(req.session.user.email); // email user yg login SSO
const url = `https://wa.drwapp.com/api/send?e=${token}`
  + `&phone=628123456789&text=${encodeURIComponent('Halo, ini follow-up dari kami')}`;

const r = await fetch(url);
const data = await r.json();

if (r.ok) {
  console.log('terkirim:', data.wa_message_id); // { ok, from, to, wa_message_id }

} else if (r.status === 429) {
  // DITAHAN SEMENTARA (rate_menit | cooldown_kontak | daily_cap | warmup |
  // pesan_identik | jam_kerja). Jadwalkan ulang di antrean Anda — JANGAN
  // retry beruntun, itu justru menaikkan risiko nomor kena banned.
  const jeda = Number(r.headers.get('retry-after') || data.retryAfterSec || 60);
  console.warn(`ditahan (${data.rule}), coba lagi ${jeda} detik lagi`);
  await antrean.jadwalkanUlang({ phone, text, setelahDetik: jeda });

} else if (r.status === 409) {
  // DITOLAK PERMANEN. Mengulang dgn isi & tujuan yang sama akan ditolak lagi:
  //   kontak_dingin       -> nomor belum pernah chat; jangan hubungi duluan
  //   link_pesan_pertama  -> kirim perkenalan tanpa link dulu
  //   opt_out             -> kontak berhenti langganan; hormati, jangan kirim
  console.error(`ditolak (${data.rule}): ${data.error}`);
  await antrean.batalkan({ phone, alasan: data.rule });

} else {
  // 400 param kurang | 401 token salah/kadaluarsa | 403 email tak berizin
  // 503 integrasi nonaktif
  console.error(`gagal ${r.status}: ${data.error}`);
}

Contoh: PHP

<?php
$secret = getenv('INTEGRATION_SECRET');
$key = hash('sha256', $secret, true);
$iv = random_bytes(12);
$payload = json_encode(['e' => strtolower($email), 't' => time()]);
$tag = '';
$ct = openssl_encrypt($payload, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
$token = rtrim(strtr(base64_encode($iv.$tag.$ct), '+/', '-_'), '=');
$url = "https://wa.drwapp.com/api/send?e=$token&phone=628123456789&text=".urlencode('Halo');

// PENTING: tanpa ignore_errors, file_get_contents() mengembalikan false pada
// 4xx sehingga alasan penolakan (rule) tidak pernah terbaca.
$ctx  = stream_context_create(['http' => ['ignore_errors' => true, 'timeout' => 20]]);
$body = file_get_contents($url, false, $ctx);
$code = (int) substr($http_response_header[0], 9, 3);
$res  = json_decode($body, true);

if ($code === 200) {
  echo "terkirim: ".$res['wa_message_id'];

} elseif ($code === 429) {
  // Ditahan sementara -> jadwalkan ulang, jangan retry beruntun.
  $jeda = $res['retryAfterSec'] ?? 60;
  error_log("ditahan ({$res['rule']}), ulangi {$jeda} detik lagi");
  antrean_jadwalkan_ulang($phone, $text, $jeda);

} elseif ($code === 409) {
  // Ditolak permanen: kontak_dingin | link_pesan_pertama | opt_out.
  // Perbaiki dulu isi/tujuannya — mengulang sama saja akan ditolak lagi.
  error_log("ditolak ({$res['rule']}): {$res['error']}");
  antrean_batalkan($phone, $res['rule']);

} else {
  error_log("gagal {$code}: ".($res['error'] ?? $body));
}

Kode respons