Base de conocimiento de GetMyBot

Widgets y respuestas privadas de Telegram

Configura widgets de Telegram, procesa selecciones y envía respuestas privadas.

En esta página

Las reacciones pueden enviar widgets interactivos, procesar selecciones y responder en privado a un comando o botón. Las opciones aparecen en el editor cuando están habilitadas para el proyecto y se selecciona un canal de Telegram compatible.

Lección 1. Crea un widget de selección

  1. Conecta un bot de Telegram y abre su proyecto. Crea una reacción para un comando, por ejemplo choose.
  2. En Enviar mensaje, elige Añadir bloque → Widget de Telegram. Introduce un título y, si quieres, un texto.
  3. Añade opciones con una etiqueta visible y datos de evento únicos, por ejemplo yes y no. Puedes crear entre una y ocho opciones; cada dato admite hasta 64 bytes UTF-8.
  4. Guarda el bloque y la reacción. Envía el comando al bot en un chat privado de Telegram y prueba la selección en un dispositivo.

Lección 2. Procesa una selección

Crea otra reacción con el disparador Evento de widget de Telegram. Indica los datos de la opción deseada o deja el campo vacío para aceptar cualquier selección. Añade las acciones y guarda la reacción. Selecciona una opción en el widget enviado y comprueba el resultado.

La acción Responder al widget de Telegram devuelve datos al widget. Colócala justo después de los cálculos necesarios: la espera está limitada a dos segundos y la respuesta puede quedar vacía. Actualizar datos del widget de Telegram modifica el widget de origen; un valor vacío borra el campo seleccionado. Cada campo admite hasta 1024 bytes UTF-8.

Widgets compartidos y reenviados

Activa Widget compartido cuando los mismos datos públicos deban ser visibles para todos los destinatarios. No incluyas información privada en esos datos. Para volver a enviar un widget, selecciona uno creado por el mismo bot y canal.

El procesamiento de widgets reenviados es una opción independiente. Telegram no proporciona el chat del widget reenviado: las restricciones por tipo e ID de chat no se aplican a ese evento y los datos de chat no están disponibles. Solo se pueden actualizar los datos públicos.

Lección 3. Envía una respuesta privada

Para un botón que ejecuta una reacción, abre la reacción de destino y activa la respuesta privada en su acción de envío. La respuesta está destinada a quien pulsó el botón y no debe convertirse en un mensaje normal del grupo. Puedes registrar un comando privado en la configuración de comandos del bot de Telegram.

Usa un solo bloque en la respuesta privada: texto o un archivo multimedia compatible, incluidos audio y vídeo. Prueba el flujo con un bot de pruebas y una persona real. Si falta el contexto del botón o del mensaje, o ha caducado, la respuesta no se envía públicamente.

Audio, vídeo y citas

La acción de envío incluye bloques separados de Audio y Vídeo. Sube un archivo a la biblioteca o elige un file_id de Telegram disponible; usa exactamente un archivo para una respuesta privada. La cita de mensajes con formato se aplica a respuestas normales de Telegram y no es compatible con una respuesta privada.

Widgets en la conversación del operador

Un widget enviado aparece en una tarjeta con su HTML y los últimos datos confirmados. Las actualizaciones correctas de los datos actualizan la tarjeta. Los datos públicos de un widget compartido se actualizan para sus destinatarios del mismo canal de Telegram; los datos del chat pertenecen únicamente al destinatario correspondiente.

La vista previa es de solo lectura: sus botones no ejecutan reacciones. Muestra el estado guardado, no una captura del dispositivo ni una confirmación de lectura. Una respuesta del widget que Telegram no guarda como datos del mensaje y el estado local del cliente pueden ser diferentes. Si no hay una instantánea confirmada disponible, la tarjeta lo indica.

Una nueva pulsación puede enviar a Telegram los mismos datos. La respuesta message is not modified a una edición se considera una acción correcta sin cambios. En una entrada antigua del historial, esta respuesta significa que el mensaje ya contenía el texto y los botones solicitados.

Solución de problemas

  • No aparece el widget o la respuesta privada: comprueba el canal seleccionado y la disponibilidad para el proyecto.
  • La selección no activa la reacción: revisa el disparador, los datos de la opción, el alcance de chats y que la reacción esté activa.
  • No puedes seleccionar un widget compartido: confirma que se creó en el mismo proyecto y canal.
  • Un evento reenviado no actualiza datos de chat: Telegram no proporciona ese contexto; usa datos públicos.

Consulta también reacciones y mensajes y botones.