Mensajes y botones
Prepara la respuesta del bot con texto, fotos y botones, y haz preguntas que guarden la respuesta del cliente.
En esta página
Para enviar texto, una foto y un botón «Elegir», añade la acción Enviar mensaje. La respuesta se construye con partes separadas, llamadas bloques: por ejemplo, primero la foto de un producto y después su descripción con botones debajo. Esos botones también se llaman botones inline.
Con la misma acción puedes hacer una pregunta y esperar la respuesta. Por ejemplo, pedir un teléfono y guardarlo en la ficha del cliente. A continuación se explican los bloques, los botones y las preguntas.
Bloques del mensaje
Pulsa Agregar bloque y elige qué enviar. Puedes combinar varios: un saludo de texto, una foto y un archivo con el programa de una clase.
- Texto: texto con formato, sustituciones y botones, de hasta 4096 caracteres.
- Foto: imagen con pie de foto.
- Archivo: documento con descripción.
- Voice: audio OGG/OPUS, MP3 o M4A, de hasta 50 MB, que Telegram muestra como mensaje de voz (
sendVoice). - GIF: animación o MP4 sin sonido de hasta 50 MB (
sendAnimation). - Video note: MP4 cuadrado de hasta 60 segundos (
sendVideoNote), sin pie de foto. El archivo de la biblioteca multimedia se vuelve a subir en cada envío: Telegram no admite ensendVoice,sendAnimationnisendVideoNoteunfile_idobtenido de otra forma. - Carousel: de 2 a 10 tarjetas, cada una con foto, descripción y botones propios. En Telegram se recorren con «‹ ›» dentro de un mismo mensaje mediante
editMessageMediasi cada foto tiene unfile_idválido, indicado en la tarjeta u obtenido de la biblioteca multimedia. Si falta ese ID para alguna foto, todas las tarjetas se envían como mensajes de foto separados. En otros canales, como VK, también se envían por separado. Se conservan la descripción y los botones de cada tarjeta. - Retraso: pausa en segundos antes del siguiente bloque.
- IA: respuesta generada por el modelo a partir de un prompt.
- Reacción: llama a otra reacción, con la opción de esperar a que termine.
Los bloques de voz, GIF, nota de vídeo y carrusel funcionan en las reacciones igual que los demás y también se incluyen en una difusión rápida de la reacción. Consulta Difusiones.
Puedes arrastrar los bloques para cambiar su orden. El modo de presentación puede ser En orden o Aleatorio para variar las respuestas. El menú principal del bot puede quedar Sin cambios, configurarse de nuevo u Ocultar.
Opciones del bloque
Los bloques de texto y archivos multimedia tienen opciones para fijar el mensaje, enviarlo sin sonido, protegerlo contra reenvío, ocultar contenido con un spoiler, quitar la vista previa de enlaces y borrarlo automáticamente después de un número de segundos.
Botones inline
En cada bloque puedes configurar botones mediante Texto del botón y Tipo de botón:
- Texto: envía el texto del botón como respuesta del usuario. En Telegram y VK aparece como teclado de respuestas: pulsarlo puede responder a una pregunta o activar una reacción por texto. En WhatsApp, Instagram, Messenger y el widget web se muestra como botón de respuesta sin teclado permanente.
- Enlace: abre una URL.
- Aplicación web: abre una Telegram Mini App. Consulta Mini App.
- Reacción: al pulsarlo se inicia otra reacción.
- Inline query: inserta «@bot consulta» en el campo de escritura del chat actual o permite elegir otro chat (
switch_inline_query/switch_inline_query_current_chat). Solo está disponible en Telegram tras activar el modo inline con/setinlineen @BotFather. GetMyBot no responde a esas consultas (answerInlineQueryno está implementado): el botón prepara el texto, pero no realiza una búsqueda. - Prefilled text: abre el chat del bot mediante
https://t.me/<bot>?text=…y deja un texto preparado en el campo de escritura, sin enviarlo (prefill). - Payment link: abre una URL de pago obligatoria. Primero debes crear el pago con la acción Emitir una factura (
payment_create). Es una página de pago externa, no una factura nativa de Telegram. - Notificación: muestra un texto al pulsarlo, sin ejecutar una reacción ni transmitir los datos guardados del botón (Carry). En Telegram es un aviso breve o una ventana de hasta 200 caracteres; en VK, una banda breve de hasta 90 caracteres, sin ventana.
Respuesta de texto o mensaje preparado
| Lo que quieres hacer | Tipo y configuración | Qué ocurre al pulsar |
|---|---|---|
| Elegir «Sí» en un formulario | Texto, etiqueta «Sí»; el mensaje debe esperar una respuesta | El paso de diálogo recibe «Sí» |
| Preparar una consulta | Prefilled text, etiqueta «Escribir», texto «Quiero hacer un pedido» | El texto queda en el campo de escritura del chat; la persona puede editarlo y enviarlo |
El texto visible del botón y el mensaje preparado son campos distintos. Preparar texto no envía un mensaje ni inicia una reacción por sí solo.
Un botón Reacción envía al bot un evento de pulsación separado, llamado callback en la documentación técnica. Inline query y Prefilled text actúan dentro de Telegram y no envían ese evento. Por eso no pueden recibir una respuesta answerCallbackQuery ni transmitir datos Carry.
Icono y color del botón
Puedes mostrar un emoji premium antes del texto de un botón. En el campo del icono introduce su ID (icon_custom_emoji_id) como entero positivo de 64 bits. Por ejemplo, 007 se interpreta como 7. Las letras, el cero, los números negativos y los valores demasiado grandes se descartan; el botón se guarda sin icono.
Telegram solo muestra ese icono si el bot tiene los derechos necesarios: un nombre adicional adquirido mediante Fragment, o Telegram Premium del propietario cuando envía directamente a un chat privado o grupo. Para los demás bots, Telegram ignora el icono sin mostrar otro emoji en su lugar.
Estilo del botón define el color: Normal sin color, Principal azul, Éxito verde y Peligro rojo. El campo técnico se llama style.
La opción De un solo uso (quemar al pulsar) (single_use) permite usar los datos guardados del botón una sola vez. El cambio de texto del botón y el borrado del mensaje después de pulsarlo se configuran por separado.
Indicadores de botones
Son opciones adicionales que se activan con una casilla:
- En nueva fila: coloca el botón al principio de la siguiente fila.
- Extender al ancho completo: pone el botón en una fila propia; el siguiente también empezará una fila nueva.
Esquema del aspecto esperado; los corchetes representan botones:
Una fila: [Catálogo] [Ayuda]
En nueva fila: [Catálogo]
[Ayuda]
Ancho completo: [ Ayuda ]
Las filas y los colores funcionan en Telegram y VK. La distribución en filas se conserva al volver a abrir y editar el mensaje. El emoji premium necesita una conexión Telegram compatible y los derechos del bot. No existe un ajuste para «Abrir dentro de Telegram»: la Bot API no permite controlar ese comportamiento con una opción de este tipo.
Límites según el canal
Elige una conexión para el bloque o para un botón concreto. Si eliges Todos los canales, el editor solo ofrece las capacidades comunes a los canales seleccionados. No permite guardar un tipo de botón incompatible.
- Telegram: URL, Mini App, reacciones, aviso o ventana, filas, colores y emoji personalizado si el bot tiene los derechos necesarios.
- VK: URL, reacciones, aviso breve (snackbar), filas y colores. VK Mini App y VK Pay solo están disponibles al elegir una conexión VK compatible.
- WhatsApp: un solo botón URL de llamada a la acción (CTA), sin otros botones en el mismo mensaje. Hasta 3 opciones de respuesta se muestran como botones normales; de 4 a 10, como lista. El texto del botón admite hasta 20 caracteres. No hay filas, colores, Mini App ni avisos.
- Instagram / Messenger: el adaptador actual solo transmite opciones de respuesta (quick replies) de hasta 20 caracteres. No admite URL, Mini App, avisos, filas ni colores.
- Widget web: URL y opciones de respuesta, sin filas, colores ni avisos.
- Email: enlaces, incluidos los de pago, pero no opciones de respuesta ni avisos.
En los botones creados desde una lista solo puedes indicar el número de columnas si el canal admite filas. En los demás canales, el propio canal decide cómo distribuirlos. Los límites de cantidad de botones y longitud del texto se comprueban al enviar.
Qué ocurre al pulsar
Si el botón comunica la pulsación al bot y el canal lo admite, puedes reemplazar el mensaje por un texto o por el contenido de otra reacción, eliminar el mensaje, asignar una etiqueta o guardar un parámetro. Solo en Telegram puedes reemplazar el texto del propio botón después de pulsarlo, por ejemplo, cambiar «Reservar» por «Elegido». Aunque VK permite editar mensajes, no permite cambiar el texto del botón.
Telegram espera que el bot confirme la pulsación mediante answerCallbackQuery. GetMyBot normalmente lo hace y elimina el indicador de carga del botón. Omitir answerCallbackQuery desactiva esa confirmación.
En un botón Reacción, el campo Text on press (notification) permite escribir una confirmación breve, como «Clase elegida»: hasta 200 caracteres en Telegram o 90 en VK; admite sustituciones. Normalmente Telegram la muestra unos instantes sobre el chat. Show as a popup (alert) solo está disponible en Telegram y abre una ventana (answerCallbackQuery con show_alert). Si el texto está vacío, el bot solo retira el indicador de carga. Con Omitir answerCallbackQuery, no se envían ni el texto ni la ventana.
Datos del botón (Carry)
Carry permite que cada botón recuerde a qué se refiere. Por ejemplo, un abrigo y un vestido pueden tener ambos un botón «Comprar». En el primero guarda product_id=101 y en el segundo product_id=102. Al pulsar el vestido, la siguiente reacción recibe {{ctx.product_id}} con el valor 102.
En el editor esta opción se llama Datos al pulsar. La clave indica el nombre del valor; este puede ser un número, texto o sustitución. El bot lo guarda cuando se envía el mensaje y lo coloca en los datos temporales (ctx) cuando se pulsa. Cada botón conserva sus propios valores.
Validez de los datos del botón, segundos (ttl_seconds, TTL) indica cuánto tiempo se conservan: 3600 equivale a una hora. 0 usa el valor predeterminado de 30 días. Al caducar, los datos dejan de estar disponibles. De un solo uso (quemar al pulsar) (single_use) los elimina tras la primera pulsación. Un precio guardado no se actualiza cuando cambia el catálogo: consulta el precio actual mediante el ID del producto antes de cobrar.
Consulta los pasos detallados y la diferencia con los parámetros permanentes en Botones dinámicos y parámetros.
Botones dinámicos
Si ya tienes los productos o clases en una lista, no añadas sus botones a mano. Botones dinámicos de la lista crea uno por cada elemento. Indica la clave de la lista en ctx, un nombre para cada elemento (alias), cuántos botones van en una fila y la plantilla del botón. Por ejemplo, {{item.name}} inserta el nombre de cada producto. Más información en Botones dinámicos y parámetros.
Emoji premium en el texto
En un bloque de texto, el botón de formato Premium emoji inserta <tg-emoji emoji-id="…">🙂</tg-emoji>. Quienes tengan Telegram Premium verán el emoji personalizado; los demás verán el emoji alternativo incluido dentro de la etiqueta. Funciona con los formatos HTML y Markdown del bloque. El ID puede tener hasta 32 cifras; puedes obtenerlo con getCustomEmojiStickers o reenviando un mensaje con ese emoji a un bot como @idstickerbot.
Enlaces al bot y texto preparado
Un enlace t.me/<bot>?start=<param> hace que Telegram envíe /start <param>. No se puede abrir un chat con ese parámetro sin activar /start mediante el mismo enlace. Elige la opción adecuada:
- /start silencioso: en una reacción con el disparador Comando /start y el valor apropiado de Etiqueta en el enlace de inicio, puedes dejar sin bloques la acción Enviar mensaje. El propio
/startno tendrá una respuesta visible, pero su etiqueta ya estará disponible en el contexto del evento para usarla en las condiciones y otras acciones de la reacción. - Prefilled text: el enlace
https://t.me/<bot>?text=<text>(en un botón de este tipo o un botón normal de enlace) abre el chat y deja el texto en el campo de escritura sin enviarlo. No se activa/start: la persona decide cuándo enviarlo. - Mensaje automático «en nombre del usuario» al abrir: la Bot API no permite que un bot envíe mensajes como si los hubiera escrito la persona. La alternativa más cercana es un enlace
?start=y una reacción que responda desde el bot con el texto deseado.
Respuesta esperada (pasos de diálogo)
Un bloque de texto puede Esperar respuesta del usuario (paso del diálogo). Así el mensaje se convierte en un paso y la secuencia queda en pausa hasta recibir la respuesta. Varios pasos consecutivos forman un formulario o asistente dentro del chat.
Tipo de respuesta esperado
El bot puede esperar un tipo concreto: texto, Selección de la lista de opciones mediante botones, foto, vídeo, nota de vídeo, audio, documento, mensaje de voz, ubicación, contacto, calendario o dado. Si la persona envía otro tipo, el paso considera la respuesta inadecuada.
Verificación del texto
Para una respuesta de texto puedes comprobar si es un teléfono, correo, enlace, fecha, hora o si coincide con la fórmula. Por ejemplo, si esperas un teléfono, se rechaza un texto cualquiera y el bot muestra un mensaje de error. La validación mediante fórmula usa una fórmula avanzada: devuelve texto vacío si acepta la respuesta y un mensaje de error si la rechaza.
Guardar la respuesta
Puedes Guardar respuesta en parámetro. Después estará disponible como {{param.clave}} en las sustituciones y se podrá usar en condiciones. Así cada paso va completando la ficha del cliente.
Con la opción de omitir la pregunta si el parámetro ya tiene valor, el bot usa el valor existente. Para una pregunta con validación de email guardada en un parámetro personal, también puede usar el email verificado del perfil vinculado en el widget, Telegram, VK y WhatsApp. Solo se completa automáticamente desde el perfil una dirección verificada; si no hay un valor adecuado, el bot hace la pregunta.
Error, recordatorio y tiempo de espera
- Mensaje al fallar la verificación: qué mostrar si la respuesta no pasa la comprobación.
- Recordar si no hay respuesta: qué enviar si la persona no contesta.
- Cancelar espera de respuesta por tiempo de espera: cuándo dejar de esperar. Al agotarse el plazo puedes Ejecutar reacción al cancelar (opcional), por ejemplo para cerrar el formulario con un mensaje amable. Esa reacción aparece en el gráfico de conexiones como «Tiempo de espera agotado»; la reacción que procesa la respuesta aparece como «Respuesta esperada».
Salir del paso con un comando
/cancel o la palabra rusa отмена cancelan la espera y responden Отменено. («Cancelado»), salvo que se haya configurado una reacción de cancelación. La palabra española «cancelar» no es un comando integrado. Por defecto, los demás comandos se tratan como una respuesta y pasan por la misma validación que el texto normal: el paso puede seguir esperando hasta recibir una respuesta válida. Si activas Bot commands (e.g. /start) end the wait (escape_on_command), cualquier comando, como /start a mitad del formulario, cancela silenciosamente la espera y se ejecuta normalmente.
Sustituciones
El botón Sustituciones inserta variables de la persona ({{first_name}}, {{username}}, {{user_id}}), del evento ({{text}}, {{chat_id}}, {{datetime}}) y de sus parámetros ({{param.clave}}). Consulta la lista completa en Sustituciones y fórmulas.
Botón del menú del bot
La acción Menu button permite elegir el menú normal del bot, una lista de comandos o un botón Mini App con texto y URL. Se puede aplicar al chat actual o a la configuración general del bot. Por ejemplo, configura una Mini App personal solo para el cliente actual. La disponibilidad depende de las capacidades del canal.
Qué sigue
- Sustituciones y fórmulas: variables en textos y botones.
- Acciones: otras acciones de las reacciones.
- Mini App: botón de aplicación web.