> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tanya Jawab Umum Webhook

> Dapatkan jawaban atas pertanyaan paling umum tentang webhook, termasuk pengelolaan, dukungan jaringan, percobaan ulang, dan pemecahan masalah

## Kredit dan Batas Laju

<Accordion title="How many addresses can I input for 1 webhook?">
  Hingga 100.000 alamat menggunakan [API](/docs/id/api-reference/webhooks/create-webhook).
</Accordion>

<Accordion title="Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?">
  Ya, mengedit webhook melalui API atau dasbor dikenai biaya 100 kredit per permintaan. Ini berlaku untuk setiap perubahan, termasuk mengubah URL, menambahkan/menghapus alamat, atau memperbarui jenis transaksi.
</Accordion>

<Accordion title="How many credits does it cost to receive a webhook notification?">
  Setiap peristiwa webhook dikenai biaya 1 kredit saat Helius memproses dan mengirimkan peristiwa tersebut ke endpoint Anda. Anda tetap dikenai biaya terlepas dari apakah endpoint Anda berhasil memproses webhook atau mengembalikan kesalahan.
</Accordion>

<Accordion title="How much does it cost to create, edit, and delete webhooks?">
  Semua operasi pengelolaan webhook (membuat, mengedit, menghapus) dikenai biaya 100 kredit per permintaan jika dilakukan melalui API. Biaya ini mencakup pemrosesan yang diperlukan untuk memperbarui konfigurasi webhook Anda.
</Accordion>

## Jaringan yang Didukung

<Accordion title="Are webhooks available on Solana Devnet?">
  Ya. Jika Anda membuat webhook melalui UI, pilih “devnet” sebagai “Jaringan”. Jika Anda membuatnya melalui Webhook API, tetapkan parameter “webhookType” ke "rawDevnet", "enhancedDevnet", atau “discordDevnet” sesuai dengan jenis webhook yang Anda inginkan.
</Accordion>

<Accordion title="Can I input 'localhost' for my webhook URL?">
  Tidak—URL harus dapat diakses secara publik melalui HTTPS. Helius tidak dapat mengakses server pengembangan lokal melalui URL localhost.
</Accordion>

## Menggunakan Webhook

<Accordion title="How can I verify that the webhook came from Helius?">
  Tetapkan header otorisasi saat membuat atau memperbarui webhook. Helius mengirimkan kembali nilai ini dalam header `Authorization` saat mengirim data ke endpoint webhook Anda, sehingga Anda dapat memverifikasi keaslian permintaan tersebut.
</Accordion>

<Accordion title="What is the difference between 'raw' and 'enhanced' webhooks?">
  **Webhook mentah** mengembalikan data transaksi Solana biasa langsung dari blockchain. Saat transaksi terjadi untuk alamat yang dipantau, data transaksi mentah dikirim ke URL webhook Anda.

  **Webhook yang diperkaya** menyediakan jenis transaksi yang telah ditafsirkan oleh Helius. Kami mengurai lebih dari 100 jenis transaksi Solana (listing NFT, swap DeFi, transfer, dan sebagainya) dan mengabstraksikannya ke dalam skema kami sendiri.

  Gunakan webhook mentah jika Anda menginginkan semua data transaksi tanpa abstraksi, atau webhook yang diperkaya jika Anda menginginkan deteksi dan penguraian jenis transaksi bawaan.
</Accordion>

<Accordion title="When does the Webhook send a notification?">
  Webhook mengirimkan notifikasi segera setelah transaksi yang cocok dikonfirmasi di blockchain.
</Accordion>

## Percobaan Ulang

<Accordion title="How should my endpoint acknowledge a webhook event?">
  Endpoint Anda harus mengembalikan kode status `200` dalam waktu **1 detik** untuk mengonfirmasi bahwa peristiwa berhasil diterima. Sebagai praktik terbaik, segera berikan respons `200` dan tangani pemrosesan secara asinkron — ini mencegah waktu habis yang disebabkan oleh logika bisnis yang lambat.
</Accordion>

<Accordion title="What is the retry policy for webhooks?">
  Helius mencoba kembali pengiriman saat endpoint Anda mengembalikan kesalahan `5xx`, kesalahan `4xx` (kecuali `403`), mengalami waktu habis, atau gagal akibat kesalahan koneksi maupun kegagalan DNS. Kami mencoba kembali hingga **3 kali** dengan **jeda 1 detik** di antara setiap percobaan.

  Jika semua percobaan ulang gagal, peristiwa tersebut **hilang secara permanen** — tidak ada antrean ulang atau siklus pengiriman kedua.

  Pantau log webhook Anda di [Dasbor Helius](https://dashboard.helius.dev/webhooks) untuk mengidentifikasi kegagalan pengiriman dan menyelidiki masalah endpoint.

  Kami juga menawarkan kebijakan percobaan ulang yang dapat disesuaikan untuk paket perusahaan.
</Accordion>

<Accordion title="Is a webhook event delivered exactly once?">
  Helius dapat mengirimkan peristiwa webhook yang sama beberapa kali. Hal ini dapat terjadi akibat logika percobaan ulang atau masalah jaringan.

  Penangan webhook Anda harus siap menangani duplikat dengan baik — memproses peristiwa yang sama beberapa kali harus menghasilkan keluaran yang sama seperti memprosesnya sekali.

  Untuk menangani duplikat, gunakan tanda tangan transaksi atau pengidentifikasi peristiwa unik guna melacak peristiwa yang telah Anda proses.
</Accordion>

<Accordion title="Do webhooks post failed transactions?">
  Tergantung pada jenis webhook. Webhook yang diperkaya tidak mengirimkan transaksi yang gagal, tetapi webhook mentah menyertakan transaksi yang berhasil maupun gagal.
</Accordion>

## Penonaktifan Otomatis

<Accordion title="Why was my webhook automatically disabled?">
  Helius memantau kondisi endpoint dan secara otomatis menonaktifkan webhook dengan **tingkat kegagalan pengiriman ≥ 95%**. Paket berbayar (Dev dan yang lebih tinggi) dievaluasi dalam rentang waktu 7 hari, sedangkan webhook paket Gratis dievaluasi dalam rentang waktu 24 jam. Hal ini mencegah percobaan pengiriman yang sia-sia ke endpoint yang tidak dapat dijangkau.

  Penyebab umum meliputi URL endpoint yang tidak dapat dijangkau, server Anda yang terus-menerus mengembalikan respons kesalahan, atau masalah jaringan/firewall yang memblokir pengiriman Helius.
</Accordion>

<Accordion title="How do I re-enable a disabled webhook?">
  1. Perbaiki masalah yang mendasari pada endpoint Anda.
  2. Masuk ke [Dasbor Helius](https://dashboard.helius.dev/webhooks).
  3. Temukan webhook yang dinonaktifkan dan aktifkan kembali.

  Anda juga dapat mengaktifkan kembali webhook secara terprogram melalui [endpoint Toggle Webhook API](/docs/id/api-reference/webhooks/toggle-webhook) dengan mengirimkan permintaan PATCH berisi `{ "active": true }`.
</Accordion>

<Accordion title="Will my webhook get disabled again right after I re-enable it?">
  Tidak. Setelah diaktifkan kembali, webhook memasuki **masa tenggang 24 jam** dan tidak akan dinonaktifkan secara otomatis selama periode tersebut. Ini memberi Anda waktu untuk memastikan endpoint Anda berfungsi dengan baik sebelum evaluasi berikutnya.
</Accordion>

<Accordion title="Will I be notified when a webhook is auto-disabled?">
  Ya — pengguna **paket Dev dan yang lebih tinggi** menerima notifikasi email saat webhook dinonaktifkan secara otomatis. Pengguna paket Gratis dapat memantau status webhook di [Dasbor Helius](https://dashboard.helius.dev/webhooks).
</Accordion>

<Accordion title="Can I disable a webhook without deleting it?">
  Ya. Anda dapat mengaktifkan dan menonaktifkan webhook dari [Dasbor Helius](https://dashboard.helius.dev/webhooks) atau melalui [endpoint Toggle Webhook API](/docs/id/api-reference/webhooks/toggle-webhook). Dengan demikian, Anda dapat menjeda pengiriman untuk sementara tanpa kehilangan konfigurasi webhook.
</Accordion>

## Memecahkan Masalah Webhook

<Accordion title="Why is my webhook dropping data?">
  Hilangnya data biasanya terjadi saat endpoint Anda mengalami kesalahan, sehingga memicu percobaan ulang webhook yang akhirnya gagal dan menyebabkan kehilangan data. Periksa log webhook Anda di [dasbor](https://dashboard.helius.dev/webhooks), pastikan pencatatan log sisi klien yang memadai telah diterapkan, dan [hubungi dukungan](/docs/id/support/contact-support) jika masalah berlanjut.
</Accordion>

<Accordion title="Why aren't my webhooks working?">
  Pastikan jenis transaksi yang dipilih cocok dengan transaksi yang Anda pantau. Mulailah dengan jenis transaksi "ANY" untuk menentukan apakah masalahnya bersifat umum atau disebabkan oleh ketidakcocokan jenis. Gunakan [webhook.site](http://webhook.site/) untuk menguji apakah masalahnya terletak pada konfigurasi endpoint Anda.
</Accordion>

<Accordion title="Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?">
  Webhook `TOKEN_MINT` hanya dipicu untuk program tertentu seperti Candy Machine V1 dan Solana Program Library. Webhook ini tidak mencakup semua peristiwa pencetakan token di seluruh blockchain. Untuk pemantauan yang lebih luas, pertimbangkan penggunaan langganan akun atau program yang lebih umum melalui webhook dengan pemfilteran jenis transaksi "ANY".
</Accordion>

***

## Perlu Bantuan Lebih Lanjut?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="/docs/id/support/contact-support">
    Dapatkan bantuan dari tim kami melalui Discord, obrolan, atau dukungan email.
  </Card>

  <Card title="Status Page" icon="wave-pulse" href="/docs/id/support/status-page">
    Periksa ketersediaan layanan dan informasi performa secara real-time.
  </Card>
</CardGroup>