Acción: Enviar pago¶
Esta acción te permite enviar pagos en criptomonedas a una dirección externa o a la billetera de otro usuario de VisualMaker sin comisiones para transacciones internas. Hay dos métodos principales:
-
Red externa (Blockchain):
- Envía fondos a una dirección de billetera externa.
- Se aplican comisiones según la red.
- Cada criptomoneda tiene un monto mínimo de envío.
-
Red interna (Telegram):
- Envía pagos instantáneos, sin mínimos de envío y sin comisiones, a otros usuarios de VisualMaker.
- Especifica el destinatario usando su @username, enlace (
t.me/usuario) o ID de usuario. - Envía incluso si el destinatario no se ha unido a VisualMaker, los fondos estarán disponibles en su billetera cuando lo haga.
Asegúrate de tener suficiente saldo en tu billetera de VisualMaker para cubrir el monto y las comisiones aplicables.
¿Cómo configurar la acción?¶
1. Crear la acción¶
- Ve a tu bot y entra al editor pulsando
🛠 Editar. - Selecciona el botón o comando donde deseas agregar esta acción, o crea uno nuevo.
- Ve a
Acciones 🌟→🎯 Nueva acción→📤 Enviar pago. - Pulsa en
Configurar 🛠para configurarla.
2. Configurar las opciones¶
➡️ Establecer moneda¶
Selecciona la criptomoneda a enviar (por ejemplo, BTC, USDT, TON).
➡️ Establecer cantidad¶
Ingresa el monto a enviar.
➡️ Establecer destinatario¶
- Para retiros externos: Indica la dirección de la billetera.
- Para retiros internos: Especifica el @username, enlace (
t.me/usuario) o ID de Telegram.
➡️ Establecer memo (opcional)¶
Añade el memo requerido por ciertas monedas (por ejemplo, TON).
➡️ Ejecutar acción (opcional)¶
Indica el ID de la acción que se ejecutará al confirmarse el envío, debe ser de tipo Recibir parámetros para recibir los datos del pago, y debe estar aislada por un separador. Esta acción solo se ejecuta en envíos por red externa (Blockchain), ya que los pagos internos (Telegram) son instantáneos.
3. Activar la acción¶
Pulsa ✅ Activar para activar esta acción y que quede funcional.
¿Qué devuelve esta acción a través de su ID?¶
La acción no devuelve datos directamente, pero enviará información del pago enviado a una acción de tipo Recibir parámetros, para que puedas usarlo en acciones posteriores.
Parámetros enviados a la acción de Recibir parámetros¶
Al confirmarse un envío a través de la blockchain, se ejecutará la acción establecida, debe ser de tipo Recibir parámetros. A través de ella podrás obtener datos acerca del envío realizado.
- Monto enviado:
#IDAccionRecParam.param1# - Monto en USD:
#IDAccionRecParam.param2# - Comisión cobrada:
#IDAccionRecParam.param3# - Moneda usada:
#IDAccionRecParam.param4# - Red usada:
#IDAccionRecParam.param5# - ID del usuario:
#IDAccionRecParam.param6# - TXID (hash de la transacción):
#IDAccionRecParam.param7#
Reemplaza
IDAccionRecParampor el ID de la acción de tipo Recibir parámetros que has creado.
Ejemplo práctico: Enviar TRX mediante la red externa (Blockchain)¶
En este ejemplo crearemos un botón llamado Retirar que:
- Solicite al usuario el monto a retirar y la dirección de
TRX. - Envíe el pago.
- Confirme el pago al usuario y registre la transacción en un canal.
1. Crear el botón Retirar¶
- Entra al editor de tu bot pulsando
🛠 Editar. - Crea un nuevo botón pulsando en
✳️ Nuevo botón | comandoy nómbraloRetirar. - Pulsa en
Acciones 🌟para configurar las acciones del botón.
2. Configurar las acciones¶
a) Acción 1: Enviar mensaje¶
- Pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠:-
Pulsa
💬 Establecer mensaje 💬e ingresa:Tienes {balance} TRX. Ingresa el monto que deseas retirar. -
Añade un teclado para cancelar:
- Pulsa
💠 Desplegar teclado 💠→🔘 Crear nuevo teclado 🔘→🔷 Inferior. - Agrega un botón con el texto:
Cancelar
- Pulsa
-
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
b) Acción 2: Esperar respuesta¶
- Pulsa
🎯 Nueva acción→⏳ Esperar respuesta. -
Pulsa en
Configurar 🛠y realiza los siguientes ajustes:- Validación: Marca únicamente la opción
número. Esto asegurará que el usuario introduzca un número válido. -
Mensaje de error: Ingresa un mensaje de error en caso de entrada no válida, por ejemplo:
Ingresa solo números válidos. Inténtalo de nuevo. -
Textos para cancelar: Ingresa el texto que estableciste como botón para cancelar en la acción anterior, en este caso es:
Cancelar -
Mostrar mensaje al cancelar: Ingresa el mensaje que se mostrará al usuario si cancela, por ejemplo:
Operación cancelada. -
Pulsar botón al cancelar: Ingresa
/start, para que al cancelar cargue el menú principal.
- Validación: Marca únicamente la opción
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
c) Acción 3: Condición¶
- Pulsa en
🎯 Nueva acción→🧭 Condición. - Por ahora no hacemos nada aquí (la configuraremos más adelante).
d) Acción 4: Enviar mensaje¶
- Pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠→💬 Establecer mensaje 💬e ingresa:Ingresa tu dirección de TRX. -
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
e) Acción 5: Esperar respuesta¶
- Pulsa
🎯 Nueva acción→⏳ Esperar respuesta. -
Pulsa en
Configurar 🛠y realiza los siguientes ajustes:-
Pulsa
🔍 Validación 🔍→🔍 Establecer expresión regular 🔎e ingresa una expresión regular para validar que la dirección enviada sea deTRX, por ejemplo:^T[A-Za-z1-9]{33}$Puedes buscar expresiones regulares para cada caso en Internet, buscando por ejemplo:
regular expression for TRX address. -
Mensaje de error: Ingresa un mensaje de error en caso de entrada no válida, por ejemplo:
Dirección de TRX no válida. Inténtalo nuevamente. -
Textos para cancelar: Ingresa
Cancelar -
Mostrar mensaje al cancelar: Ingresa el mensaje que se mostrará al usuario si cancela, por ejemplo:
Operación cancelada. -
Pulsar botón al cancelar: Ingresa
/start, para que al cancelar cargue el menú principal.
-
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
f) Acción 6: Enviar pago¶
- Pulsa en
🎯 Nueva acción→📤 Enviar pago. - Por ahora no hacemos nada aquí (la configuraremos más adelante).
g) Acción 7: Cambiar variable¶
- Copia el ID de la acción de
Esperar respuesta(acción 2). - Pulsa en
🎯 Nueva acción→🗃 Cambiar variable. -
Pulsa en
Configurar 🛠:- Seleccionar variable: Ingresa
balance - Tipo de modificación: Selecciona
🔺 Incrementar 🔺 -
Valor a guardar: Restamos el monto enviado del
balancedel usuario. Guarda lo siguiente:-{#IDAcciónEsperarRespuesta.text#}Reemplaza
IDAcciónEsperarRespuestapor el ID de la acción deEsperar respuestaque copiaste antes.
- Seleccionar variable: Ingresa
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
h) Acción 8: Enviar mensaje¶
- Pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠→💬 Establecer mensaje 💬e ingresa:✅ Tu retiro está en camino. -
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
i) Acción 9: Ejecutar botón¶
- Pulsa en
🎯 Nueva acción→↪️ Ejecutar botón. -
Pulsa en
Configurar 🛠→🔘 Establecer botón 🔘e ingresa:/start -
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
j) Agregar un Separador¶
Pulsa en Nuevo separador 📍 para agregar un separador al final y crear un nuevo bloque de acciones. Mira qué son los separadores.
k) Acción 10: Enviar mensaje¶
- Pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠→💬 Establecer mensaje 💬e ingresa:❌ Ingresa una cantidad entre 0.025 y {balance}. -
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
l) Acción 11: Ejecutar botón¶
- Pulsa en
🎯 Nueva acción→↪️ Ejecutar botón. -
Pulsa en
Configurar 🛠→🔘 Establecer botón 🔘e ingresa:/start -
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
m) Agregar un Separador¶
Pulsa en Nuevo separador 📍 para agregar un separador al final y crear un nuevo bloque de acciones. Mira qué son los separadores.
n) Acción 12: Recibir parámetros¶
- Pulsa en
🎯 Nueva acción→🖥 Recibir parámetros. - Esta acción no requiere configuración, simplemente actívala pulsando en
✅ Activar. - Copia el ID de esta acción (
Recibir parámetros), lo necesitarás en un momento.
ñ) Acción 13: Enviar mensaje (al usuario)¶
- Pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠→💬 Establecer mensaje 💬e ingresa:✅ Tu retiro de {#IDAccionRecParam.param1#} TRX ha sido procesado, el TXID es: {#IDAccionRecParam.param7#}Nota 1: Reemplaza
IDAccionRecParamcon el ID de la acción deRecibir parámetrosque acabas de copiar.Nota 2: Recuerda que el parámetro 1 contiene el monto enviado, y el parámetro 7 el TXID de la transacción.
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
o) Acción 14: Enviar mensaje (al canal)¶
- Agrega este bot como administrador del canal que quieras usar para registrar las transacciones.
- Regresa al bot, pulsa en
🎯 Nueva acción→✉️ Enviar mensaje. -
Pulsa en
Configurar 🛠:-
Pulsa
💬 Establecer mensaje 💬e ingresa:📤 Nuevo retiro 📤 Usuario: {first_name} Cantidad: {#IDAccionRecParam.param1#} TRX TXID: {#IDAccionRecParam.param7#}Reemplaza
IDAccionRecParamcon el ID de la acción deRecibir parámetrosque copiaste hace un momento. -
Pulsa
👤 Enviar a alguien más 👤→📍 Establecer nuevo destinatario 📍e ingresa el@usuarioo el ID del canal donde registrarás las transacciones.
-
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
p) Configurar la acción de Condición¶
- Copia el ID de la acción de la acción 2, de tipo
Esperar respuesta. -
Regresa a la acción de
Condición(acción 3) y pulsa enConfigurar 🛠:-
Nueva condición:
{balance > 0 and to_number(#IDAccion.text#) >= 0.025 and to_number(#IDAccion.text#) <= balance}Nota 1: Reemplaza
IDAccioncon el ID de la acción deEsperar respuestaque acabas de copiar.Nota 2: Hemos usado operadores de comparación, míralos todos aquí.
Nota 3: Hemos usado la función to_number() para convertir un número que se encuentra en formato de texto, a un número como tal en formato numérico, puedes ver esta y todas las funciones aquí.
Nota 4: 0.025 es el mínimo de envío de TRX mediante la red externa (Blockchain).
-
Si es verdadero: Selecciona
continuar. - Si es falso:
- Pulsa en
🆔 Ejecutar acción por ID 🆔. - En
➡️ Después:asegúrate de que esté seleccionadocontinuar. - Envía el ID de la acción de
Enviar mensaje(acción 10).
- Pulsa en
-
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
q) Configurar la acción de Enviar pago¶
-
Localiza la acción de
Enviar pago(acción 6) y pulsa enConfigurar 🛠:🧾 Establecer moneda 🧾:SeleccionaTRX.-
💰 Establecer cantidad 💰:Establece el monto a enviar:{#IDAcciónEspResp1.text#}Reemplaza
IDAcciónEspResp1por el ID de la primera acción deEsperar respuestaagregada (acción 2). -
👤 Establecer destinatario 👤:Establece la dirección a la cual enviar:{#IDAcciónEspResp2.text#}Reemplaza
IDAcciónEspResp2por el ID de la segunda acción deEsperar respuestaagregada (acción 5). -
🕹 Ejecutar acción 🕹:Establece la acción a ejecutar una vez el pago sea procesado:#IDAccionRecParam#Reemplaza
IDAccionRecParampor el ID de la acción deRecibir parámetros(acción 12).
-
Regresa al menú de acciones y activa esta acción pulsando en
✅ Activar.
Resultado final¶
- El usuario pulsa
Retirar. - El bot solicita monto y dirección, valida los datos y verifica que tenga
balancesuficiente. - Si todo es correcto:
- Procesa el pago y muestra el TXID al usuario.
- Notifica la transacción en un canal.
- Si el
balancees insuficiente, muestra un mensaje de error.
Así quedaron las acciones¶
