Para desarrolladores
Qué puedes vincular con Kallina desde el código, hoy
Kallina aún no tiene una API REST pública documentada. Tiene cuatro puntos de conexión que funcionan: herramientas webhook llamadas por el agente durante la conversación, direcciones que inician flujos, el script para el botón de voz y un servidor MCP. El acceso a la API para casos especiales lo discutimos a pedido.
Puntos de conexión
Herramientas webhook durante la llamada
En la ficha del agente defines una herramienta: nombre, descripción, dirección, método, esquema de campos y tiempo máximo de espera. El agente la llama cuando la conversación lo requiere y usa la respuesta en la frase.
Direcciones que inician flujos
Un flujo del constructor puede tener su propia dirección de activación. Tu sistema envía una solicitud y el flujo comienza con los datos recibidos.
Botón de voz en el sitio
Un solo script en la página. La sesión de voz recibe una dirección temporal, así que el identificador del agente no aparece en el código de la página.
Servidor MCP
Los asistentes compatibles con MCP se pueden conectar a la cuenta de Kallina mediante autorización OAuth, para leer agentes, llamadas y leads o para iniciar llamadas.
Botón de voz: el código a insertar
El script se carga de forma simple, no como módulo y no mediante 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 | Qué hace |
|---|---|
| data-widget | Identificador público del widget. Obligatorio. |
| data-mode | «button» muestra el botón; «inline» no muestra nada y deja el inicio a tu código. |
| data-position | Esquina del botón: abajo a la derecha o abajo a la izquierda. |
| data-color | El color del botón. |
| data-label | La etiqueta accesible del botón. |
Autenticación de las direcciones del flujo
| Método | Cuándo usarlo |
|---|---|
| Sin autenticación | Solo para pruebas, en flujos que no tocan datos personales. |
| Básico | Usuario y contraseña, para sistemas que no saben otra cosa. |
| Encabezado propio | Un encabezado con un valor secreto establecido por vosotros. |
| Portador | Un token en el encabezado de autorización. |
Herramientas MCP disponibles
Los nombres de abajo son los del servidor. El acceso se da por cuenta, después de la autorización.
- 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
Preguntas frecuentes
¿Tenéis una API REST con claves?
No pública. Si necesitáis iniciar llamadas o leer resultados de vuestro sistema, escríbenos el caso y establecemos el acceso y su forma.
¿Recibo un webhook con el resultado después de cada llamada?
No como servicio estándar. El resultado se envía por flujos o por las integraciones existentes; para un formato fijo lo hablamos en el proyecto.
¿Hay documentación?
Para el botón de voz y las herramientas webhook, la descripción de esta página y la ayuda de la aplicación. Para cualquier acceso adicional, recibiréis la documentación al inicio del proyecto.
¿Las herramientas webhook deben responder rápido?
Sí. Cada herramienta tiene un tiempo máximo de espera; una respuesta lenta significa una pausa en la conversación, así que mantén las solicitudes cortas.
Descríbenos lo que quieres conectar
Dinos qué sistema, qué datos y en qué momento de la llamada. Te respondemos qué se puede hacer con lo que existe y qué hay que construir.