Webhook chatbota je HTTPS krajnja točka na koju platforma chatbota metodom POST šalje JSON sadržaj svaki put kada se nešto dogodi: posjetitelj započne razgovor, agent dovrši odgovor, prikupi se lead. Usmjeri tu krajnju točku na n8n, Make ili Zapier i sve što slijedi — upozorenja na Slacku, tablice, ažuriranja CRM-a, e-poruke za praćenje — automatizacija je koju već znaš izgraditi. U SuperCognitu krajnju točku registriraš na nadzornoj ploči, odabereš događaje, a svaka je isporuka potpisana i ponavlja se u slučaju neuspjeha. Ovaj vodič pokriva postojeće događaje, izgled sadržaja poruka, prijemnik u svakom alatu i nekoliko pogrešaka zbog kojih tiho gubiš podatke.

Događaji na koje se možeš pretplatiti

Nazivi događaja javni su ugovor: novi se dodaju, postojeći se nikad ne preimenuju, pa automatizacija izgrađena danas nastavlja raditi. Oni koje koristi većina ljudi:

Događaj
Kada se pokreće
Tipična upotreba
conversation.created
Posjetitelj započne novi razgovor s agentom
Brojanje razgovora po stranici ili kanalu; pokretanje mjerača sesije
message.created
Dodana je poruka, s bilo koje strane
Potpuno preslikavanje zapisa razgovora u vlastitu pohranu
message.completed
Agent dovrši generiranje odgovora
Pregled kvalitete, ocjena raspoloženja, obračun tokena
lead.captured
Agent je prikupio kvalificiran lead
Upozorenje na Slacku, redak u tablici, CRM koji sam vodiš
lead.delivered
Lead je stigao u povezani CRM
Potvrda predaje; pokreće se kasnije od captured, nakon eventualnog ponavljanja
lead.failed
Odustalo se od isporuke u CRM
Upozorenje čovjeku — lead je i dalje na nadzornoj ploči i može se ponovno poslati
payment.completed
Poveznica za plaćanje poslana u chatu je plaćena
Ispunjenje narudžbe, potvrde, nadzorne ploče prihoda
knowledge.source.failed
Ponovna sinkronizacija web-stranice ili dokumenta nije uspjela
Upozorenje osobi zaduženoj za sadržaj
product.published / unpublished
Agent ili MCP poslužitelj promijenio je status
Dnevnik promjena, stranica statusa
channel.disconnected
WhatsApp ili Telegram izgubio je vezu
Obavijest dežurnoj osobi prije nego što kupci primijete

Krajnja točka s praznim popisom događaja prima sve. Počni usko — jedan događaj, jedan tijek rada — i proširi kada prvi recept postane dosadan.

Kako izgleda sadržaj poruke za lead

{
  "id": "evt_…",                // stable across retries — dedupe on this
  "event": "lead.captured",
  "version": 1,
  "createdAt": "2026-09-10T09:14:02.000Z",
  "workspaceId": "…",           // a receiver may serve several workspaces
  "data": {
    "leadId": "…",
    "productId": "…",
    "sessionId": "…",
    "agent": "Showroom assistant",
    "contact": { "name": "Ana Silva", "email": "ana@example.com", "phone": null },
    "fields": { "budget": "20k" },
    "consent": true,
    "sourceUrl": "https://acme.com/pricing",
    "status": "pending",
    "crm": { "provider": "pipedrive", "leadId": "…", "url": "…" }
  }
}

Objekt fields sadrži kvalifikacijske odgovore koje je agent prikupio, consent bilježi da je posjetitelj pristao na kontakt, a crm postoji samo kada je povezan CRM. Sadržaj poruka samo dobiva nova polja; ništa što danas mapiraš neće nestati.

Registriraj krajnju točku

01

Najprije stvori prijemnik

U n8n-u, Makeu ili Zapieru dodaj webhook okidač i kopiraj URL koji dobiješ. Mora prihvaćati POST i brzo odgovoriti kodom 2xx — spori posao obavi nakon odgovora.

02

Dodaj webhook na nadzornoj ploči

U Postavkama → Webhookovi dodaj krajnju točku, zalijepi URL i odaberi događaje. Kopiraj tajni ključ za potpisivanje; bez njega nećeš izgraditi provjeru. Ista registracija dostupna je i putem REST API-ja za timove koji sve postavljaju iz koda.

03

Pošalji test

Započni razgovor s vlastitim agentom ili prikupi testni lead. Prati dnevnik isporuka na nadzornoj ploči: svaki pokušaj bilježi se sa statusom odgovora koji je vratila tvoja krajnja točka.

04

Provjeri potpis prije nego što povjeruješ sadržaju

Svaka isporuka nosi zaglavlje x-supercognit-signature: sha256= nakon čega slijedi HMAC-SHA256 neobrađenog tijela zahtjeva, s tvojim tajnim ključem kao ključem. Izračunaj ga, usporedi u konstantnom vremenu, odbaci ako se ne podudara. Bilo tko može poslati POST na javni URL; samo platforma može potpisati.

// Node.js — verify the signature on the RAW body (not the parsed JSON)
import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(rawBody, header, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
  return expected.length === header.length && timingSafeEqual(Buffer.from(expected), Buffer.from(header));
}

Primanje u svakom alatu

n8n

Koristi čvor Webhook s metodom POST i opcijom „Respond immediately”. Odmah iza njega dodaj čvor Code koji provjerava potpis gornjim isječkom — n8n izlaže neobrađeno tijelo kada to uključiš na čvoru — a zatim granaj tijek prema polju event čvorom Switch. Samostalno hostan n8n iza tvoje vlastite domene najurednija je opcija: tvoj tajni ključ i tvoji podaci ostaju kod tebe.

Make

Stvori Custom webhook, pokreni jednu testnu isporuku kako bi Make naučio strukturu, a zatim dodaj router prema polju event. Make može izračunati HMAC u tekstualnoj funkciji; usporedi ga sa zaglavljem prije routera i zaustavi scenarij ako se ne podudara.

Zapier

Koristi Webhooks by Zapier s Catch Hook kao okidačem. Zapier sam parsira JSON, što je praktično, ali znači i da ti za provjeru treba korak Code koji rekonstruira neobrađeno tijelo; ako ti je to previše, ograniči Zap na recepte niskog rizika poput obavijesti, a upise u CRM ostavi izvornoj integraciji.

Ponavljanja i idempotentnost

Isporuke koje ne dobiju 2xx ponavljaju se do pet pokušaja s eksponencijalnim odmakom — u razmacima od jedne, dvije, četiri i osam minuta — a svaki se pokušaj bilježi sa statusom odgovora. Polje id na omotnici ostaje isto u svim pokušajima, i upravo ti to omogućuje uklanjanje duplikata: ako je tvoja krajnja točka odgovorila sporo, a ponavljanje je ipak stiglo, druga kopija ima isti id i preskačeš je. Odgovori brzo, spremi id, posao obavi poslije.

Pet recepata koji opravdavaju postavljanje

  • lead.captured → poruka na Slacku u prodajni kanal s kontaktom, kvalifikacijskim odgovorima i poveznicom na zapis razgovora.
  • lead.failed → upozorenje osobi zaduženoj za vezu s CRM-om, s ID-jem leada za ponovno slanje s nadzorne ploče.
  • message.completed → dodavanje u tablicu za pregled, a zatim tjedno uzorkovanje deset odgovora radi kvalitete.
  • conversation.created → brojanje po sourceUrl na nadzornoj ploči, kako bi vidio koje stranice pokreću razgovore.
  • knowledge.source.failed → zahtjev osobi zaduženoj za sadržaj prije nego što agent počne odgovarati iz zastarjelih stranica.

„ChatGPT webhook”: zašto ta pretraga ne pronalazi ništa korisno

Ljudi koji traže ChatGPT webhook obično misle na jedno od dvoje. Ako su izradili prilagođeni GPT, odgovor je da GPT može pozvati tvoj API putem akcije, ali ti ne šalje događaj kada se dogodi razgovor — nema izlaznog webhooka na koji se možeš pretplatiti. Ako su sami izradili bota na OpenAI API-ju, webhook je njihov vlastiti kod koji trebaju napisati. U oba slučaja tražena funkcija je platforma koja emitira događaje o razgovorima i leadovima. Upravo je to gornji katalog događaja.

Pogreške zbog kojih gubiš podatke

  • Obavljanje sporog posla prije odgovora. Upis u CRM koji traje dvanaest sekundi uzrokuje istek isporuke, koja se zatim ponavlja — i sad imaš dvije prodajne prilike.
  • Provjera parsiranog JSON-a umjesto neobrađenog tijela. Ponovna serijalizacija mijenja bajtove; potpis se nikad neće podudarati.
  • Pretplata na sve već prvog dana. Samo message.created može biti tisuće događaja dnevno; počni s onim na koji ćeš reagirati.
  • Ignoriranje lead.failed. Lead je siguran na nadzornoj ploči, ali nitko ne zna da ga treba ponovno poslati ako mu nešto to ne kaže.

Webhookovi su dio chatbota koji nitko ne vidi, a o kojem svi ovise. Registriraj jednu krajnju točku, provjeri jedan potpis, izgradi jedan recept i ostatak tvog sustava počinje čuti što tvoj agent radi.