Mis on webhook? Lihtne selgitus mittearendajatele: kuidas ühendada vestlusrobot oma tööriistadega
Webhook on automaatne sõnum, mille üks rakendus saadab teisele kohe, kui midagi juhtub. Vaata, kuidas vestlusroboti webhookid töötavad, mille poolest need API-st erinevad ja…

Selles artiklis
Niisiis, mis on webhook? Webhook on automaatne sõnum, mille üks rakendus saadab teisele kohe, kui midagi juhtub, näiteks kui sinu vestlusrobot kogub uue müügivihje. Selle asemel et sinu teised tööriistad küsiksid iga paari minuti tagant „kas midagi uut?“, annab vestlusrobot neile kohe teada.
Mõtle sellele kui erinevusele iga tund postkasti juurde kõndimise ja uksekella vahel. Uksekell heliseb ainult siis, kui keegi päriselt ukse taga on.
Allpool loed, kuidas vestlusroboti webhookid töötavad, kuidas need API-ga võrreldes erinevad, milliseid sündmusi tasub saata ja kuidas neid turvaliselt hoida.
Peamised järeldused
- Webhook lükkab andmed sündmuse toimumisel teise süsteemi; API on tavaliselt midagi, mille poole sa ise pöördud, et andmeid tõmmata.
- Kasulikud vestlusroboti webhookid käivituvad äriliste sündmuste peale, nagu uus müügivihje, vestluse üleandmine inimesele või suletud vestlus.
- HMAC-allkirjad tõendavad, et sõnum on ehtne, ja korduskatsed tagavad, et lühike katkestus ei too kaasa andmete kadumist.
Mis on webhook lihtsas keeles?
Webhookil on kolm osa:
- Sündmus: lähterakenduses juhtub midagi, näiteks külastaja jätab vestlusesse oma e-posti aadressi.
- URL: vastuvõtva süsteemi aadress, mida nimetatakse sageli lõpp-punktiks (endpoint). Kleebid selle lähterakenduse seadetesse.
- Sisu (payload): väike andmepakett, tavaliselt JSON-vormingus, mis kirjeldab, mis juhtus.
Kui sündmus toimub, saadab lähterakendus sisu sellele URL-ile. Vastuvõttev süsteem loeb selle ja teeb midagi kasulikku: loob kontakti, postitab teavituse, lisab arvutustabelisse rea. Kellelgi pole vaja nuppu vajutada ega kirjutada skripti, mis muudatusi kontrolliks.
Ka vastuvõtvat poolt ei pea sa ise ehitama. Automatiseerimisplatvormid nagu Zapier, Make ja n8n saavad sulle mõne klikiga webhooki URL-i luua, mistõttu saavad webhooke üldse kasutada ka mittearendajad.
Webhook vs API: mis vahe neil on?
Neid peetakse sageli konkurentideks, kuid tegelikult töötavad nad paarina. API (rakendusliides) on rida uksi rakendusse, millele sa koputad, et andmeid lugeda või muuta. Webhook on rakendus, mis koputab sinu uksele, kui midagi juhtub.
Ilma webhookideta on ainus viis uutest sündmustest teada saada pärimine (polling): API-lt ikka ja jälle küsimine, kas midagi on muutunud.
| Webhook (tõukamine) | API pärimine (tõmbamine) | |
|---|---|---|
| Kes alustab | Lähterakendus, kui sündmus toimub | Sinu süsteem, ajakava järgi |
| Kiirus | Peaaegu reaalajas | Nii kiiresti, kui sinu pärimise intervall lubab |
| Sobib kõige paremini | Teavitused, uute kirjete sünkroonimine, töövoogude käivitamine | Masseksport, aruanded, päringud vajaduse korral |
| Seadistamine | Kleebi URL, vali sündmused | Kirjuta skript või ajastatud töö |
| Peamine risk | Kaotatud sõnumid, kui vastuvõtja on maas (lahendatakse korduskatsetega) | Viivitused, raisatud päringud, päringulimiidid |
Paljud integratsioonid kasutavad mõlemat. Webhook ütleb: „vestlus 123 anti just üle“, ja vastuvõttev süsteem pöördub seejärel API poole, kui vajab rohkem üksikasju.
Vestlusroboti webhookid: sündmused, mida tasub saata
Parimad vestlusroboti webhookid vastavad hetkedele, mis on sinu meeskonnale juba olulised. Kolm levinud näidet:
Uus müügivihje kogutud
Külastaja jagab kontaktandmeid ja vastab ühele-kahele kvalifitseerivale küsimusele. Tüüpilised kasutusviisid: loo või uuenda kontakt CRM-is, teavita oma müügikanalit või lisa müügivihje (nõusolekuga) soojendusnimekirja. Kuna kiire vastamine uutele müügivihjetele toob rohkem tehinguid, on see tavaliselt esimene webhook, mille meeskonnad seadistavad.
Vestlus anti üle inimesele
Assistent otsustas, et vestluse peaks üle võtma inimene, või klient palus inimest. Tüüpilised kasutusviisid: teavita valvekorras klienditeenindajat, ava help deskis pilet või märgi prioriteetne konto. Sisu peaks kandma konteksti, millele sinu vestlusrobotilt inimesele üleandmise protsess tugineb, nagu kavatsus, sildid ja kontaktandmed.
Vestlus suleti
Vestlus lõppes, lahendatuna kas AI või klienditeenindaja poolt. Tüüpilised kasutusviisid: logi see aruandluse jaoks, uuenda juhtpaneeli või loo järeltegevuse ülesanne.
Lihtne reegel: telli ainult neid sündmusi, mille peale sa ka tegutsed. Iga webhook, mille sisse lülitad, on üks asi juurde, mida jälgida.
Webhookide turvalisus: allkirjad, korduskatsed ja edastuse jälgimine
Webhooki URL on lihtsalt aadress internetis. Mis takistab kellelgi sinna võltsitud „uus müügivihje“ sõnumeid saatmast? Ja mis juhtub, kui sinu server on kümme minutit maas? Neile küsimustele vastavad kolm kaitsemeedet.
HMAC-allkirjad. Saatjal ja vastuvõtjal on ühine salajane võti. Saatja arvutab sisu ja salajase võtme põhjal allkirja ning lisab selle igale päringule. Vastuvõtja arvutab selle uuesti ja lükkab tagasi kõik, mis ei ühti, nii et võltsitud või muudetud sõnumid ei lähe läbi.
Korduskatsed. Kui vastuvõtja edastust ei kinnita, proovib saatja hiljem uuesti, tavaliselt üha pikemate vahedega. Lühike katkestus ei tähenda kaotatud andmeid.
Kaitselülitid ja edastuse jälgimine. Kui lõpp-punkt ebaõnnestub järjest, peatab kaitselüliti (circuit breaker) edastused mõneks ajaks, selle asemel et katkist serverit pommitada. Edastuslogid näitavad, mis saadeti ja kas see õnnestus, nii et saad vigu otsida ilma oletamata.
Vastuvõtval poolel hoiavad enamikku probleeme ära mõned harjumused:
- Kontrolli allkirja enne andmete kasutamist.
- Vasta kiiresti õnnestumise koodiga ja tee raske töö taustal.
- Arvesta duplikaatidega: korduskatse võib sama sündmuse edastada kaks korda, seega kasuta korduste vahelejätmiseks sündmuse ID-d.
- Kasuta ainult HTTPS-lõpp-punkte.
- Edasta ainult neid isikuandmeid, mida vastuvõttev tööriist vajab; isikuandmete kaitse üldmääruse (GDPR) reeglid AI-vestlusrobotitele kehtivad ka siis, kui andmed vestlusest lahkuvad.
Kuidas Conviro reaalajas webhooke käsitleb
Conviro pakub reaalajas webhooke. Sündmused jõuavad sinu lõpp-punkti kohe, kui need toimuvad, HMAC-iga allkirjastatuna, et saaksid iga päringut kontrollida, ebaõnnestunud edastuse korral automaatselt uuesti saadetuna ja kaitselülitiga kaitstuna. Edastuse jälgimine näitab, mis saadeti ja kas see jõudis kohale.
Suuna need webhookid oma koodile või koodivabale tööriistale: Conviro ühendub ka Zapieri, Make'i ja n8n-iga ning pakub REST API-t bearer-tokeniga autentimise ja piiratud õigustega võtmetega, et andmeid vajaduse korral tõmmata. Kõik see on saadaval Pro paketis ja kõrgemates pakettides. Arendaja dokumentatsioon kirjeldab sisu ja allkirjade kontrolli ning automatiseerimise integratsioonide leht näitab koodivabu lahendusi.
Korduma kippuvad küsimused
Mis on webhook lihtsate sõnadega?
Webhook on automaatne teavitus, mille üks rakendus saadab teisele, kui toimub kindel sündmus. Annad lähterakendusele URL-i, valid sündmused ja see postitab igal korral sellele URL-ile väikese andmepaketi. See toimib nagu tarkvara uksekell: vastuvõttev süsteem saab muudatustest kohe teada, selle asemel et korduvalt kontrollida.
Kas webhookide kasutamiseks on vaja arendajat?
Mitte alati. Automatiseerimisplatvormid nagu Zapier, Make ja n8n loovad sulle webhooki URL-i ja lasevad visuaalses redaktoris sissetulevad andmed tegevustega siduda. Arendajast on kasu, kui ehitad oma lõpp-punkti, kontrollid allkirju koodis või ühendad sisemise süsteemi, millel pole valmis konnektorit.
Kas webhook on kiirem kui API?
Uutest sündmustest teada saamiseks jah. Webhook saabub hetk pärast sündmust, samas kui API pärimine on täpselt nii kiire, kui sageli sa kontrollid. Ajalooliste andmete või lisaüksikasjade jaoks on API õige tööriist. Enamik hästi ehitatud integratsioone kasutab webhooke teavitamiseks ja API-t info otsimiseks.
Mis juhtub, kui mu webhooki lõpp-punkt on maas?
See sõltub saatjast. Head webhookisüsteemid proovivad ebaõnnestunud edastusi teatud aja jooksul uuesti, nii et lühikesed katkestused ei too kaasa andmete kadu, ja mõned peatavad edastused lõpp-punkti, mis järjest ebaõnnestub. Kontrolli, kas sinu teenusepakkuja teeb korduskatseid, ja veendu, et sinu lõpp-punkt suudab sama sündmuse kahekordse saabumise turvaliselt käsitleda.
Järgmised sammud
Vali üks sündmus, mille peale tegutseksid juba täna, tavaliselt uued müügivihjed, ja ühenda see tööriistaga, kus sinu meeskond juba töötab. Kui see töötab usaldusväärselt, lisa üleandmised ja suletud vestlused. Alusta Conviroga tasuta, seadista oma assistent ja mine üle Pro paketile, kui oled webhookide ühendamiseks valmis.
Avaldanud
Conviro
Jagame teadmisi AI-põhise klienditoe, vestlusrobotite automatiseerimise ja SaaS-i kasvustrateegiate kohta.
Arenda Conviro baasil
Ühenda vestluspõhised töövood oma süsteemidega
Tutvu arendaja ressursside ja integratsioonimustritega enne, kui lahenduse ülesehituse kavandad.
Seotud artiklid
Veel postitusi
Engineering
IMAP, POP3 ja SMTP lihtsalt selgitatult: klienditoe postkasti ühendamine AI-assistendiga
7 min lugemist
Loe artiklit
Engineering
Kui sõnumikanalid vaikivad: WhatsAppi, Instagrami ja veebivestluse edastuse jälgimine
7 min lugemist
Loe artiklit
Engineering
7 viisi, kuidas kasutada vestlusroboti API-t: ehita edasi oma klienditoe vestlustele
7 min lugemist
Loe artiklit