# Kirim peristiwa ke sistem Anda dengan webhook

> Webhook memberi tahu sistem Anda sendiri saat sesuatu terjadi di toko, seperti pesanan baru atau perubahan stok. Tambahkan URL endpoint di Pengaturan > Webhook, pilih peristiwanya, kirim tes, dan lihat setiap pengiriman beserta responsnya.

Pusat Bantuan / Integrasi - Diperbarui 2 November 2026

Webhook mengirim pesan ke alamat web pilihan Anda, saat sesuatu terjadi di toko. Misalnya, pesanan baru bisa langsung sampai ke sistem pemenuhan pesanan, perubahan stok ke lembar inventaris, atau pelanggan baru ke CRM. Sistem Anda tidak perlu terus-menerus menanyakan perubahan ke Shoprocket.

Anda butuh tempat tujuan untuk pesan-pesan itu: alamat di server Anda sendiri, atau alat yang menyediakannya, seperti platform otomatisasi. Menyiapkan sisi penerima biasanya pekerjaan developer.

## Sebelum memulai

- Webhook tersedia mulai paket **Growth**. Di paket yang lebih rendah, layar menunjukkan paket yang mencakupnya.
- Webhook adalah bagian dari aplikasi **Alat developer**, bersama **Kunci API**. Jika Anda tidak melihat **Webhook** di bawah **Pengaturan** di sidebar, buka **Aplikasi**, cari **Alat developer** di bawah **Developer** lalu klik **Tambah**. Lihat [Tambah dan hapus aplikasi](https://shoprocket.io/id/bantuan/halaman-aplikasi.md).

## Tambah endpoint

1. Di dasbor, buka **Pengaturan > Webhook** dan klik **Tambah endpoint**.
2. Isi **Nama**. Namai sesuai sistem tujuannya, agar Anda tahu apa yang rusak jika menghapusnya.
3. Isi **URL endpoint**. Harus diawali `https://`.
4. Biarkan **Endpoint mode uji** nonaktif untuk endpoint yang menjalankan bisnis nyata Anda. Aktifkan untuk endpoint yang hanya boleh menerima pesanan uji.
5. Pilih peristiwa yang akan dikirim. Centang peristiwa satu per satu, gunakan **Pilih semua** untuk satu kelompok, atau **Berlangganan semua peristiwa**. Sebaiknya pilih hanya peristiwa yang dipakai sistem Anda. Klik **Contoh** di samping peristiwa untuk melihat pesan yang dikirimnya.
6. Klik **Tambah endpoint**.

![Laci Tambah endpoint webhook: nama Fulfilment, URL endpoint https, Endpoint mode uji nonaktif, dan order.created dicentang dengan contoh payload-nya terbuka](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## Peristiwanya

| Kelompok | Peristiwa |
|---|---|
| **Pesanan** | Dibuat, diperbarui, dibayar, dikembalikan dananya, dipenuhi, dipenuhi sebagian, dihapus |
| **Pelanggan** | Dibuat, diperbarui, dihapus |
| **Produk** | Dibuat, diperbarui, dihapus |
| **Inventaris** | Stok diperbarui |
| **Diskon** | Dibuat, diperbarui, dihapus |
| **Kategori** | Dibuat, diperbarui, dihapus |
| **Langganan** | Dibuat, diperpanjang, perpanjangan gagal, dijeda, dilanjutkan, dibatalkan, kedaluwarsa |
| **Kunci lisensi** | Ditetapkan, ditangguhkan, dipulihkan, kedaluwarsa, dicabut |

## Kirim tes

Klik **Kirim tes** pada endpoint. Shoprocket langsung mengirim peristiwa uji dan memberi tahu apakah endpoint Anda menerimanya dan apa jawaban server Anda, misalnya "Merespons 200 dalam 140ms.", atau bahwa endpoint sama sekali tidak bisa dijangkau.

## Lihat apa yang dikirim

Kartu **Pengiriman terbaru**, di bawah endpoint Anda, mencantumkan setiap peristiwa yang coba dikirim Shoprocket: kapan, kode respons dari server Anda, dan berapa percobaan yang dibutuhkan. Pengiriman berstatus **Terkirim**, **Dalam antrean**, **Mencoba lagi**, atau **Gagal**. Setelah memperbaiki masalah di sisi Anda, klik **Kirim ulang** pada pengiriman mana pun untuk mengirimnya lagi.

![Pengiriman terbaru sebuah endpoint: peristiwa terkirim dengan HTTP 200, satu Mencoba lagi dengan HTTP 500, dan tombol Kirim ulang](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## Saat pengiriman gagal

Server Anda harus menjawab setiap pesan dengan kode respons 2xx apa pun. Jika tidak, Shoprocket terus mencoba lagi selama sekitar satu hari.

Jika pengiriman ke satu endpoint gagal 20 kali berturut-turut, endpoint dimatikan dan menyebutkan alasannya. Perbaiki endpoint Anda, lalu klik **Aktifkan kembali sekarang**. Apa pun yang mengantre selama dimatikan lalu dikirim. Sebelum endpoint dimatikan, Anda diperingatkan saat kegagalan menumpuk, misalnya "3 pengiriman gagal berturut-turut. Setelah 20 kali, kami mematikan endpoint ini secara otomatis."

## Edit atau hapus endpoint

Klik tombol edit endpoint untuk mengubah nama, alamat, atau peristiwanya, lalu **Simpan**. Untuk berhenti mengirim ke endpoint itu selamanya, klik **Hapus** dan konfirmasi.

## Untuk developer

Setiap pesan ditandatangani dengan signing secret endpoint, agar server Anda bisa memastikan pesan benar-benar dari Shoprocket. Klik **Tampilkan rahasia penandatanganan** pada endpoint untuk menyalinnya. Setiap pesan juga menyertakan nama peristiwa dan ID pengiriman, sehingga server Anda bisa mengabaikan pengulangan. Panduan developer berisi pemeriksaan tanda tangan, payload setiap peristiwa, dan detail percobaan ulang. Lihat [Webhook](https://shoprocket.io/docs/webhooks.md).

## Terkait

- [Buat kunci API](https://shoprocket.io/id/bantuan/kunci-api.md)
- [Zapier](https://shoprocket.io/id/bantuan/zapier.md)
- [Mode uji vs tayang](https://shoprocket.io/id/bantuan/mode-uji-dan-pembayaran-langsung.md)

[Buka Webhook di dasbor Anda](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/id/bantuan/webhook
- Language: Bahasa Indonesia (id)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
