---
title: "Kirim data ke sistem Anda dengan webhook"
description: "Terima permintaan di URL Anda sendiri saat seseorang mendaftar, berpartisipasi, atau menang, lengkap dengan payload bertanda tangan, basic auth, payload kustom, dan log setiap pengiriman."
url: https://scratcher.io/id/help/developers/webhooks
language: id
---

1. [Pusat bantuan](https://scratcher.io/id/help)
2. [API, webhook, dan MCP](https://scratcher.io/id/help/developers)
3. Kirim data ke sistem Anda dengan webhook

# Kirim data ke sistem Anda dengan webhook

Terima permintaan di URL Anda sendiri saat seseorang mendaftar, berpartisipasi, atau menang, lengkap dengan payload bertanda tangan, basic auth, payload kustom, dan log setiap pengiriman.

Webhook mengirimkan data ke URL pilihan Anda tepat saat sesuatu terjadi, misalnya saat seseorang berpartisipasi dalam kampanye atau memenangkan hadiah. Developer Anda yang menyiapkan sistem penerimanya.

Webhook tersedia di paket yang mencakup **Webhooks & API** (Basic ke atas).

## Webhook kampanye atau webhook akun?

- **Webhook kampanye** diatur di editor kampanye dan hanya aktif untuk kampanye tersebut. Webhook ini memiliki event “Every time a lead participates in a campaign” dan “When a lead wins a prize”, serta opsi paling lengkap.
- **Webhook akun** diatur di **Settings** > **Webhooks**. Webhook ini memiliki event “When a new lead is created”: event ini aktif satu kali per orang, yaitu saat pertama kali orang tersebut ditambahkan ke lead Anda, dari kampanye mana pun asalnya.

## Menambahkan webhook ke kampanye

1. Buka kampanye di editor, lalu masuk ke **Connect** > **Webhooks**.
2. Klik **Add webhook**.
3. Masukkan **Payload URL**. URL harus diawali https: “We only support webhooks over HTTPS to ensure that the data sent remains secure.”
4. Pilih **Content type**: **application/json** atau **application/x-www-form-urlencoded**.
5. Pilih **Method**. Formulir diawali dengan **GET**, yang mengirim data di URL. Pilih **POST** untuk mengirimnya di body, yang umumnya diharapkan oleh kebanyakan sistem.
6. Di bagian **Authentication** (hanya untuk POST), pilih **Basic Auth** jika URL Anda memerlukan nama pengguna dan kata sandi, lalu isi **Username** dan **Password**. Jika tidak, biarkan **None**.
7. Masukkan **Secret** untuk menandatangani permintaan (disarankan). Lihat “Memeriksa tanda tangan” di bawah.
8. Aktifkan **Log response body** jika Anda ingin melihat respons dari sistem Anda. “Enable to store the response body for debugging.”
9. Biarkan **Active** tetap aktif. “We will only deliver events if the webhook is active.”
10. Pilih event: “Every time a lead participates in a campaign” atau “When a lead wins a prize”.
11. Aktifkan **Custom payload** jika Anda ingin menentukan field sendiri (lihat di bawah).
12. Klik **Add webhook**. Anda akan melihat “Webhook added”.

Panel **Webhooks** menampilkan daftar webhook kampanye dengan status **Active** atau **Inactive**, serta **Last delivery failed** jika permintaan terakhir gagal. Gunakan **Actions** untuk **Edit**, **See deliveries**, atau **Delete** webhook. Saat mengedit webhook, kosongkan **Secret** untuk mempertahankan secret yang sudah ada.

## Menambahkan webhook akun

1. Buka **Settings** > **Webhooks** (di bawah **Developers**). Webhook Anda tercantum di **My webhooks** (atau di bawah nama setiap daftar lead, jika Anda memiliki beberapa).
2. Klik kartu bertanda plus untuk menambahkan webhook. Dialog **Add webhook** menampilkan “Send a request to an external URL whenever selected events happen.”
3. Isi **Payload URL**, **Content type** (“Select content type of the webhook”), **Method**, dan **Secret** seperti di atas.
4. Di bagian **Which events should trigger the webhook?**, pilih “When a new lead is created”.
5. Centang “Yes, allow me to specify a customized payload (Advanced users only)” jika Anda ingin menggunakan field sendiri.
6. Centang **Log response body** (“This webhook will log the response body”) jika perlu, dan biarkan **Active** tetap tercentang (“We will deliver event details when this hook is triggered”).
7. Klik **Add webhook**.

Klik webhook untuk mengubahnya (**Simpan perubahan**), menetapkan **New secret**, membuka **Show deliveries**, atau **Delete webhook** (“This action cannot be reverted!”).

## Data yang dikirim

Secara default, body berisi `event` (nama event: `lead_created_on_campaign`, `new_campaign_winner`, atau `lead_created`) dan objek `data`:

- `campaign`: `id` dan `name` kampanye (webhook kampanye)
- `lead`: field formulir lead berdasarkan kunci field-nya (misalnya `first_name`), ditambah `id`, `phone_number`, dan `created_at`
- `lead.permissions`: untuk setiap kotak centang persetujuan, apakah disetujui, teksnya, tanggalnya, dan alamat IP-nya (webhook kampanye)
- `participant`: `channel` asal orang tersebut dan waktu ia berpartisipasi (webhook kampanye)
- `quiz`: jawaban atas pertanyaan kuis yang diberi nama, juga dengan nama yang mudah dibaca dan diawali “Simple”
- `prize`: `id`, `name`, `value`, `coupon_code` hadiah, serta waktu hadiah dimenangkan (webhook pemenang)

Nilai kosong tidak disertakan, begitu pula persetujuan yang tidak diterima. Dengan metode GET, data yang sama dikirim sebagai parameter kueri di URL.

## Payload kustom

Jika **Custom payload** aktif, hanya field yang Anda pilih yang dikirim, dan tidak ada pembungkus `event`.

1. Di bagian **Data mapping**, klik **Add mapping**.
2. Ketik **Field name** yang diharapkan sistem Anda. Gunakan huruf, angka, tanda hubung, dan garis bawah.
3. Pilih field Scratcher yang akan dikirim (“Group → Field”), atau **Custom value** lalu ketik **Value** tetap.
4. Ulangi untuk setiap field. Hapus field dengan ikon tempat sampah (**Remove** atau **Remove data mapping**).

## Memeriksa tanda tangan

Jika Anda menetapkan secret, setiap permintaan memiliki header `X-Hub-Signature`: `sha1=` diikuti hash HMAC-SHA1 dari payload berenkode JSON (body seperti dijelaskan di atas), dengan secret Anda sebagai kuncinya. Hitung hal yang sama di sisi Anda lalu bandingkan untuk memastikan permintaan benar-benar berasal dari Scratcher.

## Pengiriman dan percobaan ulang

- Jika URL Anda tidak merespons atau mengembalikan error (status 400 atau lebih tinggi), Scratcher akan mencoba lagi dua kali: setelah 5 detik dan setelah satu menit.
- Pengalihan (redirect) tidak diikuti, jadi gunakan URL akhir.
- Buka daftar pengiriman (**See deliveries** di kampanye, **Show deliveries** untuk webhook akun) untuk melihat setiap permintaan dan respons. Setiap pengiriman menampilkan **ID**, **Request**, dan **Response** beserta kode statusnya (serta **Response body** jika Anda mencatatnya). Gunakan **copy** untuk menyalin payload.
- Aktifkan **Show only failed deliveries** untuk melihat masalahnya saja. Bagian atas menampilkan “Failed deliveries in the last 60 days”.
- Klik **Retry** untuk mengirim ulang pengiriman: “The webhook is being resent.”
- “Webhook delivery logs are retained for 60 days.”

## Pemecahan masalah

- “The ... field must use HTTPS.”: **Payload URL** diawali http. Gunakan https.
- Semua pengiriman gagal tanpa respons: URL tidak dapat dijangkau dari internet, misalnya alamat lokal atau internal. Gunakan URL publik.
- Sistem Anda tidak menerima data: metodenya **GET**, sehingga data ada di URL. Ganti ke **POST**.
- Field yang diharapkan sistem Anda tidak ada: field tersebut kosong, atau persetujuannya tidak diterima. Atur sistem Anda agar memperlakukan field yang tidak ada sebagai kosong.

API, webhook, dan MCP

- [Mulai menggunakan REST API](https://scratcher.io/id/help/developers/rest-api)
- [Kirim data ke sistem Anda dengan webhook](https://scratcher.io/id/help/developers/webhooks)
- [Scratcher MCP untuk alat AI Anda sendiri](https://scratcher.io/id/help/developers/mcp)

Terus belajar

## Artikel terkait

- [Mulai menggunakan REST API](https://scratcher.io/id/help/developers/rest-api): Buat token akses pribadi dengan scope yang tepat, atau daftarkan aplikasi OAuth, lalu baca kampanye, lead, dan daftar dari sistem Anda sendiri.
- [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status): Lihat lead mana saja yang telah dikirim ke alat Anda, pahami pesan kesalahannya, perbaiki masalahnya, lalu kirim ulang.
- [Hubungkan 8.000+ aplikasi dengan Zapier](https://scratcher.io/id/help/integrations/zapier): Kirim pendaftar baru dari Scratcher ke Google Sheets, Slack, CRM Anda, atau ribuan aplikasi lainnya dengan Zapier.

Butuh bantuan?

## Masih butuh bantuan?

Tim kami siap membantu. Jika Anda sudah menggunakan Scratcher, cara tercepat adalah lewat chat di dalam platform.

- **[Chat dengan kami](https://platform.scratcher.io/id/login)**

    Masuk dan klik tombol chat di pojok kanan bawah. Rex langsung menjawab, dan tim kami hanya sejauh satu klik.
- **[Jadwalkan pertemuan](https://scratcher.io/id/book-a-meeting)**

    Panggilan video gratis 30 menit dengan tim kami: tur produk, ide kampanye, atau bantuan penyiapan.
- **[Kirim email](mailto:contact@scratcher.io)**

    Kirim email ke contact@scratcher.io dan kami akan segera membalas.
