Siirry pääsisältöön

Webhookit: yhdistä Smartsupp Makeen, n8n:ään ja omiin työkaluihisi

Reaaliaikaiset tapahtumailmoitukset Smartsuppista mihin tahansa URL-osoitteeseen — määritä webhookit, valitse tapahtumat ja yhdistä Makeen tai n8n:ään muutamassa minuutissa.

Tekijä: Michal Jindra

Webhookien avulla Smartsupp voi lähettää reaaliaikaisia ilmoituksia valitsemaasi URL-osoitteeseen — järjestelmäsi saa tiedon heti, kun keskustelu avataan, yhteystieto luodaan tai viesti toimitetaan. Tässä artikkelissa kerrotaan, mitä webhookit ovat, miten määrität ne hallintapaneelissa ja miten yhdistät ne automaatioalustoihin, kuten Makeen ja n8n:ään.

Olemme jakaneet artikkelin muutamaan osioon:

Mihin webhookeja voi käyttää?

Webhook on automaattinen HTTP-viesti, jonka Smartsupp lähettää valitsemaasi URL-osoitteeseen aina, kun valittu tapahtuma toteutuu. Sen sijaan, että työkalusi tarkistaisivat muutoksia toistuvilla kyselyillä, tiedot lähetetään niille heti, kun jotain tapahtuu.

Tyypillisiä käyttötapauksia ovat:

  • Automaatioalustat — käynnistä työnkulkuja Makessa, n8n:ssä tai vastaavissa työkaluissa lisätäksesi yhteystietoja CRM:ään, lähettääksesi ilmoituksia Slackiin tai kirjataksesi liidejä laskentataulukkoon

  • Sisäiset järjestelmät — siirrä keskustelu- ja yhteystietoja hallintapaneeleihin, tietovarastoihin tai tukipyyntöjärjestelmiin reaaliajassa

  • Ilmoitukset — ilmoita tiimillesi, kun keskusteluja arvioidaan tai viestin toimitus epäonnistuu

Vinkki: Webhookit ovat saatavilla Plus-paketissa ja sitä ylemmissä paketeissa — Plus sisältää 1 webhookin, Expert sisältää 3 ja Ultimate tarjoaa mukautetun rajan. Vertaa paketteja →

Luo webhook

Webhookin määrittäminen Smartsuppin hallintapaneelissa onnistuu muutamassa vaiheessa:

  • 1. Avaa Asetukset Ja siirry Webhookit -osioon.

  • 2. Lisää uusi webhook napsauttamalla ja syötä Päätepisteen URL-osoite — osoite, johon Smartsupp lähettää tapahtumatiedot.

  • 3. Valitse Tapahtumat Jotka haluat vastaanottaa (katso koko luettelo seuraavasta osiosta).

  • 4. Tallenna webhook. Siitä lähtien valitut tapahtumat toimitetaan HTTP POST -pyyntöinä, joiden hyötykuorma on JSON-muodossa.

Huomautus: Aiemmin määritetyt webhookit toimivat edelleen normaalisti. Pyrimme tuomaan kaikki nykyiset webhookit näkyviin ja hallittaviksi hallintapaneelin uuteen osioon.

⚠️ Oletko luonut webhookeja aiemmin? Vanhemmat webhookit eivät vielä näy tässä osiossa — ne toimivat edelleen kuten ennenkin. Yhdistämme vanhan ja uuden järjestelmän, jotta kaikkea voi hallita yhdessä paikassa.

Saatavilla olevat tapahtumat

Smartsupp voi ilmoittaa päätepisteellesi kolmen eri luokan tapahtumista. Valitse vain tapahtumat, joita työnkulkusi todella tarvitsee — näin päätepisteesi kuormitus pysyy kevyenä ja vältät tarpeettoman liikenteen.

Yhteystiedot

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Keskustelut

  • conversation.opened

  • conversation.closed

  • conversation.closed_by_contact

  • conversation.rated

  • conversation.agent_assigned

  • conversation.agent_unassigned

  • conversation.agent_joined

  • conversation.agent_left

  • conversation.agent_replied

  • conversation.bot_replied

  • conversation.contact_replied

  • conversation.message_delivered

  • conversation.message_delivery_failed

Kävijät

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Aiheeseen liittyvät resurssit: Smartsuppin kehittäjädokumentaatio — täydelliset JSON-hyötykuorman skeemat jokaiselle tapahtumatyypille.

Testaa webhook

Varmista ennen käyttöönottoa sisäänrakennetulla testitoiminnolla, että päätepisteesi on saavutettavissa ja Make- tai n8n-skenaariosi on määritetty oikein.

Napsauta hallintapaneelin webhook-asetuksissa Lähetä testi. Smartsupp lähettää esimerkkihyötykuorman päätepisteesi URL-osoitteeseen. Tarkista vastaanottavasta palvelusta, että tiedot saapuivat odotetussa muodossa.

Vinkki: Makessa skenaariosi on oltava aktiivinen ja vastaanottovalmiudessa ennen testin lähettämistä. Vaihda n8n:ssä Webhook-solmu käyttämään tuotanto-URL-osoitettaan ja varmista, että työnkulku on aktiivinen.

Toimitus, uudelleenyritykset ja tietoturva

Smartsupp on suunniteltu toimittamaan webhook-tapahtumat luotettavasti myös silloin, kun päätepisteesi on tilapäisesti poissa käytöstä.

  • Muoto — kaikki tapahtumat lähetetään HTTP POST -pyyntöinä, joiden JSON-runko kuvaa tapahtuman ja sen tiedot

  • Vastaus — päätepisteesi tulisi vastata HTTP-tilakoodilla 2xx mahdollisimman nopeasti; hitaat vastaukset voivat viivästyttää uudelleenyrityksiä

  • Uudelleenyritykset — jos toimitus epäonnistuu, Smartsupp yrittää uudelleen pitenevin väliajoin enintään 3 päivän ajan

  • Automaattinen käytöstä poistaminen — jatkuvasti epäonnistuvat päätepisteet poistetaan käytöstä automaattisesti; voit ottaa ne uudelleen käyttöön hallintapaneelissa milloin tahansa

  • Tietoturva — jokainen webhook-pyyntö allekirjoitetaan, jotta voit varmistaa sen tulleen aidosti Smartsuppista; katso docs.smartsupp.com -sivustolta allekirjoituksen tarkistamisen tarkemmat ohjeet

Huomautus: Jos päätepisteesi poistetaan käytöstä toistuvien epäonnistumisten vuoksi, ota se uudelleen käyttöön kohdassa Asetukset → Webhookit Kun olet korjannut ongelman syyn. Smartsupp jatkaa tapahtumien lähettämistä välittömästi.

Yhdistä Smartsupp Makeen tai n8n:ään

Smartsuppin yhdistäminen automaatioalustaan onnistuu neljässä vaiheessa. Prosessi on sama Makessa ja n8n:ssä — vain käynnistyssolmu on erilainen.

  • 1. Avaa Make, lisää Webhookit → Mukautettu webhook -käynnistin ja kopioi luotu URL-osoite. Avaa n8n, lisää Webhook -käynnistyssolmu ja kopioi sen tuotanto-URL-osoite.

  • 2. Siirry Smartsuppissa kohtaan Asetukset → Webhookit, luo uusi webhook ja liitä kopioitu URL-osoite.

  • 3. Valitse tarvitsemasi tapahtumat ja tallenna webhook.

  • 4. Napsauta Lähetä testi Jotta Make tai n8n tallentaa tietorakenteen — rakenna sitten loput skenaariostasi tai työnkulustasi sen pohjalta.

Vinkki: Aktivoi Makessa skenaariosi ennen testin lähettämistä — muuten webhook-tietoja ei tallenneta. Käytä n8n:ssä Tuotanto- URL-osoitetta (ei testin URL-osoitetta), kun määrität Smartsuppin webhookin.

Mitä seuraavaksi?

  • Smartsupp REST API — tutustu koko API:in, jonka avulla voit lukea ja kirjoittaa Smartsuppin tietoja ohjelmallisesti.

  • Automaatiot — määritä sääntöpohjaisia automaatioita, jotka käynnistyvät suoraan Smartsuppissa ilman ulkoista työkalua.

  • Integraatioiden yleiskatsaus — katso kaikki saatavilla olevat natiivit integraatiot CRM-järjestelmiin, verkkokauppa-alustoihin ja muihin palveluihin.

💡 Tarvitsetko lisää apua? Ota yhteyttä Tukitiimiimme — autamme mielellämme!

Aiheeseen liittyvät artikkelit
Vastasiko tämä kysymykseesi?