Mine põhisisu juurde

Webhookid — ühendage Smartsupp Make'i, n8n-i ja oma tööriistadega

Seadistage webhookid otse töölaual ja saage reaalajas teavitusi vestluste, kontaktide ja külastajate kohta Make'is, n8n-is või oma süsteemis.

Webhookid võimaldavad Smartsuppil saata reaalajas teavitusi teie valitud URL-ile — hetkel, mil vestlus avatakse, kontakt luuakse või sõnum kohale toimetatakse, saab teie süsteem sellest teada. See artikkel selgitab, mis on webhookid, kuidas neid töölaual seadistada ja kuidas ühendada need automatiseerimisplatvormidega nagu Make ja n8n.

Jagasime artikli mõneks osaks:

Milleks webhookid kasulikud on?

Webhook on automaatne HTTP-sõnum, mille Smartsupp saadab teie valitud URL-ile alati, kui toimub valitud sündmus. Muudatuste pärimise asemel saavad teie tööriistad andmed kätte kohe, kui midagi juhtub.

Tüüpilised kasutusjuhud:

  • Automatiseerimisplatvormid — käivitage töövood Make'is, n8n-is või sarnastes tööriistades: kontaktide lisamine CRM-i, teavitused Slacki, müügivihjete logimine tabelisse

  • Sisemised süsteemid — edastage vestluste ja kontaktide andmed reaalajas armatuurlaudadele, andmeladudele või piletisüsteemidele

  • Teavitused — teavitage oma meeskonda, kui vestlusi hinnatakse või sõnumi edastamine ebaõnnestub

Vihje: Webhookid on saadaval alates Plus-paketist — Plus sisaldab 1 webhooki, Expert 3 ja Ultimate pakub kohandatud limiiti. Võrrelge pakette →

Webhooki loomine

Webhooki seadistamine võtab Smartsuppi töölaual vaid mõne sammu:

  • 1. Avage Settings ja minge jaotisse Webhooks.

  • 2. Klõpsake uue webhooki lisamiseks ja sisestage oma endpoint URL — aadress, kuhu Smartsupp sündmuste andmed saadab.

  • 3. Valige sündmused, mida soovite saada (täielik loend on järgmises jaotises).

  • 4. Salvestage webhook. Sellest hetkest edastatakse valitud sündmused HTTP POST päringutena JSON-sisuga.

Märkus: Varem seadistatud webhookid töötavad edasi tavapäraselt. Töötame selle nimel, et kõik olemasolevad webhookid oleksid uues töölaua jaotises nähtavad ja hallatavad.

Saadaolevad sündmused

Smartsupp saab teie endpointi teavitada sündmustest kolmes kategoorias. Valige ainult need sündmused, mida teie töövoog tegelikult vajab — nii püsib endpoint kerge ja väldite tarbetut liiklust.

Kontaktid

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Vestlused

  • conversation.opened

  • conversation.closed

  • conversation.closed_by_contact

  • conversation.rated

  • conversation.agent_assigned

  • conversation.agent_unassigned

  • conversation.agent_joined

  • conversation.agent_left

  • conversation.agent_replied

  • conversation.bot_replied

  • conversation.contact_replied

  • conversation.message_delivered

  • conversation.message_delivery_failed

Külastajad

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Seotud materjalid: Smartsuppi arendajadokumentatsioon — iga sündmusetüübi täielikud JSON-payload'i skeemid.

Testige oma webhooki

Enne käikuminekut kasutage sisseehitatud testfunktsiooni, et veenduda, et teie endpoint on kättesaadav ja Make'i või n8n-i stsenaarium on õigesti seadistatud.

Klõpsake töölaual webhooki seadetes Send test. Smartsupp saadab teie endpoint URL-ile näidis-payload'i. Kontrollige vastuvõtvas teenuses, et andmed saabusid oodatud kujul.

Vihje: Make'is peab teie stsenaarium olema enne testi saatmist aktiivne ja kuulama. n8n-is lülitage Webhook-sõlm production URL-ile ja veenduge, et töövoog on aktiivne.

Edastamine, korduskatsed ja turvalisus

Smartsupp on loodud webhook-sündmusi usaldusväärselt edastama isegi siis, kui teie endpoint on ajutiselt kättesaamatu.

  • Formaat — kõik sündmused saadetakse HTTP POST päringutena, mille JSON-keha kirjeldab sündmust ja selle andmeid

  • Vastus — teie endpoint peaks vastama 2xx HTTP-olekukoodiga võimalikult kiiresti; aeglased vastused võivad korduskatseid edasi lükata

  • Korduskatsed — kui edastamine ebaõnnestub, proovib Smartsupp uuesti kasvavate intervallidega kuni 3 päeva

  • Automaatne väljalülitamine — pidevalt ebaõnnestuvad endpointid lülitatakse automaatselt välja; saate need töölaual igal ajal uuesti sisse lülitada

  • Turvalisus — iga webhook-päring on allkirjastatud, et saaksite kontrollida, et see tuli tõesti Smartsuppist; vaadake docs.smartsupp.com allkirja kontrollimise üksikasju

Märkus: Kui teie endpoint lülitatakse korduvate vigade tõttu välja, lülitage see pärast probleemi lahendamist jaotises Settings → Webhooks uuesti sisse. Smartsupp jätkab sündmuste saatmist kohe.

Ühendage Smartsupp Make'i või n8n-iga

Smartsuppi ühendamine automatiseerimisplatvormiga võtab neli sammu. Protsess on Make'i ja n8n-i puhul sama — erineb vaid trigger-sõlm.

  • 1. Make'is lisage Webhooks → Custom webhook trigger ja kopeerige loodud URL. n8n-is lisage Webhook trigger-sõlm ja kopeerige selle production URL.

  • 2. Smartsuppis minge Settings → Webhooks, looge uus webhook ja kleepige kopeeritud URL.

  • 3. Valige vajalikud sündmused ja salvestage webhook.

  • 4. Klõpsake Send test, et Make või n8n tabaks andmestruktuuri — seejärel ehitage ülejäänud stsenaarium selle peale.

Vihje: Make'is aktiveerige stsenaarium enne testi saatmist — muidu webhooki andmeid ei tabata. n8n-is kasutage Smartsuppi webhooki seadistamisel production URL-i (mitte testi oma).

Mis edasi?

  • Smartsupp REST API — tutvuge täieliku API-ga Smartsuppi andmete programmaatiliseks lugemiseks ja kirjutamiseks.

  • Automatiseeringud — seadistage reeglipõhised automatiseeringud, mis käivituvad otse Smartsuppis ilma välise tööriistata.

  • Integratsioonide ülevaade — vaadake kõiki saadaolevaid integratsioone CRM-ide, e-kaubanduse platvormide ja muuga.

💡 Vajate rohkem abi? Võtke ühendust meie toe meeskonnaga — aitame hea meelega!

Seotud artiklid
Kas see vastas teie küsimusele?