# Semak log webhook

> Lihat setiap webhook yang dihantar oleh borang derma ke sistem luar, semak statusnya, dan hantar semula webhook yang gagal.
>
> Source: https://docs.berisalam.com/webhook-logs/

Webhook menghantar butiran transaksi baru daripada borang derma ke sistem luar anda, contohnya sistem akaun atau CRM. **Webhook Logs** menyimpan rekod setiap webhook yang dihantar. Gunakan log ini untuk menyemak sama ada sistem anda menerima data itu.

Beri Salam hanya menghantar webhook untuk borang yang mempunyai URL webhook. Anda menetapkan URL itu dalam borang derma: **Donations** → **Forms** → **Edit** → **Additional Settings** → **Webhook »**.

## Bagaimana webhook dihantar

Panel **Webhook** pada borang derma menerangkan peraturan ini:

- Butiran transaksi baru dihantar ke URL yang anda tetapkan.
- Sistem anda mesti membalas dengan kod `200` selepas menerima data.
- Permintaan tamat masa selepas 30 saat.
- Jika cubaan pertama gagal, Beri Salam akan menghantar semula webhook itu secara automatik.

## Semak log webhook

Ikut langkah ini dalam Beri Salam console.

1. Klik **Tools**.
2. Klik **Webhook Logs**. Senarai webhook dipaparkan.
3. Jika perlu, pilih **Created Date Range** atau **Module**, kemudian klik **Filter**.
4. Klik **View** untuk melihat butiran webhook itu.
5. Klik **« Back to Webhook Logs** untuk kembali ke senarai.

Senarai **Webhook Logs** mempunyai lajur berikut:

| Lajur | Keterangan |
|---|---|
| **Created** | Tarikh dan masa webhook dihantar. |
| **Module** | Sumber webhook. **Donations** untuk transaksi borang derma. **Webhook_Test** untuk ujian daripada butang **Test Webhook**. |
| **URL** | Alamat yang menerima webhook. |
| **Attempts** | Bilangan cubaan menghantar webhook. |
| **Status Code** | Kod respons daripada sistem anda. `200` bermaksud berjaya. Kod lain, contohnya `404`, bermaksud gagal. |

Page **Webhook Details** menunjukkan **Created Date**, **Last Updated**, **Module**, **URL**, **Status Code** dan **Attempts**, serta data yang dihantar dalam **Request Header:** dan **Request Data:**.

## Hantar semula webhook

Selepas anda membaiki sistem penerima, ikut langkah ini untuk menghantar semula webhook yang gagal.

1. Klik **Tools** → **Webhook Logs**.
2. Cari rekod yang gagal.
3. Klik **Resend** pada rekod itu. Anda juga boleh klik **View**, kemudian **Resend Request**.
4. Semak lajur **Status Code** semula selepas beberapa minit.

Rekod **Webhook_Test** tidak mempunyai butang **Resend**.

> **Caution**
> Butang **Delete** memadam rekod log itu. Rekod yang dipadam tidak boleh dihantar semula.

## Tips

- **Uji URL dahulu.** Klik **Test Webhook** dalam panel **Webhook** pada borang, kemudian semak rekod **Webhook_Test** dalam log.
- **Pastikan sistem anda membalas dengan cepat.** Permintaan yang mengambil masa lebih daripada 30 saat dikira gagal.

## Isu biasa

### Adakah Beri Salam akan cuba menghantar semula webhook yang gagal?

Ya. Jika cubaan pertama gagal, Beri Salam akan menghantar semula webhook itu secara automatik. Lajur Attempts dalam Webhook Logs menunjukkan bilangan cubaan.

### Bagaimana saya menghantar semula webhook yang gagal selepas sistem saya dibaiki?

Dalam Webhook Logs, klik Resend pada rekod itu. Beri Salam akan menghantar data transaksi itu sekali lagi.