Conectar Webflow
Asigna una colección del CMS a una base de conocimiento y mantenla al día según cambian los elementos.
Qué hace
Asigna una colección del CMS de Webflow a una base de conocimiento. Cada elemento publicado de la colección se convierte en un documento, y Webflow nos avisa cuando uno se publica, cambia o se borra.
A qué puede acceder
A las colecciones del sitio que elijas y a sus elementos publicados. Solo lectura: nunca se escribe nada de vuelta en Webflow, y no se toca ningún otro sitio de tu cuenta.
No lee tu Designer, la estructura de tus páginas, tus recursos, los envíos de formularios, los usuarios del sitio ni los pedidos de Ecommerce.
Qué necesitas antes de empezar
- Una cuenta de Webflow con un sitio con CMS activado y al menos una colección.
- Permiso en ese espacio de Webflow para autorizar una aplicación.
- Un espacio de WelcomeAI en plan Pro o superior.
- Contenido realmente publicado. Los elementos en borrador no son visibles para nosotros.
Autenticación
Un token de API del sitio que creas en Webflow y pegas aquí una vez.
En Webflow: Site settings → Apps & integrations → API access → Generate API token. Webflow lo muestra una sola vez, así que cópialo antes de cerrar el diálogo.
Marca estos permisos al crearlo:
Un token al que le falte uno de estos sigue siendo un token válido, así que Webflow responde 403 y no 401, y nosotros te decimos qué permiso falta por su nombre. Crea uno nuevo con esa casilla marcada y reconecta.
El token se cifra antes de guardarse y nunca vuelve a un navegador. Borrarlo en Webflow nos quita el acceso al instante.
Configurarlo
- Integraciones → Conecta una plataforma → Webflow.
- Pega el token de API del sitio. (El campo App client secret de abajo es opcional: complétalo solo si quieres que verifiquemos la firma que Webflow pone en sus webhooks.)
- Elige el sitio, después la colección y la base de conocimiento que alimenta.
- Asigna los campos: cuál es el título, cuál el cuerpo, cuál la URL. Los valores por defecto suelen ser correctos y se pueden cambiar.
- Guarda. La primera sincronización se ejecuta al momento, y los webhooks se registran a la vez.
Cómo funciona la sincronización
Webhooks, no sondeo. Webflow nos llama cuando un elemento se crea, se modifica, se borra o se despublica, así que un cambio aparece a los segundos de publicarlo en Webflow.
Registramos esos cuatro webhooks por ti al crear la fuente, y los quitamos cuando la borras. No hay nada que pegar. Si tu token no tiene sites:write, la pantalla te lo dice y muestra la URL para agregarlos a mano: Webflow → Site settings → Apps & integrations → Webhooks → Add webhook, uno por evento, con esa URL como destino.
Un webhook que registramos se dispara para todas las colecciones del sitio, porque Webflow no permite filtrar por una. Los elementos de una colección que no asignaste se ignoran al llegar.
También hay un repaso programado diario, para recoger lo que un webhook perdido habría dejado atrás. Es la red de seguridad, no el mecanismo.
Convertir tus formularios de Webflow en leads
Los formularios que ya tienes en tu sitio de Webflow pueden convertirse en leads aquí, junto a los que recoge el widget: la misma lista, las mismas rutas de CRM, los mismos webhooks salientes, la misma exportación.
Integraciones -> la conexión de Webflow -> Capturar envíos de formularios. Registramos un webhook form_submission en todos los sitios que ve tu token, y la URL lleva un secreto propio: nada en ella nombra tu espacio de trabajo, así que nadie que no lo tenga puede publicar en tus leads.
Qué llega:
- El correo, el teléfono y el nombre se sacan de los campos de tu propio formulario, en español o en inglés, por cómo los llamaste:
Correo electrónico,Email,Teléfono,Nombre,First Name. Si ningún nombre de campo parece una dirección, se usa la respuesta que sí lo es. - Todo lo demás se guarda tal cual, con el nombre que le diste al campo, para poder asignarlo después a una propiedad del CRM.
- La misma persona es un solo lead. Alguien que completó tu formulario de Webflow el mes pasado y tu widget de chat hoy es un único registro, marcado como Recurrente.
Dos cosas que a propósito no hace:
- Un envío sin correo y sin teléfono no se convierte en lead. Una casilla de newsletter no es alguien a quien puedas responder, y todos los CRM rechazan un contacto sin forma de contactarlo.
- Sin atribución de campaña. Webflow reporta el envío desde sus propios servidores, así que el navegador que completó el formulario nunca llega hasta nosotros y no hay parámetros UTM que registrar. Un lead del widget los tiene; uno de un formulario de Webflow, no.
Dejar de capturar envíos de formularios quita los webhooks y revoca la URL en el mismo acto.
Qué se importa
De cada elemento publicado: el campo que asignaste como título, el que asignaste como cuerpo (el texto enriquecido se convierte a Markdown conservando encabezados y listas) y la URL en vivo del elemento para las citas. Cualquier otro campo que asignes se guarda como metadato junto al documento.
Los elementos en borrador, y los de una colección que no asignaste, no se importan.
Cómo se gestionan las actualizaciones
Los documentos se identifican por el id del elemento de Webflow. Editar un elemento actualiza el mismo documento. Despublicarlo o borrarlo elimina el documento, sus fragmentos y sus embeddings.
Renombrar una colección o cambiar el nombre de un campo no rompe la asignación, porque se guarda por id. Borrar un campo asignado sí: la fuente avisará de que ya no encuentra el cuerpo y tendrás que volver a asignarlo.
Para qué se usa
Un sitio de marketing cuyo contenido de ayuda vive en una colección. Un catálogo de producto sobre el que los visitantes preguntan. Un changelog o un blog sobre el que los clientes preguntan "cuándo cambiasteis X".
Cómo comprobar que funciona
- Fuentes conectadas muestra la fuente como Conectada con la hora de la última sincronización.
- El Registro de sincronización lista cada ejecución: cuántos elementos encontró, creó, actualizó y saltó.
- Publica una edición pequeña en Webflow y mira cómo cambia la hora del documento.
- Pregúntale al Playground algo que solo responda esa colección.
Errores habituales
"Credencial caducada": se borró el token en Webflow, o el sitio se movió a otro espacio. Crea un token nuevo y reconecta. Reintentar no sirve.
"Webflow aceptó el token pero no tiene el permiso sites:read": el token es válido y de la cuenta correcta; se creó sin esa casilla marcada. Webflow no puede agregarle un permiso a un token existente, así que crea uno nuevo y reconecta.
"Requiere acción: no encontrado": la colección se borró o se renombró a algo que ya no podemos resolver. Vuelve a asignarla.
No se sincroniza nada tras publicar: puede que se haya eliminado el webhook de Webflow. Usa Probar conexión en la fuente: vuelve a comprobar la credencial ahora mismo y te dice si el problema es el token o el webhook.
Los elementos salen vacíos: el campo asignado como cuerpo está vacío en esos elementos, o es un tipo de campo sin texto (una imagen, una referencia). Revisa un elemento en Webflow.
Reconectar
Integraciones → la conexión → Reconectar, y pega un token de API del sitio nuevo. Las fuentes existentes conservan su asignación y no se reimporta nada.
Desconectar
Quitar la conexión detiene la sincronización. Borrar la fuente pregunta si conservar sus documentos: "solo la conexión" los deja en su sitio y respondiendo, que suele ser lo que quieres si el contenido sigue siendo correcto.
Borrar el token dentro de Webflow tiene el mismo efecto desde el otro lado, y la fuente aparecerá como Credencial caducada.
Borrar una fuente también quita los webhooks que registramos para ella, así que Webflow deja de enviar a una dirección que ya no responde.