# Dapatkan webhook setiap kali Anda menerima pesanan tiket | Panduan Ticket Fairy 1. [Ticket Fairy](https://www.ticketfairy.com/) 2. [Panduan](https://www.ticketfairy.com/id/guides) 3. Dapatkan webhook setiap kali Anda menerima pesanan tiket Pengembang dan API # Dapatkan webhook setiap kali Anda menerima pesanan tiket Webhook mengirim setiap pesanan ke alamat milik Anda beberapa detik setelah pembeli membayar. Agensi dan promotor yang memiliki CRM, sistem gudang, atau sistem pemenuhan pesanan sendiri dapat menerima setiap penjualan saat terjadi, tanpa menunggu ekspor malam hari. Minta Ticket Fairy mengirim setiap pesanan baru ke alamat milik Anda beberapa detik setelah pembeli membayar, agar sistem Anda menerima penjualan tanpa perlu memintanya berkala. Untuk: Mengirim setiap penjualan tiket ke sistem Anda saat terjadi Perlu waktu: 8 menit - [Buat kunci webhook](#step-1) - [Arahkan webhook ke alamat Anda](#step-2) - [Pilih pemicunya](#step-3) - [Tentukan kapan memasang webhook pada brand, bukan event](#step-4) - [Pasang di tempat yang harus menerimanya](#step-5) - [Jual tiket dan lihat hasilnya masuk](#step-6) ## Sebelum mulai - Anda memiliki alamat yang menerima POST dan merespons dengan cepat. Gunakan HTTPS untuk endpoint sungguhan karena setiap permintaan membawa detail pesanan dan pembeli. - Anda memiliki token akses pribadi untuk baris perintah. Panduan untuk membuatnya tersedia secara terpisah. - Anda tahu event mana yang harus mengirim data: satu event, semua event di bawah satu brand, atau semua event dalam satu tur. 1. ## Buat kunci webhook Buka pengaturan akun Anda, lalu pilih **Buat Kunci API Webhook** di bawah **Kunci API Webhook**. **Catatan:** Platform seperti Zapier meminta kunci ini saat Anda menghubungkannya. Webhook yang Anda buat sendiri memanggil alamat Anda secara langsung dan tidak memerlukan apa pun dari kartu ini. ![Kartu Kunci API Webhook Ticket Fairy yang menampilkan kunci, dengan kontrol untuk menyalin dan membuatnya kembali](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png) Kunci webhook setelah dibuat. 2. ## Arahkan webhook ke alamat Anda Jalankan "ticketfairy webhook create --url https://example.com/hooks/tickets --on order" pada brand yang sedang Anda kerjakan. **Catatan:** Setiap pesanan dikirim ke alamat tersebut sebagai JSON. Balas dengan kode sukses secepatnya, lalu lakukan pekerjaan yang lebih lama setelahnya agar penjualan yang ramai tidak perlu menunggu Anda. 3. ## Pilih pemicunya Masukkan hal yang ingin Anda terima di "--on": "order" untuk pesanan, atau "new\_event", "update\_event", "publish\_event", dan "find\_event" untuk event itu sendiri. **Catatan:** Satu webhook membawa satu notifikasi. Jadi, sistem yang ingin menerima pesanan dan publikasi memerlukan dua webhook. ## Tentukan kapan memasang webhook pada brand, bukan event Pasang webhook pada satu event jika hanya event tersebut yang harus mengirim data ke sistem Anda, atau pada brand jika semua event harus mengirim data. Satu tur memiliki pemasangannya sendiri. Empat notifikasi event menjadi pengecualian: "new\_event", "update\_event", "publish\_event", dan "find\_event" hanya menjangkau webhook brand dan tur, bukan webhook yang dipasang pada satu event. Jadi, pasang webhook pada brand jika sistem Anda ingin menerima notifikasi publikasi. 4. ## Pasang di tempat yang harus menerimanya Masukkan "--event", "--brand", atau "--tour" pada perintah yang membuat webhook. **Catatan:** Jika tidak ada satu pun dari ketiganya, perintah akan menggunakan brand yang sedang Anda kerjakan. 5. ## Jual tiket dan lihat hasilnya masuk Beli satu tiket sendiri, lalu periksa apakah permintaan sampai ke alamat Anda. **Catatan:** Pengiriman berlangsung di latar belakang, bukan di dalam proses checkout, jadi tunggu beberapa detik. Setelah itu, refund pesanan Anda sendiri. ## Coba langkah-langkah ini di acara Anda sendiri Buat akun gratis, susun acara Anda dan ikuti langkah-langkah di atas di dasbor Anda sendiri. Hanya perlu beberapa menit dan Anda tidak perlu menjadwalkan panggilan penjualan. Alamat email Anda [Buat akun gratis](https://manage.ticketfairy.com/welcome) [Pesan demo](https://www.ticketfairy.com/id/event-ticketing/book-a-demo) Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit. ## Atau minta dikerjakan untuk Anda Fai dapat membuka halaman yang berisi kunci webhook. Webhook dibuat dari baris perintah, dan langkah-langkah di bawah ini menunjukkan perintahnya. ### Di dasbor Anda, dengan Fai Buka pengaturan akun saya agar saya bisa mendapatkan kunci webhook ### Dari asisten Anda sendiri, lewat MCP Hubungkan asisten Anda ke [server MCP kami](https://www.ticketfairy.com/mcp-server) lalu minta: Biarkan `--read-only` dalam konfigurasi MCP Anda. Tugas ini hanya membaca data, jadi asisten Anda tidak memerlukan alat yang membuat perubahan. Pilih brand \ dan tampilkan event-nya ## Dari terminal Anda Pasang CLI dari [halaman CLI kami](https://www.ticketfairy.com/cli), masuk dengan `ticketfairy auth login`, lalu pilih brand yang Anda kerjakan dengan `ticketfairy brand use `. `ticketfairy brand list` dan `ticketfairy event list` menampilkan ID yang digunakan perintah lain. Buat webhook, lalu baca kembali apa yang sedang menerima data. ### Panggil alamat Anda setiap kali pesanan dibuat ticketfairy webhook create --url https://example.com/hooks/tickets --on order ### Tampilkan webhook pada brand aktif ticketfairy webhook list ## Biarkan Fai mengerjakannya untuk Anda Fai bekerja di dalam dasbor Ticket Fairy Anda. Buat akun Anda, buka Fai dan tempel perintah di atas. [Buat akun gratis](https://manage.ticketfairy.com/welcome) [Pesan demo](https://www.ticketfairy.com/id/event-ticketing/book-a-demo) Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit. ## Nonaktifkan salah satunya 1. ### Matikan saat Anda memperbaikinya Jalankan "ticketfairy webhook update \ --disable", menggunakan ID dari "ticketfairy webhook list". **Catatan:** Webhook yang dinonaktifkan menyimpan pengaturannya dan berhenti menerima data. Aktifkan kembali dengan perintah yang sama dan "--enable". 2. ### Hapus yang sudah selesai digunakan Jalankan "ticketfairy webhook delete \" setelah tidak ada lagi yang memerlukannya. **Catatan:** Penghapusan bersifat permanen. Jika Anda hanya ingin menjedanya, nonaktifkan terlebih dahulu. Fai dapat membuka dashboard untuk Anda. Saat ini, webhook dibaca dan diubah dari baris perintah. ### Di dasbor Anda, dengan Fai Buka pengaturan akun saya ### Dari asisten Anda sendiri, lewat MCP Biarkan `--read-only` dalam konfigurasi MCP Anda. Tugas ini hanya membaca data, jadi asisten Anda tidak memerlukan alat yang membuat perubahan. Pilih brand \ dan tampilkan event-nya ### Dari terminal Anda Baca webhook, lalu matikan atau hapus salah satunya. #### Tampilkan webhook pada brand aktif ticketfairy webhook list #### Hentikan penerimaan webhook tanpa menghapusnya ticketfairy webhook update \ --disable #### Hapus webhook secara permanen ticketfairy webhook delete \ ## Pertanyaan yang mungkin Anda punya Mengapa tidak ada yang masuk saat event saya ditayangkan?: Periksa webhook tersebut dipasang pada apa. Notifikasi event hanya menjangkau webhook brand dan tur, jadi webhook yang dipasang pada satu event hanya menerima pesanan. Apa yang terjadi jika alamat saya tidak aktif?: Pengiriman tersebut gagal, lalu pengiriman berikutnya dicoba seperti biasa. Balas dengan 410 Gone dan kami akan menghapus webhook dari daftar. Ini cara yang tepat untuk berhenti berlangganan dari sisi Anda. Bisakah saya memeriksa apakah permintaan benar-benar berasal dari Ticket Fairy?: Bisa. Minta dukungan Ticket Fairy menambahkan secret penandatanganan ke event Anda. Setelah itu, setiap permintaan membawa header X-Signature yang dapat dihitung ulang oleh endpoint Anda menggunakan secret yang sama. Apakah pesanan yang sama bisa sampai kepada saya lebih dari sekali?: Bisa. Seluruh pesanan dikirim ulang setiap kali berubah, jadi refund, pembatalan, penjualan kembali, atau transfer akan mengirimkannya masing-masing. Cocokkan berdasarkan nomor pesanan dan terapkan data yang Anda terima, bukan menghitung setiap pengiriman sebagai penjualan baru. Bisakah saya menguji dengan alamat lokal?: Alamat http biasa di komputer Anda sendiri diterima, jadi tunnel hanya kemudahan, bukan keharusan. Setiap permintaan membawa detail pesanan dan pembeli. Gunakan http untuk pengujian, lalu berikan alamat HTTPS untuk sistem live. ## Masih ada pertanyaan? Jadwalkan demo dan kami akan menjawabnya lewat panggilan, sesuai jenis acara Anda. Atau buat akun Anda dan lihat sendiri. [Pesan demo](https://www.ticketfairy.com/id/event-ticketing/book-a-demo) [Buat akun gratis](https://manage.ticketfairy.com/welcome) Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit. ## Panduan terkait - [Cara lain menggunakan Ticket Fairy](https://www.ticketfairy.com/id/event-ticketing/features) - [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/id/guides/create-an-api-key-for-your-own-app) - [Jual tiket langsung dari situs web Anda](https://www.ticketfairy.com/id/guides/sell-tickets-on-your-own-website) - [Sync your ticket buyers to Mailchimp](https://www.ticketfairy.com/id/guides/sync-buyers-to-mailchimp) - [Semua panduan Ticket Fairy](https://www.ticketfairy.com/id/guides) ## Lakukan ini di acara Anda sendiri Buat akun, susun acara, dan ikuti langkah-langkahnya di dasbor Anda. Anda tidak perlu memesan panggilan penjualan. [Buat akun gratis](https://manage.ticketfairy.com/welcome) [Pesan demo](https://www.ticketfairy.com/id/event-ticketing/book-a-demo) ## Jual tiket dengan Ticket Fairy Semua yang ada di panduan ini tersedia di dasbor Anda sejak hari Anda mendaftar. - Siapkan acara Anda dalam hitungan menit - Acara gratis memang gratis - Fai, kopilot Anda, sudah tersedia [Buat akun gratis](https://manage.ticketfairy.com/welcome) Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit. ## Lihat lewat panggilan Jadwalkan demo dan kami akan menunjukkan cara Ticket Fairy menangani jenis acara Anda. [Pesan demo](https://www.ticketfairy.com/id/event-ticketing/book-a-demo) [Cara lain menggunakan Ticket Fairy](https://www.ticketfairy.com/id/event-ticketing/features) ### Kiat untuk menjual lebih banyak tiket Saran praktis dari penyelenggara yang tiketnya habis terjual, dan setiap panduan baru begitu terbit. Kami menghormati privasi Anda. Berhenti berlangganan kapan saja.