> ## 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.

# Notion

> Responder a @menciones en comentarios de páginas y bloques de Notion

Notion permite que el asistente responda en comentarios de páginas y bloques. Alguien del equipo escribe el nombre del bot en un comentario y la respuesta vuelve en ese mismo hilo.

## Cuándo usarlo

Úsalo para una wiki, un briefing de cliente o una página de proyecto cuya conversación ya está en comentarios. El asistente no edita el contenido de la página y no ve el espacio hasta que compartes cada página con la conexión.

## Qué oye el asistente

El asistente oye comentarios de las páginas compartidas con la conexión. Los bots de conexión de Notion no aparecen en el menú @: hay que escribir `@` y el nombre a mano. Basta una suscripción a **Comment created**.

## 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.

Un propietario del espacio abre [Notion Settings → Connections](https://www.notion.com/help/create-integrations-with-the-notion-api), activa el modo de desarrollador y crea una conexión. El token empieza por `ntn_` o `secret_` y se muestra una sola vez. El token de verificación del webhook aún no existe: Notion lo envía solo cuando hay una URL pública. Las pantallas están en [Notion webhooks](https://developers.notion.com/reference/webhooks).

## Crearlo en el proveedor

1. En Notion, abre **Settings → Connections**. Hace falta ser propietario del espacio.
2. Activa el acceso de desarrollador para conexiones internas y elige **New connection**.
3. Ponle nombre, elige el espacio y activa **Read comments** e **Insert comments**.
4. Abre el menú de la conexión y copia el token de integración. Se muestra una sola vez.
5. En cada página que el asistente deba ver, abre **••• → Connections** y añade esta conexión.
6. Deja el webhook para el paso siguiente. Notion pide una URL HTTPS pública antes de crear el token de verificación.

## 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 **Notion** pega **Notion integration token**. Deja vacío **Webhook verification token**. **Bot @mention name** es el nombre que se escribe después de `@`.

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 del webhook. También aparece al editar la conexión.
2. En la conexión de Notion, abre **Webhooks → Create a subscription** y elige **Comment created**. Pega la URL de Famulor.
3. Notion envía el token de verificación una vez. Vuelve a abrir la conexión en Famulor. El token aparece como **Notion verification token**, y el menú tiene **Copy verification token**.
4. Pega ese token en el paso **Verify** de Notion. Si se perdió el primer envío, reenvía el token desde Notion.
5. Tras verificar, Notion bloquea la URL. Un comentario nuevo que mencione el nombre del bot aparece en el historial.

## Historial

Abre el [historial](https://docs.famulor.io/es/monitoring/history.md) y filtra por **Notion**. 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 notion --name "Support" \
  --assistant-id ASSISTANT_UUID --token ntn_… --bot-username notion-bot
```


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