# Notion

Envía respuestas a una base de datos de Notion con mapeo de campos.

## Notion

Envía cada respuesta a una base de datos de Notion como una nueva página. Mapea campos a propiedades, crea cuerpos de página enriquecidos y rellena respuestas anteriores.

<h2 id="what-you-get">Qué obtienes</h2>

<ul>
  <li>Una página de Notion por cada respuesta</li>
  <li>Mapeo de campos: campo del formulario → propiedad de la base de datos</li>
  <li>Cuerpo de página enriquecido opcional compuesto desde las respuestas</li>
  <li>Relleno de respuestas anteriores a petición</li>
  <li>Recuperación automática cuando se renombran propiedades de la base de datos</li>
</ul>

<h2 id="connect">Conectar Notion</h2>

<h2 id="test-event">Evento de prueba</h2>

<p>
  El paso de finalización y el panel de detalles de la integración tienen un botón <strong>Enviar prueba</strong> que crea una página real
  en tu base de datos. Las propiedades de texto y título reciben marcadores <code>[Question Title]</code>, los números reciben
  <code>0</code>, los emails reciben <code>test@example.com</code>, las fechas reciben la marca de tiempo actual, los selects usan la
  primera opción disponible y los archivos reciben una imagen de marcador pequeña. Elimina la página de prueba después de verificar.
</p>

<h2 id="backfill">Rellenar respuestas anteriores</h2>

<p>
  Tras conectar, puedes rellenar respuestas pasadas en la base de datos. Las páginas se crean de una en una (~3 por segundo para mantenerse
  dentro de los límites de velocidad de Notion), con progreso registrado cada 10 páginas.
</p>

<h2 id="property-types">Tipos de propiedades</h2>

<h3 id="metadata-properties">Propiedades de metadatos</h3>

<p>
  Channel muestra "Public link" o "Request", y Request ID contiene el id de la solicitud que respondió esa respuesta, así una base de datos
  que recoge tanto respuestas por enlace de compartición como por solicitud puede distinguirlas y enlazarlas de nuevo con la solicitud.
</p>

<h2 id="repeating-groups">Grupos repetibles</h2>

<p>
  Si tu formulario tiene un <a href="/es/building-forms/repeating-groups">grupo repetible</a>, el selector de campos te da dos formas de
  mapearlo, según si quieres todo el grupo en una propiedad o cada campo miembro por separado.
</p>

<ul>
  <li>
    <strong>Todo el grupo → una propiedad</strong> — elige el grupo en sí para mapear cada entrada en una única propiedad de Rich text (o
    Title). Cada entrada aparece como una fila numerada y etiquetada, como "1. Nombre completo: Jane Appleseed, Edad: 34, 2. Nombre
    completo: Marcus Lee, Edad: 29".
  </li>
  <li>
    <strong>Cada campo miembro → su propia propiedad</strong> — elige un campo miembro para darle una propiedad dedicada. Los valores de
    cada entrada se unen con " · " (por ejemplo "Jane Appleseed · Marcus Lee").
  </li>
</ul>

<p>
  Los campos miembro que ya no existen en el formulario pero aparecen en respuestas anteriores siguen siendo mapeables, así que la
  sincronización nunca se rompe para respuestas antiguas.
</p>

<h2 id="rich-page-body">Cuerpo de página enriquecido</h2>

<p>
  Además del mapeo de propiedades, puedes crear un cuerpo de página enriquecido con el editor de plantillas. Escribe <strong>@</strong> para
  insertar el valor de cualquier campo del formulario — el editor los muestra como chips de mención que se resuelven en las respuestas
  enviadas al sincronizar.
</p>

<p>
  Los cuerpos de página admiten párrafos, <strong>negrita</strong>, <em>cursiva</em>, <u>subrayado</u> y enlaces. Los encabezados, listas e
  imágenes no están soportados — se representan como párrafos simples. El texto se divide automáticamente en bloques de 2.000 caracteres por
  bloque de texto enriquecido (límite de Notion).
</p>

<h2 id="abandoned-responses">Eventos de respuestas abandonadas</h2>

<p>
  Si un encuestado empieza tu formulario pero no lo termina, Formstep puede sincronizar igualmente los datos parciales. En el paso{' '}
  <strong>Envíos abandonados</strong>, ajusta <strong>Enviar evento abandonado después de</strong> a 12 horas, 1 día, 3 días o 1 semana. Una
  revisión cada hora crea entonces una página con lo que el encuestado haya completado, usando el mismo mapeo de propiedades que una
  respuesta completada. Mapea el campo de metadatos "Estado de la respuesta" a una propiedad Status o Select para distinguirlas en Notion.
</p>

<p>
  Solo se revisan los borradores creados desde un enlace de compartir, y puedes acotarlo más con <strong>Campos requeridos</strong> — la
  página solo se crea cuando se ha rellenado al menos uno de los campos que elijas.
</p>

> ℹ️ **Función Pro**
> <p>
>     La entrega de respuestas abandonadas requiere un plan Pro o Business. La integración principal con Notion está disponible en todos los
>     planes. Consulta <a href="/es/subscription-billing/plans-pricing">planes y precios</a>.
>   </p>

<h2 id="schema-drift">Cambios de esquema y recuperación automática</h2>

<p>
  Si renombras una propiedad en Notion, Formstep detecta el cambio en la siguiente respuesta y actualiza su mapeo automáticamente. Las
  propiedades se identifican por su ID interno estable, por lo que los cambios de nombre son transparentes.
</p>

<p>
  Si eliminas una propiedad, Formstep la elimina del mapeo y sigue sincronizando los campos restantes. Si el tipo de una propiedad cambia a
  algo incompatible (por ejemplo, número se convierte en select), el valor puede fallar al sincronizar — vuelve a abrir la integración y
  reasigna ese campo.
</p>

<h2 id="troubleshooting">Solución de problemas</h2>

<ul>
  <li>
    <strong>Base de datos no visible</strong> — Vuelve a autorizar y comparte la base de datos con Formstep durante la pantalla de
    consentimiento de Notion.
  </li>
  <li>
    <strong>Incompatibilidad de propiedades</strong> — Los tipos incompatibles impiden la sincronización. Vuelve a abrir la integración para
    ver qué campos necesitan atención.
  </li>
  <li>
    <strong>Límites de velocidad</strong> — La API de Notion tiene límites por espacio de trabajo. Formstep reintenta automáticamente; los
    rellenos se limitan a ~3 páginas por segundo.
  </li>
  <li>
    <strong>Acceso revocado</strong> — Si eliminas Formstep de Configuración de Notion → Conexiones, la integración se detiene con un error
    y la persona que la configuró recibe un email. Vuelve a conectar para restablecer.
  </li>
</ul>

<h2 id="faq">Preguntas frecuentes</h2>

  <p>No. Crea la base de datos en Notion primero y luego compártela con Formstep durante la autorización.</p>

  <p>
    La siguiente respuesta falla con un error de "no encontrado" y la integración se detiene. La base de datos queda fijada al crear la
    integración, así que elimina esta integración y crea una nueva apuntando a la nueva base de datos.
  </p>

  <p>
    Sí. Las cuentas de Notion se conectan a nivel de espacio de trabajo. Cualquier miembro puede usar cualquier cuenta conectada al
    configurar una integración.
  </p>

  <p>
    Sí. Autoriza espacios de trabajo de Notion adicionales durante nuevas configuraciones de integración. Cada formulario elige qué cuenta
    usar.
  </p>

  <p>No. Pero si eliminas Formstep de Configuración de Notion → Conexiones, el token se revoca y tendrás que volver a conectar.</p>

  <p>
    Ambas aparecen como páginas en la misma base de datos. La propiedad "Estado de la respuesta" muestra "Completed", "Partial", o "Updated"
    cuando un encuestado editó una respuesta anterior — usa las vistas filtradas de Notion para separarlas.
  </p>

  <p>
    Ve a Configuración del formulario → Integraciones → Notion y elimina la integración. Para también revocar el acceso de Formstep a tu
    espacio de trabajo de Notion, ve a Configuración de Notion → Conexiones y elimina Formstep.
  </p>

<h2 id="next-steps">Siguientes pasos</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Slack](/es/integrations/slack) — Publica respuestas en un canal de Slack
  - [Airtable](/es/integrations/airtable) — Envía respuestas a una base de Airtable
  - [Grupos repetibles](/es/building-forms/repeating-groups) — Permite que los encuestados añadan tantas entradas como necesiten
</div>
