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.

Întrebare despre o comandăRO
  1. ClientAm comandat ieri o canapea. Știți când vine?
  2. AgentSpuneți-mi numărul comenzii, vă rog, și mă uit acum.
  3. ClientPatru, șapte, doi, opt.
  4. AgentComanda e la depozit și pleacă joi; curierul vă sună cu o oră înainte.
✓ Răspuns luat din sistemul magazinului
Exemplu de conversație

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âmpurile unei unelte webhook
CâmpLa ce foloseșteExemplu
NumeCum se numește unealta în instrucțiunile agentuluistare_comanda
DescriereCând s-o folosească agentul, scris ca pentru un coleg nouFolosește-o când clientul întreabă unde e comanda lui
AdresăAdresa din sistemul vostru care primește cerereaUn endpoint al magazinului, dedicat agentului
MetodăFelul cererii HTTP: POST, GET, PUT sau PATCHPOST, valoarea implicită
Câmpurile cereriiCe date cere agentul de la client și le trimite, descrise ca schemă JSONNumărul comenzii, ca text
Timp de așteptareCâte secunde așteaptă agentul răspunsul30 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ă

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Prețurile Kallina pe larg

Î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 040

La 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

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.