Proyectos y canales
Cómo crear un proyecto, conectar un bot y comprobar su estado. Varios canales, cambio de token, pausas y recuperación tras una suspensión.
En esta página
Un proyecto reúne la configuración, las reacciones y los datos de un bot o servicio. Un canal lo conecta con un lugar donde hablan tus clientes: un bot de Telegram, el chat de tu sitio web u otra aplicación de mensajería. Por ejemplo, una escuela puede tener un proyecto con dos canales: Telegram y su sitio web.
Crea el proyecto en Proyectos y después añade un canal. Para Telegram necesitas el token de @BotFather, el código que permite gestionar el bot. Puedes cambiar de proyecto desde la parte superior de la cuenta.
También puedes conectar WhatsApp y VK al mismo proyecto y usar las mismas reacciones en todos los canales. Consulta Canales y WhatsApp.
Conexión de un bot
- Si aún no tienes un proyecto, abre Proyectos y pulsa Añadir proyecto. En su tarjeta, pulsa Añadir canal y selecciona Telegram. Para el primer bot también puedes usar el asistente inicial.
- Pega el token de @BotFather y pulsa Validar. GetMyBot muestra el
@usernamedel bot para que confirmes que el token es correcto. - Pulsa Conectar. El token se guarda cifrado y la recepción de actualizaciones comienza de inmediato.
Telegram aparecerá en la tarjeta del proyecto junto a los demás canales. Verás el nombre del proyecto, la dirección del bot, el número de usuarios, las reacciones activas y las solicitudes de hoy. Consulta el saldo 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
GetMyBot recibe automáticamente los mensajes y otros eventos de Telegram después de conectar el bot. No tienes que configurar esa recepción por separado: basta un token válido. El bot puede responder a mensajes privados y de grupos, pulsaciones de botones, entradas y salidas de participantes, reacciones a mensajes y pagos.
Habilitar y deshabilitar
Cada bot puede estar activado o desactivado; puedes cambiarlo en la tarjeta Estado del bot de los ajustes. Si lo desactivas, deja de responder inmediatamente. No hace falta volver a conectarlo.
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.
GetMyBot comprueba periódicamente si el bot sigue funcionando. El estado puede tardar hasta un minuto y medio en actualizarse, para que un retraso breve no cambie la etiqueta sin motivo.
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.
- Si hay varios canales de Telegram, la etiqueta general del proyecto no confirma que cada canal funcione por separado. Comprueba el canal concreto si deja de recibir mensajes.
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:
getMeresponde 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 activado o desactivado, un bot puede aparecer como Congelado: significa que está suspendido porque el plan actual ya no permite tener tantos bots conectados. Hay dos motivos:
- Se superó el límite de bots: cambiaste a un plan que permite menos bots de los que tienes conectados.
- La suscripción no se renovó: terminó el plan de pago y ahora se aplica el límite del plan gratuito.
Un bot suspendido no recibe mensajes. Sus datos, reacciones y contactos se conservan, por lo que puedes volver a activarlo.
Cómo reactivarlo. Contrata un plan que permita el número de bots que necesitas. Cuando se active, los bots volverán a funcionar automáticamente, empezando por los más antiguos, hasta alcanzar el límite del nuevo plan. No puedes elegir el orden. Si necesitas otros bots, elimina antes las conexiones que ya no uses.
También puede suspenderse toda la cuenta. En ese caso se detienen todos los bots y envíos, y verás el aviso «Cuenta congelada». Para resolverlo, contacta con soporte. Consulta Pagos y saldo.
Perfil y sincronización
El botón Sincronizar en Ajustes actualiza el nombre del bot desde Telegram, por ejemplo, si lo cambiaste en @BotFather. La foto del bot se actualiza automáticamente.
Cambiar el token
Si regeneró el token en @BotFather (Configuración del bot → Revocar / Nuevo token), actualícelo en Configuración → Canales → Telegram 🔑. El nuevo token debe pertenecer al mismo bot (que coincida con el ID interno de Telegram); esto preserva todas las reacciones, suscriptores y datos. Si no se muestra el canal de Telegram, elige «Cambiar token» en la misma ventana.
Transferir un bot a otra cuenta
Ajustes → Cambiar propietario envía una propuesta de transferencia a otra cuenta de GetMyBot por correo. La propuesta dura 72 horas. Hasta que la otra persona la acepte, el proyecto sigue siendo tuyo y puedes cancelar la propuesta. Cuando la acepta, cambia el propietario y pierdes el acceso al proyecto. Úsalo para entregar un proyecto a un cliente o compañero.
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).
Así puedes usar la misma configuración inicial en varios proyectos.
Instalar una solución del catálogo
El catálogo incluye soluciones listas para instalar. Indica los datos necesarios, comprueba que tu proyecto y sus conexiones sean compatibles, y revisa qué se creará. Después de la instalación, completa los pasos pendientes y prueba la solución con una consulta de prueba.
Este asistente es distinto de aplicar una plantilla del bot. Completar un paso de instalación no demuestra por sí solo que un servicio externo funcione: comprueba también el resultado real.
Resultados de una solución instalada
Elige el período que quieres evaluar. Si comparas resultados, selecciona un modo disponible y comprueba cuántos casos se incluyeron. «No hay suficientes datos» y «No se puede comparar» no significan que el resultado sea cero.
¿Qué sigue?
- Ajustes, equipo y acceso: configuración del proyecto y permisos.
- Reacciones: conceptos básicos: define cómo responde el bot.
- Importar desde SamBot: traslada un bot existente.
- Pagos y saldo: planes y límite de bots.