Integrasi & API

Isi Data Webhook dan Cara Memperbaiki Masalahnya

Header dan contoh isi data yang dikirim Jalinara ke penerima webhook, plus cara memeriksa webhook yang tidak sampai atau gagal.

Webhook adalah kiriman otomatis dari Jalinara ke alamat aplikasi Anda saat ada kejadian, misalnya pesan masuk. Halaman ini untuk tim teknis yang membuat penerimanya: apa yang dikirim, dan apa yang diperiksa bila datanya tidak sampai.

Cara mengisi alamat penerima ada di Cara Memasang Webhook Perangkat dan Cara Mengirim Webhook dari Automasi.

Header yang dikirim Jalinara

Contoh isi data pesan masuk

Nilai di bawah ini fiktif.

{
  "device": "dev_xxx",
  "sender": "6280000000110",
  "pushName": "Pelanggan Uji (contoh)",
  "message": "Halo, mau tanya",
  "type": "text",
  "isGroup": false,
  "media_url": null,
  "timestamp": 1718700000
}

• Data asli juga membawa kolom event: message.incoming untuk pesan masuk dan device.disconnected saat perangkat terputus.
• Kabar status pesan memakai "type": "status".
• Untuk media, media_url berisi tautan file. Pada pesan teks isinya null.

Contoh ini bukan susunan lengkap. Catat contoh data asli yang tiba di penerima Anda, termasuk dari aksi Automasi, dan jadikan itu acuan. Jangan menebak susunannya.

Cara memeriksa webhook perangkat yang tidak sampai

Kegagalan webhook perangkat tidak tercatat di dashboard Jalinara.

1. Lihat log di aplikasi penerima.

2. Minta tim teknis memanggil POST /api/gateway/webhook/test dengan API Token (TOKEN_ANDA).

3. Bila uji gagal, buka Perangkat & API › Perangkat, klik ikon Edit pada baris perangkat, lalu periksa URL Webhook (opsional). Cocokkan gejalanya dengan tabel di bawah.

Cara memeriksa aksi Kirim webhook (POST) yang gagal

Berbeda dengan webhook perangkat, aksi ini mencatat hasilnya di Riwayat eksekusi.

1. Di sidebar, buka Balas Otomatis › Automasi.

2. Klik ikon Riwayat eksekusi pada baris alur.

   Perbesar

3. Cari baris Kirim webhook (POST) berstatus ① Gagal, lalu baca alasannya di ② Detail.

   Jalinara mencoba ulang hingga 3 kali sebelum mencatat Gagal, jadi satu kiriman bisa sampai ke penerima lebih dari sekali.

4. Cocokkan Detail dengan tabel di bawah.

5. Klik ikon Edit pada baris alur, perbaiki URL webhook, lalu klik Simpan.

Masalah yang paling sering