Skip to main content

​
Pengenalan

Event device.connected dipicu ketika perangkat atau channel komunikasi menjadi terhubung dan tersedia untuk digunakan.
Gunakan event ini untuk memonitor uptime dan ketersediaan channel.

​
Trigger Event

Perangkat terhubung
       ↓
   Platform CSKU AI
       ↓
   Trigger webhook device.connected
       ↓
   HTTP POST → URL Webhook Anda

​
Struktur Payload

{
  "event": "device.connected",
  "timestamp": 1738056000,
  "device": {
    "id": "device_abc123",
    "name": "WhatsApp Business Device",
    "channel": {
      "id": "channel_merchant_id",
      "name": "WhatsApp Business",
      "engine": "wa"
    },
    "bisnis": {
      "id": "biz_123",
      "name": "My Business"
    },
    "user": {
      "id": "merchant_456",
      "name": "Merchant Name"
    }
  },
  "status": "connected"
}

​
Deskripsi Field

FieldTipeDeskripsi
eventstringIdentifier event: device.connected
timestampintegerUnix timestamp saat event terjadi
device.idstringIdentifier perangkat unik
device.namestringNama tampilan perangkat
device.channel.idstringIdentifier channel
device.channel.namestringNama channel
device.channel.enginestringTipe engine channel
device.bisnis.idstringID Bisnis
device.bisnis.namestringNama bisnis
device.user.idstringID user merchant
device.user.namestringNama merchant
statusstringStatus perangkat: connected

​
Use Case

Lacak ketersediaan channel dan downtime.
Notifikasi tim ketika perangkat kembali online setelah offline.
Monitor channel mana yang tersedia untuk menangani pesan pelanggan.
Jadwalkan maintenance saat waktu sepi berdasarkan pola koneksi.

​
Implementasi

app.post('/webhook', async (req, res) => {
  const { event, device } = req.body;
  
  if (event === 'device.connected') {
    console.log(`Perangkat ${device.name} sekarang terhubung`);
    
    // Update status perangkat
    await db.devices.update(device.id, {
      status: 'connected',
      last_connected: new Date(req.body.timestamp * 1000)
    });
    
    // Kirim notifikasi ke tim
    await notifyTeam(`Perangkat ${device.name} sudah online`);
  }
  
  res.status(200).send('OK');
});

​
Event Terkait

Device Disconnected

Perangkat menjadi offline