Troubleshooting Webhook

Halaman ini berisi beberapa masalah umum saat menggunakan Webhook dan cara memeriksanya.

Menu Webhooks Tidak Muncul

Kemungkinan penyebab:

• Plugin Webhook belum aktif.
• Lisensi belum valid.
• User tidak memiliki akses admin.

Solusi:

1. 1
   Step 1: Cek plugin

   Pastikan plugin aktif di menu Plugins.

2. 2
   Step 2: Cek lisensi

   Periksa status lisensi.

3. 3
   Step 3: Login admin

   Login sebagai administrator.

Webhook Tidak Terkirim

Periksa beberapa hal berikut:

• Field Active sudah dicentang.
• Endpoint URL sudah diisi.
• Endpoint menggunakan https://.
• Event yang dipilih sesuai dengan aktivitas yang terjadi.
• Payload template valid JSON.
• Endpoint tujuan dapat diakses dari server WordPress.

Jika endpoint tidak menggunakan HTTPS, webhook akan dilewati dan dicatat sebagai skipped.

Payload Tidak Sesuai

Jika payload tidak sesuai atau endpoint menerima format yang salah:

• Pastikan {{payload}} tidak dibungkus tanda kutip.
• Pastikan variable string seperti {{event}} dibungkus tanda kutip.
• Validasi JSON template sebelum disimpan.
• Cek payload aktual di halaman log.

Contoh benar:

{
  "event": "{{event}}",
  "data": {{payload}}
}

Contoh yang berpotensi salah:

{
  "event": "{{event}}",
  "data": "{{payload}}"
}

Endpoint Menerima Request Tapi Status Failed

Webhook menentukan status berdasarkan response dari endpoint tujuan.

Pastikan endpoint tujuan mengembalikan response 2xx jika payload berhasil diterima.

Contoh response sukses:

{
  "success": true
}

Jika endpoint mengembalikan 400, 401, 403, atau 404, webhook akan menganggap request gagal dan umumnya tidak melakukan retry.

Terjadi Duplicate Data di Sistem Tujuan

Duplicate dapat terjadi jika payload dikirim ulang atau request retry diproses lebih dari sekali oleh endpoint tujuan.

Solusi:

• Gunakan idempotency key di sistem tujuan.
• Cek object_id, order ID, atau invoice ID sebelum membuat data baru.
• Jika data sudah ada, return response sukses tanpa membuat duplikat.

Feed Endpoint Mengembalikan 401

Kemungkinan penyebab:

• Header Authorization tidak dikirim.
• Format API key salah.
• API key sudah tidak valid.

Gunakan format:

Authorization: Bearer sejoliapi_<prefix>_<secret>

Feed Endpoint Mengembalikan 403

Kemungkinan penyebab:

• API key valid, tetapi tidak memiliki scope yang dibutuhkan.

Pastikan API key memiliki scope:

orders:read

Log Terlalu Banyak

Jika log terlalu banyak, gunakan tombol clear log dari halaman log dengan hati-hati.