Webhookien avulla Smartsupp lähettää reaaliaikaisia ilmoituksia valitsemaasi URL-osoitteeseen — heti kun keskustelu avautuu, kontakti luodaan tai viesti toimitetaan, järjestelmäsi tietää siitä. Tämä artikkeli selittää, mitä webhookit ovat, miten ne määritetään hallintapaneelissa ja miten ne yhdistetään automaatioalustoihin kuten Make ja n8n.
Olemme jakaneet artikkelin muutamaan osioon:
Mihin webhookit sopivat?
Webhook on automaattinen HTTP-viesti, jonka Smartsupp lähettää valitsemaasi URL-osoitteeseen aina, kun valittu tapahtuma tapahtuu. Muutosten kyselyn sijaan työkalusi saavat tiedot heti, kun jotain tapahtuu.
Tyypillisiä käyttötapauksia:
Automaatioalustat — käynnistä työnkulkuja Makessa, n8n:ssä tai vastaavissa työkaluissa: kontaktien lisäys CRM:ään, ilmoitukset Slackiin, liidien kirjaus taulukkoon
Sisäiset järjestelmät — syötä keskustelu- ja kontaktitiedot reaaliajassa hallintanäkymiin, tietovarastoihin tai tikettijärjestelmiin
Ilmoitukset — hälytä tiimisi, kun keskustelu arvioidaan tai viestin toimitus epäonnistuu
Vinkki: Webhookit ovat käytettävissä Plus-paketista alkaen — Plus sisältää 1 webhookin, Expert 3 ja Ultimate tarjoaa mukautetun rajan. Vertaile paketteja →
Luo webhook
Webhookin määrittäminen vie vain muutaman vaiheen Smartsuppin hallintapaneelissa:
1. Avaa Settings ja siirry Webhooks-osioon.
2. Klikkaa lisätäksesi uuden webhookin ja syötä endpoint-URL — osoite, johon Smartsupp lähettää tapahtumatiedot.
3. Valitse tapahtumat, jotka haluat vastaanottaa (täydellinen lista seuraavassa osiossa).
4. Tallenna webhook. Tästä lähtien valitut tapahtumat toimitetaan HTTP POST -pyyntöinä JSON-sisällöllä.
Huomio: Aiemmin määritetyt webhookit toimivat edelleen normaalisti. Työskentelemme sen eteen, että kaikki olemassa olevat webhookit näkyvät ja ovat hallittavissa uudessa hallintapaneelin osiossa.
Käytettävissä olevat tapahtumat
Smartsupp voi ilmoittaa endpointillesi tapahtumista kolmessa kategoriassa. Valitse vain ne tapahtumat, joita työnkulkusi todella tarvitsee — näin endpoint pysyy kevyenä ja vältät turhan liikenteen.
Kontaktit
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Keskustelut
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Kävijät
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Aiheeseen liittyvät resurssit: Smartsuppin kehittäjädokumentaatio — täydelliset JSON-payload-skeemat jokaiselle tapahtumatyypille.
Testaa webhookisi
Ennen käyttöönottoa varmista sisäänrakennetulla testitoiminnolla, että endpointtisi on tavoitettavissa ja Make- tai n8n-skenaariosi on määritetty oikein.
Klikkaa hallintapaneelin webhook-asetuksissa Send test. Smartsupp lähettää malli-payloadin endpoint-URL-osoitteeseesi. Tarkista vastaanottavasta palvelusta, että tiedot saapuivat odotetussa muodossa.
Vinkki: Makessa skenaarion on oltava aktiivinen ja kuuntelemassa ennen testin lähettämistä. n8n:ssä vaihda Webhook-solmu production-URL-osoitteeseen ja varmista, että työnkulku on aktiivinen.
Toimitus, uudelleenyritykset ja turvallisuus
Smartsupp on suunniteltu toimittamaan webhook-tapahtumat luotettavasti myös silloin, kun endpointtisi on tilapäisesti tavoittamattomissa.
Muoto — kaikki tapahtumat lähetetään HTTP POST -pyyntöinä, joiden JSON-runko kuvaa tapahtuman ja sen tiedot
Vastaus — endpointin tulee vastata 2xx HTTP -tilakoodilla mahdollisimman nopeasti; hitaat vastaukset voivat viivästyttää uudelleenyrityksiä
Uudelleenyritykset — jos toimitus epäonnistuu, Smartsupp yrittää uudelleen kasvavin väliajoin jopa 3 päivän ajan
Automaattinen poiskytkentä — jatkuvasti epäonnistuvat endpointit poistetaan käytöstä automaattisesti; voit ottaa ne uudelleen käyttöön hallintapaneelista milloin tahansa
Turvallisuus — jokainen webhook-pyyntö on allekirjoitettu, jotta voit varmistaa sen tulevan aidosti Smartsuppilta; katso docs.smartsupp.com allekirjoituksen varmistamisen tiedot
Huomio: Jos endpointtisi poistetaan käytöstä toistuvien virheiden vuoksi, ota se uudelleen käyttöön kohdassa Settings → Webhooks ongelman korjaamisen jälkeen. Smartsupp jatkaa tapahtumien lähettämistä heti.
Yhdistä Smartsupp Makeen tai n8n:ään
Smartsuppin yhdistäminen automaatioalustaan vie neljä vaihetta. Prosessi on sama Makelle ja n8n:lle — vain trigger-solmu eroaa.
1. Lisää Makessa Webhooks → Custom webhook -triggeri ja kopioi luotu URL. Lisää n8n:ssä Webhook-trigger-solmu ja kopioi sen production-URL.
2. Siirry Smartsuppissa kohtaan Settings → Webhooks, luo uusi webhook ja liitä kopioitu URL.
3. Valitse tarvitsemasi tapahtumat ja tallenna webhook.
4. Klikkaa Send test, jotta Make tai n8n tallentaa tietorakenteen — rakenna sitten loput skenaariosta sen päälle.
Vinkki: Aktivoi Makessa skenaariosi ennen testin lähettämistä — muuten webhook-tietoja ei tallenneta. Käytä n8n:ssä production-URL-osoitetta (ei testi-URL:ää) Smartsupp-webhookia määrittäessäsi.
Mitä seuraavaksi?
Smartsupp REST API — tutustu koko API:in Smartsupp-tietojen ohjelmalliseen lukemiseen ja kirjoittamiseen.
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 muuhun.
💡 Tarvitsetko lisää apua? Ota yhteyttä tukitiimiimme — autamme mielellämme!