Webhookai leidžia Smartsupp siųsti realaus laiko pranešimus jūsų pasirinktu URL — vos tik atidaromas pokalbis, sukuriamas kontaktas ar pristatoma žinutė, jūsų sistema apie tai sužino. Šiame straipsnyje paaiškinama, kas yra webhookai, kaip juos nustatyti valdymo skydelyje ir kaip sujungti su automatizavimo platformomis, tokiomis kaip Make ir n8n.
Straipsnį suskirstėme į kelias dalis:
Kam naudingi webhookai?
Webhookas yra automatinė HTTP žinutė, kurią Smartsupp siunčia jūsų pasirinktu URL kiekvieną kartą, kai įvyksta pasirinktas įvykis. Užuot nuolat tikrinę pakeitimus, jūsų įrankiai gauna duomenis iškart, kai kas nors įvyksta.
Tipiniai naudojimo atvejai:
Automatizavimo platformos — paleiskite darbo eigas Make, n8n ar panašiuose įrankiuose: kontaktų pridėjimas į CRM, pranešimai į Slack, potencialių klientų registravimas lentelėje
Vidinės sistemos — realiuoju laiku perduokite pokalbių ir kontaktų duomenis į valdymo skydelius, duomenų saugyklas ar užklausų sistemas
Pranešimai — įspėkite komandą, kai pokalbis įvertinamas arba nepavyksta pristatyti žinutės
Patarimas: Webhookai prieinami nuo Plus plano ir aukščiau — Plus apima 1 webhooką, Expert 3, o Ultimate siūlo individualų limitą. Palyginkite planus →
Sukurkite webhooką
Webhooko nustatymas Smartsupp valdymo skydelyje užtrunka vos kelis žingsnius:
1. Atidarykite Settings ir eikite į skiltį Webhooks.
2. Spustelėkite pridėti naują webhooką ir įveskite savo endpoint URL — adresą, kuriuo Smartsupp siųs įvykių duomenis.
3. Pasirinkite įvykius, kuriuos norite gauti (visas sąrašas kitoje skiltyje).
4. Išsaugokite webhooką. Nuo šio momento pasirinkti įvykiai pristatomi kaip HTTP POST užklausos su JSON turiniu.
Pastaba: Anksčiau nustatyti webhookai toliau veikia įprastai. Dirbame, kad visi esami webhookai būtų matomi ir valdomi naujoje valdymo skydelio skiltyje.
Galimi įvykiai
Smartsupp gali pranešti jūsų endpointui apie trijų kategorijų įvykius. Rinkitės tik tuos įvykius, kurių jūsų darbo eigai tikrai reikia — taip endpointas išlieka lengvas ir išvengiama nereikalingo srauto.
Kontaktai
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Pokalbiai
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
Lankytojai
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Susiję ištekliai: Smartsupp dokumentacija kūrėjams — pilnos kiekvieno įvykio tipo JSON payload schemos.
Išbandykite savo webhooką
Prieš paleisdami naudokite integruotą testavimo funkciją, kad įsitikintumėte, jog endpointas pasiekiamas, o jūsų Make ar n8n scenarijus nustatytas teisingai.
Valdymo skydelio webhooko nustatymuose spustelėkite Send test. Smartsupp išsiųs pavyzdinį payload jūsų endpoint URL. Patikrinkite priimančioje paslaugoje, ar duomenys atėjo laukiamu formatu.
Patarimas: Make scenarijus turi būti aktyvus ir klausytis prieš siunčiant testą. n8n perjunkite Webhook mazgą į production URL ir įsitikinkite, kad darbo eiga aktyvi.
Pristatymas, pakartojimai ir saugumas
Smartsupp sukurtas patikimai pristatyti webhook įvykius net tada, kai jūsų endpointas laikinai nepasiekiamas.
Formatas — visi įvykiai siunčiami kaip HTTP POST užklausos su JSON turiniu, aprašančiu įvykį ir jo duomenis
Atsakymas — jūsų endpointas turėtų kuo greičiau atsakyti 2xx HTTP būsenos kodu; lėti atsakymai gali uždelsti pakartojimus
Pakartojimai — jei pristatyti nepavyksta, Smartsupp bando dar kartą didėjančiais intervalais iki 3 dienų
Automatinis išjungimas — nuolat nepavykstantys endpointai automatiškai išjungiami; bet kada galite juos vėl įjungti valdymo skydelyje
Saugumas — kiekviena webhook užklausa pasirašyta, kad galėtumėte patikrinti, jog ji tikrai iš Smartsupp; žr. docs.smartsupp.com parašo tikrinimo detales
Pastaba: Jei jūsų endpointas išjungiamas dėl pasikartojančių klaidų, išsprendę problemą vėl jį įjunkite skiltyje Settings → Webhooks. Smartsupp iškart atnaujins įvykių siuntimą.
Sujunkite Smartsupp su Make arba n8n
Smartsupp sujungimas su automatizavimo platforma užtrunka keturis žingsnius. Procesas Make ir n8n atveju toks pat — skiriasi tik trigger mazgas.
1. Make pridėkite Webhooks → Custom webhook trigerį ir nukopijuokite sugeneruotą URL. n8n pridėkite Webhook trigerio mazgą ir nukopijuokite jo production URL.
2. Smartsupp eikite į Settings → Webhooks, sukurkite naują webhooką ir įklijuokite nukopijuotą URL.
3. Pasirinkite reikalingus įvykius ir išsaugokite webhooką.
4. Spustelėkite Send test, kad Make ar n8n užfiksuotų duomenų struktūrą — tada ant jos sukurkite likusią scenarijaus dalį.
Patarimas: Make aktyvuokite scenarijų prieš siųsdami testą — kitaip webhook duomenys nebus užfiksuoti. n8n naudokite production URL (ne testinį), kai nustatote Smartsupp webhooką.
Kas toliau?
Smartsupp REST API — susipažinkite su visu API programiniam Smartsupp duomenų skaitymui ir rašymui.
Automatizacijos — nustatykite taisyklėmis pagrįstas automatizacijas, kurios paleidžiamos tiesiai Smartsupp be išorinio įrankio.
Integracijų apžvalga — peržiūrėkite visas galimas integracijas su CRM, el. prekybos platformomis ir kt.
💡 Reikia daugiau pagalbos? Susisiekite su mūsų palaikymo komanda — mielai padėsime!