Kirjaa WhatsApp-viestit HubSpotiin Coexistence-numerosta

Miten WhatsApp-viesti päätyy HubSpotin kontaktille?

Kolmessa vaiheessa. Meta toimittaa viestin numerolle asettamaasi webhook-kohteeseen, joka tässä on n8n:n Webhook-solmu. Työnkulku hakee HubSpotista kontaktin, jolla on lähettäjän puhelinnumero, ja luo uuden, jos osumaa ei löydy. Sen jälkeen se luo communication-tietueen viestin tekstillä ja liittää sen kontaktiin.

HubSpot rakensi Communications-objektin juuri tähän tarkoitukseen. Se kuvaa WhatsAppissa, LinkedInissä tai tekstiviestillä HubSpotin ulkopuolella lähetettyä tai vastaanotettua viestiä, ja se näkyy tietueen aikajanalla kuten kirjattu puhelu tai sähköposti. Pakolliset ominaisuudet ovat kanavatyyppi, hs_communication_logged_from arvolla CRM, viestin sisältö (body), omistaja ja aikaleima.

Tähän ei tarvita HubSpotin marketplace-sovellusta. n8n:n HTTP-pyyntösolmu voi käyttää samoja HubSpot-tunnuksia, jotka olet jo määrittänyt HubSpot-solmua varten, ja kutsu on yksi POST viestiä kohden.

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

Kirjautuvatko myös puhelimella kirjoitetut viestit?

Kirjautuvat, ja juuri tämän Coexistence-numero tuo mukanaan. Kun joku tiimistä vastaa WhatsApp Business -sovelluksesta, Meta lähettää kaiun tästä lähtevästä viestistä samaan webhook-kohteeseen. Työnkulku, joka käsittelee sekä saapuvat viestit että kaiut, kirjoittaa keskustelun molemmat puolet aikajanalle. Myyjä, joka avaa kontaktin HubSpotissa, näkee sekä asiakkaan kysymyksen että myymälän vastauksen.

Haaroita työnkulku webhookin kentän mukaan. Saapuvat viestit tulevat kentässä messages ja puhelimesta lähetetyt vastaukset kentässä smb_message_echoes. Kirjaa ensimmäiset vastaanotetuiksi ja jälkimmäiset lähetetyiksi, niin aikajana etenee oikeassa järjestyksessä.

Vastaukset, jotka työnkulku itse lähettää Cloud API -rajapinnan kautta, se tietää jo, joten kirjaa ne lähetyshetkellä odottamatta webhookia.

Entä HubSpotin oma WhatsApp-saapuneet-kanava?

Se on eri integraatio. HubSpotin keskustelujen saapuneet-näkymä yhdistää WhatsApp-numeron suoraan HubSpotiin, ja sen tietopankin mukaan numeroa ei saa olla yhdistetty toiseen WhatsApp-integraatioon. Kanava on saatavilla Marketing Hubin tai Service Hubin Professional- ja Enterprise-tasoilla.

EasyCoexistencen kautta yhdistettyyn numeroon päästään toista reittiä: Meta ohjaa webhookit omistamaasi URL-osoitteeseen, ja HubSpot vastaanottaa tietueet API:n kautta. Keskusteluun vastataan puhelimesta tai työnkulustasi, ja HubSpot toimii ensisijaisena tietolähteenä, joka säilyttää historian kontaktin, kaupan tai tukipyynnön yhteydessä.

Kutsu vaatii contacts-kirjoitusoikeuden (scope) yksityiseen sovellukseen tai tunnukseen, jolla kutsu tehdään. Se on sama oikeus, jota työnkulku tarvitsee jo kontaktin luomiseen.

Miten työnkulun tulisi yhdistää lähettäjä kontaktiin?

Puhelinnumeron perusteella, normalisoituna ennen hakua. Meta lähettää lähettäjän numeron pelkkinä numeroina maatunnuksen kanssa ilman plusmerkkiä, esimerkiksi 14155550188. HubSpotin kontaktit syötetään käsin, joten sama henkilö voi olla tallennettuna muodossa +1 415 555 0188 tai (415) 555-0188.

Luotettava tapa on pitää erillistä kontaktin ominaisuutta, johon tallennetaan numero pelkkinä numeroina, täyttää se, kun työnkulku luo kontaktin, ja hakea tämän ominaisuuden perusteella. Hakeminen suoraan vapaatekstisestä puhelinkentästä toimii työnkulun luomille kontakteille mutta ohittaa monet ihmisen luomat, mikä tuottaa kaksoiskappaleita.

Jos haku ei palauta mitään, luo kontakti käyttämällä webhookin payloadin profiilinimeä etunimenä ja pelkkinä numeroina kirjoitettua numeroa molemmissa kentissä. Ihminen voi yhdistää tai nimetä kontaktin uudelleen myöhemmin, ja keskustelu on jo liitetty siihen.

Yleiset virheet

• Vain saapuvien viestien kirjaaminen. Aikajanalla näkyy silloin kysymyksiä ilman vastauksia, koska puhelimella kirjoitetut vastaukset tulevat smb_message_echoes-tapahtumina.
• hs_communication_logged_from -kentän jättäminen asettamatta. HubSpot vaatii arvoksi CRM, kun communication luodaan API:n kautta.
• Kontaktien hakeminen raa'asta puhelinkentästä. Metan pelkkien numeroiden muoto harvoin vastaa sitä, mitä ihminen on kirjoittanut, ja jokainen ohi mennyt haku luo kaksoiskontaktin.

Usein kysytyt kysymykset

Lue lisää