Integrasi WhatsApp Business API dengan CRM Anda (Persediaan yang Berfungsi)

Berikut ialah realiti yang mengecewakan: anda berjaya mengalirkan perbualan WhatsApp, wakil memberi respons, lead menunjukkan minat, kemudian 40% daripada kenalan tersebut tidak pernah muncul dalam CRM anda. Bukan kerana had teknikal, tetapi kerana integrasi telah dikonfigurasi dengan salah dengan cara yang gagal tanpa sebarang amaran.

Seorang pengurus RevOps di syarikat B2B SaaS mendapati perkara ini apabila beliau menarik laporan WhatsApp dan membandingkannya dengan HubSpot. Jurang itu nyata dan telah terkumpul selama dua bulan. Pembetulan mengambil masa satu petang setelah beliau mengenal pasti laluan yang digunakan dan apa yang telah salah dikonfigurasi.

Panduan ini membimbing anda melalui tiga persediaan integrasi utama: ManyChat ke HubSpot, Respond.io ke HubSpot, dan webhook ke mana-mana CRM, dengan langkah pemetaan medan, logik penyahduplikatan, dan atribusi UTM khusus yang diperlukan oleh setiap satu.

Memilih Laluan Integrasi Anda

Sebelum menyentuh sebarang tetapan, pilih laluan anda. Keputusan bergantung pada tumpukan alat sedia ada dan CRM anda. Menurut dokumentasi rasmi WhatsApp Business Platform Meta, Business API menyokong tiga peringkat pengesahan dengan keupayaan pemesejan yang berbeza, laluan integrasi anda menentukan peringkat mana yang terpakai untuk kes penggunaan anda. Jika anda masih memutuskan platform chat yang sesuai dengan aliran kerja anda, perbandingan Respond.io berbanding ManyChat untuk jualan B2B menguraikan pertimbangan dengan jelas.

Jika anda menggunakan HubSpot dan secara aktif membina aliran dalam ManyChat, gunakan Laluan A. Jika anda menjalankan semua operasi chat melalui Respond.io, Laluan B memberikan penyegerakan yang lebih mendalam. Jika CRM anda bukan HubSpot, Laluan C ialah pilihan anda.

Laluan A: ManyChat ke HubSpot

Mengaktifkan Integrasi

Dalam ManyChat, pergi ke Settings, kemudian Integrations, kemudian HubSpot. Anda memerlukan:

• Akaun HubSpot dengan akses Contacts
• Peranan admin ManyChat
• Kunci API HubSpot atau sambungan OAuth (OAuth lebih disyorkan)

Klik Connect, benarkan sambungan HubSpot, dan sahkan portal yang dipautkan.

Kebenaran HubSpot yang Diperlukan

Pengguna HubSpot yang menyambung memerlukan sekurang-kurangnya: Contacts (lihat dan edit), Properties (lihat), dan Workflows (lihat). Jika anda menggunakan aliran kerja HubSpot yang dicetuskan oleh data ManyChat, tambahkan Workflows (edit).

Memetakan Medan Kenalan

Data pelanggan ManyChat dipetakan ke sifat kenalan HubSpot. Berikut ialah pemetaan lalai dan perkara yang perlu anda sesuaikan:

Untuk memetakan atribut tersuai, pergi ke ManyChat, kemudian Integrations, kemudian HubSpot, kemudian Field Mapping dan tambahkan baris baharu. Sifat HubSpot perlu wujud sebelum anda boleh memetakannya. Cipta dahulu dalam HubSpot di bawah Contacts, kemudian Properties.

Penugasan Pemilik Kenalan

ManyChat boleh menetapkan pemilik kenalan HubSpot berdasarkan round-robin atau pemilik tetap. Tetapkan ini di bawah tetapan integrasi HubSpot, kemudian Default Owner. Untuk pasukan yang melakukan penghalaan berasaskan wilayah, anda perlu menggunakan aliran kerja HubSpot yang dicetuskan pada penciptaan kenalan untuk menugaskan semula berdasarkan syarikat atau rantau.

Apa yang Disegerakkan dan Apa yang Tidak

ManyChat menyegerakkan sifat kenalan dan secara pilihan menolak nota dengan ringkasan perbualan. Ia tidak menyegerakkan transkrip perbualan penuh ke HubSpot secara asli. Untuk sejarah perbualan, anda memerlukan Laluan B atau penyelesaian menggunakan webhook.

Integrasi ini juga tidak menolak kemas kini kenalan secara masa nyata untuk setiap mesej. Ia mencetus pada peristiwa tertentu dalam aliran anda (biasanya pada opt-in atau apabila langkah aliran mencetuskan tindakan HubSpot).

Laluan B: Respond.io ke HubSpot

Menyambung Melalui Modul HubSpot Asli Respond.io

Dalam Respond.io, pergi ke Settings, kemudian Integrations, kemudian HubSpot. Anda akan mengesahkan melalui OAuth. Respond.io memerlukan akaun admin HubSpot untuk sambungan awal.

Setelah disambungkan, Respond.io mewujudkan penyegerakan dua hala: kenalan yang dicipta dalam Respond.io muncul dalam HubSpot, dan kenalan HubSpot sedia ada boleh ditarik ke dalam perbualan Respond.io.

Pemetaan Peringkat Kitaran Hayat

Respond.io boleh mengemas kini peringkat kitaran hayat HubSpot berdasarkan peristiwa perbualan. Konfigurasikan ini di bawah tetapan integrasi HubSpot:

• Kenalan baharu daripada WhatsApp, kemudian Lead
• Soalan kelayakan diselesaikan, kemudian Marketing Qualified Lead
• Mesyuarat ditempah, kemudian Sales Qualified Lead

Tetapkan pemetaan ini untuk mencetus secara automatik apabila langkah yang relevan dalam aliran anda selesai.

Penyahduplikatan Kenalan Mengikut Nombor Telefon

Respond.io menggunakan nombor telefon sebagai kunci penyahduplikatan utama apabila menyegerakkan ke HubSpot. Jika kenalan sudah wujud dalam HubSpot dengan nombor telefon berformat E.164 yang sama, Respond.io mengemas kini rekod sedia ada dan bukannya mencipta duplikat.

Tangkapannya: format nombor telefon mesti sepadan dengan tepat. Jika HubSpot mempunyai "+1 (555) 000-0000" dan Respond.io menghantar "+15550000000", ia tidak akan menyahduplikat. Standardkan semua nombor telefon ke format E.164 dalam kedua-dua sistem. Dalam HubSpot, anda boleh menggunakan aliran kerja dengan tindakan "Format phone number" untuk menormalkan rekod sedia ada.

Pilihan Penyegerakan Sejarah Perbualan

Respond.io boleh menolak sejarah perbualan ke HubSpot sebagai nota pada rekod kenalan. Aktifkan ini di bawah integrasi HubSpot, kemudian Sync Options, kemudian Log Conversations. Setiap perbualan menjadi nota bertanda masa dengan pertukaran penuh.

Ini ialah kelebihan terbesar Laluan B berbanding Laluan A untuk pasukan yang mahukan wakil melihat konteks sebelum menghubungi lead yang bersumber daripada chat.

Laluan C: Webhook ke Mana-Mana CRM

Menstrukturkan Muatan Webhook Respond.io

Respond.io menyokong webhook keluar yang dicetuskan oleh peristiwa perbualan (kenalan baharu, mesej diterima, langkah aliran selesai). Konfigurasikan ini di bawah Settings, kemudian Developer, kemudian Webhooks.

Contoh muatan apabila kenalan melengkapkan langkah aliran kelayakan:

{
  "event": "contact.updated",
  "contact": {
    "id": "abc123",
    "phone": "+15550001234",
    "firstName": "Jane",
    "lastName": "Chen",
    "customAttributes": {
      "company_size": "50-200",
      "use_case": "sales_automation",
      "timeline": "Q2_2026",
      "source_ad_id": "23849572894"
    },
    "createdAt": "2026-04-18T09:32:00Z",
    "optInTimestamp": "2026-04-18T09:31:47Z"
  },
  "conversation": {
    "id": "conv_xyz789",
    "channel": "whatsapp"
  }
}

Membina Zap Zapier atau Make

Dalam Zapier:

1. Pencetus: Webhooks by Zapier, kemudian Catch Hook
2. Salin URL webhook ke dalam Respond.io
3. Hantar kenalan ujian melalui aliran untuk mengisi data sampel
4. Tindakan: Cipta atau Kemas Kini Kenalan dalam CRM anda
5. Petakan medan daripada muatan webhook ke medan CRM
6. Tambahkan langkah penapis: teruskan hanya jika phone tidak kosong

Dalam Make (dahulunya Integromat), gunakan modul Webhooks sebagai pencetus, kemudian halakan ke modul Cipta/Kemas Kini Kenalan CRM anda.

Menangani Isu Format Nombor Telefon

WhatsApp sentiasa menghantar nombor telefon dalam format E.164. Kebanyakan CRM menerima E.164 tetapi sesetengahnya (terutamanya Salesforce) mempunyai keperluan format tempatan. Tambahkan langkah pemformat teks dalam Zapier atau Make untuk menghilangkan awalan kod negara atau memformat semula mengikut keperluan sebelum tindakan CRM dicetuskan.

Atribusi UTM dan Sumber

Apabila kenalan memasuki funnel WhatsApp anda daripada iklan Meta, data sumber iklan dibawa bersama mereka, tetapi hanya jika anda telah menyambungkan penyerahan dengan betul. Untuk persediaan iklan penuh yang menyuap saluran atribusi ini, lihat panduan tentang kempen iklan Click-to-WhatsApp.

Meta menghantar parameter ad_id dan campaign_id apabila perbualan dimulakan daripada iklan Click-to-WhatsApp. Respond.io menangkap ini secara automatik dalam metadata perbualan. ManyChat menangkapnya sebagai pembolehubah User Input jika anda telah menambahkan langkah sumber iklan Meta ke aliran anda.

Untuk mendapatkan atribusi peringkat kempen dalam CRM anda:

1. Simpan ad_id, ad_set_id, dan campaign_id sebagai atribut tersuai dalam platform chat anda
2. Sertakannya dalam pemetaan medan atau muatan webhook ke CRM
3. Cipta sifat tersuai HubSpot "WhatsApp Campaign Source" yang dipetakan ke campaign_id
4. Bina laporan HubSpot yang ditapis mengikut "WhatsApp Campaign Source" untuk melihat Pipeline mengikut kempen

Ini memberikan anda pandangan kempen ke Pipeline yang mudah tanpa memerlukan alat atribusi pihak ketiga.

Peraturan Penyahduplikatan

Apabila nombor telefon yang sama memasuki funnel anda beberapa kali (biasa dengan kempen penargetan semula), integrasi anda memerlukan peraturan yang jelas. Ini terutamanya relevan apabila automasi penangkapan lead menarik kenalan dari pelbagai saluran serentak.

Susunan keutamaan:

1. Padankan mengikut nombor telefon dahulu (dinormalkan kepada E.164)
2. Jika padanan ditemui: kemas kini rekod sedia ada, jangan cipta baharu
3. Jika tiada padanan: cipta kenalan baharu, tandakan sebagai lead baharu
4. Jika telefon sepadan tetapi e-mel berbeza: kemas kini e-mel hanya jika rekod sedia ada tidak mempunyai e-mel

Dalam HubSpot, penyahduplikatan asli hanya memadankan mengikut e-mel secara lalai. Untuk penyahduplikatan berasaskan telefon, gunakan aliran kerja HubSpot: cetus pada penciptaan kenalan, cari kenalan sedia ada mengikut nombor telefon, dan jika ditemui, gabungkan rekod menggunakan langkah kod tersuai atau aplikasi penyahduplikatan pihak ketiga seperti Dedupely.

Dalam Salesforce, gunakan peraturan duplikat di bawah Setup, kemudian Duplicate Management, dengan peraturan padanan pada medan Phone. Kajian Gartner mengenai kualiti data CRM mendapati bahawa kualiti data yang lemah menelan kos organisasi purata $12.9 juta setahun. Penyahduplikatan telefon ialah salah satu pembetulan yang paling kos efektif.

Menguji Integrasi

Jalankan urutan 6 langkah ini sebelum melancarkan:

1. Hantar diri anda melalui aliran WhatsApp penuh menggunakan nombor telefon ujian
2. Semak platform chat anda (ManyChat atau Respond.io) untuk mengesahkan kenalan dicipta dengan semua atribut tersuai yang diisi
3. Tunggu 2-3 minit, kemudian semak CRM anda untuk kenalan baharu dengan nombor telefon yang sepadan
4. Sahkan setiap medan yang dipetakan tiba dengan nilai yang betul, terutamanya atribut tersuai
5. Semak bahawa pemilik kenalan telah ditetapkan dengan betul
6. Hantar ujian kedua dengan nombor telefon yang sama untuk mengesahkan penyahduplikatan (kemas kini, bukan duplikat)

Jika langkah 3 gagal: semak status sambungan integrasi anda dahulu, kemudian lihat log peristiwa dalam platform chat anda untuk ralat penyegerakan.

Jika langkah 4 gagal dengan atribut tersuai yang hilang: sahkan bahawa atribut telah diisi semasa aliran (semak rekod kenalan dalam ManyChat atau Respond.io) dan bahawa pemetaan medan dikonfigurasi dengan betul.

Kesilapan Lazim

Ketidakpadanan format nombor telefon. Kegagalan yang paling biasa. Normalkan ke E.164 di mana-mana sahaja sebelum anda membina sebarang pemetaan. Chat funnel yang mematuhi GDPR untuk pembeli EU merangkumi keperluan tambahan berkaitan penyimpanan nombor telefon jika kenalan anda berada di EU.

Cap masa opt-in yang tiada. GDPR dan Dasar Perniagaan WhatsApp kedua-duanya memerlukan anda merekodkan masa pengguna opt-in. Simpan cap masa opt-in sebagai medan CRM dari hari pertama, bukan sebagai renungan kemudian.

CRM menyekat rekod tanpa e-mel. HubSpot dan Salesforce boleh dikonfigurasi untuk memerlukan e-mel pada penciptaan kenalan. Kenalan WhatsApp sering tidak mempunyai e-mel yang dikumpulkan. Sama ada alih keluar keperluan e-mel untuk kenalan yang bersumber daripada chat atau kumpulkan e-mel sebagai langkah aliran.

Konflik jenis sifat HubSpot. Jika anda memetakan atribut teks ManyChat ke sifat nombor HubSpot, penyegerakan akan gagal tanpa sebarang amaran. Padankan jenis sifat dengan tepat: teks ke teks, nombor ke nombor, dropdown ke dropdown.

Langkah Seterusnya

Setelah integrasi anda disahkan berfungsi, bina pandangan CRM yang ditapis mengikut "WhatsApp Campaign Source is not empty". Gandingkan pandangan ini dengan reka bentuk model data CRM yang kukuh supaya sifat chat tersuai anda berada dalam skema yang konsisten dari awal. Ini menjadi pandangan berterusan anda untuk menjejaki Pipeline yang bersumber daripada chat. Semak setiap minggu berbanding sumber lead lain anda untuk melihat sumbangan saluran tersebut.

Dari sana, hubungkan titik atribusi ke hasil jualan. Apabila lead yang bersumber daripada chat berjaya ditutup, tandakan kontrak dengan sumber kempen asal. Selepas 60 hari anda akan mempunyai data yang cukup untuk mengoptimumkan perbelanjaan iklan ke arah kempen yang menghasilkan bukan sahaja perbualan, tetapi hasil jualan yang ditutup.

Ketahui Lebih Lanjut

• Persediaan funnel chat iklan Meta ke WhatsApp dari hujung ke hujung
• Automasi penghalaan lead untuk lead yang ditangkap melalui chat
• Bagaimana kematian borang kenalan sedang membentuk semula penangkapan lead
• Automasi aliran kerja CRM untuk pasukan ops
• Mengukur prestasi chat funnel: metrik yang penting
• Persediaan Respond.io dengan HubSpot dari hujung ke hujung