Catat pesan WhatsApp di HubSpot dari nomor Coexistence

Bagaimana pesan WhatsApp bisa masuk ke kontak HubSpot?

Dalam tiga langkah. Meta mengirim pesan ke tujuan webhook yang Anda atur untuk nomor tersebut, yang di sini berupa node Webhook n8n. Workflow mencari kontak di HubSpot berdasarkan nomor telepon pengirim dan membuat kontak baru jika tidak ada yang cocok. Setelah itu workflow membuat rekaman komunikasi berisi teks pesan dan mengaitkannya dengan kontak tersebut.

HubSpot membuat objek Communications untuk kasus ini. Objek itu mewakili pesan di WhatsApp, LinkedIn, atau SMS yang dikirim atau diterima di luar HubSpot, dan tampil di linimasa rekaman seperti panggilan atau email yang dicatat. Properti wajibnya adalah tipe saluran, hs_communication_logged_from yang diatur ke CRM, isi pesan, pemilik, dan stempel waktu.

Semua ini tidak memerlukan aplikasi dari marketplace HubSpot. Node HTTP di n8n dapat memakai ulang kredensial HubSpot yang sudah Anda siapkan untuk node HubSpot, dan panggilannya hanya satu POST per pesan.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

Apakah pesan yang diketik di ponsel juga ikut dicatat?

Bisa, dan inilah yang ditambahkan oleh nomor Coexistence. Saat seseorang di tim membalas dari aplikasi WhatsApp Business, Meta mengirim echo dari pesan keluar itu ke tujuan webhook yang sama. Workflow yang menangani pesan masuk sekaligus echo akan menulis kedua sisi percakapan ke linimasa, sehingga tenaga penjual yang membuka kontak di HubSpot melihat apa yang ditanyakan pelanggan dan apa jawaban toko.

Pisahkan alurnya berdasarkan field webhook. Pesan masuk datang di bawah messages dan balasan dari ponsel datang di bawah smb_message_echoes. Catat yang pertama sebagai diterima dan yang kedua sebagai terkirim, maka linimasa akan berurutan.

Balasan yang dikirim workflow sendiri lewat Cloud API sudah diketahui olehnya, jadi catat saat pengiriman, tanpa menunggu webhook.

Bagaimana dengan saluran kotak masuk WhatsApp milik HubSpot sendiri?

Itu integrasi yang berbeda. Kotak masuk percakapan HubSpot menghubungkan nomor WhatsApp ke HubSpot itu sendiri, dan basis pengetahuannya menyatakan bahwa nomor tersebut tidak boleh terhubung ke integrasi WhatsApp lain. Fitur ini tersedia di Marketing Hub atau Service Hub Professional dan Enterprise.

Nomor yang terhubung lewat EasyCoexistence dijangkau dengan cara lain: Meta mengarahkan webhook ke URL milik Anda, dan HubSpot menerima rekaman lewat API-nya. Percakapan dijawab dari ponsel atau oleh workflow Anda, dan HubSpot menjadi sistem pencatatan yang menyimpan riwayatnya pada kontak, deal, atau tiket.

Panggilan ini membutuhkan scope tulis kontak pada aplikasi privat atau kredensial yang menjalankannya, yaitu scope yang sama yang sudah dibutuhkan workflow untuk membuat kontak.

Bagaimana workflow sebaiknya mencocokkan pengirim dengan kontak?

Berdasarkan nomor telepon, yang dinormalisasi sebelum pencarian. Meta mengirim pengirim sebagai angka dengan kode negara tanpa tanda plus, misalnya 14155550188. Kontak HubSpot diketik manual, jadi orang yang sama bisa tersimpan sebagai +1 415 555 0188 atau (415) 555-0188.

Pola yang andal adalah menyediakan satu properti kontak khusus yang berisi nomor hanya angka, mengisinya saat workflow membuat kontak, dan mencari berdasarkan properti itu. Mencari langsung di field telepon teks bebas berhasil untuk kontak yang dibuat workflow, tetapi melewatkan banyak kontak yang dibuat orang, sehingga muncul duplikat.

Saat pencarian tidak menemukan apa pun, buat kontak dengan nama profil dari payload webhook sebagai nama depan dan nomor hanya angka di kedua field. Seseorang dapat menggabungkan atau mengganti namanya nanti, dan percakapannya sudah terlampir.

Kesalahan umum

• Hanya mencatat pesan masuk. Linimasa lalu menampilkan pertanyaan tanpa jawaban, karena balasan yang diketik di ponsel datang sebagai event smb_message_echoes.
• Membiarkan hs_communication_logged_from tidak diatur. HubSpot mewajibkan nilainya CRM saat membuat komunikasi lewat API.
• Mencari kontak pada field telepon mentah. Format hanya angka dari Meta jarang cocok dengan yang diketik orang, dan setiap pencarian yang meleset membuat kontak duplikat.

Pertanyaan yang sering diajukan

Lanjut membaca