Mobile or Access API Documentation

Route auth private channel web: /broadcasting/auth (middleware: web) untuk browser session + CSRF token. Untuk mobile gunakan: /api/mobile/v1/broadcasting/auth (middleware: auth:sanctum) dengan header Authorization: Bearer <token>.

window.Echo.private(`wa.chat.${contactId}`)
  .listen('.NewMessage', (payload) => console.log('NewMessage', payload))
  .listen('.NewComment', (payload) => console.log('NewComment', payload))
  .listen('.ConversationAccountUpdated', (payload) => console.log('ConversationAccountUpdated', payload));

window.Echo.private(`wa.contacts.${clientId}`)
  .listen('.ContactStateUpdated', (payload) => console.log('ContactStateUpdated', payload))
  .listen('.ContactPreviewUpdated', (payload) => console.log('ContactPreviewUpdated', payload));

Kedua API Webchat ini bukan bagian dari /api/mobile/v1 dan tidak memakai Bearer token, jadi tidak muncul di tester "Test Endpoint" di bawah — dokumentasi di section ini murni referensi (contoh cURL/JS manual). Public Widget API tidak butuh autentikasi sama sekali (dibatasi lewat token widget + rate limit); Agent Inbox API butuh sesi login browser (cookie), bukan token yang bisa dipakai dari luar browser/Postman tanpa sesi tersebut.

TOKEN=nscs6iwivknjno4dsvouekhx3yyh32m9

# 1. Cek apakah email ini sudah punya history (menentukan perlu OTP atau tidak)
curl -X POST "https://apps.rndsolusi.com/api/webchat/$TOKEN/check-history" \
  -H "Content-Type: application/json" \
  --data '{"email":"budi@example.com","phone":"081234567890"}'
# -> {"success":true,"has_history":false}

# 2. Jika has_history=true, minta kode OTP dulu
curl -X POST "https://apps.rndsolusi.com/api/webchat/$TOKEN/otp/request" \
  -H "Content-Type: application/json" \
  --data '{"email":"budi@example.com","website":""}'
# -> {"success":true}

# 3. Verifikasi kode yang diterima lewat email
curl -X POST "https://apps.rndsolusi.com/api/webchat/$TOKEN/otp/verify" \
  -H "Content-Type: application/json" \
  --data '{"email":"budi@example.com","code":"123456"}'
# -> {"success":true}

# 4. Mulai sesi chat (name/email/phone; website = honeypot, kosongkan)
curl -X POST "https://apps.rndsolusi.com/api/webchat/$TOKEN/start" \
  -H "Content-Type: application/json" \
  --data '{"name":"Budi Santoso","email":"budi@example.com","phone":"081234567890","website":""}'
# -> {"success":true,"visitor_token":"...","conversation_id":123,"visitor_name":"Budi Santoso"}

# 5. Simpan visitor_token, lalu pakai untuk polling/kirim pesan
VISITOR_TOKEN="...dari langkah 4..."
curl "https://apps.rndsolusi.com/api/webchat/$TOKEN/messages" \
  -H "X-Visitor-Token: $VISITOR_TOKEN"

curl -X POST "https://apps.rndsolusi.com/api/webchat/$TOKEN/messages" \
  -H "Content-Type: application/json" \
  -H "X-Visitor-Token: $VISITOR_TOKEN" \
  --data '{"content":"Halo, saya butuh bantuan"}'

Endpoint ini dipanggil oleh SPA Webchat Beta (/webchat-beta) memakai sesi cookie hasil login web biasa (role admin/manager/agent), bukan Bearer token — tidak bisa dites langsung dari cURL/Postman tanpa membawa cookie sesi tersebut. Semua endpoint menerima query client_id (hanya efektif untuk role admin memilih client lain; manager/agent selalu terikat ke client mereka sendiri).

// Kirim balasan teks ke contact tertentu
fetch('/webchat-beta/api/contacts/123/send', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-Requested-With': 'XMLHttpRequest' },
  credentials: 'same-origin',
  body: JSON.stringify({ client_id: 3, content: 'Halo, ada yang bisa dibantu?' })
});

// Tutup percakapan dengan kategori + ringkasan
fetch('/webchat-beta/api/contacts/123/close', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-Requested-With': 'XMLHttpRequest' },
  credentials: 'same-origin',
  body: JSON.stringify({ client_id: 3, category_id: 1, sub_category_id: 2, summary: 'Sudah selesai dibantu' })
});

window.Echo.private(`webchat.chat.${contactId}`)
  .listen('.NewMessage', (payload) => console.log('NewMessage', payload.message));

const pusher = new Pusher(REVERB_APP_KEY, {
  wsHost: REVERB_HOST, wsPort: REVERB_PORT, wssPort: REVERB_PORT,
  forceTLS: true, enabledTransports: ['ws', 'wss'], disableStats: true,
});

pusher.subscribe(`webchat.widget.${visitorToken}`)
  .bind('NewMessage', (data) => console.log('NewMessage', data.message));