Per sviluppatori
Cosa potete collegare a Kallina dal codice, oggi
Kallina non ha ancora un API REST pubblico documentato. Ha quattro punti di collegamento che funzionano: strumenti webhook chiamati dall'agente durante la conversazione, indirizzi che avviano flussi, lo script per il pulsante vocale e un server MCP. L'accesso all'API per casi speciali lo discutiamo su richiesta.
Punti di collegamento
Strumenti webhook durante la chiamata
Nella scheda dell'agente definite uno strumento: nome, descrizione, indirizzo, metodo, schema dei campi e tempo massimo di attesa. L'agente lo chiama quando la conversazione lo richiede e usa la risposta nella frase.
Indirizzi che avviano flussi
Un flusso nel costruttore può avere il proprio indirizzo di attivazione. Il vostro sistema invia una richiesta, e il flusso parte con i dati ricevuti.
Il pulsante vocale sul sito
Un solo script sulla pagina. La sessione vocale riceve un indirizzo temporaneo, quindi l'identificatore dell'agente non appare nel codice della pagina.
Server MCP
Gli assistenti compatibili con MCP si possono connettere all'account Kallina tramite autorizzazione OAuth, per leggere agenti, chiamate e lead oppure per avviare chiamate.
Pulsante vocale: il codice da inserire
Lo script si carica semplicemente, non come modulo e non tramite 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>| Attributo | Cosa fa |
|---|---|
| data-widget | L'identificatore pubblico del widget. Obbligatorio. |
| data-mode | "button" mostra il pulsante; "inline" non mostra nulla e lasciate l'avvio al vostro codice. |
| data-position | Angolo del pulsante: in basso a destra o in basso a sinistra. |
| data-color | Colore del pulsante. |
| data-label | Etichetta accessibile del pulsante. |
Autenticazione degli indirizzi di flusso
| Metodo | Quando utilizzarla |
|---|---|
| Senza autenticazione | Solo per test, su flussi che non toccano dati personali. |
| Base | Nome utente e password, per sistemi che non conoscono altro. |
| Intestazione personalizzata | Un'intestazione con un valore segreto stabilito da voi. |
| Bearer | Un token nell'intestazione di autorizzazione. |
Strumenti MCP disponibili
I nomi qui sotto sono quelli del server. L'accesso viene concesso per account, dopo autorizzazione.
- 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
Domande frequenti
Avete un'API REST con chiavi?
Non pubblica. Se avete bisogno di avviare chiamate o leggere risultati dal vostro sistema, scriveteci il caso e stabiliremo l'accesso e la sua forma.
Ricevo un webhook con il risultato dopo ogni chiamata?
Non come servizio standard. Il risultato viene inviato tramite flussi o tramite le integrazioni esistenti; per un formato fisso lo discutiamo nel progetto.
Esiste documentazione?
Per il pulsante vocale e gli strumenti webhook, la descrizione di questa pagina e l'aiuto nell'applicazione. Per qualsiasi accesso in più, la documentazione la ricevete all'avvio del progetto.
Gli strumenti webhook devono rispondere rapidamente?
Sì. Ogni strumento ha un tempo massimo di attesa; una risposta lenta significa una pausa nella conversazione, quindi mantenete brevi le richieste.
Descriveteci cosa volete collegare
Dite quale sistema, quali dati e in quale momento della chiamata. Vi diciamo cosa si può fare con ciò che esiste e cosa va costruito.