> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Notion Tu recepcionista puede buscar en tu espacio de trabajo de Notion, leer una página y consultar una base de datos, como una lista de precios, una tabla de productos o una lista de puestos vacantes, para responder a quienes llaman. La lectura se realiza mediante [herramientas de webhook](/docs/es/reception-ai/integrations/webhooks) con una conexión interna de Notion, que funciona en todos los planes de Notion y solo ve las páginas que compartes con ella. Añadir entradas a una base de datos también funciona con una herramienta de webhook, mediante una segunda conexión que solo puede añadir contenido. Puedes usar [Zapier](/docs/es/reception-ai/integrations/zapier) para ello, pero se recomienda la herramienta de webhook: no necesita una cuenta de Zapier ni consume tus tareas de Zapier, y cada solicitud va directamente a Notion. Sin embargo, la herramienta de webhook no puede rellenar la propiedad de título, así que si tus entradas necesitan un título real, usa Zapier. > **Note** > > Si tu contenido de Notion cambia rara vez, quizá no necesites una integración. Exporta la página de > Notion y [súbela a tu base de conocimientos](#use-the-knowledge-base-instead). > **Warning** > > Tu recepcionista puede leer todo lo que compartas con la conexión y repetírselo a quienes llaman. > Comparte solo páginas sobre las que puedan oír hablar quienes llaman y añade una > [regla](/docs/es/reception-ai/receptionist/rules-and-procedures) para que tu recepcionista nunca lea > registros privados, como datos de clientes, a quienes llaman. ## Configuración ### Crea una conexión interna Debes ser propietario del espacio de trabajo. Ve a [app.notion.com/developers/connections](https://app.notion.com/developers/connections), selecciona **Internal connections** y después **Create a new connection**. Llámala `Reception.ai` y elige tu espacio de trabajo. En la pestaña **Configuration**, permite solo la lectura de contenido y copia el **API token**. ### Comparte páginas con la conexión Abre la pestaña **Content access** de la conexión, selecciona **Edit access** y elige las páginas y bases de datos que debería leer tu recepcionista. También puedes abrir una página en Notion, seleccionar **•••** → **Connections** → **+ Add connection** y elegir `Reception.ai`. Las páginas secundarias también se comparten. ### Busca el ID de la fuente de datos Para permitir que tu recepcionista lea una base de datos, abre la configuración de la base de datos en Notion, selecciona **Manage data sources**, abre el menú **•••** junto a la fuente de datos y selecciona **Copy data source ID**. ### Crea las herramientas de webhook Crea las [herramientas de abajo](#tools). Para cada una, ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**. ### Pruébalo [Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) haciendo una pregunta que responda una de tus páginas compartidas. ## Herramientas Cada herramienta envía estas cabeceras de solicitud: | Cabecera | Tipo | Valor | | ---------------- | ------- | ------------------------------------------ | | `Authorization` | Secreto | `Bearer ` seguido del token de tu conexión | | `Notion-Version` | Valor | `2026-03-11` | Configura **Assign to agents** como **Receptionist** en cada herramienta y selecciona **Enable**. ### Buscar páginas | Campo | Valor | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `search_notion` | | **Descripción** | "Busca en nuestras páginas de Notion por título. Úsala cuando alguien que llama pregunte algo que nuestros documentos podrían responder y luego lee la mejor coincidencia con `read_notion_page`." | | **Método** | POST | | **URL** | `https://api.notion.com/v1/search` | | **Parámetros del cuerpo** | `query` (cadena, obligatorio): "Un título breve que buscar, como `pricing` u `opening hours`." `page_size` (número, valor fijo): `10` | ### Leer una página | Campo | Valor | | -------------------------- | -------------------------------------------------------------------------------------- | | **Nombre** | `read_notion_page` | | **Descripción** | "Lee el texto completo de una página de Notion encontrada con `search_notion`." | | **Método** | GET | | **URL** | `https://api.notion.com/v1/pages/{page_id}/markdown` | | **Parámetros de ruta** | `page_id` (cadena, obligatorio): "El `id` de una página devuelta por `search_notion`." | | **Parámetros de consulta** | `markdown_version` (cadena, valor fijo): `v2` | ### Leer una base de datos | Campo | Valor | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `read_notion_table` | | **Descripción** | "Enumera las filas de nuestra lista de precios. Úsala cuando alguien que llama pregunte por precios o por lo que ofrecemos." Describe aquí tu propia tabla. | | **Método** | POST | | **URL** | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query` | | **Parámetros del cuerpo** | `page_size` (número, valor fijo): `100` | Sustituye `DATA_SOURCE_ID` por el ID que copiaste. Crea una herramienta por cada base de datos, cada una con su propio nombre y descripción. ## Añade entradas a una base de datos con una herramienta de webhook (recomendado) Para guardar algo de una llamada en una base de datos de Notion, como un contacto potencial o una solicitud de devolución de llamada, crea una herramienta que añada una entrada. ### Crea una conexión para nuevas entradas Crea una segunda conexión interna, por ejemplo `Reception.ai entries`, del mismo modo que la primera. En la pestaña **Configuration**, permite solo insertar contenido y copia su **API token**. En **Content access**, comparte solo la base de datos a la que añadirá entradas. Esta conexión no puede leer nada, así que las entradas se mantienen privadas. ### Prepara la base de datos Copia el ID de la fuente de datos de la base de datos, como en [Configuración](#set-up). Cada propiedad que rellena la herramienta es una clave en la solicitud, y las claves no pueden contener espacios, así que asigna a esas propiedades nombres de una sola palabra, como `Phone`, `Email` y `Status`. ### Crea la herramienta de webhook Ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**. | Campo | Valor | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nombre** | `add_notion_entry` | | **Descripción** | "Guarda un nuevo contacto potencial en nuestra base de datos de contactos potenciales cuando alguien que llama quiere un presupuesto o que le devolvamos la llamada." Describe aquí tu propia base de datos. | | **Método** | POST | | **URL** | `https://api.notion.com/v1/pages` | | **Cabeceras de solicitud** | `Authorization` (Secreto): `Bearer ` seguido del token de la nueva conexión `Notion-Version` (Valor): `2026-03-11` | | **Parámetros del cuerpo** | `parent` (objeto, obligatorio) `markdown` (cadena, obligatorio) `markdown_version` (cadena) `properties` (objeto, obligatorio) | | **Asignar a agentes** | **Receptionist** | Configura los parámetros del cuerpo así: * `parent`: un campo, `data_source_id` (cadena, valor fijo): el ID de tu fuente de datos. * `markdown` (de la conversación): "La entrada en Markdown. Empieza con una línea `# ` seguida del nombre de quien llama y de lo que necesita, por ejemplo `# Jane Doe: quote for a new boiler`. Después añade una línea en blanco y los detalles de la solicitud." * `markdown_version` (valor fijo): `v2` * `properties`: selecciona **Add field** una vez por cada propiedad que rellenar. Cada una es un objeto con el nombre exacto de la propiedad y un campo para su valor: * `Phone` (objeto): `phone_number` (cadena, de la conversación): "El número de teléfono de quien llama." * `Email` (objeto): `email` (cadena, de la conversación): "La dirección de correo electrónico de quien llama, confirmada letra por letra. Omítela si no ha dado ninguna." * `Status` (objeto, obligatorio): `select` (objeto, obligatorio), con un campo, `name` (cadena, valor fijo): `New` Notion documenta que, cuando se omite la propiedad de título, el primer encabezado `#` se convierte en el título de la página; su documentación solo lo muestra para páginas creadas dentro de otra página, así que comprueba que funcione en tu base de datos. En cualquier caso, el encabezado y los detalles se guardan como contenido de la entrada, y se rellenan las propiedades de teléfono, correo electrónico y estado. Omite la propiedad de título de `properties`: Notion anida los valores de título y texto a seis niveles de profundidad, uno más de lo que permiten las herramientas de webhook. Las propiedades de número de teléfono, correo electrónico, URL, número, casilla de verificación, selección y fecha son compatibles. Una propiedad de tipo Status usa `status` en lugar de `select`. Selecciona **Enable** y después [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) solicitando que te devuelvan la llamada. La entrada aparecerá en la base de datos. ## Añade entradas a una base de datos con Zapier Para añadir entradas mediante Zapier, conecta [Zapier](/docs/es/reception-ai/integrations/zapier). En tu servidor MCP de Zapier en [mcp.zapier.com](https://mcp.zapier.com), añade la acción **Create Data Source Item** de Notion, configura la base de datos como un valor fijo y deja que la IA rellene los campos. En Reception.ai, abre la pestaña **Tools** de la integración de Zapier, selecciona **Refresh tools** y asigna la acción al **Client** (recepcionista). ## Usa la base de conocimientos en su lugar Para contenido que no cambia a menudo, la [base de conocimientos](/docs/es/reception-ai/knowledge-base/overview) es más sencilla y rápida que las consultas en tiempo real. En Notion, abre el menú **•••** de la página, elige **More** → **Export** y selecciona **PDF**, **HTML** o **Markdown & CSV**. Las exportaciones HTML y Markdown se descargan como un archivo zip, así que descomprímelo primero. Después [sube el archivo](/docs/es/reception-ai/knowledge-base/file-uploads). Las bases de datos se exportan a CSV, que la base de conocimientos no admite, así que exporta las bases de datos como PDF. Vuelve a exportar y subir el archivo cuando cambie el contenido. ## Limitaciones * La búsqueda de Notion coincide con títulos de páginas y bases de datos, no con el texto dentro de las páginas. Pon títulos claros a las páginas, como "Política de cancelación". * `read_notion_table` devuelve las primeras 100 filas y solo sus propiedades, no el contenido de la página de cada fila. Mantén pequeñas las tablas que lee tu recepcionista. * El servidor MCP alojado de Notion requiere iniciar sesión en un navegador, excepto en los planes Business y Enterprise, donde un propietario del espacio de trabajo puede crear un token MCP. Las herramientas de webhook anteriores funcionan en todos los planes. * `add_notion_entry` no puede rellenar propiedades de título ni de texto. Pon los nombres y las notas en el encabezado y el contenido. * Si añades entradas mediante Zapier, cada acción de Zapier que ejecute tu recepcionista consume tareas de tu plan de Zapier. Actualmente, Zapier cuenta dos tareas por cada llamada realizada correctamente. ## Resolución de problemas | Problema | Qué comprobar | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 de Notion | La cabecera `Authorization` debe ser `Bearer ` seguida del token de la conexión. | | 400 sobre la versión | Configura `Notion-Version` como `2026-03-11`. | | 404 u `object_not_found` | Comparte la página o base de datos con la conexión y usa el ID de la fuente de datos, no el ID de la base de datos. | | 403 en `read_notion_page` | La conexión necesita permiso para leer contenido. | | 403 en `add_notion_entry` | La conexión de entradas necesita permiso para insertar contenido y acceso a la base de datos. | | 400 `validation_error` en `add_notion_entry` | Cada clave de `properties` debe coincidir exactamente con un nombre de propiedad, y su campo debe coincidir con el tipo de la propiedad. | | Las nuevas entradas aparecen como **Untitled** | Notion no ha tomado el encabezado `#` como título de tu base de datos. El encabezado sigue estando al principio de la página de cada entrada y puedes encontrar las entradas por su teléfono o estado. Para obtener un título, usa la opción de Zapier. | | La búsqueda no encuentra nada | La búsqueda solo coincide con títulos y solo de páginas compartidas con la conexión. | | El recepcionista va lento con una tabla grande | Las tablas grandes devuelven muchos datos. Divide la tabla o mueve el contenido a la base de conocimientos. |