Hubungkan WhatsApp ke Activepieces pada nomor Coexistence

Bagaimana cara menghubungkan nomor Coexistence ke Activepieces?

Buat koneksi WhatsApp Business di Activepieces dengan dua nilai: token akses dan ID WhatsApp Business Account. Dashboard EasyCoexistence menampilkan keduanya untuk koneksi tersebut, dan get_api_credentials mengembalikannya ke asisten. Petunjuk piece membahas pembuatan app Meta dan system user, karena mengasumsikan Anda belum punya keduanya. Di sini nomor sudah terhubung, jadi langsung tempel nilainya.

Lalu buat flow yang dimulai dengan trigger New Incoming Message, atur verify token pilihan Anda, dan publikasikan flow. Salin URL webhook trigger ke tujuan webhook nomor di EasyCoexistence dengan verify token yang sama. Meta mengirim permintaan verifikasi, trigger menjawabnya, dan setiap pesan ke nomor memulai satu run.

Mengapa app secret harus tetap kosong?

Karena secret yang menandatangani pengiriman ini bukan milik Anda untuk ditempel. Meta menandatangani setiap webhook dengan app secret dari app yang memiliki langganan, dan pada nomor yang terhubung lewat EasyCoexistence itu adalah app EasyCoexistence, yang secret-nya tidak pernah dibagikan.

Piece menganggap kolom ini opsional. Bila kosong, trigger menerima pengiriman apa adanya. Bila diisi dengan secret app lain, setiap pengiriman gagal pada pemeriksaan X-Hub-Signature-256 dan diabaikan diam-diam, yang tampak persis seperti pesan tidak pernah tiba.

Verify token yang menjaga orang asing keluar dari handshake. Pilih nilai acak yang panjang, dan jaga URL trigger tetap privat, karena itulah alamat yang memulai flow Anda.

Apa yang bisa dilakukan flow setelah pesan masuk?

Trigger memberi flow pesan yang sudah diratakan: pengirim, nama profil, ID pesan, tipe, teks, ID media apa pun, balasan tombol dan daftar, serta ID nomor telepon penerima. Dari situ ini menjadi flow Activepieces biasa yang menjangkau piece lain, seperti CRM, spreadsheet, atau langkah AI.

Balasan memakai piece yang sama. Send Message mengirim teks bebas, dan hanya terkirim di dalam jendela layanan pelanggan, yaitu 24 jam sejak pesan terakhir pelanggan. Send Template Message mengirim template yang sudah disetujui, satu-satunya yang terkirim setelah jendela itu. Tombol interaktif, daftar, media, lokasi, dan reaksi adalah aksi tersendiri.

Petunjuk Activepieces sendiri mencatat bahwa Meta hanya menerima satu URL callback per app. Dengan tujuan per nomor, batasnya satu URL per nomor, jadi flow yang harus menangani beberapa jenis event sebaiknya bercabang di dalam satu flow.

Apakah balasan yang diketik di ponsel sampai ke flow?

Sampai ke webhook, tetapi tidak ke trigger ini. Pada nomor Coexistence, Meta mengirim echo dari setiap balasan yang diketik di aplikasi WhatsApp Business ke tujuan yang sama, di bawah field smb_message_echoes. Trigger New Incoming Message milik piece hanya membaca field messages dan membuang yang lain.

Bila Anda butuh balasan dari ponsel di dalam flow, mulai dengan piece Webhook generik Activepieces, yang menerima metode HTTP apa pun, dan jawab GET verifikasi dengan langkah Return Response pada URL sinkronnya. Setelah itu Anda mengurai payload mentah sendiri, termasuk kedua field.

Untuk sebagian besar flow, trigger piece adalah pilihan yang lebih sederhana: ia bereaksi pada pelanggan, dan balasan tim tetap terlihat di aplikasi pada ponsel.

Kesalahan umum

• Menempel app secret ke koneksi WhatsApp. Pengiriman ditandatangani dengan secret app EasyCoexistence, sehingga semuanya diabaikan.
• Mengatur tujuan sebelum flow dipublikasikan. Meta memverifikasi seketika dan flow yang belum dipublikasikan tidak bisa menjawab.
• Mengira trigger New Incoming Message melihat balasan yang diketik di ponsel. Trigger ini hanya membaca field messages, bukan smb_message_echoes.

Pertanyaan yang sering diajukan

Lanjut membaca