Preskoči na glavno vsebino

Webhooki — povežite Smartsupp z Make, n8n in lastnimi orodji

Nastavite webhooke neposredno v nadzorni plošči in prejemajte obvestila v realnem času o pogovorih, stikih in obiskovalcih v Make, n8n ali lastnem sistemu.

Webhooki omogočajo Smartsuppu pošiljanje obvestil v realnem času na URL po vaši izbiri — v trenutku, ko se pogovor odpre, stik ustvari ali sporočilo dostavi, vaš sistem to izve. Ta članek pojasnjuje, kaj so webhooki, kako jih nastaviti v nadzorni plošči in kako jih povezati s platformami za avtomatizacijo, kot sta Make in n8n.

Članek smo razdelili na nekaj razdelkov:

Čemu so webhooki namenjeni?

Webhook je samodejno HTTP sporočilo, ki ga Smartsupp pošlje na URL po vaši izbiri, kadar koli se zgodi izbrani dogodek. Namesto stalnega preverjanja sprememb vaša orodja prejmejo podatke v trenutku, ko se nekaj zgodi.

Tipični primeri uporabe:

  • Platforme za avtomatizacijo — sprožite poteke dela v Make, n8n ali podobnih orodjih: dodajanje stikov v CRM, obvestila v Slack, beleženje leadov v preglednico

  • Notranji sistemi — pošiljajte podatke o pogovorih in stikih v realnem času v nadzorne plošče, podatkovna skladišča ali sisteme za zahtevke

  • Obvestila — obvestite ekipo, ko je pogovor ocenjen ali ko dostava sporočila ne uspe

Nasvet: Webhooki so na voljo od paketa Plus naprej — Plus vključuje 1 webhook, Expert 3, Ultimate pa ponuja prilagojeno omejitev. Primerjajte pakete →

Ustvarite webhook

Nastavitev webhooka v nadzorni plošči Smartsupp traja le nekaj korakov:

  • 1. Odprite Settings in pojdite v razdelek Webhooks.

  • 2. Kliknite za dodajanje novega webhooka in vnesite svoj endpoint URL — naslov, kamor bo Smartsupp pošiljal podatke o dogodkih.

  • 3. Izberite dogodke, ki jih želite prejemati (celoten seznam je v naslednjem razdelku).

  • 4. Shranite webhook. Od tega trenutka se izbrani dogodki dostavljajo kot zahteve HTTP POST z vsebino JSON.

Opomba: Prej nastavljeni webhooki delujejo naprej kot običajno. Prizadevamo si, da bodo vsi obstoječi webhooki vidni in upravljivi iz novega razdelka nadzorne plošče.

Razpoložljivi dogodki

Smartsupp lahko vaš endpoint obvešča o dogodkih v treh kategorijah. Izberite le dogodke, ki jih vaš potek dela zares potrebuje — tako endpoint ostane lahek in se izognete nepotrebnemu prometu.

Stiki

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Pogovori

  • 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

Obiskovalci

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Povezani viri: Dokumentacija za razvijalce Smartsupp — popolne sheme JSON payload za vsak tip dogodka.

Preizkusite svoj webhook

Pred zagonom uporabite vgrajeno testno funkcijo, da preverite, ali je endpoint dosegljiv in ali je vaš scenarij v Make ali n8n pravilno nastavljen.

V nastavitvah webhooka v nadzorni plošči kliknite Send test. Smartsupp bo na vaš endpoint URL poslal vzorčni payload. V prejemni storitvi preverite, da so podatki prispeli v pričakovani obliki.

Nasvet: V Make mora biti vaš scenarij aktiven in poslušati, preden pošljete test. V n8n preklopite vozlišče Webhook na production URL in se prepričajte, da je potek dela aktiven.

Dostava, ponovni poskusi in varnost

Smartsupp je zasnovan za zanesljivo dostavo dogodkov webhook, tudi ko je vaš endpoint začasno nedosegljiv.

  • Oblika — vsi dogodki se pošiljajo kot zahteve HTTP POST s telesom JSON, ki opisuje dogodek in njegove podatke

  • Odgovor — vaš endpoint naj čim hitreje odgovori s statusno kodo HTTP 2xx; počasni odgovori lahko zakasnijo ponovne poskuse

  • Ponovni poskusi — če dostava ne uspe, Smartsupp poskuša znova z naraščajočimi presledki do 3 dni

  • Samodejni izklop — endpointi, ki vztrajno odpovedujejo, se samodejno izklopijo; kadar koli jih lahko znova vklopite v nadzorni plošči

  • Varnost — vsaka zahteva webhook je podpisana, da lahko preverite, ali res prihaja od Smartsuppa; glejte docs.smartsupp.com za podrobnosti preverjanja podpisa

Opomba: Če se vaš endpoint izklopi zaradi ponavljajočih se napak, ga po odpravi težave znova vklopite v Settings → Webhooks. Smartsupp bo takoj nadaljeval s pošiljanjem dogodkov.

Povežite Smartsupp z Make ali n8n

Povezava Smartsuppa s platformo za avtomatizacijo traja štiri korake. Postopek je enak za Make in n8n — razlikuje se le vozlišče trigger.

  • 1. V Make dodajte trigger Webhooks → Custom webhook in kopirajte ustvarjeni URL. V n8n dodajte vozlišče trigger Webhook in kopirajte njegov production URL.

  • 2. V Smartsuppu pojdite na Settings → Webhooks, ustvarite nov webhook in prilepite kopirani URL.

  • 3. Izberite potrebne dogodke in shranite webhook.

  • 4. Kliknite Send test, da Make ali n8n zajame strukturo podatkov — nato na njej zgradite preostanek scenarija.

Nasvet: V Make aktivirajte scenarij, preden pošljete test — sicer podatki webhooka ne bodo zajeti. V n8n pri nastavitvi webhooka Smartsupp uporabite production URL (ne testnega).

Kaj sledi?

  • Smartsupp REST API — raziščite celoten API za programsko branje in pisanje podatkov Smartsupp.

  • Avtomatizacije — nastavite avtomatizacije na podlagi pravil, ki se sprožijo neposredno v Smartsuppu brez zunanjega orodja.

  • Pregled integracij — oglejte si vse razpoložljive native integracije s CRM-ji, platformami za e-trgovino in več.

💡 Potrebujete več pomoči? Obrnite se na našo ekipo za podporo — z veseljem pomagamo!

Sorodni članki
Ste s tem dobili odgovor na svoje vprašanje?