Rejestruj wiadomości WhatsApp w HubSpot z numeru Coexistence

Jak wiadomość WhatsApp trafia do kontaktu w HubSpot?

W trzech krokach. Meta dostarcza wiadomość na adres webhooka ustawiony dla numeru, którym tutaj jest węzeł Webhook w n8n. Przepływ szuka w HubSpot kontaktu z numerem telefonu nadawcy, a jeśli nic nie pasuje, tworzy nowy. Następnie tworzy rekord komunikacji z treścią wiadomości i powiązuje go z tym kontaktem.

HubSpot stworzył obiekt Communications właśnie do takich przypadków. Reprezentuje on wiadomość z WhatsApp, LinkedIn lub SMS wysłaną albo odebraną poza HubSpot i pojawia się na osi czasu rekordu tak jak zarejestrowana rozmowa czy e-mail. Wymagane właściwości to typ kanału, hs_communication_logged_from ustawione na CRM, treść, właściciel i znacznik czasu.

Nic z tego nie wymaga aplikacji z marketplace HubSpot. Węzeł HTTP Request w n8n może użyć tych samych danych uwierzytelniających HubSpot, które skonfigurowano już dla węzła HubSpot, a wywołanie to jeden POST na wiadomość.

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

Czy wiadomości wpisane na telefonie też są rejestrowane?

Mogą być i to właśnie dodaje numer Coexistence. Gdy ktoś z zespołu odpowiada z aplikacji WhatsApp Business, Meta wysyła echo tej wychodzącej wiadomości na ten sam adres webhooka. Przepływ obsługujący zarówno wiadomości przychodzące, jak i echa, zapisuje na osi czasu obie strony rozmowy. Handlowiec otwierający kontakt w HubSpot widzi więc, o co zapytał klient i co odpowiedział sklep.

Rozgałęź przepływ według pola webhooka. Wiadomości przychodzące pojawiają się w messages, a odpowiedzi z telefonu w smb_message_echoes. Pierwsze rejestruj jako odebrane, drugie jako wysłane, a oś czasu będzie w poprawnej kolejności.

Odpowiedzi wysyłane przez sam przepływ przez Cloud API są mu już znane, więc zapisuj je w chwili wysłania, zamiast czekać na webhook.

A co z własnym kanałem skrzynki WhatsApp w HubSpot?

To inna integracja. Skrzynka konwersacji HubSpot łączy numer WhatsApp bezpośrednio z HubSpot, a jego baza wiedzy mówi, że numer nie może być połączony z inną integracją WhatsApp. Jest dostępna w Marketing Hub lub Service Hub w wersji Professional i Enterprise.

Numer połączony przez EasyCoexistence działa w drugą stronę: Meta kieruje jego webhooki na adres URL, którego jesteś właścicielem, a HubSpot odbiera rekordy przez swoje API. Na rozmowę odpowiada się z telefonu lub z Twojego przepływu, a HubSpot jest systemem, który przechowuje historię przy kontakcie, szansie sprzedaży lub zgłoszeniu.

Wywołanie wymaga uprawnienia do zapisu kontaktów w aplikacji prywatnej lub w danych uwierzytelniających, którymi się posługuje. To to samo uprawnienie, którego przepływ i tak potrzebuje do utworzenia kontaktu.

Jak przepływ ma dopasować nadawcę do kontaktu?

Według numeru telefonu, znormalizowanego przed wyszukiwaniem. Meta przesyła nadawcę jako cyfry z kodem kraju i bez znaku plus, na przykład 14155550188. Kontakty w HubSpot są wpisywane ręcznie, więc ta sama osoba może być zapisana jako +1 415 555 0188 lub (415) 555-0188.

Najpewniejszy wzorzec to osobna właściwość kontaktu zawierająca sam ciąg cyfr numeru, wypełniana przy tworzeniu kontaktu przez przepływ i używana do wyszukiwania. Szukanie bezpośrednio w polu telefonu z dowolnym tekstem działa dla kontaktów utworzonych przez przepływ, ale pomija wiele tych utworzonych przez ludzi, co powoduje duplikaty.

Gdy wyszukiwanie nic nie zwróci, utwórz kontakt z nazwą profilu z payloadu webhooka jako imieniem i numerem zapisanym samymi cyframi w obu polach. Ktoś może go później scalić lub zmienić nazwę, a rozmowa jest już przypisana.

Typowe błędy

• Rejestrowanie tylko wiadomości przychodzących. Oś czasu pokazuje wtedy pytania bez odpowiedzi, bo odpowiedzi wpisane na telefonie docierają jako zdarzenia smb_message_echoes.
• Pozostawienie hs_communication_logged_from bez wartości. HubSpot wymaga, by przy tworzeniu komunikacji przez API miało ono wartość CRM.
• Wyszukiwanie kontaktów po surowym polu telefonu. Format Meta złożony z samych cyfr rzadko pasuje do tego, co wpisała osoba, a każde chybienie tworzy zduplikowany kontakt.

Najczęściej zadawane pytania

Czytaj dalej