A webhookok lehetővé teszik, hogy a Smartsupp valós idejű értesítéseket küldjön az Ön által választott bármely URL-re — amint megnyílik egy beszélgetés, létrejön egy kapcsolat vagy kézbesítésre kerül egy üzenet, az Ön rendszere értesül róla. Ez a cikk bemutatja, mik azok a webhookok, hogyan állíthatja be őket az irányítópulton, és hogyan kapcsolhatja össze őket olyan automatizálási platformokkal, mint a Make és az n8n.
A cikket néhány szakaszra bontottuk:
Mire használhatók a webhookok?
A webhook egy automatikus HTTP-üzenet, amelyet a Smartsupp az Ön által választott URL-re küld, valahányszor bekövetkezik egy kiválasztott esemény. A változások rendszeres lekérdezése helyett az Ön eszközei azonnal megkapják az adatokat, amint történik valami.
Jellemző felhasználási esetek:
Automatizálási platformok — munkafolyamatok indítása a Make-ben, az n8n-ben vagy hasonló eszközökben kapcsolatok CRM-rendszerhez való hozzáadásához, értesítések közzétételéhez a Slackben vagy érdeklődők rögzítéséhez egy táblázatban
Belső rendszerek — beszélgetési és kapcsolati adatok valós idejű továbbítása irányítópultokba, adattárházakba vagy jegykezelő rendszerekbe
Értesítések — a csapat értesítése a beszélgetések értékelésekor vagy az üzenetek kézbesítésének sikertelenségekor
Tipp: A webhookok elérhetők a Plus és magasabb csomagokban — a Plus 1 webhookot, az Expert 3 webhookot tartalmaz, az Ultimate pedig egyéni korlátot kínál. Csomagok összehasonlítása →
Webhook létrehozása
A webhook beállításához mindössze néhány lépés szükséges a Smartsupp irányítópultján:
1. Nyissa meg a Beállítások menüt, majd lépjen a Webhookok szakaszba.
2. Kattintson az új webhook hozzáadására, é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 azokat az eseményeket, amelyekről értesítést szeretne kapni (a teljes listát a következő szakaszban találja).
4. Mentse a webhookot. Ettől kezdve a kiválasztott események HTTP POST-kérésekként, JSON-adattartalommal kerülnek kézbesítésre.
Megjegyzés: A korábban beállított webhookok továbbra is a megszokott módon működnek. Dolgozunk azon, hogy az összes meglévő webhook látható és kezelhető legyen az irányítópult új szakaszában.
⚠️ Korábban már létrehozott webhookokat? A régebbi webhookok még nem jelennek meg ebben a szakaszban — továbbra is a korábbi módon működnek. Egyesítjük a régi és az új rendszert, hogy minden egy helyen legyen kezelhető.
Elérhető események
A Smartsupp három kategória eseményeiről értesítheti az Ön végpontját. Csak azokat az eseményeket válassza ki, amelyekre a munkafolyamatának valóban szüksége van — így csökkentheti a végpont terhelését, és elkerülheti a felesleges forgalmat.
Kapcsolatok
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 dokumentumok — teljes JSON-adattartalomsémák minden eseménytípushoz.
A webhook tesztelése
Az éles használat előtt a beépített tesztfunkcióval ellenőrizze, hogy a végpontja elérhető-e, és hogy a Make vagy az n8n automatizálási folyamata megfelelően van-e beállítva.
Az irányítópulton, a webhook beállításainál kattintson a Teszt küldésegombra. A Smartsupp mintaadatokat küld a végpont URL-jére. Ellenőrizze a fogadó szolgáltatásban, hogy az adatok a várt formátumban érkeztek-e meg.
Tipp: A Make rendszerében az automatizálási folyamatnak aktívnak kell lennie, és figyelnie kell a beérkező adatokat a teszt elküldése előtt. Az n8n rendszerében állítsa át a Webhook csomópontot az éles URL-jé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 Smartsuppot úgy terveztük, hogy megbízhatóan kézbesítse a webhookeseményeket akkor is, ha az Ön végpontja átmenetileg nem érhető el.
Formátum — minden esemény HTTP POST-kérésként kerül elküldésre, az eseményt és annak adatait leíró JSON-törzzsel
Válasz — a végpontnak a lehető leggyorsabban kell válaszolnia egy 2xx HTTP-állapotkóddal; 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ő várakozási időkkel próbálkozik újra, legfeljebb 3 napon át
Automatikus letiltás — a tartósan hibás végpontok automatikusan letiltásra kerülnek; az irányítópulton bármikor újra engedélyezheti őket
Biztonság — minden webhookkérés aláírással rendelkezik, így ellenőrizheti, hogy valóban a Smartsupptól érkezett-e; tekintse meg a docs.smartsupp.com oldalt az aláírás ellenőrzésének részleteiért
Megjegyzés: Ha a végpontját ismétlődő hibák miatt letiltották, engedélyezze újra a Beállítások → Webhookok szakaszban a kiváltó probléma kijavítása után. A Smartsupp azonnal folytatja az események küldését.
A Smartsupp összekapcsolása a Make vagy az n8n rendszerével
A Smartsupp négy lépésben kapcsolható össze egy automatizálási platformmal. A folyamat a Make és az n8n esetében azonos — csak az indító csomópont különbözik.
1. A Makerendszerében adjon hozzá egy Webhookok → Egyéni webhook indítót, és másolja ki a létrehozott URL-t. Az n8nrendszerében adjon hozzá egy Webhook indító csomópontot, és másolja ki az éles URL-jét.
2. A Smartsuppban lépjen a Beállítások → Webhookokszakaszba, hozzon létre egy új webhookot, és illessze be a kimásolt URL-t.
3. Válassza ki a szükséges eseményeket, és mentse 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 az automatizálási folyamat vagy munkafolyamat többi részét.
Tipp: A Make rendszerében aktiválja az automatizálási folyamatot a teszt elküldése előtt — különben a webhookadatok nem kerülnek rögzítésre. Az n8n rendszerében az éles URL-t használja (ne a teszt URL-t) a Smartsupp webhook beállításakor.
Mi a következő lépés?
Smartsupp REST API — fedezze fel a teljes API-t a Smartsupp-adatok programozott olvasásához és írásához.
Automatizálások — állítson be szabályalapú automatizálásokat, amelyek külső eszköz nélkül, közvetlenül a Smartsuppban indulnak el.
Integrációk áttekintése — tekintse meg az összes elérhető natív integrációt CRM-rendszerekkel, e-kereskedelmi platformokkal és más rendszerekkel.
💡 További segítségre van szüksége? Lépjen kapcsolatba ügyfélszolgálati csapatunkkal — örömmel segítünk!