Base de conocimiento de GetMyBot

Personas (CRM)

Buscar a un cliente, leer su conversación, añadir una etiqueta y guardar su teléfono u otros datos. Perfiles, filtros y exportación.

En esta página

La sección Personas reúne a los clientes que han escrito al bot. Abre un perfil para ver la conversación, los archivos y los datos guardados, como el teléfono, el curso que interesa al cliente o el estado de un pago. Los perfiles se crean y actualizan automáticamente a partir de los eventos.

Esta base de clientes se llama CRM. Las etiquetas permiten identificar grupos, por ejemplo «Pagó», mientras que los parámetros guardan valores concretos como phone u order_id.

Lista de usuarios

La tabla muestra el nombre, el ID de Telegram, las etiquetas y la actividad de cada persona: cuándo se la vio por última vez o si bloqueó al bot. Puedes buscar por nombre o ID y usar los filtros Todos, VIP, Pagó, Nuevo y Baja. Cada filtro muestra el número de personas. Pulsa una fila para abrir la conversación.

El filtro Blocked the bot muestra solo a quienes bloquearon al bot; la fecha del bloqueo aparece en su perfil. Export CSV descarga los resultados de la búsqueda y los filtros actuales, hasta un máximo de 10 000 filas. Un CSV puede abrirse en una hoja de cálculo. Sus columnas son tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels; las etiquetas se separan con ; y las fechas usan RFC3339. Las celdas de texto están protegidas para que una hoja de cálculo no las ejecute como fórmulas. Si se alcanza el límite de filas, la API devuelve la cabecera X-Export-Truncated: true. Por API: GET /api/bots/{botID}/users?is_blocked=true&format=csv. El parámetro is_blocked=true|false también funciona con la lista JSON normal; las personas que bloquearon al bot tienen un campo blocked_at.

Qué se guarda sobre cada usuario

El perfil incluye avatar, nombre, @username, enlace Abrir en Telegram, contadores de mensajes y conversaciones, fechas de la primera y la última conversación, etiquetas y parámetros globales. También indica si la persona bloqueó al bot o espera la respuesta de un operador.

Origen del suscriptor indica el primer enlace por el que llegó al bot. Por ejemplo, un enlace distinto para una campaña de primavera permite reconocer a sus visitantes. Los valores que identifican la campaña se llaman etiquetas UTM. En Telegram, la parte adicional del enlace tras start= se llama payload o parámetro de inicio.

Ejemplos de formatos:

  • Telegram: t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Telegram solo admite letras, dígitos, _ y - en el payload. Los pares se separan con __, y el primer - separa la clave de su valor.
  • VK: vk.me/<group>?ref=utm_source=vk&utm_medium=post.
  • Enlace de recomendación: t.me/<bot>?start=ref_<su ID>. El perfil y la sustitución {{referrals.count}} muestran cuántas personas invitó el suscriptor. Los formatos ref=<ID> y ref_<ID> se procesan aparte de las UTM.

Se guardan cinco campos: utm_source, utm_medium, utm_campaign, utm_content y utm_term. Para cada uno se toma el primer valor no vacío. Están disponibles en las sustituciones y en los segmentos como attribution.utm_source … utm_term.

El origen se fija a partir del primer enlace de inicio con un payload no vacío. Este criterio se llama first-touch o «primer contacto». Un /start posterior no cambia el origen ni añade UTM de otro enlace. Si el primer payload era una etiqueta cualquiera o una referencia, los campos UTM quedan vacíos. Un enlace sin payload no fija el origen.

En los segmentos, las UTM del enlace de inicio tienen prioridad sobre los campos del mismo nombre procedentes de visitas a la web. Los campos que falten en el enlace toman sus valores web; un enlace sin UTM no borra esos datos. El origen pertenece al canal del primer inicio y, tras recalcular el segmento, solo se aplica a un suscriptor con el mismo ID en ese canal.

Etiquetas

Una etiqueta identifica un grupo de suscriptores, como «VIP», «Pagó», «Nuevo» o «Baja». Puedes crear etiquetas propias y elegir sus colores. Añade una manualmente o con la acción Cambiar etiquetas; después úsala en las condiciones («Con etiquetas») o para elegir destinatarios de una difusión.

Una etiqueta puede ser permanente o durar un número determinado de días. Al vencer, se elimina automáticamente y el bot recibe el evento Label expired (etiqueta caducada). Por API, usa POST /api/bots/{botID}/users/{tgUserID}/labels con un UUID canónico label_id y, opcionalmente, ttl_days entre 0 y 106751. ttl_days: 0 hace permanente la etiqueta; la fecha de vencimiento de una etiqueta temporal se devuelve como label_expires_at en la lista de personas.

Parámetros

Los parámetros guardan valores asociados a una persona, como nombre, email, importe, estado del pedido o puntos. Pueden rellenarse con Cambiar parámetros, Guardar mensaje o los pasos de un diálogo. Después se usan en sustituciones ({{param.clave}}) y condiciones («Con parámetros»). Así el bot mantiene un pequeño perfil del cliente sin una base de datos externa.

Diálogos

En un diálogo se ven mensajes, fotos, vídeos, mensajes de voz, documentos, botones y marcas de entrega. Las reacciones enviadas aparecen en tarjetas aparte. Abajo puedes responder, adjuntar un archivo o enviar una reacción elegida de la lista.

Adjuntos

Adjuntos abre una galería con todos los archivos del diálogo y los filtros Fotos, Archivos, Voz y Enlaces, además de Descargar todo.

Historial del diálogo e importación

El diálogo conserva toda la conversación. Los mensajes antiguos se cargan al desplazarse hacia arriba, de modo que un historial largo se abre sin esperar a que cargue por completo. Los mensajes nuevos aparecen de inmediato en un diálogo abierto, igual que en la cola de operadores.

Si trasladas un bot desde sambot, el historial de conversaciones se importa junto con los usuarios. Al terminar, el perfil muestra los mensajes y adjuntos anteriores. Consulta Importar desde sambot.

Perfil del cliente y acciones masivas

El perfil reúne los datos del cliente, el historial de eventos (timeline), los segmentos, el diálogo y las notas del operador. El historial se carga por partes y puede filtrarse por tipo, origen y período. Guarda los cambios de propiedades y etiquetas para que queden en el registro de auditoría e inicien el recálculo de segmentos.

Selecciona clientes de la lista para aplicarles una propiedad de forma masiva. La operación conserva una instantánea de los destinatarios seleccionados, admite hasta 5000 personas y puede reintentarse sin duplicar el cambio. La exportación CSV es una operación guardada aparte que puede cancelarse antes de la descarga. Un cambio masivo ya aplicado no puede revertirse parcialmente.

Unir perfiles

El propietario puede seleccionar dos personas en la misma página y elegir Unir perfiles. Comprueba los contactos y canales, selecciona el perfil principal y confirma. Se combinan los datos y el historial; el perfil principal prevalece en caso de conflicto. La unión no se puede deshacer.

Si hay una sincronización de CRM o una operación de Ozma pendiente, espera a que termine o se revise. Resuelve primero los contactos contradictorios y los vínculos a distintos registros de CRM.

Coincidir en el correo no une perfiles automáticamente. Usa identify firmado para vincular a un usuario autenticado del sitio; La vinculación confirmada de Telegram solo está disponible cuando la función está habilitada en la región; conectar el canal no basta.

Qué sigue

Segmentos dinámicos

En Segmentos, define un público combinando condiciones con Y u O. Comprueba la definición en la vista previa antes de guardarla. Tras los cambios, vuelve a calcular sus integrantes y verifica que el segmento esté listo antes de usarlo en una difusión: guardar la definición no demuestra que el número de integrantes esté actualizado.