Acción: Esperar respuesta¶
Con esta acción, el bot espera un mensaje del usuario antes de continuar con las acciones siguientes. Puedes validar lo que el usuario envíe y configurar opciones para cancelar la espera, mostrar mensajes de error o redirigirlo a otra parte.
¿Qué puedes hacer con esta acción?¶
- Validar mensajes: Asegúrate de que el usuario envíe texto, números, multimedia o información específica utilizando validaciones predefinidas o expresiones regulares.
- Cancelar la espera: Permite al usuario cancelar la acción con un mensaje específico, como un comando o palabra clave, evitando que se continue a las acciones posteriores.
- Usar datos enviados: El contenido enviado por el usuario estará disponible para usarlo en acciones posteriores.
¿Cómo configurar la acción?¶
1. Crear la acción¶
- Ve a tu bot y pulsa en
🛠 Editar
para entrar en el modo editor. - Selecciona el botón o comando donde deseas agregar la acción, o crea uno nuevo.
- Pulsa en
Acciones 🌟
→🎯 Nueva acción
→⏳ Esperar respuesta
. - Pulsa en
Configurar 🛠
para configurar esta acción.
2. Configurar las opciones¶
➡️ Validación
¶
Define qué debe enviar el usuario. También permite el uso de expresiones regulares para validaciones avanzadas.
Tipos de validaciones predefinidas:
-
Texto
-
Número
-
Email
-
URL
-
Video
-
Foto
-
Audio
-
Documento
-
Animación
-
Contacto
-
Reenviado
-
Ubicación
➡️ Mensaje de error
(opcional)¶
Texto que se enviará si el usuario no cumple con la validación. Permite reintentos.
➡️ Textos para cancelar
(opcional)¶
Palabras clave para cancelar la espera, (ejemplo: Cancelar
, Salir
). Por defecto, /start
cancela cualquier espera del bot.
➡️ Mostrar mensaje al cancelar
(opcional)¶
Mensaje que se enviará al usuario si cancela la espera.
➡️ Pulsar botón al cancelar
(opcional)¶
Define un botón o comando al que redirigir al usuario al cancelar. Ejemplo: /start
3. Activar la acción¶
Pulsa ✅ Activar
para activar esta acción y que quede funcional.
¿Qué devuelve la acción a través de su ID?¶
La acción devuelve información acerca del mensaje enviado por el usuario, y del usuario que envió el mensaje.
Formato para obtener la información
#IDAcción.dato#
- IDAcción: El ID de la acción de
Esperar respuesta
(esta acción). - dato: La información que se desea obtener (ejemplo,
text
).
1. Datos generales del mensaje enviado por el usuario¶
text
: Contenido textual enviado por el usuario. Ejemplo:Hola, quiero más información.
file_type
: Tipo de archivo enviado (por ejemplo:photo
,video
,document
, etc.).file_id
: ID único del archivo multimedia enviado, útil para reutilizarlo en otras acciones.
2. Datos del usuario que envió el mensaje¶
id
: ID único del usuario en Telegram. Ejemplo:123456789
.first_name
: Primer nombre del usuario. Ejemplo:Juan
.last_name
: Apellido del usuario (si lo tiene). Ejemplo:Pérez
.username
: Nombre de usuario (sin el@
). Ejemplo:juan_perez
.language_code
: Idioma del usuario en formato ISO 639-1. Ejemplo:es
.is_forward
:True
si el mensaje es un mensaje reenviado; de lo contrario,False
.is_premium
:True
si el usuario tiene una suscripción Telegram Premium; de lo contrario,False
.contact
: Información del contacto compartida por el usuario (si lo compartió).location
: Coordenadas de la ubicación compartida por el usuario (si la compartió).
3. Datos si el mensaje fue reenviado (si is_forward
es True
)¶
forward.id
: ID único del chat del que proviene el mensaje reenviado.forward.title
: Nombre del canal o grupo de donde proviene el mensaje reenviado.forward.first_name
: Primer nombre del usuario original del mensaje reenviado.forward.last_name
: Apellido del usuario original del mensaje reenviado.forward.username
: Nombre de usuario del remitente original (sin@
).forward.is_bot
:True
si el remitente original es un bot; de lo contrario,False
.forward.is_premium
:True
si el remitente original tiene Telegram Premium; de lo contrario,False
.
Ejemplo práctico: Solicitar un email¶
En este ejemplo, el bot guiará al usuario para que proporcione su email. El bot validará que el email sea correcto, agradece al usuario y enviará el correo al administrador.
1. Crea un nuevo botón¶
- Entra al modo editor pulsando
🛠 Editar
en tu bot. - Pulsa en
✳️ Nuevo botón | comando
. - Escribe el nombre del botón, por ejemplo:
Enviar email
- Pulsa en
Acciones 🌟
para configurar las acciones de este botón.
2. Agrega las acciones necesarias¶
a) Acción 1: Enviar mensaje¶
El bot pedirá al usuario que proporcione su correo electrónico.
- Pulsa en
🎯 Nueva acción
→✉️ Enviar mensaje
. -
Pulsa en
Configurar 🛠
→💬 Establecer mensaje 💬
e ingresa:Hola {first_name}, envía tu correo electrónico para continuar. Si deseas cancelar, envía /cancelar
-
Regresa al menú de acciones y pulsa
✅ Activar
para activar esta acción.
b) Acción 2: Esperar respuesta¶
El bot esperará el correo y lo validará.
- Pulsa
🎯 Nueva acción
→⏳ Esperar respuesta
. -
Pulsa en
Configurar 🛠
y realiza los siguientes ajustes:- Validación: Marca la opción
email
. Esto asegurará que el usuario pueda enviar un correo válido. -
Mensaje de error: Escribe el mensaje que se mostrará si el correo no es válido. Ejemplo:
El email que enviaste no es válido. Por favor, inténtalo nuevamente.
-
Textos para cancelar: Escribe
/cancelar
para permitir al usuario detener la espera si lo desea. - Mostrar mensaje al cancelar: Escribe el mensaje que aparecerá si el usuario cancela. Ejemplo:
Operación cancelada. Si necesitas ayuda, no dudes en contactarnos.
- Validación: Marca la opción
-
Regresa al menú de acciones y pulsa
✅ Activar
para activar esta acción.
c) Acción 3: Enviar mensaje (al usuario)¶
El bot confirma que recibió el correo correctamente. A este punto solo llegará si se pasa la validación en la acción anterior.
- Pulsa en
🎯 Nueva acción
→✉️ Enviar mensaje
. -
Pulsa en
Configurar 🛠
→💬 Establecer mensaje 💬
e ingresa un mensaje agradeciendole al usuario por enviar su email.Gracias por proporcionarnos tu email.
-
Regresa al menú de acciones y pulsa
✅ Activar
para activar esta acción.
d) Acción 4: Enviar mensaje (a ti)¶
El bot enviará el correo recibido al administrador.
- Copia el ID de la acción de
Esperar respuesta
(acción 2). - Pulsa en
🎯 Nueva acción
→✉️ Enviar mensaje
. -
Pulsa en
Configurar 🛠
→💬 Establecer mensaje 💬
e ingresa el mensaje que le enviará el email al administrador.📧 Nuevo correo recibido: Email: {#IDAcción.text#} Usuario: {#IDAcción.first_name#}
Reemplaza
IDAcción
con el ID de la acción deEsperar respuesta
que copiaste. -
Ve a
👤 Enviar a alguien más 👤
y escribe tu@username
o tu ID de Telegram para que este mensaje te llegue a ti como administrador. - Regresa al menú de acciones y pulsa
✅ Activar
para activar esta acción.
Resultado final¶
Tu flujo de acciones debería verse así:
- Enviar mensaje: El bot solicita al usuario su correo electrónico.
- Esperar respuesta: El bot espera la respuesta del usuario y valida que el correo proporcionado sea válido.
- Si es correcto, continúa.
- Si es incorrecto, pide al usuario que intente de nuevo.
- Enviar mensaje: Una vez validado, agradece al usuario por proporcionar el correo.
- Enviar mensaje: El bot notifica al administrador con los datos del correo recibido.