Saltar a contenido

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:

  1. 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.
  2. 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:

  1. Solicite al usuario el monto a retirar y la dirección de TRX.
  2. Envíe el pago.
  3. Confirme el pago al usuario y registre la transacción en un canal.

1. Crear el botón Retirar

  1. Entra al editor de tu bot pulsando 🛠 Editar.
  2. Crea un nuevo botón pulsando en ✳️ Nuevo botón | comando y nómbralo Retirar.
  3. Pulsa en Acciones 🌟 para configurar las acciones del botón.

2. Configurar las acciones

a) Acción 1: Enviar mensaje
  1. Pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  2. 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
        
  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

b) Acción 2: Esperar respuesta
  1. Pulsa 🎯 Nueva acción⏳ Esperar respuesta.
  2. 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.

  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

c) Acción 3: Condición
  1. Pulsa en 🎯 Nueva acción🧭 Condición.
  2. Por ahora no hacemos nada aquí (la configuraremos más adelante).
d) Acción 4: Enviar mensaje
  1. Pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  2. Pulsa en Configurar 🛠💬 Establecer mensaje 💬 e ingresa:

    Ingresa tu dirección de TRX.
    
  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

e) Acción 5: Esperar respuesta
  1. Pulsa 🎯 Nueva acción⏳ Esperar respuesta.
  2. 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 de TRX, 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.

  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

f) Acción 6: Enviar pago
  1. Pulsa en 🎯 Nueva acción📤 Enviar pago.
  2. Por ahora no hacemos nada aquí (la configuraremos más adelante).
g) Acción 7: Cambiar variable
  1. Copia el ID de la acción de Esperar respuesta (acción 2).
  2. Pulsa en 🎯 Nueva acción🗃 Cambiar variable.
  3. 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 de Esperar respuesta que copiaste antes.

  4. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

h) Acción 8: Enviar mensaje
  1. Pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  2. Pulsa en Configurar 🛠💬 Establecer mensaje 💬 e ingresa:

    ✅ Tu retiro está en camino.
    
  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

i) Acción 9: Ejecutar botón
  1. Pulsa en 🎯 Nueva acción↪️ Ejecutar botón.
  2. Pulsa en Configurar 🛠🔘 Establecer botón 🔘 e ingresa:

    /start
    
  3. 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
  1. Pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  2. Pulsa en Configurar 🛠💬 Establecer mensaje 💬 e ingresa:

    ❌ Ingresa una cantidad entre 0.025 y {balance}.
    
  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

l) Acción 11: Ejecutar botón
  1. Pulsa en 🎯 Nueva acción↪️ Ejecutar botón.
  2. Pulsa en Configurar 🛠🔘 Establecer botón 🔘 e ingresa:

    /start
    
  3. 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
  1. Pulsa en 🎯 Nueva acción🖥 Recibir parámetros.
  2. Esta acción no requiere configuración, simplemente actívala pulsando en ✅ Activar.
  3. Copia el ID de esta acción (Recibir parámetros), lo necesitarás en un momento.
ñ) Acción 13: Enviar mensaje (al usuario)
  1. Pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  2. 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 de Recibir 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.

  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

o) Acción 14: Enviar mensaje (al canal)
  1. Agrega este bot como administrador del canal que quieras usar para registrar las transacciones.
  2. Regresa al bot, pulsa en 🎯 Nueva acción✉️ Enviar mensaje.
  3. 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 de Recibir 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.

  4. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

p) Configurar la acción de Condición
  1. Copia el ID de la acción de la acción 2, de tipo Esperar respuesta.
  2. Regresa a la acción de Condición (acción 3) y pulsa en Configurar 🛠:

    • 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 de Esperar 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é seleccionado continuar.
      • Envía el ID de la acción de Enviar mensaje (acción 10).
  3. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

q) Configurar la acción de Enviar pago
  1. Localiza la acción de Enviar pago (acción 6) y pulsa en Configurar 🛠:

    • 🧾 Establecer moneda 🧾: Selecciona TRX.
    • 💰 Establecer cantidad 💰: Establece el monto a enviar:

      {#IDAcciónEspResp1.text#}
      

      Reemplaza IDAcciónEspResp1 por el ID de la primera acción de Esperar 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 de Esperar 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 de Recibir parámetros (acción 12).

  2. Regresa al menú de acciones y activa esta acción pulsando en ✅ Activar.

Resultado final

  1. El usuario pulsa Retirar.
  2. El bot solicita monto y dirección, valida los datos y verifica que tenga balance suficiente.
  3. Si todo es correcto:
    • Procesa el pago y muestra el TXID al usuario.
    • Notifica la transacción en un canal.
  4. Si el balance es insuficiente, muestra un mensaje de error.

Así quedaron las acciones

VisualMaker crypto withdraw example