Unelte webhook
Webhook pentru agentul vocal: date din sistemul vostru, în mijlocul apelului
Un webhook al agentului vocal este o adresă din sistemul vostru pe care agentul Kallina o cheamă în timpul convorbirii, cu datele spuse de client, ca să afle un răspuns pe care nu-l are în scenariu: starea unei comenzi, un sold, o reparație. Agentul citește răspunsul și îl spune clientului cu vorbele lui. Așa legați Kallina de orice sistem cu API, chiar dacă nu apare în lista integrărilor.
- ClientAm comandat ieri o canapea. Știți când vine?
- AgentSpuneți-mi numărul comenzii, vă rog, și mă uit acum.
- ClientPatru, șapte, doi, opt.
- AgentComanda e la depozit și pleacă joi; curierul vă sună cu o oră înainte.
La ce folosește o unealtă webhook
Scenariul îi spune agentului cum să vorbească, dar nu poate ține date care se schimbă de la oră la oră. Unealta webhook umple golul: agentul pune o întrebare scurtă sistemului vostru, primește răspunsul în câteva clipe și continuă conversația cu informația proaspătă, fără să-l treacă pe client la un operator.
- Starea unei comenzi, a unei livrări sau a unei reparații
- Stocul unui produs sau prețul dintr-o listă care se schimbă
- Datele unui client, găsite după telefon sau după un cod
- O cerere înregistrată în sistemul vostru chiar în timpul apelului
Ce completați pentru o unealtă
O unealtă se definește în editorul agentului și are șase câmpuri.
| Câmp | La ce folosește | Exemplu | |
|---|---|---|---|
| Nume | Cum se numește unealta în instrucțiunile agentului | stare_comanda | |
| Descriere | Când s-o folosească agentul, scris ca pentru un coleg nou | Folosește-o când clientul întreabă unde e comanda lui | |
| Adresă | Adresa din sistemul vostru care primește cererea | Un endpoint al magazinului, dedicat agentului | |
| Metodă | Felul cererii HTTP: POST, GET, PUT sau PATCH | POST, valoarea implicită | |
| Câmpurile cererii | Ce date cere agentul de la client și le trimite, descrise ca schemă JSON | Numărul comenzii, ca text | |
| Timp de așteptare | Câte secunde așteaptă agentul răspunsul | 30 de secunde implicit, se poate schimba |
Ce date circulă și în ce ordine
În timpul convorbirii, agentul decide să folosească unealta după descrierea ei. Mai întâi adună de la client câmpurile cerute de schemă, de exemplu numărul comenzii sau data nașterii, și le poate repeta ca să fie sigur. Apoi trimite cererea la adresa voastră, cu metoda aleasă, și așteaptă răspunsul cel mult cât ați stabilit.
Sistemul vostru întoarce un răspuns, de obicei JSON, cu ce trebuie să afle clientul. Agentul nu citește răspunsul cuvânt cu cuvânt: îl folosește ca să formuleze o replică firească în limba convorbirii. De aceea e bine ca răspunsul să conțină doar câmpurile necesare, cu denumiri clare, fără date pe care agentul nu trebuie să le spună.
Fiecare folosire a uneltei rămâne în istoricul convorbirii din Kallina: numele uneltei, parametrii trimiși, răspunsul primit, cât a durat și dacă a reușit. Când un client spune că a primit o informație greșită, vedeți imediat dacă greșeala a venit din sistemul vostru sau din felul în care a vorbit agentul.
Cum pornim o unealtă nouă
Alegem întrebarea
Pornim de la o întrebare pe care clienții o pun des și la care azi răspunde un om care caută într-un program.
Pregătiți adresa
Echipa voastră face o adresă care primește câmpurile alese și întoarce doar răspunsul de care are nevoie agentul.
Scriem descrierea
Descriem unealta în cuvinte simple: când o folosește agentul, ce cere clientului și ce face dacă nu găsește nimic.
Testăm în apeluri
Sunăm cu cazuri reale și cazuri greșite, apoi citim în istoric ce a trimis agentul și ce a primit.
Pornim pe linie
Unealta intră în scenariul agentului de pe numărul vostru, iar primele zile urmărim împreună istoricul.
Exemple din meserii diferite
- Magazin online
- Clientul întreabă unde e coletul. Agentul cere numărul comenzii, unealta întoarce starea și ziua livrării, iar clientul nu mai așteaptă la coadă pentru un singur rând de informație.
- Service auto
- Proprietarul vrea să știe dacă mașina e gata. Unealta caută după numărul de înmatriculare în programul service-ului și spune stadiul; prețul final îl comunică tot consilierul.
- Firmă de livrări sau curierat
- Destinatarul sună să mute livrarea. Unealta înregistrează cererea în sistemul firmei, iar agentul îi spune că dispecerul o confirmă.
Siguranța adresei și a datelor
O adresă doar pentru agent
Recomandăm un endpoint separat, care nu poate face mai mult decât ce i-ați cerut agentului: citește o stare, nu modifică un cont întreg.
Protecția o stabilim împreună
Formularul uneltei nu are un câmp separat pentru antete. Felul în care vă protejați adresa îl alegem la configurare, de exemplu cu o cheie lungă, greu de ghicit, în adresă.
Doar câmpurile necesare
Ce întoarce sistemul vostru poate ajunge în replica agentului și rămâne în istoric. Nu trimiteți date pe care clientul nu trebuie să le audă.
Când sistemul tace
Dacă răspunsul nu vine în timpul stabilit, agentul rămâne fără datele cerute. În descriere îi spuneți ce să facă atunci: să ceară un număr de telefon sau să transfere la un om.
Ce nu face azi integrarea prin webhook
Nu trimite un webhook după fiecare apel
Kallina nu anunță azi automat un sistem extern la încheierea fiecărui apel. Rezultatul ajunge acolo prin integrările CRM sau printr-un flux.
Nu scrie singur codul vostru
Adresa și răspunsul le face echipa voastră sau furnizorul sistemului. Noi descriem exact ce câmpuri trimite agentul și ce așteaptă înapoi.
Nu înlocuiește un API public Kallina
Kallina nu are încă un API REST public documentat; accesul prin API îl discutăm la cerere. Uneltele webhook merg în sens invers: agentul vă întreabă pe voi.
Unelte webhook și adrese care pornesc fluxuri
Pe lângă uneltele folosite de agent în apel, Kallina are adrese care pornesc un flux din constructorul de fluxuri. Direcția e alta: sistemul vostru cheamă Kallina, de exemplu ca un formular nou de pe site să pornească o serie de pași. Fluxul poate trimite și un răspuns înapoi celui care l-a pornit.
Pe scurt, unealta webhook răspunde la întrebarea „ce îi spun clientului acum?”, iar adresa de flux răspunde la întrebarea „ce pornesc când se întâmplă ceva la voi?”. Multe proiecte le folosesc pe amândouă, fiecare pentru treaba ei.
Costul unei integrări prin webhook
Uneltele webhook nu se plătesc separat: intră în pachetul lunar al agentului, 99 USD sau 300 USD, cu credite care se consumă după durata convorbirilor. Partea de la voi, adresa și răspunsul ei, o construiește echipa voastră; noi o descriem și o testăm la implementare.
Încercați agentul live
Agentul de pe linia demo nu e legat de sistemul vostru, dar vă arată cum cere un număr, cum îl repetă și cum vorbește după ce primește un răspuns.
Sună agentul live: +373 79 325 040La demo luăm o întrebare de-a voastră și schițăm împreună câmpurile uneltei.
Întrebări frecvente
Ce trebuie să aibă sistemul nostru?
O adresă accesibilă din internet care primește o cerere HTTP cu câmpurile alese și întoarce un răspuns scurt. Dacă sistemul are deja un API, de multe ori ajunge un strat subțire peste el.
Cât de repede trebuie să răspundă?
Cât mai repede: clientul așteaptă în linie. Timpul maxim implicit e de 30 de secunde, dar o întrebare simplă ar trebui să primească răspuns în câteva clipe.
Agentul poate și scrie date, nu doar citi?
Da, dacă adresa voastră acceptă asta, de exemplu ca să înregistreze o cerere. Recomandăm ca scrierile să fie puține și verificate de un om.
Câte unelte poate avea un agent?
Mai multe, fiecare cu numele și descrierea ei. Cu cât descrierile sunt mai clare, cu atât agentul alege mai bine unealta potrivită.
Funcționează în română și în rusă?
Da. Câmpurile și răspunsul pot fi în orice limbă; agentul vorbește cu clientul în limba convorbirii.
Pot vedea ce a trimis agentul?
Da, în istoricul fiecărei convorbiri apar parametrii trimiși, răspunsul primit, durata și dacă cererea a reușit.
Unde se folosesc uneltele webhook
- Operator AI pentru livrări
Agentul răspunde despre comenzi și livrări din datele sistemului vostru.
- Agent vocal pentru magazine online
Starea comenzii, retururi și întrebări despre produse, la telefon.
- Agent vocal pentru service auto
Stadiul reparației, citit din programul service-ului printr-un webhook.
- Agent vocal SIP
Cum ajung la agent apelurile de pe numărul vostru.
- Ghid: primul agent vocal
Ce pregătiți înainte de pornire și cum testați scenariul.
- Fapte despre Kallina AI
Compania, limbile, integrările și limitele agenților, într-un singur loc.
Surse
Câmpurile uneltei și istoricul apelurilor au fost verificate în codul platformei Kallina la 18 noiembrie 2026.
Aduceți întrebarea la care răspundeți cel mai des
O transformăm împreună într-o unealtă: ce cere agentul, ce trimite și ce spune înapoi.