Base de conocimiento de GetMyBot

Botones dinámicos y datos

Muestra productos mediante botones, recuerda cuál eligió cada persona y pasa esa elección a la siguiente reacción.

En esta página

Un bot muestra tres productos, cada uno con un botón «Comprar». Una persona elige un vestido. La reacción siguiente debe recibir ese vestido, aunque el bot haya mostrado otros productos después.

Para conseguirlo, usa dos opciones del bloque de mensaje de Enviar mensaje: los botones dinámicos crean un botón para cada producto de una lista y Carry guarda los datos propios de cada botón.

Lo que ve el compradorDatos guardados en el botón
Abrigo, 12 000 ₽ · Comprarproduct_id=101, price=12000
Vestido, 8 000 ₽ · Comprarproduct_id=102, price=8000
Zapatillas, 6 000 ₽ · Comprarproduct_id=103, price=6000

Al pulsar el segundo botón, el escenario recibe product_id=102. El bot no tiene que deducir el producto a partir del texto «Comprar».

Crear botones desde una lista

En lugar de añadir cada producto a mano, obtén una lista de una colección o un servicio externo. El bloque Botones dinámicos desde una lista creará un botón por elemento. La lista se guarda en los datos temporales de la reacción, llamados contexto (ctx) en la configuración. Completa estos cuatro campos:

CampoEjemploResultado
Lista (over)ctx.productsEl bot toma los productos de los datos temporales. Puedes preparar esa lista con «Consulta a una fuente», «Solicitud web» o «Cálculo».
Nombre del elemento (as)item, valor predeterminado{{item.name}} se refiere al nombre de un producto de la lista.
Botones por fila (columns)1, valor predeterminadoCada producto aparece en su propia fila.
Plantilla del botón{{item.name}} · {{item.price}} ₽El bot inserta el nombre y el precio de cada producto en el texto y los demás campos del botón.

Al enviar el mensaje, el bot rellena la plantilla con los datos de cada producto. Una lista de tres productos produce tres botones. También puedes mostrar horarios disponibles, pedidos o elementos de un menú.

Ejemplo

Supongamos que ctx.products contiene productos con los campos id, name y price.

  1. Escribe ctx.products como lista, item como nombre del elemento y elige un botón por fila.
  2. Pon {{item.name}} · {{item.price}} ₽ en el texto del botón.
  3. Elige el tipo Llamar a reacción y selecciona la reacción que prepara el pedido.
  4. En Carry, añade product_id con el valor {{item.id}}.
  5. En la reacción del pedido, usa {{ctx.product_id}} para obtener el producto elegido.

Pulsa primero el segundo botón y después el primero. La reacción debe recibir el ID del producto pulsado en cada caso.

Datos del botón al pulsarlo (Carry)

Carry son los datos que el botón entregará cuando alguien lo pulse. Piensa en una etiqueta pegada a cada producto: aunque todos los botones digan «Comprar» y ejecuten la misma reacción, cada uno lleva sus propios datos.

En el editor, la opción se llama Datos al pulsar. Los valores quedan guardados cuando se envía el mensaje. Al pulsar el botón, el bot los coloca en ctx, los datos temporales de la nueva ejecución de la reacción.

  • Clave: el nombre del valor guardado. Si usas product_id, podrás leerlo como {{ctx.product_id}}.
  • Valor: lo que quieres guardar. Puede ser un número o una sustitución como {{item.id}}, {{param.order_id}} o {{ctx.x}}. La sustitución se calcula al enviar el mensaje.
  • Un solo uso (single_use): los datos guardados se eliminan tras la primera pulsación. No se pueden volver a utilizar.
  • Vigencia de los datos (ttl_seconds o TTL): cuántos segundos se conservan. Por ejemplo, 3600 es una hora. 0 usa el plazo predeterminado, actualmente 30 días; no significa almacenamiento ilimitado.

Una vez vencido el plazo, los datos antiguos ya no estarán disponibles. Permite que la persona abra el catálogo de nuevo. Cada botón enviado conserva sus propios valores, aunque tenga el mismo texto y lleve a la misma reacción que otros botones. En la documentación técnica se llama per-invocation.

Guardar parámetros al pulsar (set_params)

A veces necesitas recordar una elección después de que termine la reacción. Por ejemplo, el cliente eligió una ciudad de entrega y quieres usarla en el próximo pedido. El campo Parámetros (set_params) del botón guarda ese dato en el perfil del suscriptor cuando lo pulsa. Después podrás leer la ciudad como {{param.city}}.

Carry pasa datos temporales a la ejecución actual ({{ctx.clave}}). set_params los conserva entre ejecuciones ({{param.clave}}). El bloque de mensaje también tiene set_params, pero en ese caso el valor se guarda al enviar el mensaje, aunque nadie pulse ningún botón.

Un botón también puede añadir y quitar etiquetas al pulsarlo, con los mismos campos que el bloque de mensaje.

Qué opción usar

NecesitasUsaLee el resultado en
Pasar el producto elegido a la siguiente reacciónCarry{{ctx.product_id}}
Recordar la ciudad después de que la persona la elijaset_params en el botón{{param.city}}
Guardar un dato en cuanto se envía el mensajeset_params en el bloque{{param.clave}}

Siguientes pasos