Prijeđite na glavni sadržaj

Webhookovi — povežite Smartsupp s Makeom, n8n-om i vlastitim alatima

Postavite webhookove izravno u nadzornoj ploči i primajte obavijesti u stvarnom vremenu o razgovorima, kontaktima i posjetiteljima u Makeu, n8n-u ili vlastitom sustavu.

Webhookovi omogućuju Smartsuppu slanje obavijesti u stvarnom vremenu na URL po vašem izboru — u trenutku kada se razgovor otvori, kontakt kreira ili poruka isporuči, vaš sustav to zna. Ovaj članak objašnjava što su webhookovi, kako ih postaviti u nadzornoj ploči i kako ih povezati s platformama za automatizaciju poput Makea i n8n-a.

Članak smo podijelili u nekoliko odjeljaka:

Čemu služe webhookovi?

Webhook je automatska HTTP poruka koju Smartsupp šalje na URL po vašem izboru kad god se dogodi odabrani događaj. Umjesto stalnog provjeravanja promjena, vaši alati dobivaju podatke u trenutku kada se nešto dogodi.

Tipični primjeri korištenja:

  • Platforme za automatizaciju — pokrenite tijekove rada u Makeu, n8n-u ili sličnim alatima: dodavanje kontakata u CRM, obavijesti u Slack, bilježenje leadova u tablicu

  • Interni sustavi — šaljite podatke o razgovorima i kontaktima u stvarnom vremenu u nadzorne ploče, skladišta podataka ili sustave za tickete

  • Obavijesti — obavijestite svoj tim kada se razgovor ocijeni ili isporuka poruke ne uspije

Savjet: Webhookovi su dostupni od plana Plus naviše — Plus uključuje 1 webhook, Expert 3, a Ultimate nudi prilagođeni limit. Usporedite planove →

Kreirajte webhook

Postavljanje webhooka traje samo nekoliko koraka u Smartsupp nadzornoj ploči:

  • 1. Otvorite Settings i idite u odjeljak Webhooks.

  • 2. Kliknite za dodavanje novog webhooka i unesite svoj endpoint URL — adresu na koju će Smartsupp slati podatke o događajima.

  • 3. Odaberite događaje koje želite primati (potpuni popis je u sljedećem odjeljku).

  • 4. Spremite webhook. Od tog trenutka odabrani događaji isporučuju se kao HTTP POST zahtjevi s JSON sadržajem.

Napomena: Ranije postavljeni webhookovi i dalje rade normalno. Radimo na tome da svi postojeći webhookovi postanu vidljivi i upravljivi iz novog odjeljka nadzorne ploče.

Dostupni događaji

Smartsupp može obavještavati vaš endpoint o događajima u tri kategorije. Odaberite samo događaje koje vaš tijek rada stvarno treba — tako endpoint ostaje lagan i izbjegavate nepotreban promet.

Kontakti

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Razgovori

  • 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

Posjetitelji

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Povezani resursi: Smartsupp dokumentacija za developere — potpune JSON sheme payloada za svaki tip događaja.

Testirajte svoj webhook

Prije pokretanja upotrijebite ugrađenu testnu funkciju kako biste provjerili da je endpoint dostupan i da je vaš Make ili n8n scenarij ispravno postavljen.

U postavkama webhooka u nadzornoj ploči kliknite Send test. Smartsupp će poslati ogledni payload na vaš endpoint URL. Provjerite u servisu koji prima podatke da su stigli u očekivanom formatu.

Savjet: U Makeu vaš scenarij mora biti aktivan i slušati prije slanja testa. U n8n-u prebacite Webhook čvor na production URL i provjerite da je tijek rada aktivan.

Isporuka, ponovni pokušaji i sigurnost

Smartsupp je dizajniran za pouzdanu isporuku webhook događaja, čak i kada je vaš endpoint privremeno nedostupan.

  • Format — svi događaji šalju se kao HTTP POST zahtjevi s JSON tijelom koje opisuje događaj i njegove podatke

  • Odgovor — vaš endpoint treba odgovoriti 2xx HTTP statusnim kodom što je brže moguće; spori odgovori mogu odgoditi ponovne pokušaje

  • Ponovni pokušaji — ako isporuka ne uspije, Smartsupp pokušava ponovno s rastućim razmacima do 3 dana

  • Automatsko isključivanje — endpointi koji trajno ne uspijevaju automatski se isključuju; možete ih ponovno uključiti u nadzornoj ploči u bilo kojem trenutku

  • Sigurnost — svaki webhook zahtjev je potpisan kako biste mogli provjeriti da stvarno dolazi od Smartsuppa; pogledajte docs.smartsupp.com za detalje provjere potpisa

Napomena: Ako se vaš endpoint isključi zbog ponovljenih pogrešaka, ponovno ga uključite u Settings → Webhooks nakon što otklonite problem. Smartsupp će odmah nastaviti slati događaje.

Povežite Smartsupp s Makeom ili n8n-om

Povezivanje Smartsuppa s platformom za automatizaciju traje četiri koraka. Postupak je isti za Make i n8n — razlikuje se samo trigger čvor.

  • 1. U Makeu dodajte Webhooks → Custom webhook trigger i kopirajte generirani URL. U n8n-u dodajte Webhook trigger čvor i kopirajte njegov production URL.

  • 2. U Smartsuppu idite na Settings → Webhooks, kreirajte novi webhook i zalijepite kopirani URL.

  • 3. Odaberite potrebne događaje i spremite webhook.

  • 4. Kliknite Send test kako bi Make ili n8n uhvatio strukturu podataka — zatim na njoj izgradite ostatak scenarija.

Savjet: U Makeu aktivirajte scenarij prije slanja testa — inače podaci webhooka neće biti uhvaćeni. U n8n-u koristite production URL (ne testni) pri postavljanju Smartsupp webhooka.

Što dalje?

  • Smartsupp REST API — istražite cijeli API za programsko čitanje i pisanje Smartsupp podataka.

  • Automatizacije — postavite automatizacije temeljene na pravilima koje se pokreću izravno u Smartsuppu bez vanjskog alata.

  • Pregled integracija — pogledajte sve dostupne native integracije s CRM-ovima, e-commerce platformama i više.

💡 Trebate još pomoći? Kontaktirajte naš tim za podršku — rado ćemo pomoći!

Jesmo li odgovorili na vaše pitanje?