Pentru dezvoltatori
Ce puteți lega de Kallina din cod, azi
Kallina nu are încă un API REST public documentat. Are patru puncte de legătură care funcționează: unelte webhook apelate de agent în timpul convorbirii, adrese care pornesc fluxuri, scriptul pentru butonul vocal și un server MCP. Accesul la API pentru cazuri speciale îl discutăm la cerere.
Punctele de legătură
Unelte webhook în timpul apelului
În fișa agentului definiți o unealtă: nume, descriere, adresă, metodă, schema câmpurilor și timpul maxim de așteptare. Agentul o apelează când conversația o cere și folosește răspunsul în frază.
Adrese care pornesc fluxuri
Un flux din constructor poate avea propria adresă de declanșare. Sistemul vostru trimite o cerere, iar fluxul pornește cu datele primite.
Butonul vocal pe site
Un singur script pe pagină. Sesiunea vocală primește o adresă temporară, așa că identificatorul agentului nu apare în codul paginii.
Server MCP
Asistenții compatibili MCP se pot conecta la contul Kallina prin autorizare OAuth, pentru a citi agenți, apeluri și leaduri sau pentru a porni apeluri.
Butonul vocal: codul de inserat
Scriptul se încarcă simplu, nu ca modul și nu prin bundler.
<script src="https://app.kallina.info/embed.js" data-widget="WIDGET_ID"></script>
<script>
window.KallinaVoice.on("state", (s) => console.log(s)); // idle | connecting | listening | speaking
window.KallinaVoice.on("message", (m) => console.log(m.source, m.text));
// window.KallinaVoice.start() / window.KallinaVoice.stop()
</script>| Atribut | Ce face |
|---|---|
| data-widget | Identificatorul public al widgetului. Obligatoriu. |
| data-mode | „button” afișează butonul; „inline” nu afișează nimic și lăsați pornirea în seama codului vostru. |
| data-position | Colțul butonului: dreapta jos sau stânga jos. |
| data-color | Culoarea butonului. |
| data-label | Eticheta accesibilă a butonului. |
Autentificarea adreselor de flux
| Metodă | Când o folosiți |
|---|---|
| Fără autentificare | Doar pentru teste, pe fluxuri care nu ating date personale. |
| Basic | Utilizator și parolă, pentru sisteme care nu știu altceva. |
| Antet propriu | Un antet cu o valoare secretă stabilită de voi. |
| Bearer | Un token în antetul de autorizare. |
Unelte MCP disponibile
Numele de mai jos sunt cele din server. Accesul se dă per cont, după autorizare.
- list_agents
- get_agent
- update_agent_prompt
- list_phone_numbers
- list_calls
- get_call_transcript
- list_leads
- export_leads
- start_outbound_call
- list_campaigns
- start_campaign
- account_status
Întrebări frecvente
Aveți un API REST cu chei?
Nu public. Dacă aveți nevoie să porniți apeluri sau să citiți rezultate din sistemul vostru, scrieți-ne cazul și stabilim accesul și forma lui.
Primesc un webhook cu rezultatul după fiecare apel?
Nu ca serviciu standard. Rezultatul se trimite prin fluxuri sau prin integrările existente; pentru un format fix îl discutăm în proiect.
Există documentație?
Pentru butonul vocal și uneltele webhook, descrierea de pe această pagină și ajutorul din aplicație. Pentru orice acces în plus, documentația o primiți la pornirea proiectului.
Uneltele webhook trebuie să răspundă repede?
Da. Fiecare unealtă are un timp maxim de așteptare; un răspuns lent înseamnă o pauză în conversație, deci țineți cererile scurte.
Descrieți-ne ce vreți să legați
Spuneți ce sistem, ce date și în ce moment al apelului. Vă răspundem ce se poate cu ce există și ce trebuie construit.