Saltar a la navegación

Notion

Responde a quienes llaman usando tus páginas y bases de datos de Notion, y añade nuevas entradas a una base de datos.

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

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.

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 para que tu recepcionista nunca lea registros privados, como datos de clientes, a quienes llaman.

Configuración

1

Crea una conexión interna

Debes ser propietario del espacio de trabajo. Ve a 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.

2

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.

3

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.

4

Crea las herramientas de webhook

Crea las herramientas de abajo. Para cada una, ve a Integrations, selecciona Add integration y elige Webhook Tool.

5

Pruébalo

Prueba tu recepcionista haciendo una pregunta que responda una de tus páginas compartidas.

Herramientas

Cada herramienta envía estas cabeceras de solicitud:

CabeceraTipoValor
AuthorizationSecretoBearer seguido del token de tu conexión
Notion-VersionValor2026-03-11

Configura Assign to agents como Receptionist en cada herramienta y selecciona Enable.

Buscar páginas

CampoValor
Nombresearch_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étodoPOST
URLhttps://api.notion.com/v1/search
Parámetros del cuerpoquery (cadena, obligatorio): “Un título breve que buscar, como pricing u opening hours.”
page_size (número, valor fijo): 10

Leer una página

CampoValor
Nombreread_notion_page
Descripción”Lee el texto completo de una página de Notion encontrada con search_notion.”
MétodoGET
URLhttps://api.notion.com/v1/pages/{page_id}/markdown
Parámetros de rutapage_id (cadena, obligatorio): “El id de una página devuelta por search_notion.”
Parámetros de consultamarkdown_version (cadena, valor fijo): v2

Leer una base de datos

CampoValor
Nombreread_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étodoPOST
URLhttps://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query
Parámetros del cuerpopage_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.

1

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.

2

Prepara la base de datos

Copia el ID de la fuente de datos de la base de datos, como en Configuración. 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.

3

Crea la herramienta de webhook

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

CampoValor
Nombreadd_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étodoPOST
URLhttps://api.notion.com/v1/pages
Cabeceras de solicitudAuthorization (Secreto): Bearer seguido del token de la nueva conexión
Notion-Version (Valor): 2026-03-11
Parámetros del cuerpoparent (objeto, obligatorio)
markdown (cadena, obligatorio)
markdown_version (cadena)
properties (objeto, obligatorio)
Asignar a agentesReceptionist

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 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. En tu servidor MCP de Zapier en 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 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. 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

ProblemaQué comprobar
401 de NotionLa cabecera Authorization debe ser Bearer seguida del token de la conexión.
400 sobre la versiónConfigura Notion-Version como 2026-03-11.
404 u object_not_foundComparte 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_pageLa conexión necesita permiso para leer contenido.
403 en add_notion_entryLa conexión de entradas necesita permiso para insertar contenido y acceso a la base de datos.
400 validation_error en add_notion_entryCada 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 UntitledNotion 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 nadaLa búsqueda solo coincide con títulos y solo de páginas compartidas con la conexión.
El recepcionista va lento con una tabla grandeLas tablas grandes devuelven muchos datos. Divide la tabla o mueve el contenido a la base de conocimientos.