רישום הודעות WhatsApp ב-HubSpot ממספר Coexistence

איך ב-HubSpot נרשמת הודעת WhatsApp על איש קשר?

בשלושה שלבים. Meta שולחת את ההודעה ליעד הוובהוק (Webhook) שהגדרתם למספר, ובמקרה שלנו זה צומת Webhook ב-n8n. תהליך העבודה מחפש ב-HubSpot איש קשר עם מספר הטלפון של השולח, ויוצר אחד אם אין התאמה. אחר כך הוא יוצר רשומת communication עם טקסט ההודעה ומשייך אותה לאיש הקשר הזה.

HubSpot בנתה את אובייקט Communications בדיוק למקרה הזה. הוא מייצג הודעה ב-WhatsApp, ב-LinkedIn או ב-SMS שנשלחה או התקבלה מחוץ ל-HubSpot, ומופיע בציר הזמן של הרשומה כמו שיחה או אימייל שנרשמו ידנית. המאפיינים הנדרשים: סוג הערוץ, hs_communication_logged_from עם הערך CRM, גוף ההודעה, בעלים וחותמת זמן.

שום דבר מזה לא דורש אפליקציה משוק HubSpot. צומת HTTP Request ב-n8n יכול להשתמש באותם פרטי הגישה שכבר הגדרתם עבור צומת HubSpot, והקריאה היא POST אחד לכל הודעה.

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

האם גם הודעות שנכתבו בטלפון נרשמות?

כן, וזה מה שמספר Coexistence מוסיף. כשמישהו בצוות עונה מאפליקציית WhatsApp Business, Meta שולחת הד של ההודעה היוצאת לאותו יעד וובהוק. תהליך עבודה שמטפל גם בהודעות נכנסות וגם בהדים רושם את שני צדי השיחה בציר הזמן, כך שאיש מכירות שפותח את איש הקשר ב-HubSpot רואה מה הלקוח שאל ומה החנות ענתה.

מפצלים לפי השדה בוובהוק. הודעות נכנסות מגיעות תחת messages, ותשובות מהטלפון מגיעות תחת smb_message_echoes. רושמים את הראשונות כהתקבלו ואת השניות כנשלחו, וציר הזמן יוצא בסדר הנכון.

תשובות שתהליך העבודה עצמו שולח דרך Cloud API כבר מוכרות לו, לכן רושמים אותן ברגע השליחה ולא מחכים לוובהוק.

מה עם תיבת ההודעות המובנית של HubSpot וערוץ ה-WhatsApp שלה?

זו אינטגרציה אחרת. תיבת השיחות של HubSpot מחברת מספר WhatsApp ל-HubSpot עצמה, ובמאגר הידע שלה כתוב שאסור שהמספר יהיה מחובר לאינטגרציית WhatsApp אחרת. היא זמינה ב-Marketing Hub או ב-Service Hub ברמות Professional ו-Enterprise.

מספר שמחובר דרך EasyCoexistence עובד בכיוון ההפוך: Meta מנתבת את הוובהוקים שלו לכתובת URL שבבעלותכם, ו-HubSpot מקבלת רשומות דרך ה-API שלה. עונים על השיחה מהטלפון או מתהליך העבודה שלכם, ו-HubSpot היא מערכת הרישום שמחזיקה את ההיסטוריה על איש הקשר, העסקה או הפנייה.

הקריאה דורשת הרשאת כתיבה לאנשי קשר באפליקציה הפרטית או בפרטי הגישה שמבצעים אותה, וזו אותה הרשאה שתהליך העבודה צריך ממילא כדי ליצור את איש הקשר.

איך תהליך העבודה צריך להתאים שולח לאיש קשר?

לפי מספר הטלפון, אחרי נרמול לפני החיפוש. Meta שולחת את השולח כספרות עם קידומת המדינה וללא פלוס, למשל 14155550188. אנשי קשר ב-HubSpot מוקלדים ידנית, ולכן אותו אדם עשוי להיות שמור בפורמט +1 415 555 0188, בפורמט (415) 555-0188 או בצורה אחרת.

הדרך האמינה היא לשמור מאפיין ייעודי של איש קשר עם המספר בספרות בלבד, למלא אותו כשתהליך העבודה יוצר איש קשר, ולחפש לפיו. חיפוש ישיר בשדה הטלפון הרגיל עובד על אנשי קשר שהתהליך יצר ופוסח על רבים שאדם יצר, וכך נוצרות כפילויות.

כשהחיפוש לא מחזיר דבר, יוצרים איש קשר עם שם הפרופיל מה-payload של הוובהוק כשם פרטי ועם המספר בספרות בלבד בשני השדות. אפשר למזג או לשנות שם אחר כך, והשיחה כבר מצורפת.

טעויות נפוצות

• רישום הודעות נכנסות בלבד. ציר הזמן מראה שאלות בלי תשובות, כי אירועי smb_message_echoes הם התשובות שהוקלדו בטלפון.
• השארת hs_communication_logged_from ללא ערך. HubSpot דורשת שהוא יהיה CRM כשיוצרים רשומת תקשורת דרך ה-API, ולכן חובה למלא אותו.
• חיפוש אנשי קשר לפי שדה הטלפון הגולמי. הפורמט של Meta, ספרות בלבד, כמעט אף פעם לא תואם למה שאדם הקליד, וכל החמצה יוצרת איש קשר כפול.

שאלות נפוצות

המשיכו לקרוא