> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lark y Feishu

> Responder a mensajes directos de Lark o Feishu y a @menciones de grupo

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](https://open.larksuite.com/app). Las de China en [open.feishu.cn/app](https://open.feishu.cn/app). El evento está documentado en [Receive message](https://open.larksuite.com/document/server-docs/im-v1/message/events/receive).

## 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](https://docs.famulor.io/es/channels/messaging.md).

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](https://docs.famulor.io/es/monitoring/history.md) 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.

```bash theme={null}
famulor create-messaging-connector --platform lark --name "Support" \
  --assistant-id ASSISTANT_UUID --domain lark --app-id cli_… --app-secret APP_SECRET --verification-token VERIFY_TOKEN
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.