Base de conocimiento de GetMyBot

Acciones

Qué puede hacer el bot después de recibir un mensaje o una pulsación: responder, guardar una solicitud, dar acceso, consultar datos o cobrar un pago. Configuración y límites.

En esta página

Una acción indica una tarea concreta del bot: responder, guardar un teléfono, crear un pedido o avisar a un responsable. Una reacción puede tener varias. Por ejemplo, después de recibir una solicitud, primero guarda los datos, luego añade la etiqueta «Nueva solicitud» y, por último, confirma la recepción al cliente.

Abre Acciones en el editor y pulsa Añadir acción. El bot las ejecuta de arriba abajo. Una acción puede pasar su resultado a la siguiente mediante datos temporales (ctx). Guarda en los parámetros del usuario lo que necesitarás en conversaciones posteriores. Consulta Sustituciones y fórmulas.

Mensajes y respuestas

  • Enviar mensaje: prepara una respuesta con bloques de texto, foto, archivo, espera, IA o llamada a otra reacción. También admite botones y pasos de conversación. Consulta Mensajes y botones.
  • Guardar mensaje: guarda el texto recibido en un parámetro del usuario.
  • Reenviar: reenvía el mensaje recibido a los chats indicados, con un ID de tema opcional.
  • Notificación: avisa en chats internos e incluye datos de la persona, el chat y el mensaje.
  • Botón de menú: cambia el botón de menú de Telegram (setChatMenuButton) sin reiniciar el bot. Puedes elegir el botón habitual, una lista de comandos o una Mini App con texto y dirección URL; se admiten sustituciones. El alcance Este chat solo sirve para una conversación privada con la persona que activó la reacción: en un grupo u otro chat da error. Todos los chats cambia el botón general del bot para quienes no tienen uno propio y no se puede usar dentro de un bucle. En otros canales, la acción se omite.

Usuario: etiquetas y parámetros

  • Editar etiquetas: añade o quita etiquetas. Duración, días (ttl_days) hace que las nuevas etiquetas sean temporales. Cuando caducan, se quitan y el bot recibe el evento Etiqueta caducada; consulta Desencadenantes. Por ejemplo, puedes dar acceso durante 30 días tras un pago y retirarlo después.
  • Editar parámetros: establece, elimina o aumenta los valores guardados de la persona.

Moderación

  • Eliminar recibido: borra el mensaje entrante o, si lo eliges, todos los mensajes de esa persona; puede aplicarse después de una espera.
  • Eliminar enviados: borra mensajes del bot de esta reacción o de todo el chat, con una espera opcional.
  • Cambiar permisos: silencia, deja de silenciar, bloquea, desbloquea, limita permisos, expulsa, aprueba o rechaza una solicitud de entrada. Puedes elegir una duración y, al limitar permisos, los derechos concretos.

Expulsar (kick) retira a una persona sin mantenerla bloqueada: en Telegram la bloquea y desbloquea enseguida; en VK solo se puede hacer mediante la lista negra de la comunidad (groups.ban).

Aprobar solicitud (approve) acepta una solicitud ya enviada para entrar en un chat o comunidad privada. Rechazar solicitud (decline) rechaza una solicitud ya enviada. La persona no queda bloqueada y puede volver a solicitar la entrada. Si no hay solicitud, no hay nada que rechazar. En Telegram, el bot necesita el permiso can_invite_users. VK permite aprobar, pero no rechazar: un nodo de campaña fallará y una reacción normal se rechazará antes de enviarse.

La persona que solicita la entrada se identifica por el evento, no por user_chat_id. Telegram envía user_chat_id para que el bot pueda escribirle temporalmente por privado; no es el ID de esa persona ni del chat que hay que moderar.

El campo Chat (chat_id) indica el chat al que se aplica la acción. Si lo dejas vacío, se usa el chat del evento, pero solo cuando la reacción se activó en un grupo o canal. Para Etiqueta caducada, una ejecución programada, una campaña o un evento recibido por privado, indica el chat expresamente; de lo contrario, la acción se omite.

  • Reacción importante (color): marca la conversación para que el operador encuentre antes los casos prioritarios.

Datos y colecciones

  • Crear registro: añade una fila a una colección. Si indicas una clave de deduplicación, repetir la acción con la misma clave actualiza la fila anterior en vez de crear otra. Esta operación se llama upsert.
  • Actualizar registros: cambia filas que cumplan un filtro.
  • Buscar registros: lee filas como lista en el contexto para usarlas después.
  • Buscar en colección (record_search): busca en campos de texto, nombres alternativos y, si lo activas, con tolerancia a errores de escritura. Guarda las filas y si la búsqueda fue completa.
  • Buscar registros relacionados (record_related): lee filas por una clave compartida, como las fechas de una clase por su código, o una fila concreta por _record_id.
  • Leer página de colección (record_page): lee la siguiente parte de una consulta con filtros y ordenación. El cursor continúa esa consulta; la última página no equivale a toda la colección.
  • Total de la colección completa (record_aggregate): calcula cifras sobre todos los registros que cumplan las condiciones y sigan conservados, sin cargarlos antes en la reacción.
  • Transacción de colección (collection_transaction): comprueba condiciones y guarda varios cambios juntos. Si hay un conflicto, no queda ninguno a medio guardar. Consulta los ejercicios con colecciones.
  • Eliminar registros: borra filas que cumplan un filtro.
  • Bucle de lista: recorre una lista de ctx y ejecuta acciones por cada elemento, como sumar pedidos o guardar cada fila.

Un bucle no sirve para enviar mensajes masivos: un evento puede enviar como máximo 50 mensajes, aunque el bucle recorra hasta 500 elementos. Para eso usa Difusiones o Campañas, con control de velocidad y registro de entregas. Más abajo se explican los límites de un evento.

Consulta Colecciones y datos para más detalles.

Solicitudes externas

  • Solicitud web: envía una petición HTTP con cabeceras, cuerpo, códigos de éxito, tiempo de espera y reintentos. Admite GET, HEAD, OPTIONS, POST, PUT, PATCH y DELETE. Solo se repiten errores de red y respuestas 429 o 5xx; otros 4xx no. Para repetir POST o PATCH, debes configurar tú mismo Idempotency-Key y asegurarte de que el servicio receptor evite duplicados con esa clave. La plataforma también envía una clave propia por ejecución, igual al repetir el mismo paso, pero esa clave por sí sola no activa los reintentos de POST o PATCH. Puedes guardar parte de la respuesta en un parámetro o en ctx mediante JSONPath. La acción puede continuar en segundo plano y activar una reacción distinta para éxito o error.
  • Cargar URL: descarga una página y guarda su texto legible en ctx para utilizarlo después o dárselo a la IA.
  • Solicitud a origen: lee datos de una conexión REST u OzmaDB en ctx.
  • Escribir en origen: envía datos a una conexión con POST, PUT o DELETE.

Consulta Orígenes y claves para configurar las conexiones.

IA y cálculo

  • IA: consulta un modelo de lenguaje, guarda su respuesta en un parámetro o ctx y, si lo deseas, extrae datos según una estructura JSON o envía el texto a la persona. Consulta Respuestas de IA.
  • Calcular: usa exactamente uno de tres modos: Fórmula (expr), una expresión corta; Tabla de decisiones (rules), reglas «si → entonces» donde gana la primera que se cumpla; o Fórmula avanzada (formula), con listas, JSON y funciones hash. Guarda el resultado en ctx o en un parámetro. Consulta Fórmulas.

Lógica y escenarios

  • Reacción en cadena: desencadena otra reacción por su nombre.
  • Llamar bloque (call_block): ejecuta una secuencia reutilizable con entradas y salidas definidas. Puedes fijar una versión o usar siempre la más reciente. Consulta el ejemplo de cálculo de un pedido.
  • Siguiente reacción: pasa el control a la siguiente reacción coincidente en la lista.
  • Elegir siguiente paso (branch_result): decide según el resultado de una búsqueda, por ejemplo sin registros, uno, varios, coincidencia aproximada o resultados incompletos. Ejecuta la primera rama que coincida. Coloca la rama de resultados incompletos antes de las demás.
  • Ejecutar escenario: inicia un asistente (flujo) paso a paso. Consulte Escenarios.
  • Solicitar confirmación: envía una tarjeta al empleado que debe decidir. Los botones Confirmar y Rechazar activan las reacciones elegidas.
  • Transferir a operador: lleva la conversación a la bandeja de entrada del operador. Consulta Chats y operadores.

Pagos

  • Crear pago: crea una factura con la pasarela del bot y ofrece la dirección para pagar mediante {payment:url}. Otra reacción con el desencadenante Pago procesa el resultado. Consulta Pagos y saldo.

Escribe el importe como número decimal en la unidad principal de la moneda, por ejemplo 1500.50; la acción lo convierte a la unidad mínima. Una duración explícita del enlace puede ir de 300 a 2 592 000 segundos; 0 usa el valor predeterminado. Para crear una suscripción, indica una clave estable del plan, el importe y el periodo. Al actualizarla puedes conservar el importe o periodo actual. Cancelarla detiene los cargos futuros, pero no devuelve pagos anteriores. La clave de plan opcional reduce las suscripciones seleccionadas.

Integraciones

Las acciones GetCourse, Google Sheets y Google Drive utilizan las conexiones correspondientes; consulta Integraciones. Para enviar datos a otro servicio también puedes configurar una integración Webhook y la acción Solicitud web.

Google Sheets permite cinco operaciones. Los campos se relacionan con los nombres de las columnas de la fila de encabezados, normalmente la primera. El orden de las columnas no importa:

  • Añadir fila: escribe pares «encabezado → valor» con sustituciones. Un encabezado desconocido produce un error. Devuelve {row_number, range}.
  • Leer filas: devuelve las filas como objetos con su número _row, después de los encabezados. La página contiene 50 filas por defecto y 500 como máximo; has_more y next_offset indican si quedan más.
  • Leer última fila: devuelve la última fila con datos.
  • Buscar fila por valor de columna: devuelve la primera fila cuya columna coincide con el valor. Puedes indicar el encabezado sin distinguir mayúsculas o una letra como A o B. El valor admite sustituciones como {{param.email}}.
  • Actualizar fila: cambia las celdas de la fila row_number, por ejemplo {{ctx.lead.row_number}}.

Al leer una fila, puedes guardar un resultado JSON como {"found":true,"row_number":12,"cells":[…],"values":{"Email":"…","Plan":"…"}} en un parámetro o en ctx. Si lo guardas como lead, puedes usar {{ctx.lead.found}}, {{ctx.lead.row_number}} y campos como {{ctx.lead.Plan}}. Si no se encuentra la fila, found vale false y las celdas quedan vacías. Si la hoja supera el límite de búsqueda, la acción da un error en vez de devolver una fila incorrecta.

GetCourse crea o actualiza personas y ventas con las secciones user, system, session, deal y campos adicionales. También permite exportar usuarios, ventas y grupos; la importación devuelve {user_id, deal_id, lead_id}. Google Drive sube archivos y guarda {file_id, web_view_link}. Las acciones de integración y de IA admiten el análisis opcional de la respuesta y una ruta separada para errores. Consulta Integraciones.

El presupuesto de un evento

Todo el trabajo iniciado por un mensaje, un botón u otro evento comparte un límite de ejecución: las acciones de la reacción, otras reacciones llamadas por ella, los bucles y las solicitudes web que continúan en segundo plano. Así, un error no puede hacer que una secuencia envíe mensajes o ejecute acciones sin fin.

Tres límites:

Qué se limitaMáximoQué ocurre al alcanzarlo
Acciones por evento5000, incluidos los anidadosLa acción no se ejecuta; el paso está marcado como error
Mensajes salientes por evento50El mensaje no está en cola; el paso está marcado como error
Tiempo por evento5 minutosEl evento se detiene; se cancelan llamadas externas aún en vuelo

Un bucle tiene además su propio límite: 500 elementos por pasada. Si la lista es mayor, los demás elementos no se procesan ni aparecen en la tarjeta de la reacción. No uses un solo bucle cuando sea indispensable procesar la lista entera.

Por qué 50 mensajes pero 500 elementos

Un bucle puede actualizar hasta 500 registros, pero un evento solo puede enviar 50 mensajes.

Una reacción responde a una acción concreta de una persona. Cincuenta mensajes de salida para un mensaje recibido ya dejan un margen amplio.

Una difusión llega a muchas personas. Controla la velocidad, permite pausas y registra las entregas. Consulta Difusiones y Campañas.

Si un bucle de 500 elementos envía un mensaje por cada uno, solo pueden salir los primeros 50; los demás pasos reciben un error por el límite. Para escribir a toda la lista, usa una difusión.

Se cuentan los mensajes salientes, no las acciones. Una respuesta con varios bloques (texto, foto y archivo) consume uno por bloque. Si una respuesta no cabe en el límite restante, no se envía ninguna parte de ella.

Cómo saber si alcanzaste el presupuesto

El error aparece en la tarjeta de la reacción dentro de la conversación del suscriptor, en Personas. El paso fallido indica Límite del evento superado y cuál se alcanzó: actions, sends o deadline.

El suscriptor no recibe este error técnico. Una respuesta correcta de la API solo confirma que se aceptó el inicio del trabajo; una acción de la reacción puede alcanzar el límite más tarde. Comprueba el resultado en la tarjeta de la reacción.

El bucle continúa después del primer rechazo. Por eso puedes ver varios pasos fallidos, uno por cada elemento posterior que supera el límite. La reacción termina con error.

Qué hacer en su lugar

  • Enviar a muchas personas: usa Difusiones o Campañas, procesos separados con su propia velocidad y registro de entregas.
  • Procesar una lista grande sin enviar mensajes: un bucle sirve, pero divide la lista mediante filtros o páginas para respetar los 500 elementos por pasada.
  • Usar bucles anidados: calcula el total: 100 iteraciones externas × 100 internas serían 10 000 acciones, el doble del límite.
  • Superar los 5 minutos: suele deberse a llamadas externas. Ejecuta la Solicitud web en segundo plano y continúa en otra reacción para éxito o error.

Verificación de contacto

Verificar contacto permite solicitar un código por correo, comprobar el código que introduce la persona o confirmar que posee un número de teléfono. Para verificar una dirección de correo:

  1. Guarda la dirección de la persona en un parámetro y añade Enviar código por email.
  2. Pide a la persona que introduzca el código y, en el paso siguiente, añade Comprobar código del email.
  3. Guarda el resultado en un parámetro: 1 significa que la comprobación se superó y 0, que no. La rama con 0 debe ofrecer otro intento.

El código es válido durante 15 minutos y admite hasta cinco intentos. Tras una comprobación correcta, la dirección se vincula a la ficha actual de la persona. Si la dirección ya pertenece a otra ficha del mismo proyecto, esa ficha se fusiona con la actual, salvo que haya un conflicto con vínculos externos de CRM. Una dirección escrita sin confirmar con el código nunca fusiona fichas. Si la fusión no puede completarse, el resultado es 0 y el código puede reutilizarse hasta que caduque.

Para no enviar un código a una dirección que ya está verificada, activa Omitir el código si el email ya está verificado (skip_if_verified) en Enviar código por email y rellena Guardar resultado en parámetro (save_result_to): sin él, la reacción no se puede guardar. Para esa dirección no se envía ningún código y el parámetro recibe already_verified.

La reacción solo se guarda con esta cadena:

  1. Justo después de enviar el código va Elegir un paso según el valor, y es la última acción de la reacción. El editor puede añadirla por ti.
  2. El valor de la acción lee el resultado guardado, por ejemplo {user:email_status}.
  3. La primera rama comprueba que el valor es igual a already_verified y lleva a la reacción siguiente.
  4. Si ninguna rama coincide lleva a otra reacción, y es en ella donde el bot pide el código.

Para esta configuración, usa un nombre de parámetro sencillo, sin los caracteres :, #, { y }. No coloques la acción dentro de un bucle for_each; las ramas adicionales comparan texto sin expresiones regulares ni operadores numéricos. Si otra reacción llama a esta mediante chain o un bloque incrustado, no pongas la pregunta del código en la reacción principal después de la llamada: la principal puede continuar aunque falle la reacción hija.

El envío y la comprobación del código también funcionan en el widget web cuando el correo está configurado. La verificación del teléfono usa la identidad de WhatsApp ya confirmada y no envía ningún código.

Comprobación con botones

La comprobación está disponible en Telegram. Escribe una pregunta y de dos a ocho botones, con una sola respuesta correcta. Solo puede responder la persona que está siendo verificada. El plazo va de 10 segundos a un día; el valor predeterminado es dos minutos. Se puede volver a intentar una respuesta incorrecta hasta que venza el plazo.

Cuando alguien entra en un grupo, el bot limita sus permisos hasta que responda correctamente. Si vence el plazo, lo expulsa o bloquea según la configuración. El bot necesita el permiso can_restrict_members.

Para una solicitud de entrada, la pregunta se envía al solicitante por privado. Una respuesta correcta aprueba la solicitud; el vencimiento del plazo la rechaza. El bot necesita can_invite_users y no se configura una acción de fallo para este modo. Telegram normalmente permite escribir al solicitante hasta cinco minutos después de la solicitud; este límite se aplica al envío de la pregunta, no al plazo configurado para responder. Las plantillas de reacciones de «Grupos y canales» incluyen la comprobación para nuevos miembros y para solicitudes de entrada.

Listas, totales y decisiones basadas en datos

Estas acciones sirven para procesar datos de cualquier tipo:

  • Transformar lista (list_transform): filtra, ordena, quita duplicados y elige una página.
  • Asignar campos de lista (list_map): extrae campos anidados, crea valores y calcula datos para cada fila.
  • Unir listas (list_join): añade a las filas datos de otra lista mediante una clave compartida.
  • Grupos y totales (list_aggregate): cuenta, suma, calcula promedios, mínimos, máximos o valores distintos, también por grupos.
  • Elegir paso por valor (branch_value): comprueba condiciones ordenadas sobre texto, números o estados.
  • Actualizar registro si (record_update_if): cambia un registro solo cuando los campos esperados todavía coinciden.

Las listas pueden venir de ctx, de respuestas HTTP o de colecciones. Probar datos en el editor no ejecuta los pasos posteriores. Consulta Ajustes y ejemplos.

Empieza por las lecciones prácticas: buscar una clase, procesar una respuesta HTTP, calcular totales por categoría y confirmar una reserva comprobando su estado. Cada ejercicio indica qué configurar y qué resultado esperar. La lección de campos y uniones enseña a extraer el nombre del cliente, calcular un importe y añadir el nombre de la clase a una reserva.

Resultados de los pasos y prueba de borrador

En los campos que aceptan resultados anteriores, usa el asistente de datos. Muestra el nombre del resultado y sus campos. Si necesitas conservar la indicación de que una búsqueda fue completa o no, elige el resultado entero al procesar una lista.

Algunas acciones permiten elegir rutas según el resultado: por ejemplo, responder de forma distinta ante una actualización correcta, un conflicto o un error técnico. Que una acción termine bien no significa que un mensaje puesto en cola ya se haya entregado.

La prueba de borrador ejecuta la secuencia aún no guardada con datos de ejemplo. Muestra cálculos, ramas elegidas y acciones previstas sin enviar mensajes reales ni cambiar colecciones.

¿Qué sigue?