Webhook history
history membawa transfer satu kali percakapan yang sudah ada pada nomor Coexistence ke API. Transfer ini tiba setelah onboarding jika berbagi riwayat disetujui, dan menjadi satu-satunya sinyal yang diterima integrasi bahwa transfer tersebut benar-benar terjadi.
Jendela setelah onboarding ketika sinkronisasi harus dimulai.
Kesalahan yang dikembalikan ketika sinkronisasi sudah pernah digunakan.
Kesalahan yang dikembalikan ketika percobaan dilakukan di luar jendela tersebut.
Apa yang dikirim
Riwayat pesan satu lawan satu yang sudah dimiliki nomor tersebut di aplikasi WhatsApp Business, dibawa ke API agar perangkat lunak tidak mulai tanpa konteks pada nomor yang telah digunakan bisnis selama bertahun-tahun.
Yang tidak ikut dikirim adalah percakapan grup, karena sepenuhnya dikecualikan dari API pada nomor Coexistence, serta fitur aplikasi itu sendiri: label, balasan cepat, pesan sapaan, dan pesan saat tidak tersedia tidak memiliki padanan API dan tetap berada di perangkat.
Field ini hanya ada pada nomor Coexistence. Nomor yang menjalani onboarding dengan cara biasa tidak memiliki riwayat aplikasi sebelumnya untuk dibawa, sehingga tidak ada yang dapat dikirim.
Mengapa hanya dipicu sekali
Karena transfer ini merupakan bagian dari onboarding, bukan kemampuan yang berjalan terus-menerus.
Pemilik bisnis ditanya selama Embedded Signup apakah ingin membagikan percakapan yang sudah ada. Jawaban ya memungkinkan sinkronisasi berjalan, dan tidak ada pengaturan untuk mengaktifkannya kembali setelah itu maupun endpoint yang dapat mengulanginya. Percobaan kedua mengembalikan 2593107, bukan pembatasan laju yang akan hilang.
Ada pula batas waktu. Sinkronisasi harus dimulai dalam 24 jam setelah onboarding, dan percobaan setelahnya mengembalikan 2593108. Jika salah satunya terlewat, nomor harus diputuskan koneksinya lalu seluruh alur dijalankan kembali.
Apa yang harus dilakukan penangan
Perlakukan ini sebagai kumpulan data yang tiba satu kali dan mungkin berukuran besar, bukan sebagai lalu lintas tambahan pada jalur pesan.
- Berikan pengakuan dengan cepat dan proses secara asinkron, seperti pengiriman lainnya.
- Lakukan deduplikasi berdasarkan id pesan: history dan pesan langsung dapat tumpang tindih di sekitar waktu onboarding.
- Bersiaplah jika history tidak ada. Nomor yang pemiliknya menolak riwayat tidak mengirim apa pun melalui field ini, dan integrasi harus tetap berfungsi dalam kedua kondisi.
- Jangan menahan onboarding karenanya. Koneksi dapat digunakan sebelum transfer selesai.
Kesalahan umum
- Membangun integrasi yang mengharuskan history tersedia. Banyak nomor yang terhubung tanpa riwayat tersebut.
- Mencoba kembali sinkronisasi setelah 2593107. Ini adalah peristiwa satu kali, sehingga percobaan ulang mengembalikan kesalahan yang sama.
- Menunda keputusan tentang history sampai pekerjaan integrasi dimulai, yang biasanya terjadi setelah jendela 24 jam ditutup.
EasyCoexistence mencatat onboarding dan pilihan history pada linimasa koneksi, sehingga apakah suatu nomor disinkronkan dan pada hari apa menjadi fakta bertanggal, bukan sesuatu yang harus direkonstruksi kemudian.
Pertanyaan yang sering diajukan
Berapa banyak riwayat yang dikirim?
Jendela percakapan satu lawan satu terbaru yang ditetapkan oleh Meta, bukan oleh penyedia.
Apakah chat grup ikut dikirim?
Tidak. Grup sepenuhnya dikecualikan dari API pada nomor Coexistence.
Dapatkah saya memintanya lagi nanti?
Tidak. Proses ini berjalan sekali untuk setiap onboarding. Untuk menjalankannya lagi, nomor harus diputuskan koneksinya lalu disambungkan kembali.
Bagaimana jika pemilik menolak riwayat?
Tidak ada yang tiba melalui field ini, dan API hanya melihat pesan sejak nomor tersebut terhubung.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada