Visión general técnica#

Kivox puede operarse enteramente desde Kivox Studio, o integrarse dentro de una aplicación propia mediante su API REST. Una integración típica reparte responsabilidades de forma clara: su aplicación controla la experiencia de usuario, Kivox controla la ejecución conversacional, y sus sistemas externos proporcionan datos y acciones cuando el agente lo requiere.

La API es la base común de la plataforma: todo lo que puede hacerse desde Kivox Studio o desde un SDK pasa por ella. Kivox mantiene SDKs oficiales para algunos lenguajes, que envuelven esta misma API en un cliente idiomático. Si no existe todavía uno para su lenguaje, la API se integra directamente con cualquier cliente HTTP.

#El modelo de integración

Su aplicación identifica el espacio de trabajo y el agente que va a utilizar, crea una conversación asociada a ese agente y le envía mensajes. Una conversación puede contener múltiples mensajes, así que normalmente no se crea una nueva por cada mensaje enviado.

#Recursos principales

#Configuración recomendada

Mantenga los identificadores y credenciales fuera del código fuente.

KIVOX_API_KEY=...
KIVOX_WORKSPACE_ID=...
KIVOX_AGENT_ID=...

Es habitual usar agentes o espacios de trabajo distintos para desarrollo y producción, con credenciales y recursos independientes, de forma que pueda probar cambios sin afectar conversaciones reales.

#Contenido de esta sección