Documentación: ClientDesk
ClientDesk es un plugin CRM para Redmine. Gestiona clientes, negocios y productos dentro de un proyecto, vincula las solicitudes a los contactos y gestiona el correo electrónico sin un CRM independiente.
La interfaz del CRM se abre dentro de la página de Redmine. Un cliente, negocio o producto abierto se conserva en la URL de la página, de modo que puede actualizar el enlace o compartirlo con un colega.
Características principales
Qué se añade a Redmine
- Módulo de proyecto «ClientDesk» y un elemento de menú del proyecto ClientDesk.
- Menú superior y menú de aplicación. El elemento ClientDesk se puede activar por separado. Abre el CRM en todos los proyectos accesibles.
- Menú de administración. El elemento ClientDesk abre la configuración del plugin.
- Issue. Campo de contacto, ficha de cliente en la barra lateral, respuesta al cliente, plantillas, valoración y sugerencia de IA.
- Lista de Issues. Columnas y filtros adicionales para contacto, empresa, canal, tiempo de reacción, tiempo de respuesta, tiempo de resolución y valoración.
- Búsqueda de Redmine. La casilla Clientdesk busca clientes, negocios y productos.
- Campos personalizados para clientes, negocios y productos.
Clientes, negocios y productos
- Clientes — contactos y empresas. Un contacto tiene empresa, correo electrónico, teléfono, dirección, país, idioma, asignado y notas.
- Negocios — estado, importe, moneda, fecha de vencimiento, nota y líneas de pedido del catálogo.
- Productos — bienes, servicio o suscripción, con precios en distintas monedas.
- Suscripciones — líneas de pedido de un negocio con un periodo de 1 mes o 1 año. La ficha muestra las activas y las caducadas.
- Panel de control — resumen de clientes, negocios y productos. Los bloques dependen de los permisos del usuario.
- Diario de cambios para un cliente, negocio y producto.
Correo electrónico, respuestas y valoración
- IMAP — bandejas de entrada del proyecto. Un correo crea un Issue o un comentario en un Issue ya abierto.
- SMTP — perfiles de salida. El proyecto selecciona un perfil para las respuestas al cliente.
- Plantillas de respuesta con marcadores de posición para el nombre del cliente, el número del Issue y otros campos.
- Valoración de la solicitud. Cuando se cierra un Issue, el autor puede recibir un correo con un enlace. El enlace se abre sin iniciar sesión en Redmine.
- Cierre automático de solicitudes tras un número determinado de horas, con un correo al cliente.
- IA. En la página del Issue puede generar una respuesta a partir de una instrucción breve.
- Importación desde RedmineUp — contactos, empresas, negocios y productos. Vincular Issues a los nuevos contactos es una acción independiente.
Para quién es
- Soporte — solicitudes por correo, respuestas a clientes y valoraciones de calidad.
- Ventas — clientes, negocios, catálogo y suscripciones.
- Administrador de Redmine — estados de negocio, correo, plantillas e importación.
Compatibilidad
Redmine: 6.0 - 7.0
Bases de datos: MySQL, PostgreSQL, SQLite
El servicio web REST debe estar activado en la configuración de Redmine. De lo contrario, la página de configuración del plugin muestra la advertencia «Active el servicio web REST».
Instalación y actualización
-
Elimine la versión antigua del plugin si está instalada.
cd redmine/plugins rm -r clientdesk -
Copie la carpeta
clientdeskenredmine/plugins/. -
Ejecute las migraciones desde la raíz de Redmine.
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk -
Detenga e inicie Redmine. En algunos entornos, por ejemplo Docker, se requiere una detención e inicio completos, no un reinicio.
Desinstalación
-
Desde la raíz de Redmine ejecute:
bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=clientdesk VERSION=0 -
Elimine la carpeta del plugin.
cd redmine/plugins rm -r clientdesk -
Detenga e inicie Redmine.
Configuración
- Active el servicio web REST en la configuración de Redmine.
- Asigne permisos en Administración → Roles y permisos, sección ClientDesk.
- Active el módulo ClientDesk en Proyecto → Configuración → Módulos.
- Abra la configuración del plugin y cree los estados de negocio.
- Si se necesitan respuestas a clientes, cree un perfil SMTP y selecciónelo en la configuración del proyecto.
- Si se necesita correo entrante, añada un buzón IMAP y vincúlelo al proyecto.
Administración
La configuración del plugin está disponible para un administrador de Redmine de dos formas.
- Administración → Plugins → ClientDesk CRM plugin → Configurar.
- Administración → ClientDesk.
Pestaña «General»
- Mostrar en el menú superior — elemento ClientDesk en el menú superior de Redmine.
- Mostrar en el menú de aplicación — elemento ClientDesk en el menú de aplicación.
- Formato del nombre del contacto — «Nombre Apellido», «Nombre Segundo Apellido», «Apellido Nombre» o «Apellido Nombre Segundo».
- País predeterminado para nuevos contactos.
- Idioma predeterminado para nuevos contactos.
- Monedas disponibles — la lista usada para la moneda del negocio y los precios de los productos.
- Cerrar automáticamente las solicitudes después de — número de horas. El cierre lo realiza un trabajo en segundo plano; véase más abajo.
- Enviar un correo automático al cliente — asunto y cuerpo del correo de cierre. Ambos campos son obligatorios cuando la opción está activada.
Puede insertar en el asunto y el cuerpo del correo de cierre: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{ticket.status}.
Pestaña «Correo»
Lista de buzones IMAP. Un buzón se vincula a un proyecto.
Para un buzón se configuran host, puerto, nombre de usuario, contraseña, método de autenticación, seguridad de la conexión y verificación SSL. Después se configuran la carpeta IMAP, la carpeta de mensajes procesados correctamente y la carpeta de mensajes fallidos.
Reglas de creación de Issues:
- tracker y estado del nuevo Issue;
- Crear contactos — un nuevo contacto para un remitente desconocido;
- Usar el número de Issue del asunto — si el asunto contiene el número de un Issue abierto, el correo se convierte en un comentario en lugar de un nuevo Issue;
- Lista negra de remitentes — un patrón por línea; se permiten expresiones regulares.
El botón «Probar conexión» muestra la carpeta, el número de mensajes y el número de mensajes nuevos.
Pestaña «SMTP»
Perfiles de salida: host, puerto, cuenta, contraseña, seguridad de la conexión y dirección del remitente. Un perfil puede marcarse como predeterminado. En un proyecto puede seleccionar este perfil, otro perfil o la configuración de correo compartida de Redmine.
Pestaña «Estados de negocio»
Un directorio compartido para todos los proyectos. Un estado tiene nombre, color, indicador de activo y tipo: Abierto, Ganado o Perdido. El orden se cambia arrastrando filas. Un estado ya usado en un negocio no se puede eliminar.
Pestaña «Plantillas de respuesta»
Una plantilla es un nombre y un texto. En el texto se pueden insertar campos del cliente, del Issue y del autor de la respuesta:
%{client.name}, %{client.first_name}, %{client.last_name}, %{client.email}, %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.tracker}, %{ticket.status}, %{response.author}, %{response.author.first_name}, %{response.author.last_name}.
En la página del Issue la plantilla se selecciona desde la lista «Insertar plantilla». Se requiere permiso de edición de Issues y permiso de visualización de clientes.
Pestaña «Comunicaciones»
Un diario de mensajes entrantes y salientes. Muestra qué correos ya crearon un Issue o un comentario para que el mismo correo no se procese dos veces. Esta pestaña no tiene botón de guardar la configuración.
Pestaña «IA»
Dirección del servicio al que el plugin llama para generar una respuesta. El comportamiento en la página del Issue se activa en la configuración del proyecto.
Pestaña «Valoración de la solicitud»
Una plantilla de correo compartida que solicita valorar la solicitud. La casilla «Al cerrar un Issue, pedir al autor una valoración» activa la plantilla. El asunto y el cuerpo son obligatorios.
A continuación hay una tabla de proyectos con el módulo ClientDesk. Para cada proyecto elija un modo: Desactivado, Usar plantilla de administración o Plantilla del proyecto. El modo de plantilla de administración está disponible cuando la plantilla compartida está rellenada y activada.
En esta pestaña, las variables de plantilla usan llaves: {%ticket.id%}, {%ticket.subject%}, {%ticket.project%}, {%ticket.author.name%}, {%ticket.author.email%}, {%client.name%}, {%vote.url%}.
Pestaña «Importación»
Tres acciones, solo para administradores.
- Importar desde RedmineUp — crea contactos, negocios y productos. Los Issues no se vinculan en este paso.
- Vincular Issues a nuevos contactos — toma los vínculos de helpdesk para los clientes ya importados. Se omite un Issue que ya tenga un contacto de ClientDesk.
- Eliminar todo — elimina permanentemente contactos, empresas, negocios, productos, notas y vínculos de Issues. Los estados de negocio, los buzones y las plantillas permanecen.
Si faltan las tablas de RedmineUp en la base de datos, la importación lo indica y no crea nada.
Roles y permisos
En la sección ClientDesk:
- Ver clientes — lista y ficha de clientes, notas, búsqueda, campo de contacto en un Issue.
- Gestionar clientes — crear, editar y eliminar clientes y notas; crear un contacto desde la ficha del Issue.
- Ver negocios — negocios y suscripciones.
- Gestionar negocios — crear, editar y eliminar negocios.
- Ver productos — catálogo.
- Gestionar productos — crear, editar y eliminar productos.
El permiso de gestión no incluye el permiso de visualización. Concédelos por separado.
El elemento de menú ClientDesk es visible cuando el módulo está activado y existe al menos un permiso de visualización: clientes, negocios o productos. Las pestañas dentro del CRM se muestran según sus permisos.
La configuración de correo del proyecto la modifica un usuario con permiso de edición del proyecto. Para ello no se requieren permisos de CRM.
Trabajos en segundo plano
La obtención de correo se puede iniciar manualmente desde la configuración del proyecto. Para programarla, desde la raíz de Redmine:
bundle exec rake clientdesk:fetch_mail
El cierre automático de solicitudes se ejecuta solo con este comando:
bundle exec rake clientdesk:auto_close_issues
Configuración del proyecto
Proyecto → Configuración → ClientDesk.
IMAP
Lista de buzones entrantes de este proyecto. Un proyecto puede tener varios buzones. Desde aquí también puede ejecutar «Probar conexión» y «Obtener correo».
Tras la obtención, la página muestra cuántos correos se procesaron, cuántos Issues se crearon y cuántos comentarios se añadieron.
SMTP
Perfil de salida para las respuestas a los clientes. Si no hay ningún perfil seleccionado, una respuesta muestra una advertencia: configure SMTP en Configuración → ClientDesk → Correo.
Feedback
Al cerrar un Issue, pedir al autor una valoración:
- Desactivado;
- Usar plantilla de administración;
- Plantilla del proyecto — asunto y cuerpo personalizados. Ambos campos son obligatorios.
Marcadores de posición de la plantilla del proyecto: %{ticket.id}, %{ticket.subject}, %{ticket.project}, %{ticket.author.name}, %{ticket.author.email}, %{client.name}, %{vote.url}.
Configuración de IA
- Activar sugerencias de IA para respuestas a clientes y el prompt del sistema.
- Activar un prompt prellenado para clientes y el texto de ese prompt.
Uso
Abrir el CRM
Proyecto → ClientDesk.
Pestañas:
- Panel de control — contadores de clientes, negocios y productos. Con permiso de negocios, también se muestran totales por moneda y suscripciones.
- Clientes.
- Negocios.
- Productos.
La cabecera del CRM tiene búsqueda en clientes, negocios y productos del contexto actual. Las listas se pueden filtrar y guardar como consulta.
El elemento del menú superior o del menú de aplicación abre el mismo CRM sin vincularlo a un solo proyecto. Las listas incluyen registros de proyectos donde el módulo está activado y existe permiso de visualización.
Clientes
Filtro de la lista: Todos, Contactos, Empresas.
La ficha del cliente muestra los datos de contacto, negocios relacionados, Issues, notas y campos personalizados. Para un contacto puede crear una empresa directamente en el campo de empresa. La ficha de una empresa muestra sus contactos.
Campos principales del contacto: nombre, segundo nombre, apellidos, correo electrónico, teléfono, cargo, empresa, fecha de nacimiento, dirección, ciudad, región, país, idioma, sitio web, NIF/CIF, origen, asignado y «No contactar». Para una empresa — nombre, sector y tamaño de la empresa.
Se pueden adjuntar archivos a un cliente mediante campos personalizados de tipo «archivo». El diario muestra quién modificó el registro y cuándo.
Un cliente pertenece a un proyecto principal. También se puede hacer visible en otros proyectos: proyectos padre e hijo del principal, todos los proyectos, o la lista «Disponible además en proyectos». Vincular un Issue o un correo al proyecto del cliente no añade por sí solo el cliente a ese proyecto.
Si al crear un contacto el correo electrónico ya existe, el plugin no crea una segunda ficha. Ofrece abrir el contacto existente, añadir el proyecto a la visibilidad o cambiar el proyecto principal. Las acciones disponibles dependen de los permisos.
«Quitar del proyecto» oculta el cliente en el proyecto actual y lo mantiene en el principal. La eliminación de la ficha se realiza en el proyecto principal. Un cliente vinculado a Issues o negocios no se puede eliminar.
Negocios y suscripciones
Un negocio está vinculado a un cliente y a un proyecto. Tiene nombre, estado, importe, moneda, fecha de vencimiento, nota y líneas de pedido. Una línea de pedido es un producto, cantidad, precio y número de orden. El producto proviene del catálogo del proyecto seleccionado. El precio usa la moneda del negocio.
Desde la ficha de un cliente puede crear un negocio con el cliente ya seleccionado. Un negocio se puede mover a otro proyecto si existe permiso de gestión de negocios en ambos proyectos y el cliente es visible allí.
Una suscripción es un producto de tipo «Suscripción» con un periodo de 1 mes o 1 año. La fecha de inicio se establece en el negocio; la fecha de fin se calcula a partir del periodo. Si la fecha de vencimiento del negocio no coincide con las fechas de fin de las suscripciones, el plugin ofrece reemplazar la fecha de vencimiento.
En la página del Issue, al pasar el cursor sobre el nombre del contacto se abre una ficha: nombre, correo electrónico, negocios y suscripciones. Las suscripciones activas y caducadas se muestran por separado. Si el contacto tiene empresa, la ficha también muestra sus negocios. Los negocios de otros contactos de esa empresa se agrupan bajo «Otros negocios».
Productos
Catálogo del proyecto. Tipo de producto: Bienes, Servicio o Suscripción. Una suscripción requiere un periodo. Un producto tiene nombre, descripción, SKU y precios. La moneda del precio se elige entre «Monedas disponibles».
Un producto ya usado en un negocio no se puede eliminar. La ficha del producto muestra los negocios en los que se usa.
Issues
Si el módulo está activado y existe el permiso «Ver clientes»:
- En el formulario del Issue busque el campo de contacto y empiece a escribir un nombre. La búsqueda comienza tras dos caracteres.
- Seleccione un contacto y guarde el Issue.
- En la página del Issue el contacto se muestra en un bloque y en la ficha de la barra lateral. Puede cambiar o vaciar la ficha sin abrir el CRM.
- Con el permiso «Gestionar clientes» puede crear un contacto desde esa ficha.
Un Issue tiene un contacto actual. El cambio de contacto se guarda en el historial de la solicitud.
Puede añadir columnas y filtros a la lista de Issues: contacto, empresa del contacto, canal de la solicitud, tiempo de primera reacción, tiempo de primera respuesta, tiempo de resolución, valoración del cliente, último mensaje y su fecha. Canales: email, teléfono, chat, API. Las columnas seleccionadas se incluyen en la exportación de la lista de Issues.
Respuesta al cliente
En un comentario de un Issue con contacto hay «Responder al cliente». Puede configurar Para, Cc y Bcc. El correo se envía a través del SMTP del proyecto. El diario del Issue indica que se envió una respuesta. Una respuesta del cliente por correo llega como comentario y se marca como respuesta del cliente.
Encima del campo de comentario hay «escribir una respuesta con IA» si las sugerencias están activadas en el proyecto. Una instrucción breve y los datos del Issue se envían al servicio de IA; el texto resultante se coloca en el campo de comentario.
Valoración de la solicitud
Si las valoraciones de solicitudes están activadas en el proyecto, al cerrar un Issue el autor recibe un correo con un enlace. La página de valoración se abre sin iniciar sesión. Valoraciones: Excelente, Normal, Mala. Un comentario es opcional. Se almacena la valoración más reciente. Es visible en el Issue y en la columna de la lista de Issues.
Búsqueda de Redmine
En la página de búsqueda y en la búsqueda rápida de la cabecera hay una casilla Clientdesk. Busca clientes, negocios y productos como un solo grupo. El contador Clientdesk (N) conserva solo esos resultados.
En un solo proyecto la casilla se muestra cuando el módulo está activado y existe permiso de visualización. Al buscar en varios proyectos la casilla se muestra siempre, pero no se devuelven registros de proyectos inaccesibles.
La búsqueda cubre nombre, título, correo electrónico, teléfono, cargo, sitio web, NIF/CIF, nombre y nota del negocio, descripción del producto y campos personalizados marcados como «Buscable». Las notas y los adjuntos no se buscan. «Buscar solo en títulos» conserva nombres y títulos.
Un enlace de resultado abre la ficha en el CRM.
Preguntas frecuentes
¿Por qué falta el menú ClientDesk?
Compruebe tres condiciones.
- El módulo ClientDesk está activado en el proyecto.
- El rol tiene al menos «Ver clientes», «Ver negocios» o «Ver productos».
- Para el elemento fuera de un proyecto, «Mostrar en el menú superior» o «Mostrar en el menú de aplicación» está activado, y el mismo permiso de visualización existe en al menos un proyecto.
¿Por qué la página de configuración dice «Active el servicio web REST»?
El CRM funciona a través de la REST API de Redmine. Active el servicio en Administración → Configuración → API.
¿Puedo importar datos del CRM y vincular Issues de inmediato?
No. Primero «Importar desde RedmineUp», revise las fichas y después «Vincular Issues a nuevos contactos». Si la importación falló, «Eliminar todo» borra los datos importados y no toca estados, correo ni plantillas.
¿Por qué un correo no se convirtió en un nuevo Issue?
Si el asunto contiene el número de un Issue ya abierto y «Usar el número de Issue del asunto» está activado, el correo se añade como comentario. Un correo de la lista negra no crea un Issue. Un correo repetido es visible en la pestaña «Comunicaciones».
¿Quién puede ver la valoración del cliente?
El autor de la solicitud establece la valoración mediante el enlace del correo. En Redmine es visible en el Issue y en la columna de la lista de Issues para los usuarios que pueden acceder al Issue.