Jurnalizați mesajele WhatsApp în HubSpot de pe un număr Coexistence

Cum ajunge un mesaj WhatsApp pe un contact HubSpot?

În trei pași. Meta livrează mesajul la destinația webhook-ului setată pentru număr, care aici este un nod Webhook din n8n. Workflow-ul caută în HubSpot un contact cu numărul de telefon al expeditorului și creează unul dacă nu există nicio potrivire. Apoi creează o înregistrare de comunicare cu textul mesajului și o asociază cu acel contact.

HubSpot a creat obiectul Communications tocmai pentru acest caz. Acesta reprezintă un mesaj pe WhatsApp, LinkedIn sau SMS, trimis sau primit în afara HubSpot, și apare în cronologia înregistrării ca un apel sau un e-mail jurnalizat. Proprietățile obligatorii sunt tipul canalului, hs_communication_logged_from setat la CRM, conținutul, un proprietar și un moment de timp.

Nimic din toate acestea nu cere o aplicație din marketplace-ul HubSpot. Nodul HTTP Request din n8n poate refolosi credențialul HubSpot pe care l-ați configurat deja pentru nodul HubSpot, iar apelul este un singur POST pe mesaj.

{
  "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"
  }
}

Se jurnalizează și mesajele scrise de pe telefon?

Da, și aici contribuie un număr Coexistence. Când cineva din echipă răspunde din aplicația WhatsApp Business, Meta trimite un echo al acelui mesaj de ieșire la aceeași destinație a webhook-ului. Un workflow care tratează atât mesajele primite, cât și echo-urile scrie ambele părți ale conversației în cronologie, așa că un agent de vânzări care deschide contactul în HubSpot vede ce a întrebat clientul și ce a răspuns magazinul.

Ramificați după câmpul webhook-ului. Mesajele primite sosesc sub messages, iar răspunsurile de pe telefon sosesc sub smb_message_echoes. Jurnalizați-le pe primele ca primite și pe celelalte ca trimise, iar cronologia se citește în ordine.

Răspunsurile pe care workflow-ul le trimite el însuși prin Cloud API îi sunt deja cunoscute, deci jurnalizați-le în momentul trimiterii, fără să așteptați un webhook.

Dar canalul de inbox WhatsApp al HubSpot?

Aceea este o integrare diferită. Inbox-ul de conversații HubSpot conectează un număr WhatsApp direct la HubSpot, iar baza lor de cunoștințe spune că numărul nu trebuie să fie conectat la o altă integrare WhatsApp. Este disponibil în Marketing Hub sau Service Hub Professional și Enterprise.

Un număr conectat prin EasyCoexistence funcționează invers: Meta trimite webhook-urile către un URL pe care îl dețineți dumneavoastră, iar HubSpot primește înregistrările prin API. Conversația primește răspuns de pe telefon sau de la workflow, iar HubSpot este sistemul de evidență care păstrează istoricul pe contact, deal sau tichet.

Apelul cere un scope de scriere pentru contacte pe aplicația privată sau credențialul care îl face, același scope de care workflow-ul are oricum nevoie ca să creeze contactul.

Cum potrivește workflow-ul un expeditor cu un contact?

După numărul de telefon, normalizat înainte de căutare. Meta trimite expeditorul ca cifre cu prefixul de țară și fără semnul plus, de exemplu 14155550188. Contactele HubSpot sunt introduse manual, deci aceeași persoană poate fi salvată ca +1 415 555 0188 sau (415) 555-0188.

Modelul fiabil este să păstrați o proprietate dedicată a contactului, cu numărul doar din cifre, să o completați când workflow-ul creează un contact și să căutați după ea. Căutarea directă în câmpul liber de telefon funcționează pentru contactele create de workflow și ratează multe dintre cele create de o persoană, ceea ce produce duplicate.

Când o căutare nu returnează nimic, creați contactul cu numele de profil din payload-ul webhook-ului ca prenume și cu numărul doar din cifre în ambele câmpuri. O persoană poate să îl unească sau să îl redenumească mai târziu, iar conversația este deja atașată.

Greșeli frecvente

• Jurnalizarea doar a mesajelor primite. Cronologia arată atunci întrebări fără răspunsuri, pentru că răspunsurile scrise pe telefon sosesc ca evenimente smb_message_echoes.
• Lăsarea lui hs_communication_logged_from nesetat. HubSpot cere ca valoarea să fie CRM la crearea unei comunicări prin API.
• Căutarea contactelor în câmpul brut de telefon. Formatul Meta, doar cifre, se potrivește rar cu ce a tastat o persoană, iar fiecare ratare creează un contact duplicat.

Întrebări frecvente

Continuați să citiți