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
IDAccionRecParam
por 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 | comando
y 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
balance
del usuario. Guarda lo siguiente:-{#IDAcciónEsperarRespuesta.text#}
Reemplaza
IDAcciónEsperarRespuesta
por el ID de la acción deEsperar respuesta
que 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
IDAccionRecParam
con el ID de la acción deRecibir parámetros
que 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
IDAccionRecParam
con el ID de la acción deRecibir parámetros
que copiaste hace un momento. -
Pulsa
👤 Enviar a alguien más 👤
→📍 Establecer nuevo destinatario 📍
e ingresa el@usuario
o 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
IDAccion
con el ID de la acción deEsperar respuesta
que 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ónEspResp1
por el ID de la primera acción deEsperar respuesta
agregada (acción 2). -
👤 Establecer destinatario 👤:
Establece la dirección a la cual enviar:{#IDAcciónEspResp2.text#}
Reemplaza
IDAcciónEspResp2
por el ID de la segunda acción deEsperar respuesta
agregada (acción 5). -
🕹 Ejecutar acción 🕹:
Establece la acción a ejecutar una vez el pago sea procesado:#IDAccionRecParam#
Reemplaza
IDAccionRecParam
por 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
balance
suficiente. - Si todo es correcto:
- Procesa el pago y muestra el TXID al usuario.
- Notifica la transacción en un canal.
- Si el
balance
es insuficiente, muestra un mensaje de error.