Personalizar el bot de chat
Esta guía te muestra cómo remodelar la app del bot en el lado del proveedor sin salir de Control Center.
Requisitos previos
Sección titulada «Requisitos previos»- El rol
owneroadminen el espacio de trabajo - Un proveedor conectado. La fila Personalizar el bot solo aparece una vez conectado el espacio de trabajo
- Una app que Control Center pueda gestionar. En el caso de Slack, eso significa que la conexión incluye un token de refresco de configuración de la app (
xoxe-…); si no lo incluye, la fila lo indica y permanece desactivada
Qué puedes cambiar
Sección titulada «Qué puedes cambiar»| Campo | Significado | Límite |
|---|---|---|
| Nombre de la app | Cómo lista el proveedor la app | 1–35 caracteres |
| Nombre del bot (lo que se escribe tras @) | Lo que escriben los miembros después de @ |
1–80 caracteres |
| Descripción corta | La línea que muestra el proveedor | 140 caracteres o menos |
| Lo que el bot dice que puede hacer | Se muestra encima de un mensaje directo con el bot | 300 caracteres o menos |
| Comando | El comando que invocan los miembros, sin la barra | En minúsculas, solo a–z 0–9 _ -, truncado a 32 caracteres |
| Mensajes directos | Si el bot ofrece la experiencia de mensajes directos y de agente | Activado o desactivado |
Control Center valida los cuatro campos de texto antes de llamar al proveedor, así que obtienes «the app name must be between 1 and 35 characters» en lugar de un invalid_manifest opaco de un servidor que no puedes ver. El comando no se rechaza, sino que se normaliza: se elimina una barra inicial, el resto se pasa a minúsculas, todo lo que quede fuera de a–z 0–9 _ - se descarta y un resultado vacío vuelve a cc.
Editar el bot
Sección titulada «Editar el bot»- Ve a Ajustes → Espacio de trabajo → General y baja hasta la tarjeta Puentes de chat
- En el bloque del proveedor, haz clic en Personalizar el bot
- El diálogo se abre con los valores en vivo de la app, releídos del proveedor, así que partes de un cambio que alguien haya hecho en la propia interfaz de Slack
- Edita lo que necesites y guarda
Leer esos valores en vivo cuesta una rotación de token por parte de Slack, y por eso la fila es un clic deliberado y no algo que la página haga al cargarse.
La escritura superpone tus cambios a la definición actual de la app. Todo lo que Control Center no modela —un segundo comando slash que hayas añadido en Slack, un paso de flujo de trabajo, un ajuste que no tiene nada que ver— sobrevive intacto. Los ámbitos y los eventos se fusionan, nunca se restan.
Después de guardar, Control Center vuelve a leer la identidad del bot para que el nombre de los ajustes coincida con el nombre de la app de chat.
Reinstalar cuando cambian los permisos
Sección titulada «Reinstalar cuando cambian los permisos»Cuando un guardado cambia los permisos, el diálogo permanece abierto y dice «Slack cambió los permisos de la app. Reinstálala para que surtan efecto», con un botón Reinstalar la app que abre la página de instalación de esa app en el equipo de Slack. En Slack, eso es Install App → Reinstall to Workspace.
Cambiar el nombre del comando
Sección titulada «Cambiar el nombre del comando»Cambia Comando y guarda. A partir de ahí, el puente escribe las instrucciones con el comando con el que se invocó por última vez, de modo que el texto de ayuda y las instrucciones de vinculación siguen al cambio de nombre en lugar de nombrar un comando que ya no existe.
Cambiar el nombre no rompe los hilos vinculados existentes: los hilos tienen como clave la conversación, no el comando.
Lo que Control Center no cambia
Sección titulada «Lo que Control Center no cambia»- Ajustes estructurales. El transporte (Socket Mode), los ámbitos requeridos y las suscripciones a eventos se imponen, no se ofrecen. Una app que se puede configurar hasta dejarla en silencio desde una pantalla de ajustes es un ticket de soporte, no una función
- El icono del bot. Solo pueden cambiarlo los propios ajustes de app del proveedor, y el diálogo lo dice
- Las migraciones de funciones del propio proveedor. Una app que ya está en la antigua forma de asistente de Slack se queda así; este diálogo edita una descripción, no migra una app
Solución de problemas
Sección titulada «Solución de problemas»No aparece ninguna fila Personalizar el bot
Sección titulada «No aparece ninguna fila Personalizar el bot»El espacio de trabajo aún no está conectado. La fila solo aparece cuando el bloque del proveedor muestra una conexión activa. Consulta Configurar la integración con Slack.
La fila Personalizar el bot está desactivada
Sección titulada «La fila Personalizar el bot está desactivada»La conexión no tiene credenciales de gestión de apps: el subtítulo de la fila dice «Control Center necesita un token de configuración de la app para editar el bot. Vuelve a conectar e incluye uno.» En Slack, genera un par de tokens de configuración de la app en api.slack.com/apps y vuelve a conectar con el token de refresco rellenado. Esto es lo esperable en una app creada a mano o mediante Crear en Slack, porque Slack nunca informa de qué app ha creado.
«Control Center does not know which app to edit»
Sección titulada ««Control Center does not know which app to edit»»La conexión almacenada no lleva ningún id de app; normalmente se trata de una app conectada a mano antes de que se registrara un id. Vuelve a conectar el espacio de trabajo o crea la app desde Control Center.
El nuevo nombre del bot no ha aparecido en el chat
Sección titulada «El nuevo nombre del bot no ha aparecido en el chat»Los proveedores cachean brevemente los metadatos de la app. Si el nombre sigue obsoleto después de un minuto, comprueba si el guardado te pidió reinstalar la app.