Hubungkan WhatsApp ke CRM Bitrix24 pada nomor Coexistence

Bagaimana n8n berkomunikasi dengan Bitrix24?

Lewat webhook masuk, yang di Bitrix24 bukan penerima, melainkan kredensial. Anda membuatnya di sumber daya pengembang Bitrix24, memilih scope yang boleh dipakai, lalu mendapat URL berisi alamat portal Anda, id pengguna yang membuatnya, dan kode rahasia. Menambahkan nama method di akhir URL tersebut memanggil REST API sebagai pengguna itu, dengan izin pengguna itu.

Jadi di n8n, setiap langkah Bitrix24 adalah node permintaan HTTP yang mengirim POST ke URL itu ditambah method seperti crm.lead.add.json. Tidak ada alur OAuth yang perlu diselesaikan dan tidak ada aplikasi yang perlu dipublikasikan. Berikan webhook scope CRM saja, dan buat dari pengguna yang izinnya mencakup lead dan kontak yang harus dilihat workflow, karena Bitrix24 memeriksa akses sebagai pengguna tersebut.

Method Bitrix24 apa saja yang dipanggil workflow?

Tiga, berurutan, setelah node Webhook n8n menerima pesan dari Meta.

crm.duplicate.findbycomm dengan type PHONE dan nomor pengirim mengembalikan id lead, kontak, dan perusahaan yang memegang nomor itu. Ini pencarian yang tepat karena menelusuri ketiganya sekaligus dan dibuat untuk mencocokkan data komunikasi, bukan kolom teks biasa.

Jika hasilnya kosong, crm.lead.add membuat lead dengan nama profil WhatsApp sebagai judul dan nomor di kolom teleponnya. Lalu crm.timeline.comment.add menulis isi pesan sebagai komentar pada record, dengan parameter ENTITY_TYPE, ENTITY_ID, dan COMMENT. Komentar muncul di timeline record di samping panggilan dan email, tempat tenaga penjual biasa melihat.

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

Bagaimana pembatasan laju memengaruhi workflow?

Bitrix24 mengukur panggilan REST dengan ember bocor (leaky bucket). Setiap permintaan menambah penghitung, penghitung berkurang dengan laju tetap tiap detik, dan setelah melewati ambang, permintaan berikutnya mendapat 503 dengan QUERY_LIMIT_EXCEEDED. Pada paket Enterprise penghitung berkurang 5 per detik dengan ambang 250; pada paket lain berkurang 2 dengan ambang 50.

Setiap pesan masuk memakan dua atau tiga panggilan, jadi arus yang stabil tidak pernah mendekati batas. Lonjakan bisa: lima puluh pelanggan membalas template yang sama dalam semenit berarti hingga 150 panggilan. Atur node permintaan HTTP agar mencoba kembali saat gagal dengan jeda singkat, dan jalankan eksekusi workflow satu per satu, sehingga lonjakan mengalir ke Bitrix24 alih-alih terpental.

Apakah balasan yang diketik di ponsel sampai ke Bitrix24?

Bisa. Pada nomor Coexistence, aplikasi WhatsApp Business tetap berfungsi, dan saat seseorang membalas dari sana, Meta mengirim echo pesan keluar itu ke tujuan webhook yang sama, di bawah field smb_message_echoes.

Cabang kedua di workflow menangani echo tersebut sama seperti pesan masuk, dengan komentar yang ditandai sebagai keluar. Dengan begitu record menampilkan percakapan lengkap, baris pelanggan dan jawaban toko secara berurutan.

Balasan yang dikirim workflow sendiri lewat Cloud API sudah berada di tangan workflow saat dikirim, jadi catat pada saat itu juga, jangan menunggu webhook kembali.

Kesalahan umum

• Menempelkan URL webhook masuk ke kode sisi klien atau dokumen bersama. Kode rahasia di dalamnya memberi semua scope yang dimiliki webhook tersebut.
• Membuat webhook dari pengguna yang tidak bisa melihat semua lead. Pencarian lalu melewatkan record dan workflow membuat duplikat.
• Mengirim lonjakan panggilan tanpa percobaan ulang. Bitrix24 menjawab 503 QUERY_LIMIT_EXCEEDED dan pesan-pesan itu tidak pernah sampai ke timeline.

Pertanyaan yang sering diajukan

Lanjut membaca