Base de datos

En esta guía te enseñaremos todo lo que necesitas saber sobre las Bases de Datos de uContact para que puedas utilizarlas en tus desarrollos personalizados y crear soluciones que mejoren la experiencia de los clientes.

¿Cómo funcionan?

uContact ofrece acceso controlado a sus bases de datos internas para facilitar desarrollos personalizados e integraciones avanzadas. Esta funcionalidad está destinada a usuarios con permisos específicos que requieran consultar o trabajar con datos del sistema para ampliar las capacidades de la plataforma.

¡Uso responsable!

El acceso directo a la base de datos requiere conocimientos técnicos y debe utilizarse con precaución. Un uso inadecuado puede afectar el rendimiento del sistema. Recomendamos consultar con el equipo de Soporte antes de realizar operaciones complejas.

¿Cuáles son?

uContact cuenta con tres bases de datos principales, cada una con una función específica dentro del ecosistema de la plataforma:

ccdata

Contiene la información estructural del sistema. Aquí se almacenan todos los datos relacionados con la configuración y administración de uContact, como usuarios, conectores, campañas, flujos, entre otros elementos creados dentro de la plataforma.

• El acceso es de solo lectura.
• Se pueden visualizar todas las tablas y el detalle de sus columnas.
• No se permite realizar operaciones de escritura (insertar, modificar o eliminar registros).

ccrepo

Almacena los datos históricos generados durante el uso del sistema. Esto incluye registros de interacciones, métricas, campañas, entre otros datos históricos.

• El acceso es de solo lectura.
• Se pueden visualizar todas las tablas y el detalle de sus columnas. Consulta el diccionario de datos de las tablas principales de ccrepo.
• No es posible modificar, insertar ni eliminar datos en esta base.

cccustom

Diseñada exclusivamente para desarrollos personalizados. Esta base permite extender la funcionalidad de uContact mediante la creación de estructuras de datos propias.

• Se permite crear nuevas tablas, así como insertar, actualizar y eliminar registros.
• Es ideal para integraciones externas, almacenamiento de configuraciones específicas o cualquier lógica adicional que se quiera implementar sin afectar las bases principales del sistema.

¿Qué permite el acceso?

El acceso a las Bases de Datos de uContact está pensado para usuarios con necesidades avanzadas de integración y personalización.

El acceso a las bases de datos permite:

• Desarrollar integraciones con sistemas externos (CRM, ERP, herramientas BI, etc.).
• Implementar lógicas personalizadas directamente relacionadas con campañas, reportes o flujos de trabajo.
• Almacenar información adicional que complemente la experiencia de atención en uContact.

Oops, ¡acceso limitado!

Para acceder a esta funcionalidad, es necesario contar con un usuario especial. Si necesitas acceso, contacta al equipo de Soporte enviando un correo a ucontact.support@net2phone.com

Acceso a la interfaz

Una vez que tu usuario especial haya sido habilitado, encontrarás la opción Base de Datos dentro del menú Desarrollador, simplemente tienes que hacer clic para poder acceder.

Aceptación de términos

La primera vez que accedas a la funcionalidad de Base de Datos, se mostrará un mensaje de responsabilidad que deberás aceptar obligatoriamente para continuar:

Mensaje de responsabilidad:

Entiendo que acceder y usar la base de datos de una manera para la que no fue diseñada, puede resultar en degradaciones de servicio y caídas.

• Este mensaje aparece una sola vez al iniciar sesión por primera vez con el usuario especial.
• Debes aceptarlo obligatoriamente para poder acceder a la interfaz de base de datos.
• Una vez aceptado, no volverá a aparecer en futuros accesos.

¿Dónde se pueden utilizar consultas personalizadas?

Las consultas personalizadas a las bases de datos pueden utilizarse en:

• Diseñador de flujos: actividades con consultas SQL para lógica personalizada
• Wallboards: widgets con consultas para métricas y reportes en tiempo real
• Tareas programadas: automatización de procesos con acceso a datos

Ejemplo:

SELECT guid, channel, agent FROM ccrepo.interactions WHERE campaign = 'Ventas' LIMIT 10;

Entorno de trabajo

uContact proporciona una interfaz web integrada que permite interactuar con las bases de datos de forma visual e intuitiva.

Características principales

• Interfaz gráfica completa: visualiza tablas, ejecuta consultas y administra estructuras de datos sin necesidad de herramientas externas.
• Acceso controlado: solo disponible para usuarios con los permisos correspondientes.
• Tres bases de datos disponibles: ccdata, ccrepo y cccustom con sus respectivos niveles de acceso.

¿Qué puedes hacer?

En todas las bases de datos:

• Ejecutar consultas SQL de tipo SELECT para ver la información disponible.
• Visualizar detalles de las tablas y columnas, incluyendo tipos de datos, claves primarias, relaciones y restricciones.

Solo en cccustom:

• Crear y administrar estructuras personalizadas: tablas, procedimientos almacenados, funciones e índices.
• Gestionar datos: insertar, actualizar y eliminar registros según las necesidades de tu desarrollo.
• Diseñar tu esquema de datos: construye la estructura que mejor se adapte a tu caso de uso.

Buenas Prácticas

• Documenta tus tablas y campos personalizados para facilitar el mantenimiento.
• Utiliza índices apropiados para optimizar el rendimiento de tus consultas.
• Realiza pruebas en un entorno controlado antes de implementar cambios en producción.

Restricciones de acceso

Solo los usuarios con permisos especiales, otorgados por el equipo de Soporte, pueden ejecutar, crear o editar consultas personalizadas en:

• Actividades del Diseñador de flujos
• Paneles de Wallboards
• Tareas

Los usuarios sin estos permisos no podrán visualizar ni modificar las queries existentes en estas funcionalidades.