Cómo está estructurado NN Agent: cliente, cuenta, campaña, diálogo
NN Agent opera con seis entidades. Son las mismas en el panel y en la API, por lo que los nombres de esta página aparecen tanto en las pantallas como en las direcciones de las solicitudes.
Cliente y licencia#
Cliente — su cuenta en NN Agent, a la que están vinculadas las cuentas, campañas y contactos. El cliente se crea al verificar en el bot de Telegram, y se emite un token de acceso a la API para él.
Licencia define cuántos slots tiene activos y hasta qué fecha. Las licencias se activan con un código y se renuevan; en la API, esto es un grupo separado de operaciones — GET /v2/client/licenses, POST /v2/client/licenses/activate, POST /v2/client/licenses/renew.
Cuenta#
Cuenta — cuenta de mensajería conectada, desde la cual NN Agent escribe y lee. La cuenta tiene su propio identificador en formato UUID, nombre y foto; para el cliente del otro lado, es una persona normal, no un bot.
Pueden haber muchas cuentas: se sincronizan en un solo feed, y no es necesario cambiar entre chats. Más detalles — Multi-cuenta.
Sesión de autorización#
Sesión de autorización — objeto temporal que vive exactamente tanto tiempo como dure la conexión de la cuenta. La creas, el mensajero envía un código, envías el código a la sesión, y si es necesario, también la contraseña en la nube, después de lo cual la cuenta se conecta.
La sesión tiene su propio UUID, separado del identificador de la cuenta. Hay una opción con un código QR en lugar del código del mensaje.
Campaña#
Campaña — envío saliente: conjunto de contactos, conjunto de opciones del primer mensaje y cuentas vinculadas que envían esos mensajes. Una cuenta puede participar en varias campañas, y viceversa.
La campaña almacena sus contactos por separado, por lo que la base de una campaña no se mezcla con la base de otra.
Pila de mensajes#
Pila de mensajes — lista de opciones de mensaje inicial de la campaña. NN Agent toma de ella el texto para el siguiente contacto, por lo que toda la base no recibe el mismo carácter en carácter texto.
La pila se llena uno por uno o mediante carga; los elementos individuales se eliminan por identificador.
Contacto y diálogo#
Contacto — registro en la base de la campaña: a quién se debe escribir. Los contactos se cargan mediante un archivo CSV o XLSX y se exportan en el mismo formato.
Diálogo — correspondencia entre su cuenta y un interlocutor específico. El diálogo se dirige a un par «cuenta + identificador del interlocutor», y en este mismo par se leen los mensajes y se envían nuevos.
Cómo está relacionado#
El cliente posee cuentas y campañas. La campaña mantiene contactos y un conjunto de mensajes y se basa en las cuentas vinculadas a ella. El envío a través de la campaña genera diálogos que luego lleva AI según su guion.
Siguiente#
- Primeros pasos — reunir todo esto en el panel.
- Resumen de la API — las mismas entidades con las direcciones de las solicitudes.
- Flujo de chat — lo que sucede con el diálogo después del primer contacto.