Webhook di API FoodSoul: CRM secara otomatis memberi tahu layanan Anda tentang peristiwa baru

Sekarang FoodSoul secara otomatis mengirimkan notifikasi ke sistem Anda ketika sesuatu terjadi di CRM. Misalnya, ada pesanan baru, pelanggan melakukan pembayaran atau pengembalian dana, atau tamu baru mendaftar. Cukup sekali saja Anda menentukan alamat layanan Anda, dan data akan langsung dikirim ke sistem akuntansi, bot Anda, CRM kedua, atau analitik.

Notifikasi tentang peristiwa apa saja yang bisa diterima

1. Pesanan baru dengan kartu lengkap. Berguna untuk sistem akuntansi, dapur, dan analitik.
2. Perubahan status pesanan. Cocok untuk bot yang memberi tahu pelanggan tentang pesanan, dan untuk call center.
3. Perubahan status pembayaran, termasuk pengembalian dana. Diperlukan untuk akuntansi dan pencatatan keuangan.
4. Pelanggan baru dan perubahan datanya. Untuk CRM eksternal dan layanan pengiriman pesan.
5. Penambahan, pengurangan, dan hangusnya bonus. Untuk program loyalitas dan komunikasi dengan tamu.
6. Ulasan baru. Untuk manajer dan layanan kualitas.
7. Penunjukan kurir. Untuk logistik dan notifikasi kepada pelanggan.
8. Perubahan daftar stop. Untuk situs web, dapur, dan platform tempat Anda berjualan.
9. Cabang menghentikan atau melanjutkan penerimaan pesanan. Untuk kontrol operasional dan manajemen jaringan.

Anda sendiri yang memilih peristiwa mana yang ingin diterima. Anda bisa mengaktifkan hanya yang diperlukan, misalnya “pesanan baru” dan “pembayaran”. Tidak menemukan peristiwa yang Anda butuhkan? Tulis kepada kami — kami dengan senang hati akan menambahkannya.

Cara menghubungkan

1. Aktifkan webhook untuk cabang yang diinginkan — kunci tanda tangan akan dibuat secara otomatis.
2. Pilih peristiwa yang ingin Anda terima notifikasinya.
3. Masukkan alamat layanan Anda, tempat FoodSoul akan mengirimkan data. Hanya alamat dengan HTTPS yang diterima.
4. Tambahkan kunci tanda tangan ke layanan yang menerima notifikasi, dan atur pemeriksaan tanda tangan. Jika saat membuat webhook Anda memasukkan alamat yang berbeda, tambahkan kunci ke setiap layanan.
5. Pastikan layanan Anda mengonfirmasi penerimaan notifikasi dalam waktu 10 detik, jika tidak FoodSoul akan mengirimkannya kembali.

6. Atur pemeriksaan duplikasi: notifikasi yang sama bisa datang beberapa kali. Semua duplikasi memiliki ID yang sama (header X-Webhook-ID). Pastikan layanan Anda menyimpan ID notifikasi yang sudah diproses dan melewati duplikasi — sehingga satu pembayaran tidak diproses dua kali.

    

Keamanan: mengapa kunci tanda tangan diperlukan
 

FoodSoul menandatangani setiap notifikasi dengan kunci tanda tangan — rangkaian karakter yang hanya Anda dan kami yang memilikinya. Dengan tanda tangan ini, sistem Anda memverifikasi bahwa notifikasi benar-benar berasal dari FoodSoul dan tidak diubah selama pengiriman.
 

Siapa pun bisa mengirim permintaan ke alamat layanan Anda. Misalnya, penipu bisa mengirim notifikasi palsu “pesanan telah dibayar”, dan Anda bisa saja menyerahkan pesanan yang belum dibayar.
 

Dengan tanda tangan, hal itu tidak akan terjadi. Server Anda menghitung tanda tangan dengan kunci yang sama dan membandingkannya dengan yang diterima. Jika tanda tangan tidak cocok, berarti notifikasi palsu atau telah diubah.

 

Jika terjadi masalah

• Jika layanan Anda sementara tidak tersedia, FoodSoul akan mencoba mengirimkan notifikasi beberapa kali lagi dalam waktu 10 jam. Gangguan singkat atau restart server tidak akan menyebabkan kehilangan peristiwa.
• Jika masalah berlangsung lama, langganan akan dinonaktifkan dan Anda akan menerima email: dengan begitu Anda akan mengetahui adanya masalah.
• Untuk mengaktifkan langganan kembali, hubungi dukungan teknis. Di sana Anda juga bisa meminta pengiriman ulang notifikasi yang tidak terkirim selama gangguan.
   

Deskripsi detail tentang peristiwa dan format data — ada di dokumentasi API.

Hormat kami, tim FoodSoul! Kami bekerja untuk Anda!