Añadir botones callback en Telegram

En Telegram se llama botones callback a los botones que, al pulsarlos, envían una solicitud al bot. La respuesta del bot se muestra en una ventana emergente.

Junto con la solicitud, el bot recibe información sobre quién ha pulsado el botón. Por eso puede responder de forma distinta a cada usuario, por ejemplo, insertando su nombre en el texto de la respuesta.

FLOWIN permite añadir automáticamente botones callback a los mensajes reenviados, trasladar a ellos parte del texto, copiar botones existentes y recopilar estadísticas de clics.

Para qué sirven los botones callback

Puedes ocultar detalles importantes de un mensaje en un botón callback. Por ejemplo, en un canal de inversión puedes dejar en el texto la idea de la operación y el nombre de la acción, y mostrar el precio de compra o venta, el stop-loss y el take-profit solo después de pulsar el botón. Si alguien copia automáticamente solo el texto del mensaje, esas condiciones no aparecerán en la copia.

Para obtener la señal completa, hay que pulsar el botón. FLOWIN registrará el clic y en las estadísticas se verá quién ha abierto los detalles y cuándo. Esto ayuda a encontrar a quienes recopilan tu contenido automáticamente. También es posible copiar la propia respuesta, por lo que el botón dificulta la copia, pero no la impide.

Generación de un botón callback

En el modo «Generación», FLOWIN añade un botón nuevo al mensaje reenviado. Tú indicas su nombre y eliges qué mostrar después del clic: una respuesta escrita de antemano o un fragmento del propio mensaje.

Para configurarlo necesitas un reenvío activado en el modo «Copia». Como cuenta remitente, elige un bot conectado mediante token, ya que solo los bots pueden enviar mensajes con botones callback.

Como ejemplo, utilizaremos una señal sobre las acciones de una empresa ficticia. Trasladaremos las condiciones de la operación de la línea «Detalles» al botón «Más información»:

0. Abre @flow_in_bot, envía el comando /start y pulsa «Panel de control».

   

1. Abre «Menú» → «Botones» → «Botones callback». Pulsa «Crear» y elige «Generación».

   

   

2. En «Nombre», introduce «Más información». En «Contenido», pega <regexp>(?<=Detalles: ).*$</regexp>. Este patrón selecciona el texto situado después de «Detalles: ». Pulsa «Crear».

   

3. En el botón creado, pulsa «Aplicar». En la ventana «Selección de reenvíos», marca el reenvío que necesites y pulsa «Guardar».

   

   

4. Envía el ejemplo al chat de origen. En el chat de destino aparecerán puntos suspensivos en lugar de las condiciones de la operación. Pulsa «Más información»: se mostrarán el precio de compra, el stop-loss y el take-profit.

   

   

   

Copia de los botones callback originales

El modo «Copia» sirve cuando el mensaje original ya tiene un botón callback. FLOWIN leerá su respuesta y añadirá al mensaje reenviado un botón con el mismo nombre y texto.

Para copiarlo también necesitas un reenvío en el modo «Copia», con un bot conectado mediante token como cuenta remitente. La cuenta de escucha, es decir, la cuenta que lee los mensajes del chat de origen, será la que pulse el botón original. Comprueba que el botón le responda con texto.

1. Abre «Menú» → «Reenvíos» y pulsa «Configuración» en el reenvío correspondiente.

   

   

2. En la ventana de configuración, abre la pestaña «Botones». En «Lectura de botones», activa «Botones callback» y pulsa «Guardar».

   

3. Abre «Menú» → «Botones» → «Botones callback». Pulsa «Crear» y elige «Copia».

   

   

4. En la ventana que se abre, pulsa «Crear».

   

5. En la configuración creada, pulsa «Aplicar». En la ventana «Selección de reenvíos», marca el reenvío que tiene activada la lectura de botones y pulsa «Guardar».

   

   

6. Envía al chat de origen una señal nueva con un botón. En el chat de destino, abre el botón copiado: el nombre y las condiciones de la operación deben coincidir con los originales.

   

   

Cómo modificar un botón callback

Para modificar un botón ya creado, abre la lista «Botones callback».

1. Pulsa «Cambiar» en el botón correspondiente.

   

2. Modifica los campos que necesites y pulsa «Guardar». Comprueba los datos nuevos en la lista.

   

   

Configuración de los botones callback

En el modo «Generación» están disponibles los cinco campos que se describen a continuación. En el modo «Copia» solo puedes modificar «Color» y «Descripción», ya que el nombre y el contenido se toman del botón original.

Nombre

Indica el texto que se verá en el botón, por ejemplo, «Más información». Este campo es obligatorio.

Puedes utilizar metaetiquetas que insertan datos del mensaje. Por ejemplo, <src-chat-name> inserta el nombre del chat de origen.

Color

Elige una de las cuatro opciones: «Por defecto», «Azul», «Rojo» o «Verde». Si eliges «Por defecto», el botón nuevo tendrá el color estándar de Telegram y el copiado conservará su color original.

Contenido

En este campo se define la respuesta que el lector verá al pulsar el botón. Es obligatorio rellenarlo: escribe un texto preparado o indica un patrón para buscar un fragmento del mensaje.

Para trasladar parte del mensaje al botón, encierra el patrón de búsqueda entre <regexp>…</regexp>. Por defecto se utiliza <regexp>\s.{20,180}$</regexp>: selecciona entre 20 y 180 caracteres al final del mensaje después de un espacio o un salto de línea. Si la respuesta queda vacía, FLOWIN no añadirá el botón.

Si escribes la respuesta como texto normal, sin <regexp>, el contenido del mensaje no cambiará. Puedes añadir a la respuesta las metaetiquetas <clicker-name> y <clicker-id>. FLOWIN las sustituirá por el nombre y el ID de Telegram de quien haya pulsado el botón. Por ejemplo, ¡Hola, <clicker-name>! se convertirá en un saludo con el nombre del lector.

Texto de reemplazo

Este texto aparecerá en el mensaje en lugar del fragmento trasladado al botón. Por defecto quedan puntos suspensivos .... Si dejas el campo vacío, el fragmento se eliminará sin sustituirlo por nada. Esta opción no modifica el mensaje si «Contenido» contiene una respuesta preparada sin un patrón de búsqueda.

Descripción

Aquí puedes dejar una nota sobre la finalidad del botón. Puedes dejar el campo vacío: no afecta al funcionamiento del botón.

Cómo elegir los mensajes para el botón

Para añadir el botón solo a determinados mensajes, vincúlale un filtro, por ejemplo, con la palabra «acciones». Los mensajes sin esa palabra se reenviarán, pero sin el botón. Si vinculas ese filtro al propio reenvío, no se enviarán los mensajes que no contengan «acciones». La configuración se describe en la guía de filtros.

Otras acciones con los botones

Junto a cada configuración de la lista «Botones callback» está el menú «Más». Incluye las siguientes acciones:

• «Aplicar» abre la selección de reenvíos en los que funcionará el botón.
• «Duplicar» crea una copia de la configuración.
• «Seleccionar proyecto» añade el botón a un proyecto.
• «Eliminar» elimina la configuración.

Puedes ver los reenvíos ya seleccionados mediante «Reenvíos [1]». El número entre corchetes indica cuántos hay. En esa ventana puedes añadir reenvíos o quitar aquellos donde ya no necesites el botón.

Cómo consultar las estadísticas de clics

Las estadísticas muestran quién pulsa tus botones y cuánto tarda en abrirlos después de la publicación. Los datos se recopilan por chat de destino: incluyen los botones de todos los reenvíos a ese chat.

1. Abre «Reenvíos» en el menú del panel. En el reenvío correspondiente, pulsa «Botones callback», junto al número de configuraciones vinculadas.

   

2. En la lista «Últimos 10 botones», elige 10, 20 o 30. Aparecerán las estadísticas por usuario: nombre, ID de Telegram y clics.

   

Cómo interpretar los indicadores:

• La columna «clics» indica cuántos botones distintos ha pulsado el usuario. Por ejemplo, 3/5 significa que ha pulsado 3 de los 5 botones. Los clics repetidos no aumentan esta cifra.
• «promedio» y «mediana» indican cuánto tiempo suele pasar hasta el primer clic. La mediana depende menos de los clics aislados con mucho retraso.
• «mínimo» y «máximo» indican el menor y el mayor tiempo de espera hasta el primer clic.
• En la fila de botones se destacan con color los que el usuario ha pulsado. El número indica el orden del primer clic y la cifra entre paréntesis, cuántas veces ha pulsado ese botón.

Si un usuario abre casi todas las señales nuevas con el mismo retraso breve, puede que las esté recopilando automáticamente. Compara la hora de sus clics con la aparición de tus señales en otro canal. Por sí solos, los clics rápidos no demuestran que haya una copia.