Ajustes, equipo y acceso
Cambiar el comportamiento del bot, invitar al equipo, limitar permisos y activar el modo de prueba. Acceso a un proyecto y a toda la cuenta.
En esta página
En Ajustes se cambian las reglas generales del bot y el acceso del equipo. Por ejemplo, puedes activar el modo de prueba para ti, permitir que un operador trabaje solo con las conversaciones o dar a un administrador permiso para editar reacciones.
Antes de cambiar algo, comprueba qué proyecto está seleccionado en la parte superior de la cuenta. El acceso a un proyecto y el acceso a toda la cuenta se configuran por separado. Arriba también se muestran el estado del bot, el número de usuarios y el consumo de solicitudes.
General
- Mención: cómo se menciona al bot en los grupos.
- Posición en la lista: orden del bot entre los demás.
- Modo de visualización de usuarios: «Mostrar todos» / «Solo activos» / «Solo los que pagaron».
- Idioma de la interfaz: Русский / English.
Comportamiento
Interruptores que controlan cómo funciona el bot:
- Solicitar consentimiento para el tratamiento de datos personales.
- Enviar al usuario un mensaje de error.
- Admitir entidades HTML en los mensajes.
- Agrupar archivos multimedia en un solo mensaje.
Modo de prueba
En Test users (usuarios de prueba), indica los ID de Telegram o VK del propietario y de quienes prueban el bot, hasta un máximo de 20. Sus mensajes pasan por las reacciones habituales, pero no se cobran solicitudes: ni por iniciar una reacción, ni por entregar mensajes, ni por IA o integraciones. En el registro de solicitudes, estas filas llevan la marca «Test» y la columna Descontado muestra lo que se habría cobrado por un usuario normal. Para encontrar tu ID, envía /start al bot y abre tu perfil en Personas. Por API: PATCH /api/bots/{botID}/settings con {"test_user_ids":[123456789]}; por MCP: update_bot_settings.
Acceso al proyecto
La tarjeta Acceso al proyecto de los ajustes del bot permite trabajar en un solo bot a otras personas: cada una inicia sesión con su propio email y ve el proyecto en su cuenta. Si necesitas compartir todos los bots de la cuenta, incluidos los futuros, usa el acceso a la cuenta.
La tarjeta está visible para el propietario del bot y los miembros con el permiso «Acceso». La lista contiene tres tipos de fila:
- Miembro: una cuenta que ya aceptó la invitación y puede trabajar en el proyecto. Una marca indica si tiene activada la 2FA.
- Invitado: la invitación se envió, pero todavía no se aceptó. La fila indica hasta cuándo vale el enlace. Por sí sola, no concede acceso.
- Fila antigua: procede de una versión anterior de la pantalla, donde se añadían nombres manualmente. No concede acceso y solo se puede eliminar.
El propietario lleva la marca Propietario: tiene todos los permisos y no se puede modificar ni eliminar.
Roles
Cada rol incluye un conjunto de permisos:
| Rol | Permisos en el proyecto |
|---|---|
| Administrador | Todos los permisos, incluida la gestión del acceso. |
| Gestor | Chats, analítica, lectura de tickets de soporte y respuesta en soporte. |
| Operador | Chats, lectura de tickets de soporte y respuesta en soporte. Así puedes incorporar operadores de Chats sin darles acceso al constructor. |
Cambiar el rol de una fila sustituye sus permisos por los del nuevo rol. Un miembro que no es propietario solo puede asignar un rol si ya tiene todos los permisos de ese rol. Nadie puede cambiar su propio rol ni sus propios permisos.
Permisos
El botón Permisos abre el ajuste detallado. Arriba figuran los permisos vigentes y debajo hay casillas agrupadas en Datos, Contenido, Automatización, Soporte, Analítica, Integraciones, IA y Seguridad. Cada cambio se guarda de inmediato; después de un ajuste manual, el rol sigue apareciendo como referencia.
- Solo puedes conceder o retirar un permiso que tengas tú mismo; el propietario los tiene todos. Las demás casillas están desactivadas y el servidor rechaza esos cambios.
- Los permisos sensibles son Exportar perfiles, Ingresos en analítica, Secretos de integraciones y Exigir doble factor. Si no tienes uno, el cuadro indica expresamente que no puedes concederlo.
- Si un permiso no funciona sin otro, por ejemplo «Editar perfiles» sin «Ver perfiles», aparece una advertencia debajo.
Invitación al proyecto
- Pulsa Invitar, indica el email y el rol (por defecto, «Operador») y pulsa Conceder acceso.
- La persona recibirá por email un enlace de un solo uso con el formato
/invite?token=…, válido durante 72 horas. Solo el destinatario ve el enlace; no aparece en la interfaz. - El destinatario abre el enlace e inicia sesión con la cuenta que usa ese email, o se registra. Al aceptar, el proyecto aparece de inmediato en su lista.
La invitación solo puede aceptarse desde una cuenta cuyo email esté verificado:
- Si el enlace se abre con otra cuenta, la página ofrece iniciar sesión con la correcta (botón Agregar cuenta) y la invitación sigue vigente.
- Si el email no está verificado, la página ofrece reenviar el correo de verificación. Una vez verificado, pulsa Correo confirmado: aceptar.
- Un enlace ya usado, caducado o desconocido no sirve: pide una invitación nueva.
Volver a invitar al mismo email sustituye la invitación anterior: se envía otro enlace válido 72 horas y el anterior deja de funcionar. No se puede invitar al email del propietario del bot; el servidor responde 409.
Cambiar o revocar el acceso
Cambia el rol en el menú de la fila y los permisos en el cuadro Permisos. También puedes ajustar el rol y los permisos de una persona invitada antes de que acepte. El botón de la papelera revoca el acceso de un miembro, cancela una invitación (su enlace deja de funcionar) o elimina una fila antigua.
Para invitar o cambiar roles y permisos, el plan del propietario del bot debe incluir roles. Si no, la lista sigue visible, aparece una indicación sobre el plan en lugar de Invitar y el servidor responde 402. Revocar acceso funciona con cualquier plan.
Acceso a toda la cuenta
El acceso al proyecto abre un solo bot. Para compartir todos los bots de la cuenta, incluidos los futuros, y los permisos propios de la cuenta (pagos, creación de bots y equipo), abre Cuenta → Cabinet access. Esta tarjeta aparece con ese nombre en la interfaz.
Roles:
- Administrator: todos los permisos.
- Manager: chats, reacciones, analítica, perfiles, eventos, segmentos, contenido y campañas (lectura y edición), lectura de tickets de soporte y respuesta en soporte.
- Operator: chats, lectura de perfiles, lectura de tickets de soporte y respuesta en soporte.
- Finance: solo lectura del saldo y los pagos, sin permisos sobre los bots.
El propietario de la cuenta figura por separado y no se puede modificar ni eliminar. El botón Rights permite ajustar los permisos de un rol; el nombre del rol permanece como referencia. Los permisos de la cuenta son:
- View balance and payments (
billing.read); - Payments and top-ups (
billing.write); - Manage the cabinet team (
team.manage); - Create bots (
bots.create); - Delete bots (
bots.delete); - Security (
security.manage); - Audit log (
audit.read).
El mismo cuadro Rights permite asignar permisos sobre los bots, que se aplican a todos los bots de la cuenta.
Puede conceder acceso el propietario o un miembro con Manage the cabinet team; nadie puede conceder un permiso que no tenga. La función requiere un plan con roles; de lo contrario, el servidor responde 402.
Invitación
El acceso se concede por email: pulsa Invite, indica la dirección y el rol. El destinatario recibe un enlace de un solo uso válido durante 72 horas. Solo puede aceptarlo desde la cuenta con ese email verificado:
- Si abre el enlace con otra cuenta, la página ofrece iniciar sesión con la correcta y la invitación sigue vigente.
- Si el email no está verificado, primero debe confirmarlo mediante el mensaje recibido.
- Un enlace usado, caducado o desconocido no sirve: pide una invitación nueva.
El acceso a toda la cuenta solo se administra desde una sesión web: estas operaciones no están disponibles con un token API ni mediante MCP. Para saber cómo se aplican los permisos de la cuenta a los tokens API, consulta la cuenta del token.
Tokens API
La sección Tokens API crea claves para acceder al bot mediante la REST API. El valor de un token se muestra una sola vez al crearlo: cópialo en ese momento; después solo aparece una versión enmascarada. Más información en REST API y tokens.
Plantillas
Una plantilla guarda una instantánea de los ajustes del bot y todas sus reacciones para reutilizarlos:
- Crear plantilla: guarda el bot actual, incluidos sus ajustes y reacciones, como una plantilla con nombre.
- Aplicar plantilla: copia la plantilla a otro bot. Sustituye los ajustes por los de la plantilla y añade las reacciones a las existentes, sin sobrescribirlas.
Sirve para desplegar un bot estándar en varios proyectos. Consulta también Proyectos y canales.
Mantenimiento del bot
- Sincronizar: obtiene de Telegram el nombre actual del bot y vuelve a configurar la recepción de mensajes si está activo. Es la forma habitual de recuperar la conexión cuando el bot aparece sin conexión y se puede repetir sin riesgo. No cambia los demás ajustes, el estado ni el orden del bot. Técnicamente, primero llama a Telegram
getMe, después vuelve a leer el estado del bot y solo registra el webhook si estáactive. Si el canal de Telegram ya estaba desactivado, la comprobación termina antes degetMe. En los estadospausedyfrozenno inicia la recepción. Si el canal se desactiva o el bot se activa al mismo tiempo que la sincronización, el nombre puede quedar guardado antes de que aparezca un error. Si Telegram rechaza el nuevo webhook, se conserva el nombre confirmado, se descarta el nuevo receptor y el proceso del bot que ya funcionaba continúa ejecutándose e informando de su estado. - Canales → Telegram 🔑 — actualiza el token tras regenerarlo en @BotFather. Si no se muestra el canal de Telegram, elige «Cambiar token» en la misma ventana.
Reenvío de mensajes de usuarios
El proyecto debe tener exactamente un canal de Telegram habilitado. Activa Reenviar mensajes de usuarios y selecciona un chat en el que pueda escribir el bot. Si lo necesitas, indica el ID numérico del tema y guarda los ajustes. Los avisos incluyen los datos del remitente y la hora del mensaje original.
Pulsa Añadir recordatorio e indica los minutos transcurridos desde el primer mensaje. Puedes añadir hasta 20 intervalos crecientes, de 1 a 43 200 minutos. Los recordatorios terminan cuando se entrega una respuesta. En un grupo puede responder un administrador o creador desde su propia cuenta; los administradores anónimos no superan la comprobación. El bot debe ser administrador del grupo para que Telegram pueda verificar los permisos de forma fiable. En un chat privado puede responder su interlocutor. Se aplica la ventana habitual de respuesta de WhatsApp de 24 horas; cuando se cierre, usa una plantilla aprobada en el servicio.
Estado del bot
La tarjeta Bot health, con ese nombre en la interfaz, muestra si el bot está disponible. Si se detecta un fallo, indica la causa, el número de reinicios automáticos, la hora del próximo intento y el último error. Puedes consultar el historial de reinicios del incidente actual y los incidentes anteriores con su duración y causa. Un bot que has desactivado aparece como desactivado, no como un bot averiado; el historial de incidentes se conserva. Más información en Proyectos y canales.
En la misma tarjeta se configuran las alertas:
- Notify the bot owner when the bot is offline: el propietario recibe una notificación en la campana y por email; el bot también envía un mensaje a los mismos chats que reciben el aviso de saldo agotado.
- Threshold, minutes without a heartbeat: un número entero entre 1 y 1440; el valor predeterminado es 5. El formulario muestra un error si se deja vacío, se introduce una fracción o se supera el intervalo. No ajusta silenciosamente el valor.
Solo el propietario del bot o un miembro con el permiso «Reacciones» puede modificar estas dos opciones. Los demás pueden ver el estado, pero no cambiar esos ajustes.
- Cambiar propietario: invita a un nuevo propietario. La invitación dura 72 horas. El proyecto sigue siendo tuyo hasta que la acepte y puedes cancelarla antes. Cuando la acepte, perderás el acceso al proyecto.
Qué sigue
- REST API y tokens: acceso programático.
- Proyectos y canales: token, transferencia y plantillas.
- Chats y operadores: el rol «Operador» en la práctica.
- Autenticación de dos factores: configuración, códigos de recuperación y dispositivos de confianza.
Ajustes de soporte y seguridad
Los ajustes de soporte establecen la zona horaria, el horario semanal, los descansos, los turnos que pasan de medianoche, los festivos y las respuestas automáticas para horarios de atención y fuera de ellos. También puedes indicar un grupo de respaldo para cuando los operadores principales no estén disponibles. Comprueba la vista previa de disponibilidad antes de guardar el horario. El sistema asignará el diálogo a un operador apto con la menor carga, lo enviará al grupo de respaldo o lo dejará sin asignar.
Solo el propietario del bot puede exigir la autenticación de dos factores a los miembros. Antes de activar esa regla, comprueba cuántas personas se verán afectadas y cómo podrán configurar la 2FA. Los roles controlan el acceso a la configuración del bot, los datos de soporte, la analítica y la política de seguridad, pero ni el equipo de soporte ni otra persona con un rol pueden ver el secreto del autenticador, los códigos de recuperación o el token de un dispositivo de confianza de otra cuenta.