Saltar al contenido

Sincronización con Notion

Vincula una plantilla a una de tus bases de datos de Notion y cada envío se convierte en una fila allí — creada cuando se envía el formulario, actualizada cuando el documento cambia después.

1 · Conecta tu espacio de trabajo

En Notion, crea una conexión interna (en notion.so/my-integrations; la Configuración de Pocper enlaza allí) y copia su token interno de la API. Pégalo en Configuración → Integraciones → Notion de Pocper. Solo el propietario del equipo puede hacerlo, y el token se guarda cifrado. Para cambiarlo, usa «Reemplazar el token» en esa misma página: el nuevo se verifica antes de reemplazar al anterior.

Después comparte con esa conexión la base de datos en la que quieres escribir, o la página donde está: ábrela en Notion, elige ••• → Conexiones → Agregar conexiones (en algunas versiones, Conexiones está dentro de ••• → Más) y selecciona tu conexión. Sin este paso, la base de datos no aparece en la lista de Pocper y, si pegas su enlace, Pocper informa de que no la encuentra.

2 · Vincula una plantilla a una base de datos

Abre el panel Espacio de trabajo de la plantilla, elige la pestaña Integración y pulsa «Vincular una base de datos de Notion». Elige una de las bases de datos que tu conexión puede ver (escribe para buscar) o pega su enlace. La primera fila, «Nueva base de datos», crea una en la página que elijas, con una columna por campo, ya asignada, y una columna Pocper ID.

Cada campo tiene un selector con las columnas de un tipo que encaja: un campo de fecha a una columna de fecha, una casilla a una casilla, texto a texto o al título. En «Datos del envío» también puedes asignar el cliente, cuándo se envió, su estado y quién lo envió.

Cada documento creado a partir de la plantilla copia estos ajustes al crearse, y su propia pestaña Integración puede cambiarlos solo para él. Un cambio posterior en la plantilla solo llega a los documentos nuevos; para los que aún siguen sus ajustes anteriores, la plantilla ofrece «Aplicarlos también a ellos». Un documento creado antes de vincular la plantilla ofrece «Usar los ajustes de la plantilla».

3 · Qué pasa al enviar

Cuando se envía un formulario — lo envíe quien lo rellena, o lo marques tú como enviado — la fila se crea en cuestión de segundos. En «Sincronización», la pestaña Integración del documento dice entonces cuándo se sincronizó por última vez, con un enlace a la fila, o que un cambio espera o falló; «Sincronizar ahora» solo aparece si el envío falló o el documento nunca se envió. Para crear la fila en cuanto exista el documento, cambia «Cuándo sincronizar» en los ajustes de Integración de la plantilla.

Las ediciones posteriores actualizan la misma fila pocos segundos después del último cambio, y cancelar un documento actualiza su columna de estado.

La página de la fila recibe un marcador que lleva de vuelta al documento y las respuestas en forma de lista (las muy largas se acortan, hasta cien). Los ajustes de Integración de la plantilla permiten desactivar el cuerpo de la página.

4 · Archivos, firmas y duplicados

Los archivos subidos y las firmas pueden ir a una columna Files & media: el archivo se copia en Notion, hasta 20 MB (uno mayor se omite y queda anotado en el registro de sincronización). Enviarlos como enlaces a una columna URL es un interruptor aparte, desactivado por defecto, porque cualquiera que pueda ver la fila podría abrir ese enlace sin iniciar sesión en Pocper.

La protección contra duplicados evita que un envío reintentado aparezca dos veces: Pocper escribe el Pocper ID de cada documento en una columna de texto con ese nombre y encuentra la fila con él. Una base de datos que ya tiene esa columna la usa; si no, el diálogo de vinculación la añade (la casilla viene marcada) o los Ajustes de la pestaña Integración la añaden con un clic.

5 · Cambios hechos en Notion

Activa la sincronización inversa en la pestaña Integración y vuelven dos cosas desde Notion. Cambiar la columna de estado a Submitted, Cancelled o Collected pasa el documento a ese estado; editar una celda asignada a un campo de texto, casilla, fecha u hora escribe el valor en el documento, y su historial muestra el cambio como hecho desde Notion. Si ambos lados cambiaron una celda, gana el valor de Notion — salvo mientras un cliente sigue rellenando el formulario (sin enviar y guardado en los últimos diez minutos): entonces se queda su valor, la celda de Notion se restaura y la pestaña Integración lo anota.

La sincronización inversa requiere un webhook, que el propietario configura una vez por equipo en Configuración → Integraciones → Notion: crea la URL del webhook, añádela como suscripción en la pestaña Webhooks de tu conexión en Notion y pega el token de verificación que Notion envía. Pocper nunca consulta Notion por su cuenta, así que sin webhook las ediciones hechas en Notion se quedan allí. Una columna que no puede devolver un valor — una firma, un archivo, cualquier campo de un documento bloqueado — se restaura en Notion, y la pestaña Integración lo anota.

6 · Cuando algo sale mal

Una fila que no se ha podido enviar se reintenta, con intervalos cada vez mayores, durante un día. Si se agotan los reintentos o Notion la rechaza de plano — se revocó el token o la base de datos ya no está compartida —, la sincronización se detiene y el propietario del equipo y quien vinculó la base de datos reciben una notificación en la aplicación que abre la pestaña Integración del documento. Allí el error dice qué hacer; el mensaje original de Notion está en «Mostrar el mensaje de Notion».

Una sincronización detenida se reanuda sola en cuanto se corrige la causa: al volver a conectar o reemplazar el token en Configuración, cuando Pocper vuelve a leer la base de datos («Recargar las propiedades desde Notion», junto al título «Campos», o cualquier cambio guardado en la pestaña Integración) o cuando se edita el documento. En la plantilla, la fila «Registro de sincronización» cuenta los fallos y puede mostrar solo esos, y una línea como «3 documentos aún no están en Notion» tiene un botón «Enviar» que los envía todos — añadiendo antes la columna Pocper ID si falta —; despliégala para ver cuáles y por qué. «Pausar la sincronización», junto al título «Sincronización», deja de enviar cambios hasta que pulses «Reanudar la sincronización».