Ir al contenido

Empezar

Conceptos clave

Ver como Markdown

Estos once conceptos aparecen en todas las guías del producto. Entenderlos de una vez evita releer la misma explicación en cada manual — cada uno enlaza a la guía donde se detalla el procedimiento completo.

Tu agencia o negocio dentro de Nuntius. Cada cuenta es un compartimento aislado: todo dato — conversaciones, leads, documentos, claves— se filtra siempre por el id de tu cuenta, y un id de otra cuenta en cualquier ruta responde “no existe”, nunca “no tienes permiso” (eso confirmaría que el dato existe). Ver Seguridad y cumplimiento.

La identidad configurable — instrucciones, modelo, recursos asignados— con la que tu asistente conversa. Puedes tener varios agentes atendiendo cosas distintas (uno para ventas, otro para soporte); cada canal o instancia de canal tiene el suyo asignado. Ver Agentes IA.

Un canal es el tipo de vía por la que conversa tu agente: WhatsApp, Telegram, Widget Web, Messenger / Instagram Directo. Una instancia es una conexión concreta de ese tipo — puedes tener varias instancias del mismo canal (dos widgets, dos números de WhatsApp), cada una con su propio agente asignado, sus propios responsables y su propia atribución de origen. Ver Canales.

El hilo de mensajes con un cliente en una instancia de canal. Tiene tres modos: IA (responde el agente), HUMANO (una persona de tu equipo tomó el control) y EN COLA (la IA derivó y espera que alguien la atienda). Ver Conversaciones.

Un lead es una oportunidad dentro de tu embudo de ventas, con etapa, calidad y responsable; se captura sola en cualquier canal o se da de alta a mano. Un contacto es la ficha del cliente en sí (teléfono, verificación, listas de marketing), compartida por todos sus leads y conversaciones — incluye también su memoria, el resumen que el agente mantiene sobre él y comparte entre canales. Ver Leads y Contactos y marketing.

Un recurso es cualquier cosa que un agente puede usar: un documento de la base de conocimiento, una plantilla o un servidor MCP. Una etiqueta es el mecanismo para decidir qué agente ve qué recurso — catálogo único, compartido por toda tu cuenta. Sin etiquetas ni “Acceso a todo”, un agente no ve ningún recurso: denegado por defecto. Ver Agentes IA, apartado de recursos.

Cada acción, plantilla o documento declara si es Interno (solo tu equipo) o Ambos (también un visitante anónimo de un canal público, como el widget de tu web). “Interno” es el valor por defecto para todo lo que no se declara explícitamente — fail-closed. Una pieza Ambos que escribe en un sistema externo devuelve al visitante anónimo solo la confirmación mínima, nunca el dato completo. Ver Control del agente: recursos y permisos.

Para un caller identificado (una persona con sesión, un empleado con su canal propio, una clave de API), un catálogo fino de permisos decide qué puede hacer — cruzado siempre con el techo de su medio de acceso (los scopes sellados de una clave, o el recorte de user_medium_grants de un canal). Ver Control del agente: recursos y permisos y Claves API y medios de acceso.

Un trabajo es una tarea suelta que ejecuta tu agente, puntual o repetida. Un flujo encadena varios pasos con la posibilidad de ramificarse según una condición. Una consigna es un flujo que le pides a tu asistente por chat, en tu propio lenguaje, y que él construye — se edita igual que uno hecho a mano. Ver Trabajos y flujos.

Una credencial secreta para llamar a /public/v1 desde tu propio código — pensada para integraciones máquina a máquina, nunca para que una persona inicie sesión con ella. Se muestra completa una única vez; sus scopes de lectura/gestión por recurso quedan sellados al crearla. Ver Claves API y medios de acceso y Autenticación.

Model Context Protocol, el estándar abierto para que un asistente de IA use herramientas externas de forma estructurada. Tiene dos direcciones opuestas en Nuntius: el servidor MCP propio saca tu cuenta (leads, contactos, citas…) hacia TU asistente de IA externo (Claude Desktop, Claude Code, Cursor); un servidor MCP externo (BYO-MCP), que tú registras en Ajustes, mete herramientas de terceros dentro del agente que atiende a tus clientes — bajo tu propia responsabilidad. Ver Integraciones y MCP.