Exportación de Base de Datos de Clientes con Comando /export¶
El comando /export exporta información sobre los diálogos de Hotline como un informe tabular de usuarios y chats de grupo. Puede exportar todos los diálogos activos, seleccionar diálogos por una o varias etiquetas, excluir etiquetas concretas o consultar temas eliminados. También puede añadir datos actuales de Telegram: idioma, username, nombre y teléfono.
En esta página, etiqueta significa una marca (mark) de Hotline creada y asignada con el comando /mark. Por eso, la sintaxis del comando y el campo CSV conservan el término técnico mark.
Cómo Funciona¶
El comando funciona únicamente en el tema General del grupo backend. Al iniciarlo aparece un mensaje en General y el operador recibe en el chat privado con el bot de configuración un aviso de generación del informe.
El CSV terminado se envía al operador por ese chat privado. En General solo se publica un resumen con el modo, el número de filas y los errores. Si el bot de configuración no puede enviar un mensaje privado al operador, la exportación no comienza.
Características Principales¶
- Exportación de todos los diálogos activos
- Selección por una o varias etiquetas
- Exclusión de diálogos con etiquetas determinadas
- Exportación de temas eliminados
- Datos actuales de Telegram: username, nombre, idioma y teléfono
- Selección de una conexión cuando varias usan el mismo grupo backend
- Detención de una exportación en curso
Formato de Exportación¶
Para los diálogos activos, el CSV contiene estos campos:
| Campo | Descripción |
|---|---|
chat_id |
Identificador de chat o usuario de Telegram; los temas usan chat_id(thread_id) |
last_date |
Fecha del último mensaje en tema |
status |
Estado actual del diálogo (user_answered, support_answered, closed) |
title |
Nombre del tema |
frontend_type |
Tipo de tema (private, group, channel, etc.) |
topic_link |
Enlace al tema en grupo backend |
marks |
Marcas de Hotline asignadas con /mark, llamadas etiquetas en esta página |
ignore_chat |
Indica si el chat está incluido en IGNORE_CHATS |
Para los diálogos eliminados están disponibles chat_id, last_date, status, title y frontend_type.
La opción with añade los campos seleccionados username, name, lang y phone. También aparece la columna error si Hotline no pudo obtener de Telegram los datos actuales de un chat.
Formato CSV
El archivo CSV se puede abrir en Excel, Google Sheets o importar a otros sistemas CRM para procesamiento posterior.
/export envía el informe al operador como CSV. Con acceso a la API, el mismo informe terminado puede obtenerse como TSV mediante /api/v2/export/{export_id}/report?format=tsv.
Llamar al Comando¶
Ayuda¶
/export
/export help
Ambos comandos muestran la ayuda en inglés.
Todos los Diálogos Activos¶
/export all
Exporta todos los diálogos activos de la conexión actual.
Diálogos con Etiquetas¶
/export mark deal
/export mark vip,deal
Si se indican varias etiquetas, el informe incluye diálogos con al menos una de ellas. /export mark vip,deal selecciona diálogos con la etiqueta vip o deal.
Si alguna etiqueta no existe, la exportación no comienza. Separe los nombres con comas.
Excluir Etiquetas¶
/export all exclude spam,test
/export mark vip,deal exclude blocked
exclude elimina los diálogos que tengan al menos una de las etiquetas indicadas. Se puede usar con all y mark.
Diálogos Eliminados¶
/export deleted
Exporta información del archivo de temas eliminados. Las etiquetas y exclude no se usan en este modo.
Los datos proceden de la base de datos de Hotline. Para comprobar antes si los temas existen y archivar los ausentes, ejecute /sync all deleted en General. Con muchos diálogos, pruebe primero dry con una cantidad limitada, por ejemplo /sync 10 dry.
Datos Adicionales¶
/export all with username,name
/export mark vip,deal with lang,phone
/export deleted with data
Después de with, indique username, name, lang y phone separados por comas. data es una abreviatura para obtener los cuatro campos.
Los datos actuales se consultan en Telegram, lo que aumenta el tiempo de generación. Debido a restricciones de Telegram para cuentas o bots conectados, algunas filas pueden contener un valor en error en lugar de los datos solicitados.
Seleccionar una Conexión¶
/export all instance INSTANCE_ID
/export mark vip,deal instance INSTANCE_ID with data
instance INSTANCE_ID ejecuta la exportación solo para la conexión indicada. Es útil cuando varios bots o cuentas usan el mismo grupo backend.
Detener la Exportación¶
/export stop
Detiene la exportación activa de la conexión. No se genera un informe parcial. Solo puede ejecutarse una exportación por conexión a la vez.
Notas Importantes¶
Derechos de acceso
El acceso se controla con EXTENSIONS_ALLOWED. Si la lista está vacía o ausente, todos los operadores del grupo backend pueden usar el comando. Una lista no vacía lo permite solo a los operadores indicados.
Confidencialidad
El CSV puede contener identificadores de chat, atributos internos de segmentación, nombres y teléfonos. Respete las reglas de confidencialidad. Se recomienda descargar los archivos inmediatamente y eliminarlos del chat al terminar.
Exportación regular
Realice exportaciones regulares de base de datos para crear copias de seguridad.
Límite de Tamaño
Un informe puede contener hasta 100.000 filas. Si el resultado supera este límite, la exportación termina con un error.