Fungsi webhook
Webhook mengirim detail sebuah event di toko Anda ke tempat lain begitu event itu terjadi. Anda memilih event-nya dan tujuannya:
- API: Storeep mengirim data event ke alamat web (URL) server Anda, CRM, skenario Zapier atau Make, atau alat pelacakan iklan.
- Email: Storeep mengirim data event ke sebuah alamat email, misalnya agar Anda mendapat email untuk setiap pesanan baru.
Buka Pengaturan > Webhook. Anda memerlukan izin Pengaturan.
Banyak alat sudah punya aplikasi siap pakai yang lebih mudah: Google Sheets, jaringan kurir, dan pixel iklan. Periksa marketplace Aplikasi lebih dulu.
Membuat webhook
Klik Tambah webhook baru, isi formulirnya, lalu klik Tambah.
- Aktifkan: dicentang secara default. Jika dicentang, event langsung dikirim. Hapus centangnya untuk menyimpan webhook tetapi menjedanya.
- Nama: label untuk daftar Anda, misalnya "Pesanan baru CRM".
- Jenis: API atau Email.
- Event:
- Pesanan dibuat: pelanggan membuat pesanan baru.
- Pesanan diperbarui: status atau detail pesanan berubah.
- Sesi dibuat: pengunjung baru datang ke toko Anda. Hanya untuk jenis API.
- Format: Json.
- URL (jenis API): alamat tujuan pengiriman. Bagian
https://sudah ditambahkan untuk Anda, jadi ketik sisanya, sepertiapi.example.com/orders. - Alamat email (jenis Email): tujuan email dikirim.
Webhook Email hanya mengirim event pesanan. Jika Anda memilih Email dengan Sesi dibuat, tidak ada yang dikirim.
Memasukkan data pesanan ke dalam URL
Anda bisa menaruh kolom apa pun dari data event di dalam URL dengan kurung kurawal ganda, {{field_name}}. Contohnya:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Ini mengirim ID klik Facebook dan total pesanan ke platform pelacakan iklan atau afiliasi, tanpa server tambahan. Kolom yang tidak ada akan menjadi kosong. Untuk melihat nama-nama kolom, buat webhook Email untuk event yang sama lalu lihat data yang Anda terima.
Daftar webhook
Setiap baris menampilkan Nama, URL / Email, Jenis, Event, Format, dan Status (Aktif atau Dinonaktifkan). Klik sebuah baris untuk mengeditnya. Centang baris lalu pilih Hapus webhook untuk menghapusnya secara permanen. Ada jumlah maksimum webhook per toko, dan Anda melihat pesan saat batas itu tercapai.
Anda bisa membuat beberapa webhook untuk event yang sama, misalnya satu ke CRM dan satu ke pelacak iklan Anda.
Saat pengiriman gagal
- Server Anda sebaiknya segera menjawab dengan kode sukses (2xx). Jawaban yang lambat dihitung sebagai kegagalan.
- Jika server Anda mati atau sibuk (jawaban 5xx atau 429, atau tidak ada jawaban), Storeep mencoba lagi beberapa kali dalam beberapa menit berikutnya. Hanya webhook yang gagal yang dicoba ulang, jadi webhook lain tidak menerima duplikat.
- Jika server Anda menolak permintaan (jawaban 4xx seperti 404 atau 403), Storeep tidak mencoba lagi, karena alamat atau keamanannya salah.
- Jika sebuah webhook gagal beberapa kali berturut-turut, pemilik toko menerima satu email: "Tindakan diperlukan: webhook Storeep Anda gagal", berisi nama webhook, alamat, event, dan kode error terakhir. Setelah webhook berfungsi lagi, masalah berikutnya bisa memicu peringatan baru. Anda bisa mematikan email ini di Notifikasi.
- Webhook Email dikirim sekali, tanpa percobaan ulang.
Webhook dijeda karena saldo belum dibayar
Jika toko Anda punya jumlah terutang yang belum dibayar dan dompet Anda tidak cukup untuk menutupinya, webhook menunggu. Webhook dikirim setelah Anda menambah saldo dan jumlah tersebut dilunasi. Lihat Dompet dan tagihan.
Tips
- Jika server Anda memerlukan kata sandi atau kunci, taruh di query URL, misalnya
?key=yoursecret. - Sesi dibuat terpicu untuk setiap pengunjung, yang bisa sangat banyak di toko yang ramai. Gunakan hanya jika server Anda sanggup menanganinya.
- Agar sebuah alat bisa membaca pesanan dan produk Anda kapan pun ia mau, gunakan token akses.