Saltar a contenido

Acción: esperar respuesta

Esta acción esperará a que el usuario envíe algo para continuar con el resto de las acciones.

Puedes aplicar validaciones para garantizar que el usuario envía exactamente lo que se espera que envíe, si lo enviado no cumple con una validación se mostrará el mensaje de error especificado, y entonces el usuario podrá volver a intentarlo.

También puedes usar textos para cancelar, si el usuario envía alguno de estos textos se detendrá la acción y se mostrará el mensaje al cancelar establecido, en caso de haber, y por último se pulsará el botón al cancelar establecido, también en caso de haber.

Lo que envíe el usuario es accesible a través del ID de esta acción, podrá ser usado en acciones posteriores usando #IDAcción#,

Opciones de la acción:

  • Validación: Para validar que lo que envíe el usuario sea lo esperado, se puede validar texto, números, emails, url, videos, fotos, entre otros. También puedes establecer validaciones más avanzadas haciendo uso de expresiones regulares, por ejemplo, la expresión regular para validar que lo enviado por el usuario sea una dirección de TRX válida sería ^T[A-Za-z1-9]{33}$.
  • Mensaje de error (opcional): Es el mensaje de error que será enviado al usuario si no se cumple la validación, el usuario podrá reintentar hasta que se cumpla o hasta que envíe uno de los textos de cancelación. Puedes usar expresiones, variables, e IDs de acciones anteriores para mejorar tus mensajes.
  • Textos para cancelar (opcional): Uno o varios textos que al ser enviados cancelarán esta acción y todas las que le siguen, es una buena práctica crear anteriormente un teclado con estos textos para que el usuario sepa cómo cancelar. Además, por defecto /start cancela cualquier espera en el bot.
  • Mostrar mensaje al cancelar (opcional): Es el mensaje que será enviado al usuario cuando este envíe uno de los textos de cancelación, ideal para hacerle saber que la operación ha sido cancelada. Puedes usar expresiones, variables, e IDs de acciones anteriores para mejorar tus mensajes.
  • Pulsar botón al cancelar (opcional): Para especificar que al enviar uno de los textos para cancelar se pulse automáticamente uno de los botones o comandos principales del bot, para de esta forma redirigir al usuario hacia alguna parte, por ejemplo, al menú principal.

¿Qué devuelve la acción a través de su ID?

  • text: Si lo que envió el usuario es un texto, podrás acceder a él a través de #IDAcción.text#.
  • file_type: Si lo que envió el usuario es una multimedia o archivo, aquí podrás consultar de qué tipo es.
  • file_id: Si lo que envió el usuario es una multimedia o archivo, podrás acceder a su file_id través de #IDAcción.file_id#.
  • id: ID de Telegram del usuario que envió el mensaje.
  • first_name: Primer nombre del usuario.
  • last_name: Apellido del usuario.
  • username: Nombre de usuario, sin @.
  • language_code: Código de idioma del usuario, en formato ISO 639-1.
  • is_deleted: Devuelve True si el usuario es una cuenta eliminada en Telegram, o False si no lo es.
  • is_bot: Devuelve True si el usuario es un bot, o False si no lo es.
  • is_premium: Devuelve True si el usuario es un usuario con una suscripción Premium de Telegram activa, o False si no lo es.
  • is_verified: Devuelve True si el usuario es un usuario verificado por Telegram, o False si no lo es.
  • is_restricted: Devuelve True si el usuario tiene alguna restricción impuesta por Telegram, o False si no tiene ninguna.
  • is_scam: Devuelve True si el usuario tiene la etiqueta de estafa impuesta por Telegram, o False si no la tiene.
  • is_fake: Devuelve True si el usuario es catalogado como falso por Telegram, o False si es real.
  • is_forward: Devuelve True si el mensaje es un mensaje reenviado, o False si no lo es.
  • contact: Devuelve el contacto del usuario, en caso de que lo haya compartido.
  • location: Devuelve la ubicación del usuario, en caso de que la haya compartido.

Si is_forward es True, también podrás acceder a lo siguiente:

  • forward.id: ID de Telegram del chat del cual proviene el mensaje reenviado.
  • forward.title: Si el mensaje reenviado proviene de un canal o grupo, devuelve su nombre.
  • forward.first_name: Si el mensaje reenviado proviene de un usuario, aquí se almacena su primer nombre
  • forward.last_name: Si el mensaje reenviado proviene de un usuario, aquí se almacena su apellido.
  • forward.username: Nombre de usuario, sin @, del chat del cual proviene el mensaje reenviado.
  • forward.is_deleted: Devuelve True si el chat del cual proviene el mensaje reenviado es una cuenta eliminada en Telegram, o False si no lo es.
  • forward.is_bot: Devuelve True si el mensaje reenviado proviene de un bot, o False en caso contrario.
  • forward.is_premium: Devuelve True si el usuario del cual proviene el mensaje reenviado tiene una suscripción Premium de Telegram activa, o False si no la tiene.
  • forward.is_verified: Devuelve True si el chat del cual proviene el mensaje reenviado está verificado por Telegram, o False si no lo está.
  • forward.is_restricted: Devuelve True si el usuario del cual proviene el mensaje reenviado tiene alguna restricción impuesta por Telegram, o False si no tiene ninguna.
  • forward.is_scam: Devuelve True si el chat del cual proviene el mensaje reenviado tiene la etiqueta de estafa impuesta por Telegram, o False si no la tiene.
  • forward.is_fake: Devuelve True si el usuario del cual proviene el mensaje reenviado es catalogado como falso por Telegram, o False si es real.
  • forward.post_views: Si el mensaje reenviado es una publicación de un canal, devuelve el número de vistas que tiene esa publicación, como valor numérico.
  • forward.post_times_forwarded: Si el mensaje reenviado es una publicación de un canal, devuelve el número de veces que la publicación ha sido reenviada, como valor numérico.