Volver al centro de ayuda

Conecta Feishu con Elisi Agent

Conecta un bot de Feishu con Elisi Agent

Después de configurar la conexión, puedes escribir por privado a tu bot empresarial en Feishu y pedir a Elisi Agent que registre o busque tareas, listas y otros elementos.

Antes de empezar

Necesitas:

  • Una cuenta de Elisi.
  • Permiso para crear y publicar una app personalizada de Feishu.
  • Aprobación del administrador de tu empresa para los permisos de la app, si es necesaria.

1. Crea una app de Feishu

  1. Abre la plataforma abierta de Feishu y ve a la consola de desarrolladores.
  2. Crea una app personalizada de empresa.
  3. En Añadir capacidades, activa Bot.
  4. En Permisos, añade:
    • Leer los mensajes privados que los usuarios envían al bot.
    • Enviar mensajes como la app.
    • Para usar el bot en grupos, añade también el permiso para recibir mensajes que mencionen al bot.

Guarda el App ID y el App Secret.

2. Conecta el bot en Elisi

  1. Abre Ajustes en Elisi.
  2. En Elisi AI, selecciona Bot de Feishu / Lark.
  3. Elige Feishu como plataforma. Si usas el servicio internacional Lark, selecciona Lark.
  4. Introduce un nombre opcional para el bot, el App ID, el App Secret y el Verification Token que muestra la consola de Feishu.
  5. Selecciona Conectar bot.

Después de la verificación, Elisi mostrará:

  • Una URL de callback de eventos.
  • Un comando de un solo uso para vincular la cuenta.

El App Secret solo se muestra una vez. Elisi lo guarda cifrado y no lo envía al agente.

3. Configura los callbacks de eventos

Vuelve a la plataforma abierta de Feishu:

  1. Abre Eventos y callbacks o Suscripciones de eventos.

  2. Selecciona Enviar eventos a un servidor de desarrollador.

  3. Copia la URL de callback de eventos de Elisi y pégala como URL de solicitud.

  4. Deja vacío Encrypt Key.

  5. Guarda la URL y espera a que Feishu confirme la verificación.

  6. Selecciona Añadir evento y añade:

    Recibir mensajes (im.message.receive_v1)

Verificar la URL no es suficiente; también debes añadir im.message.receive_v1.

4. Publica e instala la app

  1. Crea una versión nueva en la plataforma abierta de Feishu.
  2. Comprueba que incluye los permisos y el evento de mensaje recién añadidos.
  3. Envíala a revisión y publícala. Si hace falta, completa primero la aprobación del administrador.
  4. Instálala en la empresa y confirma que tu cuenta de Feishu está dentro del ámbito de disponibilidad.

Después de cambiar permisos o suscripciones, publica una versión nueva para aplicar los cambios.

5. Vincula tu cuenta de Elisi

La configuración y la publicación suelen tardar más de 15 minutos. Cuando la app esté publicada, vuelve a Elisi:

  1. En la tarjeta del bot, selecciona Generar nuevo código de vinculación.

  2. Copia el comando de un solo uso completo, por ejemplo:

    /elisi-bind AbCdEf123

  3. En los siguientes 15 minutos, abre un chat privado con el bot y envía el comando.

  4. Cuando aparezca el mensaje de éxito, vuelve a Elisi y actualiza el estado.

La configuración termina cuando el estado cambia de Esperando vinculación a Conectado. La primera vinculación debe hacerse en un chat privado, no en un grupo.

6. Usa el bot

  • Chat privado: Envía texto directamente al bot.
  • Chat de grupo: Un usuario vinculado debe mencionar al bot.
  • Desconectar: Selecciona Desconectar en la tarjeta del bot en Elisi.

La versión actual admite mensajes de texto. No admite callbacks cifrados con Encrypt Key, archivos adjuntos, tarjetas interactivas ni compartir una cuenta de Elisi entre varias personas.

Solución de problemas

Problema Qué revisar
Falla la verificación de la URL o no se recibe el desafío Comprueba que la URL esté completa y que el Verification Token coincida. Borra Encrypt Key y vuelve a guardar.
La URL se verifica, pero el bot no responde en privado Confirma que añadiste im.message.receive_v1. Después de añadir eventos y permisos, vuelve a publicar, aprobar e instalar la versión actual.
Elisi sigue mostrando «Esperando vinculación» Genera otro código y envía el comando completo en un chat privado dentro de 15 minutos. Los códigos anteriores caducan.
La cuenta está vinculada, pero el bot no responde Comprueba que se haya aprobado el permiso para enviar mensajes como la app y que esté incluido en la última versión publicada.
El bot no responde en un grupo Primero vincula la cuenta por privado. Después, un usuario vinculado debe mencionar al bot en el grupo.
No encuentras el bot o no puedes escribirle Comprueba que la app esté instalada y que tu cuenta esté dentro del ámbito de disponibilidad.

Si el problema continúa, revisa Registros de envío de eventos en la plataforma abierta de Feishu y confirma que aparece im.message.receive_v1. Si no aparece, es posible que el evento, los permisos, la versión publicada o el ámbito de la app aún no estén activos.