Gunakan nomor Coexistence sebagai kotak masuk WhatsApp Cloud Chatwoot

Bagaimana cara menghubungkan nomor Coexistence ke Chatwoot?

Di dua tempat, dengan urutan ini.

Di Chatwoot, tambahkan kotak masuk, pilih WhatsApp, lalu pilih penyedia WhatsApp Cloud dengan pengaturan manual. Masukkan nomor, phone_number_id, id WhatsApp Business Account, dan access token. Semuanya ditampilkan dashboard EasyCoexistence untuk koneksi tersebut, atau dikembalikan get_api_credentials kepada asisten. Chatwoot kemudian menampilkan URL webhook dan webhook verify token untuk kotak masuk itu.

Di EasyCoexistence, atur tujuan webhook nomor ke URL tersebut dan masukkan verify token yang sama. Meta mengirim permintaan verifikasinya ke Chatwoot, Chatwoot menjawabnya, dan sejak itu setiap pesan ke nomor tersebut masuk ke kotak masuk. Tidak ada yang berjalan di tengah, jadi tidak ada alur kerja yang perlu dijaga tetap hidup.

Apakah balasan yang dikirim dari ponsel muncul di Chatwoot?

Ya. Pada nomor Coexistence, balasan yang diketik di aplikasi WhatsApp Business dilaporkan Meta sebagai event smb_message_echoes. Job webhook Chatwoot mengenali field itu dan mencatat pesan sebagai pesan keluar di percakapan yang tepat. Kode sumbernya menjelaskan kasus ini secara langsung: bisnis yang membalas dari Chatwoot dan dari aplikasi, dengan pesan disinkronkan ke Chatwoot.

Dengan begitu pembagian tugas berjalan di praktik. Pemilik tetap bisa melayani pelanggan tetap dari ponsel, tim bisa menangani kotak masuk bersama di meja kerja, dan masing-masing melihat apa yang dikirim pihak lain tanpa perlu meneruskan tangkapan layar.

Pesan yang dikirim dari Chatwoot keluar melalui Cloud API pada nomor yang sama, jadi juga tampak di ponsel.

Mengapa kotak masuk Chatwoot tidak boleh memakai app secret?

Karena pengiriman ditandatangani dengan secret yang tidak Anda miliki. Meta menandatangani setiap webhook dengan app secret dari aplikasi pemilik langganan, yaitu aplikasi EasyCoexistence, dan secret itu tidak pernah dibagikan.

Di kode sumber Chatwoot saat ini, header X-Hub-Signature-256 pada saluran WhatsApp Cloud yang diatur manual hanya diperiksa bila app secret tersimpan di saluran itu, atau bila saluran dibuat lewat Embedded Signup milik Chatwoot sendiri. Kotak masuk manual tanpa app secret menerima pengiriman; yang diisi app secret apa pun menolak semuanya sebagai tidak sah.

Perlindungan yang berlaku di sini adalah verify token. Pilih nilai acak yang panjang, karena token itulah yang membuat Chatwoot dapat membedakan permintaan verifikasi Meta dari permintaan pihak lain.

Apa yang tidak bisa dilakukan Chatwoot pada nomor ini?

Menerima webhook di tempat kedua pada saat yang sama. Meta mengarahkan webhook sebuah nomor ke satu tujuan, jadi selama Chatwoot memegangnya, workflow n8n tidak akan menerima event yang sama. Bila Anda butuh keduanya, arahkan tujuan ke relay kecil milik Anda yang meneruskan setiap pengiriman ke Chatwoot dan ke alur kerja tersebut.

Batas Coexistence berlaku seperti di mana pun: API mengirim hingga 20 pesan per detik, teks bebas hanya keluar dalam 24 jam sejak pesan terakhir pelanggan, dan template menjangkau semua yang sesudahnya.

Aplikasi WhatsApp Business tetap perlu dibuka minimal sekali setiap 14 hari, dan EasyCoexistence memantau hal ini.

Kesalahan umum

• Mengisi app secret pada kotak masuk Chatwoot. Pengiriman ditandatangani dengan secret aplikasi EasyCoexistence, sehingga Chatwoot menolak semuanya sebagai tidak sah.
• Memakai verify token di EasyCoexistence yang berbeda dari yang ditampilkan Chatwoot. Verifikasi Meta gagal dan kotak masuk tidak pernah menerima pesan.
• Memilih Embedded Signup Chatwoot alih-alih alur manual. Itu menghubungkan nomor lewat aplikasi Meta milik Chatwoot sendiri, yaitu koneksi yang terpisah.

Pertanyaan yang sering diajukan

Lanjut membaca