Proyectos y canales

En GetMyBot, las reacciones y los datos pertenecen a un proyecto. Puedes conectar un bot de Telegram con un token de @BotFather, además de un chat web y otros canales. Abre Proyectos en el menú lateral; cambia el proyecto activo en el selector superior.

Conexión de un bot

1. Si aún no tienes un proyecto, abre Proyectos y pulsa Añadir proyecto. En su fila, pulsa Añadir canal y selecciona Telegram. Para el primer bot también puedes usar el asistente inicial.
2. Pega el token de @BotFather y pulsa Validar. GetMyBot muestra el @username del bot para que confirmes que el token es correcto.
3. Pulsa Conectar. El token se guarda cifrado y la recepción de actualizaciones comienza de inmediato.

Telegram aparece en la fila del proyecto junto a los demás canales. La fila muestra el nombre del proyecto, el @username del bot, los usuarios, las reacciones activas y las solicitudes de hoy. Consulta el saldo de solicitudes en Facturación o Estadísticas.

Múltiples bots

Una cuenta puede gestionar varios proyectos y bots; el número depende del plan (límite «máximo de bots»). Cambia de proyecto arriba o en Proyectos. Reacciones, Chats y Estadísticas muestran los datos del proyecto seleccionado.

Cómo recibe el bot los mensajes

La plataforma recibe actualizaciones de Telegram automáticamente, a través de webhook o sondeo prolongado, según la configuración de la instancia. No es necesario realizar ninguna configuración por tu parte: un token válido es suficiente. El bot maneja mensajes directos, mensajes de grupos y canales, pulsaciones de botones en línea, eventos del sistema (uniones/abandonos), reacciones a mensajes y pagos.

Habilitar y deshabilitar

Cada bot tiene un estado habilitado/deshabilitado (la tarjeta "Estado del bot" en Configuración). Un bot deshabilitado no responde a los mensajes; el cambio entra en vigor inmediatamente sin necesidad de volver a conectarse.

Estado del proyecto y disponibilidad del canal

En Proyectos, el estado del proyecto aparece por separado: Activo, En pausa o Congelado. No mide la entrega de Telegram. Cada canal tiene su propia etiqueta: En línea, Sin señal, Configurado, Desactivado o Proyecto inactivo. Un proyecto activo con chat web y sin Telegram no debe parecer «detenido».

Si un proyecto activo tiene exactamente un canal de Telegram habilitado, En línea indica una señal reciente del proceso que lo atiende; de lo contrario aparece Sin señal. Si hay varios canales de Telegram habilitados, se muestra Configurado, porque la señal compartida del proyecto no se puede atribuir con seguridad a uno solo. En otros canales habilitados, Configurado indica conexión, no garantiza la entrega de cada mensaje.

La plataforma usa varios procesos. Cada uno registra una señal cada 30 segundos para el bot que atiende. La señal se considera reciente durante un minuto y medio, de modo que una sola actualización perdida no haga parpadear el estado.

Lo que sigue en la práctica:

• La etiqueta tarda en actualizarse. Después de conectar o reiniciar, «En línea» puede tardar hasta ese intervalo en aparecer.
• «Sin señal» durante más de un par de minutos en un canal de Telegram habilitado merece una revisión: comprueba el token y la tarjeta «Salud del bot» en Ajustes. El proyecto sigue Activo a menos que lo pauses o la plataforma lo congele por el plan.
• La señal se comparte entre procesos y no depende del servidor que responda a tu solicitud. Con varios canales de Telegram no demuestra la disponibilidad de cada uno.

Qué ocurre cuando el bot deja de responder

Cada minuto la plataforma revisa las señales. Si un bot habilitado no tiene ninguna reciente, abre un incidente, identifica una causa y trata de recuperarlo. La tarjeta «Salud del bot» en Ajustes puede mostrar cuatro causas:

• webhook: Telegram no entrega las actualizaciones y la plataforma vuelve a registrarlo;
• token revocado: getMe responde 401; no se reinicia automáticamente. Debes emitir un token nuevo en @BotFather y usar «Cambiar token»;
• sin proceso activo: ningún servidor procesa las actualizaciones y la plataforma reinicia el bot;
• causa desconocida: Telegram no respondió a la comprobación.

El reinicio comprueba el token con getMe y registra de nuevo el webhook, igual que «Sincronizar». Los intentos se espacian progresivamente y quedan en el historial del incidente con hora, resultado y error, si lo hubo. La tarjeta también muestra el siguiente intento.

Si el bot no responde más tiempo que el umbral de «Salud del bot» (cinco minutos por defecto), el propietario recibe una notificación en la campana y por email. Los chats configurados como destinatarios reciben un mensaje del bot. Hay una notificación por incidente; cuando vuelve la señal, llega «Bot de nuevo en línea» con la duración de la interrupción. El historial conserva las incidencias anteriores.

Congelación por plan

Además de estar habilitado/deshabilitado, un bot tiene un estado congelado. Un bot es congelado por la plataforma y no por usted, cuando el plan actual deja de cubrir la cantidad de bots conectados. Hay exactamente dos razones:

• se excede el límite de bots: te mudaste a un plan con menos bots de los que has conectado;
• la suscripción no se renovó: el plan pago finalizó y se aplica el límite del plan gratuito.

Un bot congelado no recibe mensajes: la ingesta de actualizaciones se desactiva para él, no simplemente se marca. Los datos, las reacciones y los suscriptores se conservan por completo: la congelación es reversible.

Cómo descongelar. Paga un plan que cubra la cantidad de bots que necesitas. La descongelación ocurre por sí sola en el momento en que se activa el plan pago: los bots regresan al servicio los más antiguos primero, hasta que se llena el límite del nuevo plan. No puedes elegir qué bot regresa; Si no quieres las más antiguas, elimina las conexiones sobrantes y paga el plan después.

Independientemente del congelamiento de un bot, se congela toda la cuenta: luego, cada bot y transmisión se suspenden a la vez y el panel muestra un banner "Cuenta congelada". Sólo support puede levantarlo. Ver Pagos y saldo.

Perfil y sincronización

El botón Sincronizar en Configuración actualiza el nombre del bot desde Telegram (si le cambiaste el nombre en @BotFather). El avatar del bot se introduce automáticamente.

Cambiar el token

Si regeneró el token en @BotFather (Configuración del bot → Revocar / Nuevo token), actualícelo en Configuración → Cambiar token. El nuevo token debe pertenecer al mismo bot (que coincida con el ID interno de Telegram); esto preserva todas las reacciones, suscriptores y datos.

Transferir un bot a otra cuenta

Configuración → Cambiar propietario transfiere el bot a otra cuenta GetMyBot por correo electrónico. Esta acción es irreversible: después de la transferencia pierdes el acceso al bot. Úselo cuando entregue un proyecto a un cliente o colega.

Plantillas de bot

Una plantilla es una instantánea de la configuración del bot y todas sus reacciones que se puede aplicar a otro bot:

• Crear plantilla (en Configuración) guarda el bot actual como una plantilla con nombre.
• Aplicar plantilla reemplaza la configuración del bot de destino con la de la plantilla y agrega las reacciones de la plantilla a las existentes (sin sobrescribirlas).

Esto resulta conveniente para implementar un bot estándar en varios proyectos.

¿Qué sigue?

• Configuración, equipo y acceso: parámetros de comportamiento, roles, plantillas y tokens de API.
• Reacciones: conceptos básicos: desarrolle el comportamiento de su bot.
• Importar desde SamBot: migrar un bot existente.
• Pagos y saldo: planes y límite de recuento de bots.