Necesitas un bot de aplicación, no un Webhook de grupo
La conexión utiliza tu propio bot de aplicación de Lark o Feishu, con eventos de mensajes y los permisos que requieran sus funciones. Un bot personalizado de grupo mediante Webhook no lo sustituye. Sparkles permite crear una aplicación con un código QR o conectar una existente. No conectes la misma aplicación a otro servicio de bots al mismo tiempo.
El administrador conecta su cuenta de Sparkles y concede acceso a los miembros; estos no necesitan un saldo de Credits separado. Para un asistente personal, consulta la guía del bot de IA en Telegram.
Conecta la aplicación y activa el primer grupo
- Inicia sesión en Sparkles, pulsa «Conectar apps de chat» en la barra lateral y selecciona Lark / Feishu, o abre los ajustes de la cuenta.
- Selecciona la plataforma y sigue la creación mediante QR. El administrador debe revisar y confirmar los permisos personalmente. Si ya tienes una aplicación, introduce su App ID y App Secret en los campos específicos, activa su bot, configura los eventos de mensajes mediante una conexión persistente y publica los cambios en la consola de desarrollo.
- Completa la vinculación por chat privado indicada en pantalla: escribe al bot creado con QR o envía el comando de vinculación de un solo uso mostrado para una aplicación existente. Por defecto, solo el administrador puede usar el chat privado.
- Añade el bot al grupo, menciónalo una vez y actualiza la lista de grupos en Sparkles. Los grupos nuevos están desactivados por defecto. Configura y guarda los ajustes antes de empezar.
- Elige cómo se activa y qué miembros pueden usarlo. Para empezar, las menciones y unos pocos miembros seleccionados permiten comprobar el funcionamiento antes de ampliar el acceso.
Las tarjetas en streaming y los botones interactivos requieren los permisos y callbacks correspondientes. Publica los cambios de una aplicación existente en la consola. Seleccionar «todos los mensajes» en Sparkles no concede por sí solo permiso para leerlos en la plataforma.
La activación y el acceso de los miembros son ajustes distintos
| Ajuste | Qué determina |
|---|---|
| Solo menciones / Todos los mensajes | Qué mensajes activan el bot |
| Solo administrador / Miembros seleccionados / Todos los miembros | Quién puede utilizarlo |
| Activación del grupo | Si el grupo empieza a procesar peticiones creativas |
Con «solo menciones» y «miembros seleccionados», una persona de la lista sigue teniendo que mencionar al bot. Elegir «todos los miembros» no activa un grupo desactivado. El modo de todos los mensajes es apropiado para grupos que quieren expresamente la participación del asistente; explica antes el alcance y quién asume el coste.
Continúa en el mismo tema para conservar su contexto
Los miembros autorizados que interactúan con el bot en un mismo tema comparten su contexto. Otros temas, grupos y chats privados mantienen contextos separados. Responde en el tema original para revisar su cartel; abre otro para un trabajo sin relación.
Puedes empezar por el evento y el público, añadir las referencias en ese tema y después responder con cambios concretos. Este es un ejemplo de entrada para adaptar a tus materiales, no una conversación de equipo registrada. En modo «solo menciones», selecciona primero al bot desde el menú @ de Lark / Feishu y envía después el texto. Pegar únicamente «@bot» no crea una mención válida.
Este tema es para el cartel de nuestro evento de café del fin de semana.
Organiza primero el público objetivo, el título y los tres datos imprescindibles. No generes todavía una imagen.
Reúne la información que falte y espera nuestra confirmación antes de hablar de la dirección visual.
Otros miembros autorizados pueden completar las fechas o modificar el título en el mismo tema, respetando sus reglas de activación y acceso. Mantén los proyectos independientes en temas distintos: el contexto compartido funciona mejor con un objetivo claro.
/new y /sessions funcionan de forma distinta en grupo y en privado
En un grupo, /new crea un tema independiente incluso si se envía dentro de uno anterior. /sessions muestra los temas previos de ese grupo y abre el elegido; no sustituye el contexto del tema actual por otro historial. La navegación puede requerir permisos adicionales de lectura de mensajes. Si faltan, el administrador debe revisar la configuración.
En privado, /new crea una conversación dentro del mismo chat y /sessions permite volver a las conversaciones anteriores de ese remitente. El cambio afecta a los mensajes nuevos; las tareas enviadas permanecen en su conversación original y los archivos pendientes no se trasladan.
El administrador usa /setting o /settings para elegir el modelo de respuesta, un nivel de razonamiento compatible y el idioma de las tareas nuevas. El /stop de un miembro solicita cancelar su propia tarea más reciente en el contexto actual; no permite administrar el trabajo de otras personas.
Sigue las tarjetas y conserva el archivo original
Las respuestas llegan en tarjetas Markdown por fases de procesamiento. Con permiso de CardKit, el texto puede mostrarse en streaming con efecto de escritura; en caso contrario, se actualizan tarjetas normales. Las tarjetas con opciones las responde quien hizo la pregunta, para evitar que otra persona elija por error.
Se admiten texto, imágenes, archivos normales y vídeos, con hasta 6 adjuntos por petición. Los archivos enviados antes de las instrucciones quedan pendientes por separado para cada miembro; el bot no toma automáticamente imágenes que otra persona aún no haya enviado a procesar. Se mantienen los límites de formato y tamaño de las herramientas y de la plataforma.
Los resultados de imagen incluyen una vista previa y un archivo original aparte. Descarga este último para conservar la calidad. Los resultados que superen el límite de subida no se reducen de calidad sin avisar; el administrador puede consultarlos en la web. Las reacciones de progreso requieren el permiso correspondiente y la finalización solo se marca cuando la tarea y la entrega de resultados terminan correctamente.
Explica el coste y la visibilidad antes de habilitarlo
Todas las peticiones usan los Credits y el acceso a modelos del administrador que vinculó el bot. Dar acceso a un miembro no hace gratuita la generación ni le permite entrar en todo el espacio web del administrador. /credits muestra el saldo únicamente en el chat privado del administrador, nunca en el grupo.
El administrador puede revisar sus conversaciones del canal en la web, incluidos los chats privados del canal. El directorio de conversaciones de un miembro no muestra los chats privados de otros miembros ni otros grupos, pero eso no significa que estén ocultos al administrador. Explica esta visibilidad al equipo antes de activar el bot.
Los lienzos y archivos web privados siguen requiriendo una cuenta autorizada. Publicar un enlace en el grupo no comparte automáticamente el proyecto privado del administrador con todos sus miembros. Consulta el flujo del chat al lienzo.
Empieza con una tarea pequeña y completa
Prueba con un grupo, un tema concreto y unos pocos miembros autorizados: aclara la petición, confirma una dirección, genera y descarga el resultado para revisarlo. Comprueba las tarjetas, los originales, el historial de temas y el consumo de la cuenta administradora antes de ampliar el uso.
Si el bot no responde, revisa si el grupo está activado, si el remitente tiene acceso, si debe mencionar al bot y si se han publicado los permisos. Si existe un resultado pero falta el adjunto, el administrador debe comprobarlo primero en la web antes de solicitar otra generación de pago.
Fuentes y lecturas relacionadas
Inicia sesión para conectar Telegram o Feishu / Lark. Los modelos y las creaciones utilizan los Credits y los permisos de tu cuenta.
