API · webhook · automatizáció

A chatbot eseményeiből
üzleti automatizáció lesz

Küldd tovább a leadeket, beszélgetéseket, kuponbeváltásokat és handoff eseményeket CRM-be, Google Sheets-be, n8n-be, Zapier-be, ERP-be vagy saját belső rendszerbe. A SmartAutoSend API és webhook rétege fejlesztőbarát, naplózott és duplikáció ellen védhető.

POST /webhook
{
  "id": "evt_8f3c7a9e...",
  "event_id": "evt_8f3c7a9e...",
  "event": "lead.created",
  "tenant": "webshop",
  "timestamp": "2026-09-03T10:15:30+02:00",
  "data": {
    "name": "Kovács Anna",
    "email": "anna@example.com",
    "message": "Érdekel a termék"
  }
}
REST API beszélgetések, interakciók, kimenetelek és statisztikák lekérése
Webhook események valós idejű értesítés külső rendszereknek, amikor történik valami fontos
Visszakövethető delivery payload, válaszkód, hibaüzenet, próbálkozás és kézi újraküldés
01

Webhook eseménykatalógus

Ezekre az eseményekre lehet külső rendszereket kötni. Egy endpoint csak azokra az eseményekre kap értesítést, amelyeket a portálon kiválasztasz.

lead.created

Új lead érkezett

Név, e-mail, telefonszám vagy üzenet továbbítása CRM-be, n8n-be vagy ügyfélszolgálati rendszerbe.

conversation.created

Új beszélgetés indult

Induló chat session naplózása, első aktivitás mérése vagy real-time belső értesítés.

message.created

Új üzenet érkezett

Fontos üzenetek továbbítása elemzéshez, minőségbiztosításhoz vagy belső support folyamatokhoz.

conversation.resolved

Beszélgetés lezárva

Riport, elégedettségi mérés, konverzió utókövetés vagy lezárt ügyfélút mentése.

handoff.created

Emberi átadás kérése

Ticket nyitás, operátori feladat létrehozása vagy prioritásos e-mail értesítés.

coupon.redeemed

Kupon beváltva

Kupon teljesítmény, kampányriport, Google Sheets sor vagy remarketing logika indítása.

02

Válassz integrációs példát

A leggyakoribb felhasználási módokat külön bontottuk, hogy gyorsan látszódjon, milyen eseményből milyen üzleti folyamat indulhat.

lead.created

Új érdeklődő automatikusan bekerül a CRM-be

A chatbot elkéri az ügyfél adatait, a webhook pedig továbbküldi őket HubSpot, Pipedrive, MiniCRM vagy saját CRM felé.

  • lead neve és elérhetősége
  • érdeklődés tárgya
  • beszélgetés azonosítója
  • kampány vagy webshop tenant adatok
conversation.resolved

Beszélgetések és kuponok táblázatba mentése

Google Sheets sor készülhet minden lezárt beszélgetésből, leadből vagy kuponbeváltásból.

  • napi riport alapadatok
  • ügyféligények gyűjtése
  • kupon teljesítmény mérése
  • export fejlesztői munka nélkül
message.created

Automatizációk indítása webhookból

n8n vagy Zapier fogadja az eseményt, majd továbbküldi Slackre, e-mailbe, CRM-be vagy belső feladatkezelőbe.

  • Slack vagy Teams értesítés
  • feladat létrehozás
  • e-mail sorozat indítása
  • adatok átalakítása és továbbítása
handoff.created

Ügyfélszolgálati átadás kezelése

Ha a chatbot emberi segítséget kér, a webhook azonnal nyithat ticketet a megfelelő kontextussal.

  • ügyfél kérdése és előzménye
  • prioritás és téma
  • ügyintézői értesítés
  • válaszidő mérés
03

Másolható payload és kódpéldák

A példák segítenek gyorsan bekötni a webhook fogadást és az API lekérdezést. A portálban a saját API kulcs és signing secret alapján lehet tesztelni.

Webhook payload
{
  "id": "evt_8f3c7a9e",
  "event_id": "evt_8f3c7a9e",
  "event": "lead.created",
  "timestamp": "2026-09-03T10:15:30+02:00",
  "tenant": "demo-webshop",
  "data": {
    "name": "Kovács Anna",
    "email": "anna@example.com",
    "source": "chat_widget"
  }
}
API lekérdezés
curl -H "Authorization: Bearer sa_live_..." \
  -H "Accept: application/json" \
  https://smartautosend.com/api/v1/conversations/
Node.js signature check
import crypto from "crypto";

function verifySignature(rawBody, secret, received) {
  const digest = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(`sha256=${digest}`),
    Buffer.from(received)
  );
}
Python signature check
import hmac
import hashlib

def verify_signature(payload_bytes, secret, received):
    digest = hmac.new(
        secret.encode("utf-8"),
        payload_bytes,
        hashlib.sha256,
    ).hexdigest()
    return hmac.compare_digest(f"sha256={digest}", received)
04

Webhook delivery életciklus

A delivery napló abban segít, hogy ne kelljen találgatni, mi történt egy külső rendszer felé küldött eseménnyel.

1Esemény történik a chatbotban
2Delivery rekord készül stabil event id-val
3HTTP POST indul a webhook URL-re
4Siker esetén látszik a 2xx válasz és a válaszidő
5Hiba esetén retry vagy kézi újraküldés indítható
05

Biztonság és idempotency

A cél az, hogy a külső rendszer megbízhatóan tudja ellenőrizni a kérést, és ne hozzon létre duplikált leadet, kupont vagy ticketet.

API kulcsok

Az API kulcs Bearer tokenként megy a kérés fejlécében. A rendszer az utolsó sikeres használat időpontját is naplózza.

HMAC-SHA256 aláírás

A webhook body signing secrettel aláírt, így a fogadó oldal ellenőrizheti, hogy valóban a SmartAutoSend küldte.

Idempotency-Key

Retry vagy kézi újraküldés esetén az event id változatlan, ezért a fogadó rendszer felismerheti a már feldolgozott eseményt.

Delivery napló

A portálon látszik a státusz, HTTP válasz, hiba, próbálkozás és payload. Ez gyorsabb hibakeresést ad fejlesztéskor.

első kérés evt_8f3c7a9e

feldolgozva, CRM lead létrejött

retry evt_8f3c7a9e

már ismert event id, duplikált lead nem készül

06

API referencia röviden

A portálban létrehozott API kulccsal ezek az adatok kérhetők le külső rendszerből.

GET /api/v1/conversations/Beszélgetések listája dátum, látogató vagy lezárt állapot alapján.
GET /api/v1/conversations/{id}/Egy konkrét beszélgetés részletei, üzenetekkel együtt.
GET /api/v1/interactions/Termékmegjelenítések és kattintások exportja.
GET /api/v1/outcomes/Beszélgetési kimenetelek: megoldott, handoff vagy elhagyott.
GET /api/v1/analytics/summary/Összesített statisztika, például ?days=30 időszakkal.

Kell egy konkrét bekötés?

Segítünk megtervezni, melyik esemény menjen CRM-be, táblázatba, automatizációba vagy saját backendbe. A próbaidőszak alatt már tesztelheted az API kulcsokat és webhook endpointokat.