A webhookok lehetővé teszik, hogy a Smartsupp valós idejű értesítéseket küldjön az Ön által választott URL-re — amint megnyílik egy beszélgetés, létrejön egy névjegy vagy kézbesítésre kerül egy üzenet, a rendszere azonnal értesül róla. Ez a cikk elmagyarázza, mik a webhookok, hogyan állíthatja be őket az irányítópulton, és hogyan csatlakoztathatja őket automatizálási platformokhoz, mint a Make és az n8n.
A cikket több részre osztottuk:
Mire jók a webhookok?
A webhook egy automatikus HTTP-üzenet, amelyet a Smartsupp az Ön által választott URL-re küld, valahányszor egy kiválasztott esemény bekövetkezik. Ahelyett, hogy változásokat kellene lekérdezni, az adatok azonnal eljutnak az eszközeire, amint valami történik.
Tipikus felhasználási esetek:
Automatizálási platformok — munkafolyamatok indítása Make-ben, n8n-ben vagy hasonló eszközökben névjegyek CRM-be való felvételéhez, Slack-értesítések küldéséhez vagy érdeklődők táblázatba rögzítéséhez
Belső rendszerek — beszélgetési és névjegyadatok továbbítása irányítópultokra, adattárházakba vagy jegykezelő rendszerekbe valós időben
Értesítések — csapata figyelmeztetése, ha a beszélgetéseket értékelik, vagy ha az üzenetek kézbesítése meghibásodik
Tipp: A webhookok a Plus csomagtól érhetők el — a Plus 1 webhookot tartalmaz, az Expert 3-at, az Ultimate pedig egyéni limitet kínál. Csomagok összehasonlítása →
Webhook létrehozása
A webhook beállítása mindössze néhány lépést igényel a Smartsupp irányítópultján:
1. Nyissa meg a Beállítások menüt, és navigáljon a Webhookok szakaszhoz.
2. Kattintson az új webhook hozzáadásához, és adja meg a végpont URL-jét — azt a címet, amelyre a Smartsupp az eseményadatokat küldi.
3. Válassza ki a fogadni kívánt eseményeket (a teljes lista a következő szakaszban található).
4. Mentse el a webhookot. Ettől kezdve a kiválasztott események JSON-adattartalmú HTTP POST-kérésként kerülnek kézbesítésre.
Megjegyzés: A korábban konfigurált webhookok továbbra is normálisan működnek. Folyamatban van a munka, hogy az összes meglévő webhook látható és kezelhető legyen az új irányítópult-szakaszból.
Elérhető események
A Smartsupp három kategóriában értesítheti a végpontját eseményekről. Csak azokat az eseményeket válassza ki, amelyekre a munkafolyamatának valóban szüksége van — ez karcsúsítja a végpontot és elkerüli a felesleges forgalmat.
Névjegyek
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Beszélgetések
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Látogatók
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Kapcsolódó források: Smartsupp fejlesztői dokumentáció — teljes JSON-adattartalom-sémák minden eseménytípushoz.
Webhook tesztelése
Az élesítés előtt használja a beépített tesztelő funkciót annak ellenőrzésére, hogy a végpontja elérhető-e, és hogy a Make- vagy n8n-forgatókönyv helyesen van-e beállítva.
A webhook-beállításoknál az irányítópulton kattintson a Teszt küldése gombra. A Smartsupp egy minta-adattartalmat küld a végpont URL-jére. Ellenőrizze a fogadó szolgáltatást, hogy megbizonyosodjon arról, hogy az adatok a várt formátumban érkeztek meg.
Tipp: A Make-ben a forgatókönyvnek aktívnak és figyelnie kell, mielőtt elküldi a tesztet. Az n8n-ben váltsa a Webhook-csomópontot az éles URL-re, és győződjön meg arról, hogy a munkafolyamat aktív.
Kézbesítés, újrapróbálkozások és biztonság
A Smartsupp úgy van tervezve, hogy megbízhatóan kézbesítse a webhook-eseményeket, még akkor is, ha a végpontja ideiglenesen nem érhető el.
Formátum — minden esemény HTTP POST-kérésként kerül elküldésre, JSON-törzzsel, amely leírja az eseményt és adatait
Válasz — a végpontnak a lehető leggyorsabban 2xx HTTP-állapotkóddal kell válaszolnia; a lassú válaszok késleltethetik az újrapróbálkozásokat
Újrapróbálkozások — sikertelen kézbesítés esetén a Smartsupp növekvő késleltetésekkel próbálkozik újra, legfeljebb 3 napig
Automatikus letiltás — a tartósan meghibásodó végpontok automatikusan letiltásra kerülnek; az irányítópulton bármikor újra engedélyezheti őket
Biztonság — minden webhook-kérés alá van írva, így ellenőrizheti, hogy valóban a Smartsupp-tól érkezett; az aláírás-ellenőrzés részleteit lásd a docs.smartsupp.com oldalon
Megjegyzés: Ha a végpontja ismételt hibák miatt le van tiltva, engedélyezze újra a Beállítások → Webhookok menüpontban, miután megoldotta az alapproblémát. A Smartsupp azonnal folytatja az események küldését.
Smartsupp csatlakoztatása Make-hez vagy n8n-hez
A Smartsupp automatizálási platformhoz való csatlakoztatása négy lépést igényel. A folyamat ugyanaz a Make és az n8n esetében — csak az indító csomópont tér el.
1. A Make-ben adjon hozzá egy Webhookok → Egyéni webhook indítót, és másolja ki a generált URL-t. Az n8n-ben adjon hozzá egy Webhook indító csomópontot, és másolja ki az éles URL-t.
2. A Smartsupp-ban lépjen a Beállítások → Webhookok menüre, hozzon létre egy új webhookot, és illessze be a másolt URL-t.
3. Válassza ki a szükséges eseményeket, és mentse el a webhookot.
4. Kattintson a Teszt küldése gombra, hogy a Make vagy az n8n rögzítse az adatszerkezetet — majd erre alapozva építse fel a forgatókönyv vagy a munkafolyamat többi részét.
Tipp: A Make-ben aktiválja a forgatókönyvét, mielőtt elküldi a tesztet — különben a webhook-adatok nem kerülnek rögzítésre. Az n8n-ben a Smartsupp webhook beállításakor az éles URL-t használja (ne a teszt URL-t).
Mi a következő lépés?
Smartsupp REST API — fedezze fel a teljes API-t a Smartsupp adatainak programozott olvasásához és írásához.
Automatizálások — állítson be szabályalapú automatizálásokat, amelyek közvetlenül a Smartsupp-on belül aktiválódnak külső eszköz nélkül.
Integrációk áttekintése — tekintse meg az összes rendelkezésre álló natív integrációt CRM-ekkel, e-kereskedelmi platformokkal és egyebekkel.
💡 További segítségre van szüksége? Vegye fel a kapcsolatot a ügyfélszolgálati csapatunkkal — szívesen segítünk!