Base de conocimiento de GetMyBot

Desencadenantes

Elige cuándo responderá el bot: por una palabra, un comando, un botón, un pago o un evento del sitio.

En esta página

Un desencadenante indica qué debe ocurrir para que el bot ejecute una reacción. Por ejemplo, alguien escribe /help, pulsa un botón o paga una factura.

En Desencadenante del editor puedes activar varias opciones. Basta con que se cumpla una: el comando /help o la palabra «ayuda». Si la respuesta debe enviarse solo a determinadas personas o en ciertos chats, añade condiciones.

Mensaje de texto

Se activa con un mensaje de texto o el texto que acompaña a una foto o archivo. En Qué buscar elige el modo:

  • Palabras clave: lista de palabras o frases. En Coincidencia elige contiene, coincidencia exacta, empieza por o expresión regular. También puedes activar Distinguir mayúsculas. Se admiten hasta 100 palabras clave por desencadenante y 200 caracteres por palabra; para listas mayores usa una colección. Consulta Límites.
  • Enlace — el mensaje contiene una URL.
  • Email — contiene una dirección de correo.
  • Mención (@username) — contiene una mención.
  • Cualquier texto — cualquier mensaje de texto.

Comando

Se activa con comandos que comienzan por /. En Comandos (sin «/») escribe, por ejemplo, help y menu. El bot responderá a /help y /menu.

Comando /start

Un enlace como https://t.me/your_bot?start=promo inicia el bot con el valor adicional promo. Puedes usarlo para identificar a quienes llegaron desde una promoción. Escribe solo promo en Etiqueta del enlace de inicio, sin la dirección ni start=. Déjalo vacío para responder a cualquier /start.

Pulsación de botón inline (callback)

Se activa al pulsar un botón debajo de un mensaje que envía un evento al bot. Su valor técnico callback_data puede ser distinto del texto visible. En Datos del botón (callback_data) indica el valor y en Coincidencia elige exacta, empieza por, contiene o expresión regular. Un botón que abre un enlace no activa este desencadenante.

Multimedia

Se activa con archivos adjuntos de los tipos seleccionados: Foto, Vídeo, Videomensaje, Documento, Audio, Nota de voz, GIF, Sticker, Dado, Juego, Encuesta, Contacto, Geolocalización, Lugar, Álbum.

Evento del sistema

Se activa con eventos del chat: Entró por enlace, Añadido al chat, Abandonó el chat, Eliminado del chat, Cambió de estado, Solicitud de unión, Reacción a un mensaje, Contador de reacciones. Muy útil para bienvenidas, moderación y gestión de solicitudes.

En los eventos de miembros de Telegram puedes usar {{system.subject_id}} y las demás sustituciones de eventos del sistema. La persona afectada puede ser distinta del autor: {{user_id}} identifica al autor. Si un mensaje añade a varias personas, se procesa un evento por cada una.

También hay un evento de la plataforma:

  • Etiqueta caducada (label_expired): terminó la duración de una etiqueta temporal. La reacción puede usar {{event.label_name}}, {{event.label_id}} y {{event.expired_at}}.

    La etiqueta no se elimina de inmediato. Mientras se ejecuta la reacción, la condición «tiene la etiqueta» todavía la detecta. Solo se elimina cuando el evento termina correctamente. Si la reacción falla, la etiqueta permanece y se vuelve a intentar.

    Este evento corresponde a una persona, no a un mensaje de chat, por lo que {{chat_id}} está vacío. Enviar mensaje escribe al suscriptor por privado. Cambiar permisos requiere que indiques un Chat (chat_id), por ejemplo el de un club. Sin él, la acción falla y se reintenta. Otras acciones que necesiten el chat del evento y no tengan un destino propio no se ejecutan.

Respuesta y reenviado

  • Respuesta (reply) a un mensaje — se activa cuando el mensaje es una respuesta a otro.
  • Mensaje reenviado — se activa con reenvíos.

Cada N-ésimo mensaje

Se activa cada cierto número de mensajes de una persona (campo Cada mensaje número). Sirve para mostrar recordatorios periódicos o reducir mensajes repetitivos.

Programado (fechas)

Se activa en los momentos indicados (lista de fechas). La reacción programada se envía a los suscriptores activos al llegar la hora — ver Difusiones.

Pago

Se activa cuando cambia el estado de una factura emitida por el bot. Indica el Estado del pago (Pagado, Fallido o Reembolsado), la Pasarela de pago y el Importe mínimo, en kopeks. Consulta Pagos y saldo para configurar el acceso después del pago.

Evento del cliente o del sitio

Se activa con un evento del cliente o del sitio que tenga el nombre indicado. La plataforma registra referral.joined cuando una persona nueva llega mediante ?start=ref_<user_id>. El evento incluye referrer_tg_user_id (ID de quien invitó), referrals_count (total actual de invitados) y start_payload (etiqueta del enlace que usó la persona nueva).

La reacción se ejecuta para la persona nueva. Por eso, Enviar mensaje le escribe a ella. Puedes usar {{ctx.referrer_id}} y {{event.referrer_tg_user_id}} en campos que acepten sustituciones, pero esos valores no cambian por sí solos el destinatario. La acción send_message no tiene un destinatario dinámico. {{ctx.referrer_id}} también está disponible en la primera reacción /start de la persona nueva.

Solicitud web entrante (webhook)

Se activa cuando un servicio externo envía una solicitud HTTP. Activa el disparador y guarda la reacción: después aparecerá en el campo Dirección la URL del webhook, generada automáticamente para esa reacción. Puedes copiarla, pero no modificarla. Configura el Token secreto para protegerla y elige el Método (POST / GET / PUT / ANY). Los datos recibidos quedan disponibles para las acciones mediante {{ctx.campo}}. Consulta Solicitudes web y webhooks.

Qué sigue