Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioConfiguración general e IA

Datos maestros

Para qué sirve#

Son los catálogos que se usan en toda la plataforma: tipos de documento, países con sus departamentos y ciudades, idiomas, monedas y cargos de usuario. Mantenerlos ordenados evita que cada persona escriba los datos a su manera.

Quién puede usarlo y cómo llegar#

  • Solo administradores (los botones de crear, editar y eliminar solo existen para administradores).
  • Avatar → Ajustes de sistema → Configuración general → pestaña Datos maestros.
Los tipos de contacto, los campos opcionales y los campos personalizados del contacto ya no están en Datos maestros: viven en el menú Gestión de contactos de Configuración. Ver la sección de Contactos. El texto de encabezado de la pantalla todavía los menciona.

Cómo se navega#

Al abrir la pestaña ves un menú de cuadros grandes. Al elegir uno se abre solo esa sección y, en lugar de las pestañas, aparece una flecha atrás junto al título para volver al menú.

CuadroPara qué sirve
Tipos de documentoOpciones del campo «Tipo de identificación»: cédula, pasaporte, NIT…
Países, departamentos y ciudadesPaíses con su indicativo y zona horaria, y dentro de cada uno sus departamentos o provincias y sus ciudades o municipios
IdiomasIdiomas disponibles en el contacto; el predeterminado se asigna a los contactos nuevos
MonedasMonedas disponibles en el contacto; la predeterminada se asigna a los contactos nuevos
Cargos de usuarioCargos que se asignan a los usuarios del equipo de agentes

Regla común de eliminación#

Una columna «En uso» te dice cuántos contactos usan cada elemento. Para proteger la información:

  • Un elemento en uso no se puede eliminar (el botón de la papelera ni siquiera aparece).
  • Si quieres dejar de ofrecer un elemento en uso, en los tipos de documento y en los cargos puedes deshabilitarlo en lugar de eliminarlo.
  • Al cambiar el código de un país, idioma o moneda, los contactos que lo usaban lo siguen automáticamente.

Tipos de documento#

CampoDetalle
NombreMáximo 80 caracteres. No puede repetirse
HabilitadoInterruptor (en la tabla y en la ventana). Solo los tipos habilitados se ofrecen al crear o editar usuarios

Por defecto vienen: CEDULA DE CIUDADANIA, PASAPORTE y TARJETA DE IDENTIDAD.

  • Agregar: botón Agregar → escribe el nombre → Guardar («Tipo de documento guardado.»).
  • Eliminar: solo si ningún contacto lo usa. Si lo usan: «No se puede eliminar: N contacto(s) usan este tipo de documento. Puedes deshabilitarlo en su lugar.»

Países, departamentos y ciudades#

Tres columnas que se filtran en cascada:

  1. Países (izquierda): cada fila muestra el nombre y debajo el código, el indicativo con «+» y la zona horaria. Haz clic en un país para ver sus departamentos.
  2. Departamentos / Provincias (centro): muestran el número de ciudades. Mensaje inicial: «Selecciona un país para ver sus departamentos.». Haz clic en uno para ver sus ciudades.
  3. Ciudades / Municipios (derecha): mensaje inicial «Selecciona un departamento para ver sus ciudades.». El botón Agregar de cada columna se activa solo cuando hay un país (o departamento) seleccionado.

La pantalla recuerda tu selección mientras guardas.

Campos de un país#

CampoDetalle
Código2 a 5 letras, se guardan en mayúsculas (ejemplo: CO, MX, US). Error: «Código inválido: usa el código de país de 2 letras (CO, MX, US…).»
NombreObligatorio, máximo 120 caracteres
Zona horariaOpcional. Se elige de la lista de zonas horarias (por ejemplo America/Bogota). Define la hora local del contacto que se muestra en el chat
IndicativoOpcional, solo dígitos (sin el +), hasta 6. Sirve para deducir el país de quien escribe por WhatsApp a partir de su número

Por defecto vienen 30 países (Colombia, México, Estados Unidos, Canadá, España, Argentina, Chile, Perú, Ecuador, Venezuela, Bolivia, Paraguay, Uruguay, Brasil, Panamá, Costa Rica, Guatemala, El Salvador, Honduras, Nicaragua, Cuba, República Dominicana, Puerto Rico, Reino Unido, Francia, Alemania, Italia, Portugal, China e India).

Departamentos y ciudades#

  • Colombia viene precargada con sus departamentos y su ciudad capital como punto de partida; el resto lo agregas tú.
  • Un departamento pertenece a un país y una ciudad a un departamento. Nombre máximo de 120 caracteres.
  • Un mismo nombre no puede repetirse dentro del mismo país (departamentos) ni del mismo departamento (ciudades): «Ya existe un departamento con ese nombre.».

Reglas para eliminar#

ElementoNo se puede eliminar si…Mensaje
PaísHay contactos con ese país, o contactos con esa nacionalidad, o tiene departamentos«No se puede eliminar: hay N contacto(s) usando XX.» / «No se puede eliminar: el país tiene departamentos o contactos (nacionalidad) asociados.»
DepartamentoTiene ciudades o contactos«No se puede eliminar: tiene ciudades o contactos asociados.»
CiudadHay contactos que la usan«No se puede eliminar: N contacto(s) usan esta ciudad.»

Los botones de eliminar solo se muestran cuando el elemento no tiene uso.

Idiomas#

CampoDetalle
Código2 o 3 letras en minúscula, con una variante opcional (por ejemplo es, en, pt, es-mx). Error: «Código inválido: usa el código de idioma (es, en, pt…).»
NombreMáximo 80 caracteres
PredeterminadoBotón Usar por defecto en cada fila. Solo uno puede ser el predeterminado; se asigna a los contactos nuevos

Por defecto vienen: Español (predeterminado), Inglés, Portugués, Francés, Alemán e Italiano.

Eliminar: no se puede eliminar el predeterminado («No se puede eliminar el idioma predeterminado: define otro como predeterminado primero.») ni uno que usen contactos.

Monedas#

CampoDetalle
Código3 a 10 letras en mayúscula (COP, USD, EUR…). Error: «Código inválido: usa el código de moneda (COP, USD, EUR…).»
NombreMáximo 80 caracteres
SímboloOpcional, hasta 8 caracteres (por ejemplo $)
PredeterminadoIgual que en idiomas: la predeterminada se asigna a los contactos nuevos

Por defecto vienen: Peso colombiano (COP, predeterminada), Dólar estadounidense, Euro, Peso mexicano, Peso argentino, Peso chileno, Sol peruano, Real brasileño, Libra esterlina y Dólar canadiense.

Cargos de usuario#

Los cargos describen el puesto de cada persona (por ejemplo «Asesor comercial»). Se asignan al crear o editar un usuario en Equipo de agentes y se pueden usar en los mensajes con la variable {{asesor.cargo}}.

La tabla muestra Cargo, Usuarios (cuántos lo tienen), Estado («● Habilitado» / «○ Inhabilitado») y tres botones:

BotónQué hace
LápizRenombra el cargo (máximo 100 caracteres; no puede repetirse: «Error: ya existe un cargo con ese nombre.»)
Inhabilitar / HabilitarUn cargo inhabilitado deja de ofrecerse al crear usuarios; los que ya lo tienen lo conservan
PapeleraElimina el cargo solo si ningún usuario lo tiene. Si no: «Error: no se puede eliminar: el cargo tiene N usuario(s) asignado(s). Inhabilítalo o cambia el cargo de esos usuarios.»

El sistema no trae cargos creados: empiezas con la lista vacía («Todavía no hay cargos. Crea el primero con «Agregar cargo».»).

Avisos y casos especiales#

Cambiar el código de un país, idioma o moneda modifica también a todos los contactos que lo usan. Hazlo solo si de verdad cambió el código (por ejemplo, una corrección).

<!-- Fuente: tenant-app/public/configuracion/index.php (acciones optcat_*, catalogo_*, cargo_*; sección master y sus modales), db/migrations/0015_catalogos_contacto.sql, db/migrations/0017_campos_opcionales_contacto.sql, db/migrations/0020_hora_local_asignacion.sql, db/migrations/0045_cargos.sql, shared/src/Core/MensajeVariables.php -->

¿Te fue útil esta página?
Última actualización: 14/11/2026