Base de conocimiento

La Base de conocimiento es lo que la asistente de IA sabe sobre su empresa: planes y precios, condiciones comerciales, respuestas listas para procesos y dudas frecuentes, y el aviso de incidente del momento. Esta página muestra cómo registrar cada parte, importar los textos que el equipo ya usa, verificar lo que lee la IA y escribir de una forma que la IA aproveche bien.

Visión general

Sin la base, la asistente sabe atender con lo que ve en los sistemas (registro, financiero, red), pero no sabe cuánto cuesta el plan de 500 Mbps, si hay permanencia o cómo funciona el cambio de titularidad: en esos casos transfiere al sector comercial. Con la base completa, responde esas dudas por sí sola, conduce contrataciones y mejoras de plan y explica un incidente en curso sin ocupar al equipo.

La pantalla está en el menú, grupo de administración, en Base de conocimiento (subtítulo Planes, condiciones y respuestas que la asistente usa para atender). Tiene la tarjeta de las bases arriba, las tarjetas de contenido de la base en edición y dos botones en el encabezado:

PartePara qué sirve
Bases de conocimientoUna base por empresa u operación, con nombre, y las conexiones que atiende cada una. Vea Varias bases.
Aviso para la asistenteIncidente o comunicado del momento, con vigencia.
PlanesLos planes que ofrece la asistente, con los valores oficiales.
Condiciones comercialesCargos, permanencia, cobro, vencimientos, cobertura, datos para contratar y el nombre de la empresa tal como la IA debe escribirlo.
Respuestas listasProcesos y dudas frecuentes, en formato de pregunta y respuesta.
Botón Ver lo que lee la IAMuestra exactamente el texto que va a la asistente y su tamaño.
Botón Importar de un textoLa IA lee los textos que el equipo ya usa y los separa en planes, condiciones y respuestas.

Quién accede

Se necesita el permiso Base de conocimiento del perfil de acceso (descripción en la pantalla de perfiles: Planes, precios, condiciones comerciales, respuestas listas y el aviso de incidente que la asistente usa en la atención.). Otórguelo a quienes se ocupan del área comercial y del soporte, además del administrador. Vea Usuarios y perfiles.

La base la usa la asistente que atiende al cliente por sí sola, recurso de plan a partir de NORMAL. En planes sin IA autónoma, la pantalla puede completarse, pero no hay quien la use en la atención. Vea Requisitos y planes.


Varias bases: una por empresa

Quien atiende más de un proveedor o más de una operación en el mismo ChatISP registra una base por empresa, cada una con sus propios planes, condiciones, respuestas, contactos, asuntos y aviso. La regla de vínculo es simple:

  • Una base atiende tantas conexiones de WhatsApp como quiera.
  • Cada conexión usa una sola base. Activar un número en otra base lo saca de la anterior.
  • El par QR + API oficial del mismo número cuenta como un número: la base elegida en una pata vale para la otra.
  • La base existe sin ninguna conexión, en espera o archivada, y nunca se borra junto con una conexión.

La tarjeta Bases de conocimiento

Arriba de la pantalla, cada base aparece como una tarjeta con el nombre y cuántas conexiones atiende (Atiende 1 conexión, Sin conexión por el momento, o la etiqueta Archivada). Tocar una tarjeta pasa a editar esa base: todo lo que está abajo (aviso, planes, condiciones, respuestas, contactos, asuntos, los botones Ver lo que lee la IA e Importar de un texto) vale para la base seleccionada. Justo debajo de las tarjetas están:

AcciónQué hace
Nueva basePide el nombre (cómo el equipo llama a la empresa u operación) y abre la base nueva para edición de inmediato.
RenombrarCambia el nombre de la base en edición. El nombre comercial que escribe la asistente es otro campo, en Condiciones comerciales.
ArchivarSuelta todas las conexiones de la base y la guarda. No se borra nada; Reactivar la trae de vuelta y usted vuelve a activar los números.
EliminarBorra la base y todo lo que guarda. Solo funciona con la base sin ninguna conexión: cambie la base de los números o archive antes.
Conexiones atendidas por esta baseUn interruptor por número. Activar graba al instante y muestra de qué base salió el número; desactivar deja el número sin base.

En la tarjeta de la conexión

En Conexiones, cada tarjeta tiene el cuadro Base de conocimiento con el nombre de la base en uso y el botón Cambiar. Sin base, la etiqueta queda en alerta (Ninguna) y el botón pasa a ser Elegir base: la asistente atiende ese número sin los datos comerciales de la empresa, transfiriendo dudas de plan y contratación al área comercial.

Conexión nueva, conexión eliminada

  • Con una sola base activa en la instalación, toda conexión nueva ya nace atendida por ella.
  • Con más de una, la conexión nueva nace sin base y la tarjeta pide la elección.
  • Al eliminar una conexión, la base queda como está. Cuando el mismo número vuelve a conectarse (QR o API oficial), la base y los flujos que atendían el número vuelven solos, siempre que la base siga activa y la conexión nueva todavía no tenga una elegida.

Asistente en esta base

La tarjeta Asistente en esta base indica quién es la asistente cuando atiende los números de esta base: Nombre de la asistente (solo para armar la sugerencia) y Persona en esta base. En blanco, vale la persona general de Configuración, mostrada en el campo como ejemplo, y la tarjeta avisa Esta base usa la persona general de Configuración. El botón Sugerir texto arma la persona con el mismo molde del asistente de configuración, con el nombre de la asistente y el nombre de la empresa de esta base; Volver a la persona general limpia el texto. Así el número del proveedor B deja de presentarse como el proveedor A.

ERP de esta base

Al final de la misma tarjeta, Sistemas de gestión (ERP) de esta base lista los ERP vinculados a esta empresa. La elección se hace en Integraciones, en la tarjeta de cada ERP (Atiende: Todas las bases o el nombre de una base; la elección solo aparece con más de una base activa). En los números de una base, la asistente y la ficha del cliente consultan solo sus ERP y los que atienden todas, incluso al localizar un registro por documento o nombre completo; un número sin base solo ve los ERP que atienden todas. Un ERP sin base atiende todas, como siempre.

La base predeterminada de la instalación es la primera activa. Es la que el asistente de configuración completa en el paso de planes y condiciones, y es su nombre comercial el que aparece donde no hay una conversación en curso.


Cómo usa la IA la base

En cada turno de atención, el contenido activo de la base entra en el contexto de la asistente, marcado como dato de la empresa (nunca como instrucción capaz de cambiar sus reglas). Solo entra lo que está activo y aprobado; un campo de condición vacío queda fuera.

Qué hace con cada parte

  • Dudas sobre planes, precios, cargos, permanencia y procesos: las responde ella misma, con los datos registrados, sin transferir.
  • Contratación: presenta las opciones que tienen sentido, aclara las dudas y, cuando el cliente decide, recopila los datos pedidos para contratar, un bloque a la vez. Con todo en mano, transfiere al sector comercial con todos los datos y el plan elegido en el motivo de la transferencia, avisando que el equipo confirma la instalación.
  • Mejora de plan: compara con el plan actual del registro del cliente y muestra solo los planes superiores, con la diferencia de valor.
  • Cobertura: si la lista de cobertura no responde con certeza, recopila la dirección completa y transfiere al sector comercial para que la verifique.
  • Aviso de incidente: responde a quien hable del tema con las palabras del aviso, sin inventar plazos más allá de lo que dice, y solo transfiere si el cliente necesita algo más.
  • Lo que no está en la base: no inventa; transfiere al sector adecuado.

Con la base vacía, toda duda comercial (planes, precios, contratación) va al sector comercial, y la IA recopila antes el nombre y la dirección completa de quien quiere contratar.

El Nombre de la empresa (como lo escribe la asistente) también se usa fuera de la base: la IA recibe la instrucción de escribir el nombre siempre igual, y el sistema corrige errores de escritura del nombre en las respuestas.

Tamaño y el botón Ver lo que lee la IA

El botón Ver lo que lee la IA abre Lo que la asistente lee de la base, con el texto completo armado a partir de la pantalla y el conteo: (n) caracteres enviados a la asistente en cada atención. La base entera tiene un tope de 12.000 caracteres en el contexto de la asistente; lo que lo supere se corta al final (las respuestas listas son la última parte del texto). Como el texto va en cada turno, una base concisa también consume menos IA.

Use Ver lo que lee la IA cada vez que modifique la base: es la forma más rápida de verificar si un plan quedó inactivo, si una condición quedó en blanco o si el texto está cerca del tope.


Aviso para la asistente

La tarjeta Aviso para la asistente sirve para incidentes y comunicados del momento: corte de energía en la región, mantenimiento programado, rotura de fibra. La asistente usa ese texto para responder a quien hable del tema, en lugar de transferir a cada cliente.

  1. Escriba en Texto del aviso (hasta 1.500 caracteres) lo que está ocurriendo, dónde y qué puede esperar el cliente. El ejemplo de la pantalla: "oscilación de energía de la distribuidora en el barrio Grajaú desde las 15 h; los equipos vuelven solos cuando la energía se estabiliza. Equipo monitoreando."
  2. Elija Válido por: 2 horas, 6 horas (predeterminado), 12 horas, 24 horas, 3 días o Hasta que yo lo cierre.
  3. Haga clic en Publicar aviso. La confirmación es Aviso publicado para la asistente y la tarjeta pasa a mostrar Aviso vigente hasta (fecha y hora) o Aviso vigente, sin plazo.
  4. Cuando el incidente termine, haga clic en Cerrar aviso. Con un plazo definido, el aviso expira solo; sin aviso activo, la tarjeta muestra Ningún aviso vigente.

El aviso no se envía a nadie por cuenta propia: solo orienta a la asistente cuando el cliente busca la atención. Para avisar a toda la base de clientes, use una campaña (vea Campañas). Y escriba solo hechos confirmados: la IA repite el aviso como verdad de la empresa, con sus mismas palabras.


Planes

La tarjeta Planes lista los planes que la asistente ofrece para contratación y mejora de plan, con los valores oficiales. Haga clic en Nuevo plan o en editar en un plan existente.

CampoQué completar
Nombre del planObligatorio. Cómo conoce el cliente el plan (ej.: Fibra 500).
TipoResidencial, Empresarial, Rural u Otro. El tipo va a la IA y ayuda a ofrecer el plan correcto; Otro (servicios sueltos, por ejemplo) no se menciona como tipo.
Descarga (Mbps) y Subida (Mbps)Velocidades en números enteros.
Mensualidad (R$)Valor completo.
Valor con descuento (R$)Pagando hasta el vencimiento o en promoción. Déjelo en blanco si no lo hay. La IA lo informa como "pagando hasta el vencimiento o en la promoción".
Detalles (opcional)Hasta 1.000 caracteres: lo que incluye el plan (router Wi-Fi 6, IP fija, aplicaciones), para quién está indicado, restricciones de región.
Imágenes del planAparece al editar un plan ya guardado. Hasta cinco imágenes por plan (JPG, PNG o WebP, hasta 5 MB cada una) con una leyenda que dice qué muestra cada una: la grilla de canales de TV incluidos, los detalles del paquete, el arte del plan. Agregar imagen sube el archivo, la leyenda se guarda al salir del campo y Quitar elimina la imagen. Las miniaturas quedan visibles en la lista de planes.
ActivoDesactivado, el plan sigue registrado (con la marca Inactivo) pero sale de la base que lee la IA.

La lista se ordena por precio. Al eliminar un plan aparece la confirmación ¿Eliminar este plan? La asistente deja de ofrecerlo. Sin ningún plan, la tarjeta muestra Ningún plan registrado. Registre o importe de un texto para que la asistente pueda ofrecerlos.

Con imágenes registradas, la asistente las envía por la conversación al presentar los planes a quien quiere contratar o cambiar de plan, y cuando el cliente pregunta por lo que muestra la imagen (qué canales tiene el plan, por ejemplo), en vez de describir todo por escrito. La leyenda va junto con la imagen. La acción está en Configuración, pestaña Atención, llave Enviar imágenes de los planes, encendida por defecto; sin ningún plan activo con imagen, no entra en la atención.

Los valores de la tarjeta Planes son lo que la IA informa como precio oficial. Al reajustar precios, actualice la base el mismo día; para promociones temporales, use el Valor con descuento o la condición Promoción del cargo y quítela cuando termine.


Condiciones comerciales

La tarjeta Condiciones comerciales define lo que la asistente responde sobre contratación, cobro y permanencia. Campo vacío queda fuera. Cada campo acepta hasta 2.000 caracteres. Complete y haga clic en Guardar al final de la tarjeta.

CampoEjemplo de la pantalla y orientación
Nombre de la empresa (como lo escribe la asistente)El nombre comercial exactamente como debe aparecer en los mensajes. La asistente siempre escribe el nombre así.
Cargo de instalaciónEj.: R$ 150,00 pagados el día de la instalación.
Promoción del cargoEj.: 50% de descuento contratando hoy (R$ 75,00).
PermanenciaEj.: 12 meses.
Multa por rescisiónEj.: 10% de las deudas pendientes.
Modelo de cobroPospago o prepago y cómo funciona la primera boleta proporcional.
Fechas de vencimientoEj.: días 01, 05, 10, 15, 20 o 25.
Formas de pagoEj.: boleta, Pix, tarjeta de crédito.
Envío de las facturasEj.: en PDF por correo electrónico y WhatsApp; impresa solo en la tienda.
EquiposEj.: router en comodato, devuelto al cancelar.
Plazo de instalaciónEj.: en hasta 48 horas hábiles.
CoberturaCiudades y barrios atendidos. Fuera de la lista, la asistente recopila la dirección y la pasa al sector comercial para que la verifique.
Datos pedidos para contratarUno por línea (nombre completo, CPF, dirección con código postal, fecha de vencimiento...). La asistente los recopila y los pasa listos al sector comercial.
Otras condicionesTodo lo demás que la asistente necesita saber sobre contratación y cobro.

Si el nombre de la empresa queda en blanco, la IA usa el nombre informado en el asistente de configuración inicial, cuando lo hay.


Respuestas listas

La tarjeta Respuestas listas guarda procesos y dudas frecuentes (cambio de titularidad, cambio de dirección, cancelación, copia del contrato...). La asistente responde con este contenido. Haga clic en Nueva respuesta:

CampoQué completar
AsuntoContratación, Servicios, Financiero, Soporte o General. Organiza la lista y le da contexto a la IA.
Pregunta o procesoObligatorio, hasta 160 caracteres. Cómo lo preguntaría el cliente. Ej.: ¿Cómo hago el cambio de titularidad?
RespuestaObligatoria, hasta 4.000 caracteres. La respuesta completa, con documentos, plazos, costos y el camino que debe seguir el cliente.
ActivoDesactivada, la respuesta queda guardada pero sale de la base que lee la IA.

Eliminar pide la confirmación ¿Eliminar esta respuesta?

Las respuestas listas de la Base de conocimiento son para la IA. Las respuestas rápidas que el agente inserta con la barra en el chat son otra cosa y están en Registros.


Importar de un texto

En lugar de escribir campo por campo, pegue los textos que el equipo ya usa en la atención y deje que la IA los organice.

  1. Haga clic en Importar de un texto en la parte superior de la página.
  2. Pegue los textos en el campo: tabla de planes, cargo de instalación, permanencia, cómo funciona el cambio de titularidad, lista de datos para contratar. Pueden ir varios textos juntos, hasta 20.000 caracteres. Un texto muy corto (menos de 20 caracteres) se rechaza con Pegue un texto más largo para que la asistente lo analice.
  3. Haga clic en Analizar. La pantalla muestra Leyendo los textos... mientras la IA trabaja (suele tardar algunos segundos).
  4. Revise la vista previa Revisar antes de grabar, separada en Nombre de la empresa, Planes (n), Condiciones (n, solo llenan campos vacíos) y Respuestas listas (n).
  5. Haga clic en Grabar en la base. La confirmación es Base de conocimiento actualizada y la página se recarga con el contenido nuevo.

Reglas de la importación

  • La IA copia valores y condiciones exactamente como están en el texto y no inventa números. Una condición que no aparece en el texto queda vacía.
  • Los procesos (cambio de titularidad, cambio de dirección, cancelación, cambio de vencimiento) se convierten en respuestas listas; lo que ya se convirtió en condición no se repite como respuesta.
  • Las condiciones nunca sobrescriben lo que usted ya escribió: solo llenan campos vacíos. El nombre de la empresa también solo se completa si está vacío.
  • Los planes y las respuestas se agregan a los existentes, ya activos. Importar el mismo texto dos veces duplica los planes y las respuestas: revise la lista después.
  • Si no se encuentra nada aprovechable, aparece No se encontró nada aprovechable en ese texto.; si la IA no logra analizarlo, No fue posible analizar el texto ahora. Intente de nuevo en instantes.

La importación usa IA y aparece en el consumo de IA de la Auditoría (vea Consumo y costos de IA).

La base acepta solo texto. Para aprovechar un PDF (tabla de precios, contrato, preguntas frecuentes), abra el archivo, copie el texto y péguelo en la importación. Relea el resultado: las tablas copiadas de un PDF a veces llegan con las columnas desordenadas.


Contenido esperando aprobación

Cuando la base la registra previamente el equipo de Ravi Systems (por ejemplo, en la implantación, a partir del sitio web y de los textos del proveedor), el contenido llega esperando su aprobación. Nada de eso lo usa la asistente hasta que usted lo apruebe.

  • En la parte superior de la página aparece la franja Importación esperando su aprobación: la asistente no usa nada de esto hasta que usted apruebe., con el conteo de planes, respuestas listas y condiciones sugeridas.
  • Los planes y las respuestas pendientes aparecen en la lista con el sello Esperando aprobación y el botón Aprobar. Editar y guardar un ítem también lo aprueba.
  • Las condiciones sugeridas aparecen completadas y destacadas en el formulario, con la nota Sugerencia de la importación: revise y guarde para aprobar. Guardar la tarjeta aprueba lo que esté en los campos.
  • Aprobar todo activa todos los planes y respuestas pendientes y graba las condiciones sugeridas en los campos que estén vacíos (confirmación: Importación aprobada).
  • Descartar importación borra lo que todavía no se aprobó; lo que usted ya aprobó se mantiene (confirmación: Importación descartada).

Buenas prácticas de redacción para la IA

La asistente responde con lo que está escrito y no completa lo que falta. Cuanto más claro y completo sea el texto, menos transferencias innecesarias.

Escriba hechos, no intenciones

  • Valores siempre con R$ y centavos, plazos con la unidad ("en hasta 48 horas hábiles", "5 días corridos"). Evite "consulte" y "a convenir": en esos casos la IA transfiere.
  • Cada información en un solo lugar. Si la permanencia está en la condición Permanencia, no la repita en una respuesta lista con otro texto: dos versiones diferentes confunden a la IA y al cliente.
  • Indique el camino completo del proceso: qué necesita enviar el cliente, adónde, cuánto cuesta y en cuánto tiempo queda listo.

Piense en cómo pregunta el cliente

  • En Pregunta o proceso, use las palabras del cliente: "¿Cómo cambio mi internet de dirección?" funciona mejor que "Procedimiento de transferencia de punto".
  • Una respuesta por asunto. Las respuestas gigantes que cubren varios procesos son difíciles de usar y consumen el tope de caracteres.

Deje a la base lo que es de la base

  • Los precios, condiciones y procesos van en la base; la forma de hablar va en la persona; el foco de cada etapa va en las instrucciones del flujo (vea Personalidad y reglas fijas).
  • No escriba en la base reglas que contradigan las reglas fijas de la IA (por ejemplo, "diga que la caída fue culpa de la distribuidora" sin confirmación): la base se trata como dato, y las reglas de seguridad están por encima.
  • No ponga en la base datos de clientes, contraseñas ni información interna del equipo: el contenido va a la IA en cada atención.

Manténgala actualizada

  • Reajuste de precio, plan nuevo o promoción terminada: actualice el mismo día. Plan discontinuado: desactive Activo o elimínelo.
  • Publique el aviso de incidente apenas el equipo confirme el problema y ciérrelo cuando se resuelva.
  • Revise de vez en cuando las conversaciones en las que la IA transfirió por falta de información: muestran lo que falta en la base.
ejemplo de respuesta lista
Asunto: Servicios
Pregunta o proceso: ¿Cómo hago el cambio de titularidad?
Respuesta: El cambio se hace sin costo. El titular actual y el nuevo titular deben
enviar una foto del documento con CPF y un comprobante de domicilio del nuevo titular.
Con los documentos, el equipo genera el nuevo contrato en hasta 2 días hábiles y lo
envía por correo electrónico para firma digital. La internet no se corta durante el cambio.

Problemas comunes

SíntomaCausa probable y qué hacer
La IA transfiere dudas de precio aun con planes registradosPlanes inactivos o todavía esperando aprobación, o la duda es sobre algo que la base no cubre. Verifíquelo en Ver lo que lee la IA.
La IA informa un valor antiguoEl plan o la condición no se actualizó, o hay dos informaciones diferentes para el mismo asunto (condición y respuesta lista). Deje una sola.
Una respuesta lista parece ignoradaÍtem inactivo o pendiente, o la base superó el tope de 12.000 caracteres y el final se cortó. Acorte las respuestas más largas.
La importación duplicó planesEl mismo texto se importó más de una vez. Elimine las copias en la lista de planes.
La importación no completó una condiciónEl campo ya tenía texto (la importación nunca sobrescribe) o la información no estaba en el texto pegado.
La IA sigue hablando del incidenteEl aviso no tiene plazo. Haga clic en Cerrar aviso.
No veo el menú Base de conocimientoEl perfil no tiene el permiso Base de conocimiento.