Webhookovi omogućuju aplikaciji Smartsupp slanje obavijesti u stvarnom vremenu na bilo koji URL koji odaberete — čim se otvori razgovor, izradi kontakt ili isporuči poruka, vaš sustav zna za to. Ovaj članak objašnjava što su webhookovi, kako ih postaviti na kontrolnoj ploči i kako ih povezati s platformama za automatizaciju kao što su Make i n8n.

Članak smo podijelili u nekoliko odjeljaka:

Za što su korisni webhookovi?

Webhook je automatska HTTP poruka koju Smartsupp šalje na URL po vašem izboru kad god se dogodi odabrani događaj. Umjesto periodičkog provjeravanja promjena, vaši alati primaju podatke čim se nešto dogodi.

Uobičajeni primjeri primjene uključuju:

Platforme za automatizaciju — pokrećite radne procese u platformama Make, n8n ili sličnim alatima kako biste dodali kontakte u CRM, objavili obavijesti u Slacku ili zabilježili potencijalne kupce u proračunskoj tablici
Interni sustavi — prosljeđujte podatke o razgovorima i kontaktima na kontrolne ploče, u skladišta podataka ili sustave za upravljanje zahtjevima u stvarnom vremenu
Obavijesti — obavijestite svoj tim kada su razgovori ocijenjeni ili kada isporuka poruke ne uspije

Savjet: Webhookovi su dostupni u planu Plus i višim planovima — Plus uključuje 1 webhook, Expert uključuje 3, a Ultimate nudi prilagođeno ograničenje. Usporediti planove →

Izraditi webhook

Postavljanje webhooka zahtijeva samo nekoliko koraka na kontrolnoj ploči u aplikaciji Smartsupp:

1. Otvorite Postavke i prijeđite na odjeljak Webhookovi .
2. Kliknite za dodavanje novog webhooka i unesite URL krajnje točke — adresu na koju će Smartsupp slati podatke o događajima.
3. Odaberite događaje koje želite primati (pogledajte potpuni popis u sljedećem odjeljku).
4. Spremite webhook. Od tog trenutka odabrani događaji isporučuju se kao HTTP POST zahtjevi s podatkovnim sadržajem u formatu JSON.

Napomena: Prethodno konfigurirani webhookovi nastavljaju normalno raditi. U tijeku je rad na tome da svi postojeći webhookovi postanu vidljivi i da se njima može upravljati iz novog odjeljka kontrolne ploče.

⚠️ Već ste ranije izradili webhookove? Stariji webhookovi još se ne prikazuju u ovom odjeljku — nastavljaju raditi kao i prije. Objedinjujemo stari i novi sustav kako biste svime mogli upravljati na jednom mjestu.

Dostupni događaji

Smartsupp može obavještavati vašu krajnju točku o događajima iz tri kategorije. Odaberite samo događaje koji su vašem radnom procesu doista potrebni — tako smanjujete opterećenje krajnje točke 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 programere — potpune sheme podatkovnog sadržaja u formatu JSON za svaku vrstu događaja.

Testirati webhook

Prije početka rada upotrijebite ugrađenu funkciju testiranja kako biste provjerili je li vaša krajnja točka dostupna i je li vaš scenarij u platformi Make ili n8n ispravno postavljen.

U postavkama webhooka na kontrolnoj ploči kliknite Poslati test. Smartsupp će poslati ogledni podatkovni sadržaj na URL vaše krajnje točke. Provjerite uslugu koja prima podatke kako biste potvrdili da su podaci stigli u očekivanom formatu.

Savjet: U platformi Make vaš scenarij mora biti aktivan i osluškivati prije nego što pošaljete test. U platformi n8n prebacite čvor Webhook na njegov produkcijski URL i provjerite je li radni proces aktivan.

Isporuka, ponovni pokušaji i sigurnost

Smartsupp je osmišljen za pouzdanu isporuku događaja putem webhookova, čak i kada je vaša krajnja točka privremeno nedostupna.

Format — svi događaji šalju se kao HTTP POST zahtjevi s tijelom u formatu JSON koje opisuje događaj i njegove podatke
Odgovor — vaša krajnja točka trebala bi što brže odgovoriti HTTP statusnim kodom 2xx; spori odgovori mogu odgoditi ponovne pokušaje
Ponovni pokušaji — ako isporuka ne uspije, Smartsupp pokušava ponovno uz sve dulje razmake tijekom najviše 3 dana
Automatsko onemogućavanje — krajnje točke na kojima se stalno javljaju greške automatski se onemogućuju; možete ih ponovno omogućiti na kontrolnoj ploči u bilo kojem trenutku
Sigurnost — svaki webhook zahtjev potpisan je kako biste mogli provjeriti da doista dolazi iz aplikacije Smartsupp; na stranici docs.smartsupp.com potražite pojedinosti o provjeri potpisa

Napomena: Ako je vaša krajnja točka onemogućena zbog ponovljenih grešaka, ponovno je omogućite u odjeljku Postavke → Webhookovi nakon što riješite uzrok problema. Smartsupp će odmah nastaviti slati događaje.

Povezati Smartsupp s platformom Make ili n8n

Povezivanje aplikacije Smartsupp s platformom za automatizaciju zahtijeva četiri koraka. Postupak je isti za Make i n8n — razlikuje se samo čvor okidača.

1. U platformi Make, dodajte okidač Webhookovi → Prilagođeni webhook i kopirajte generirani URL. U platformi n8n, dodajte čvor Webhook kao okidač i kopirajte njegov produkcijski URL.
2. U aplikaciji Smartsupp idite na Postavke → Webhookovi, izradite novi webhook i zalijepite kopirani URL.
3. Odaberite potrebne događaje i spremite webhook.
4. Kliknite Poslati test kako bi Make ili n8n zabilježio strukturu podataka — zatim na temelju nje izradite ostatak scenarija ili radnog procesa.

Savjet: U platformi Make aktivirajte scenarij prije slanja testa — u suprotnom podaci webhooka neće biti zabilježeni. U platformi n8n upotrijebite produkcijski URL (ne testni URL) pri postavljanju webhooka za Smartsupp.

Što slijedi?

Smartsupp REST API — istražite cijeli API za programsko čitanje i zapisivanje podataka u aplikaciji Smartsupp.
Automatizacije — postavite automatizacije temeljene na pravilima koje se pokreću izravno u aplikaciji Smartsupp bez vanjskog alata.
Pregled integracija — pogledajte sve dostupne izvorne integracije s CRM sustavima, e-commerce platformama i drugim alatima.

💡 Trebate dodatnu pomoć? Obratite se našem timu za podršku — rado ćemo vam pomoći!

Povezani članci

Webhookovi: povežite Smartsupp s platformama Make i n8n te vlastitim alatima