Para programadores
O que pode ligar ao Kallina a partir do código, hoje
O Kallina ainda não tem uma API REST pública documentada. Tem quatro pontos de ligação que funcionam: ferramentas webhook chamadas pelo agente durante a conversa, endereços que iniciam fluxos, o script para o botão de voz e um servidor MCP. O acesso à API para casos especiais é discutido mediante pedido.
Pontos de ligação
Ferramentas webhook durante a chamada
Na ficha do agente, defina uma ferramenta: nome, descrição, endereço, método, esquema dos campos e tempo máximo de espera. O agente chama-a quando a conversa o exige e usa a resposta na frase.
Endereços que iniciam fluxos
Um fluxo no construtor pode ter o seu próprio endereço de ativação. O vosso sistema envia um pedido, e o fluxo inicia-se com os dados recebidos.
Botão de voz no site
Um único script na página. A sessão de voz recebe um endereço temporário, por isso o identificador do agente não aparece no código da página.
Servidor MCP
Os assistentes compatíveis com MCP podem ligar-se à conta Kallina por autorização OAuth, para ler agentes, chamadas e leads ou para iniciar chamadas.
Botão de voz: o código a inserir
O script é carregado de forma simples, não como módulo e não através de 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>| Atributo | O que faz |
|---|---|
| data-widget | Identificador público do widget. Obrigatório. |
| data-mode | „button” mostra o botão; „inline” não mostra nada e deixe o arranque ao cuidado do vosso código. |
| data-position | Canto do botão: inferior direito ou inferior esquerdo. |
| data-color | A cor do botão. |
| data-label | A etiqueta acessível do botão. |
Autenticação de endereços do fluxo
| Método | Quando o utilizar |
|---|---|
| Sem autenticação | Apenas para testes, em fluxos que não tocam em dados pessoais. |
| Básico | Utilizador e palavra-passe, para sistemas que não sabem mais nada. |
| Cabeçalho personalizado | Um cabeçalho com um valor secreto definido por vocês. |
| Bearer | Um token no cabeçalho de autorização. |
Ferramentas MCP disponíveis
Os nomes abaixo são os do servidor. O acesso é concedido por conta, após autorização.
- 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
Perguntas frequentes
Têm uma API REST com chaves?
Não é pública. Se precisarem de iniciar chamadas ou ler resultados do vosso sistema, escrevam-nos o caso e definimos o acesso e a sua forma.
Recebo um webhook com o resultado após cada chamada?
Não como serviço standard. O resultado é enviado através de fluxos ou das integrações existentes; para um formato fixo, discutimos no projeto.
Existe documentação?
Para o botão de voz e as ferramentas webhook, a descrição nesta página e a ajuda na aplicação. Para qualquer acesso adicional, a documentação é-vos fornecida no início do projeto.
As ferramentas webhook devem responder rapidamente?
Sim. Cada ferramenta tem um tempo máximo de espera; uma resposta lenta significa uma pausa na conversa, por isso mantenha os pedidos curtos.
Descreva-nos o que quer ligar
Diga que sistema, que dados e em que momento da chamada. Respondemos-lhe o que é possível com o que existe e o que tem de ser construído.