Saltar al contenido principal
Lark (internacional) y Feishu (China) permiten que el asistente responda a un mensaje directo y a una @mención en un grupo. Elige el dominio que coincida con la consola donde creaste la app.

​
Cuándo usarlo

Usa Lark si la empresa chatea en larksuite.com y Feishu si chatea en feishu.cn. Una conexión de Famulor usa una app y un dominio.

​
Qué oye el asistente

El asistente oye el evento im.message.receive_v1: mensajes directos y mensajes de grupo que mencionan al bot. Publica una versión y concede los permisos de esas conversaciones antes del primer mensaje.

​
Dónde conseguir las claves

La guía del proveedor enlazada muestra las pantallas de estos clics. Sigue los clics de abajo junto con esas imágenes. El App ID, el App Secret y el Verification Token ya existen en la app, antes de tener la URL de Famulor. Las apps internacionales se crean en open.larksuite.com/app. Las de China en open.feishu.cn/app. El evento está documentado en Receive message.

​
Crearlo en el proveedor

  1. Abre la consola de desarrolladores de Lark o Feishu e inicia sesión.
  2. Crea una custom app. Copia el App ID (empieza por cli_) y el App Secret.
  3. Abre las suscripciones de eventos. Copia el Verification Token. Restablécelo ahí si necesitas uno nuevo.
  4. Añade una Encrypt Key solo si activas el cifrado. Entonces los eventos llegan cifrados y Famulor necesita la misma clave.
  5. Suscribe im.message.receive_v1.
  6. Activa el bot. Añade los permisos de mensajes directos y, si quieres grupos, de mensajes de grupo que mencionan al bot.
  7. Crea y publica una versión para poder instalar el bot.

​
Conectarlo en Famulor

Tu plan incluye este canal. Abre Settings → Channels, elige la tarjeta, ponle nombre a la conexión, selecciona un asistente y guarda. Los ajustes de conversación compartidos — retraso de respuesta (5 segundos por defecto) e inactividad (30 minutos por defecto) — están en la página de canales de mensajería. En la tarjeta Lark / Feishu elige Lark (International — larksuite.com) o Feishu (China — feishu.cn). Pega App ID, App Secret y Verification Token. Pega Encrypt Key solo si la app usa una. Después de guardar, abre el menú de la conexión y elige Copy webhook URL. Pega esa dirección exacta en el proveedor. Un dominio personalizado verificado ya forma parte de la dirección que muestra Famulor.

​
Apuntar el proveedor a Famulor

  1. Copia la URL de webhook de Famulor.
  2. En la suscripción de eventos de la app, pon la URL de solicitud en esa dirección y guarda. La consola comprueba el token de verificación.
  3. Instala la app publicada para las personas que deban chatear con ella.
  4. Envía un mensaje directo al bot o menciónalo con @ en un grupo. El hilo aparece en el historial.

​
Historial

Abre el historial y filtra por Lark / Feishu. El hilo, la respuesta del asistente y el análisis, si existe, aparecen ahí. Puedes pausar el asistente y responder tú.

​
API, MCP y línea de comandos

La misma conexión se crea con la API pública, la herramienta MCP create_messaging_connector o la línea de comandos. Sustituye los ejemplos por tus propios valores.