MetaMask
Añade la conexión de billetera MetaMask a las páginas de Webflow con código personalizado y, a continuación, verifica las firmas en tu propio servidor antes de restringir el acceso a contenido o escribir en el CMS.

Un sitio de Webflow no tiene una forma integrada de leer la billetera cripto de un visitante. Las secciones de código personalizado solo ejecutan HTML, CSS y JS, por lo que las comprobaciones de firma y la verificación de tokens requieren herramientas adicionales. Las billeteras MetaMask contienen las claves y direcciones que los sitios Web3 necesitan reconocer.
Conectar MetaMask y Webflow te permite sumar un botón para conectar la billetera en cualquier página que diseñes. Quienes te visiten solo aprueban la solicitud en la extensión o la app móvil de MetaMask, ¡y listo!, tu script recibe su dirección y el ID de la cadena. Sumando un pequeño servidor al flujo, puedes usar esa dirección para dar acceso exclusivo a ciertas páginas, registrar minteos o crear elementos en el CMS de Webflow.
Esta integración es ideal para desarrolladores y agencias que crean sitios de NFT, DeFi y juegos Web3. Los equipos de marketing en empresas cripto pueden mantener el diseño de la página en Webflow mientras los ingenieros se encargan del código de la billetera. Los gestores de comunidades que administran membresías con acceso restringido por tokens también se benefician, siempre y cuando alguien aloje la verificación del lado del servidor.
Cómo integrar MetaMask con Webflow
¿Qué es MetaMask? MetaMask es una billetera cripto sin custodia desarrollada por Consensys, disponible como extensión de navegador y como app para iOS y Android. Cada persona mantiene el control total de sus claves y aprueba directamente cada conexión, firma y transacción que un sitio solicite. Entre sus herramientas para desarrolladores destaca MetaMask Connect, que vincula los sitios web tanto con la extensión como con la app móvil.
Los equipos combinan MetaMask con Webflow cuando el sitio de marketing y el producto en cadena (onchain) comparten las mismas páginas. Un equipo de producto puede lanzar una página de acuñación o un área para miembros sin tener que trasladar el sitio a una aplicación React independiente. El código de la billetera se ejecuta en el navegador. Todo lo que requiera confianza, como una comprobación de firma o un token de API, se ejecuta en un servidor que tú controlas.
La integración de MetaMask con Webflow admite 2 enfoques:
- Code Embed y el código personalizado del sitio cargan MetaMask Connect EVM o un widget de billetera directo en el navegador, sin necesidad de configurar ningún servidor.
- Las API de Webflow y MetaMask te dan el control total para validar firmas, restringir accesos mediante tokens y escribir datos en el CMS, aunque requieren desarrollo del lado del servidor.
La mayoría de las implementaciones combinan ambos métodos, dependiendo de la complejidad de la configuración.
Añadir MetaMask con inserción de código y código personalizado
Los scripts del lado del cliente pueden conectar MetaMask, leer la dirección de quien visita tu sitio, pedir firmas y cambiar de red sin despeinarse. Agrégalos a todo el sitio desde la Configuración del sitio o en una sola página con un elemento Code Embed. Cada bloque de código admite hasta 50.000 caracteres de HTML, CSS y JS. Necesitas un espacio de trabajo Core, Growth, Agency o Freelancer, o un plan de sitio activo. Los scripts se muestran en la vista previa, pero solo cobran vida al publicar.
Cargar MetaMask Connect EVM desde el código personalizado del sitio
MetaMask Connect EVM (@metamask/connect-evm) es el paquete de conexión actual y reemplaza al obsoleto @metamask/sdk. Detecta el entorno del visitante y elige la extensión del navegador, un código QR o un enlace profundo (deeplink) móvil. La guía de inicio rápido oficial lo instala con npm y no muestra una etiqueta de script CDN. Lo empaquetas en un proyecto de JavaScript, alojas el archivo y lo referencias desde Webflow.
Para configurarla:
- Ejecuta
npm install @metamask/connect-evmen un proyecto de JavaScript. Las compilaciones de Vite y Webpack funcionan sin necesidad de polyfills. - Crea el cliente y asígnalo a un ID de botón, como en el ejemplo a continuación.
- Compila el paquete y alójalo en tu propio servidor o CDN.
- Ve a Configuración del sitio > Código personalizado y añade
<script src="https://your-host.com/wallet.js" defer></script>a Código del pie de página (Footer code). - Haz clic en Save changes para no perder nada.
- Añade un elemento de botón y establece su ID en
connectBtnen el panel de Configuración. - Publica en el subdominio de pruebas webflow.io y realiza pruebas antes de publicar en tu dominio personalizado.
La configuración del cliente utiliza opciones documentadas createEVMClient y el método connect:
import { createEVMClient } from '@metamask/connect-evm';
const evmClient = await createEVMClient({
dapp: { name: 'Example Webflow site' },
api: { supportedNetworks: { '0x1': 'https://your-rpc-url' } },
});
document.getElementById('connectBtn').addEventListener('click', async () => {
try {
const { accounts, chainId } = await evmClient.connect({ chainIds: ['0x1'] });
console.log(evmClient.getAccount(), chainId);
} catch (err) {
if (err.code === 4001) { /* user rejected: show a retry button */ }
if (err.code === -32002) { /* request pending: ask the user to check MetaMask */ }
}
});
El error 4001 significa que el visitante rechazó la solicitud. MetaMask señala que una cancelación también puede llegar envuelta en un código externo 53 con el código de la billetera en err.rpcCode, así que normaliza los errores antes de tomar decisiones basadas en ellos. El error -32002 significa que ya hay una solicitud pendiente, así que no vuelvas a llamar a connect(). Añade todas las cadenas que utilice tu sitio a supportedNetworks, porque las solicitudes a cadenas no configuradas arrojan errores. MetaMask recomienda una clave API de Infura para producción, y el asistente getInfuraRpcUrls crea el mapa RPC por ti.
Añade un widget de billetera vía CDN
Las bibliotecas de billeteras múltiples de terceros y los widgets de código abierto de GitHub pueden añadir un botón de MetaMask sin necesidad de un proceso de compilación, siempre que publiquen un paquete listo para el navegador que puedas cargar desde una CDN. Estos proyectos son creados por terceros, no por MetaMask.
Para añadir un widget:
- Añade elementos de botón y asígnales a cada uno el ID HTML que espera el widget.
- Abre la Configuración de la página y pega los scripts del widget en la sección Before
</body>tag. - Establece las variables de configuración del widget, como las cadenas compatibles.
- Fija la versión del script en la URL de la CDN y realiza pruebas en el entorno de pruebas.
Muchos proyectos de Web3 en GitHub tienen un mantenimiento inconsistente, así que verifica la actividad del repositorio antes de lanzar tu sitio.
Envía a los visitantes móviles al navegador integrado de MetaMask
Safari y Chrome en dispositivos móviles no pueden usar la extensión de navegador de MetaMask. MetaMask Connect abre la aplicación móvil con un enlace profundo, pero también puedes enlazar directamente al navegador integrado de la aplicación. El formato https://link.metamask.io/dapp/{dappUrl} abre tu página dentro de MetaMask Mobile, donde la conexión de la billetera funciona.
Para añadir el enlace:
- Añade un bloque de enlace o un botón a la página.
- En su configuración, establece la URL en
https://link.metamask.io/dapp/seguida de la URL de tu sitio. - Publica y prueba el enlace en un dispositivo iOS o Android que tenga MetaMask instalado.
Las vistas web (WebViews) dentro de Twitter, Discord o Reddit manejan los enlaces profundos de forma inconsistente, así que prueba cualquier enlace que compartas en plataformas sociales.
Desarrolla con las API de Webflow y MetaMask
Webflow Cloud puede alojar una aplicación de Next.js o Astro con controladores de rutas de servidor junto a tu sitio. Almacena el token de Webflow como una variable de entorno secreta para que nunca llegue al navegador.
Estas API cubren la ruta del lado del servidor:
- MetaMask Connect EVM: La referencia de métodos EVM abarca
connect,connectAndSign,switchChainy el acceso del proveedor en el navegador. - API de datos de Webflow: la API de datos de Webflow crea y publica elementos en tus colecciones del CMS y recopila los envíos de formularios.
- Webhooks de Webflow: los webhooks de Webflow envían una notificación directa a tu servidor cada vez que alguien envía un formulario o se modifica un elemento de una colección.
- Webflow Cloud: las rutas de tu servidor se ejecutan a la par de tu sitio, verifican firmas al vuelo y resguardan el token de Webflow en una variable de entorno secreta.
En una compilación de Webflow, MetaMask Connect se ejecuta en el navegador del visitante, por lo que tu servidor recibe los datos de la billetera desde tu propio código de navegador.
Guarda las direcciones de billetera en el CMS de Webflow
Una vez que una persona se conecta, el script del navegador envía la dirección seleccionada a una ruta de tu servidor, la cual genera un elemento en el CMS mediante la API de datos. Luego, una Collection List puede lucir esos elementos en tu sitio web. Usa un token de sitio para proyectos internos y OAuth para integraciones que otros vayan a instalar.
Para implementarlo:
- Lee la dirección con
evmClient.getAccount(). No asumas queaccounts[0]es la cuenta activa. - Envía la dirección desde el navegador a la ruta de tu servidor con
fetch. - En el servidor, llama a
POST https://api.webflow.com/v2/collections/{collection_id}/items/livecon un encabezadoAuthorization: Bearery un objetofieldDatade nivel superior. El endpoint necesita el ámbitoCMS:write. - Para organizar borradores en su lugar, crea elementos con
POST /collections/{collection_id}/items. - Publica los elementos organizados más tarde con
POST https://api.webflow.com/v2/collections/{collection_id}/items/publish.
Las creaciones en vivo devuelven un HTTP 202. Una solicitud que envía tanto fieldData como una matriz items devuelve un 400.
Protege el contenido con comprobaciones de firma y token
El inicio de sesión con billetera y la protección por token comienzan con un mensaje firmado. Las cuentas de usuario se retiraron el 29 de enero de 2026 y sus protecciones de contenido se eliminaron, por lo que la protección ahora se ejecuta en tu propio servidor. Mantén la verificación de propiedad en tu servidor, donde los visitantes no pueden editarla.
Para implementarlo:
- Crea un mensaje de inicio de sesión con Ethereum con tu dominio desde
window.location.host, un nonce y un tiempo deIssued At. - Llama a
evmClient.connectAndSign({ message }). Se conecta e inicia sesión en una sola aprobación y devuelveaccounts,chainId, ysignature. - Envía la dirección, el mensaje y la firma a tu servidor y verifica la firma allí.
- Verifica la propiedad del token con una lectura
balanceOfa través deeth_calloreadContractde viem. - Devuelve contenido protegido o una sesión solo a los titulares verificados.
Tu servidor se encarga de las comprobaciones de nonce, dominio y caducidad. MetaMask advierte a los usuarios cuando un dominio SIWE no coincide con el sitio, pero no les impide firmar, por lo que la comprobación del dominio en el lado del servidor sigue siendo importante.
Reacciona a los eventos de Webflow con webhooks
Los webhooks envían una POST solicitud a tu servidor cuando ocurren eventos en el sitio. Los disparadores relevantes incluyen form_submission, collection_item_created y collection_item_published. Tu servidor puede utilizarlos para realizar tareas de seguimiento, como actualizar sus propios registros de billetera cuando se publica un elemento de la Colección.
Para configurar un webhook:
- Obtén un token de sitio o un token de Data Client App con el ámbito
sites:writeque requiere el endpoint Create Webhook. La guía de webhooks también enumeraforms:readpara eventos de formulario. - Encuentra el ID de tu sitio con
GET https://api.webflow.com/v2/sites. - Envía una
POSTahttps://api.webflow.com/v2/sites/YOUR_SITE_ID/webhookscontriggerTypeyurlen el cuerpo. - Añade un
filtercon un nombre de formulario para limitar los eventosform_submissiona un solo formulario. - Valida
x-webflow-signaturecomo un HMAC SHA-256 de la marca de tiempo, dos puntos y el cuerpo de la solicitud. - Rechaza las solicitudes cuya
x-webflow-timestamptenga más de 5 minutos de antigüedad y devuelve un200.
Los webhooks añadidos en la configuración del sitio no llevan cabeceras de firma, así que regístralos a través de la API cuando necesites validar solicitudes. Un registro realizado con un token de sitio devuelve una secretKey para usar como clave de firma, y los webhooks de aplicaciones OAuth firman con el secreto de cliente de la aplicación. Las entregas fallidas se reintentan hasta tres veces más en intervalos de 10 minutos.
Qué puedes construir con la integración de MetaMask en Webflow
Integrar MetaMask con Webflow te permite añadir conexión de billetera, firma y lecturas onchain a tus páginas diseñadas sin tener que crear un frontend de dApp por separado.
- Páginas de minteo de NFT: diseña la página de minteo en Webflow e integra MetaMask Connect desde el código personalizado del sitio para que tu comunidad apruebe cada transacción directamente desde su billetera.
- Áreas exclusivas con acceso por tokens: crea una sección para miembros de una comunidad NFT que revele recursos exclusivos solo cuando tu servidor confirme que poseen el token.
- Inicio de sesión con billetera para productos web3: cambia el clásico inicio de sesión por correo por un botón para entrar con Ethereum, llevando a tus visitas verificadas directo a un panel alojado en Webflow Cloud.
- Directorios de holders: guarda cada dirección de billetera verificada como un elemento del CMS mediante tu servidor y muéstralas todas con estilo en tu sitio con una Collection List.
La restricción de acceso en el servidor sigue el mismo esquema que usa Webflow con cualquier proveedor de inicio de sesión. Consulta nuestra guía de portales con acceso por roles para ponerlo en marcha en Webflow Cloud.
Preguntas frecuentes
No. El Marketplace de Webflow no incluye una aplicación de MetaMask, por lo que debes añadir la conexión de billetera mediante código personalizado. Carga MetaMask Connect EVM desde el código personalizado del sitio o un elemento Code Embed, o añade un widget de terceros para múltiples billeteras que sea compatible con MetaMask.
No para la conexión de la billetera en sí. MetaMask Connect se ejecuta en el navegador del visitante, por lo que la conexión ocurre en tu página. Envía los datos de la billetera desde el código de tu navegador a tu propio servidor y, desde allí, llama a la API de datos de Webflow o reacciona a los webhooks de Webflow.
Sí, a través de enlaces directos (deeplinks) o con el navegador integrado de MetaMask. En computadoras de escritorio sin la extensión instalada, aparece un código QR listo para escanear con la app. Consulta la página de plataformas compatibles para ver cada entorno en detalle. El Centro de ayuda de MetaMask recomienda usar su navegador móvil integrado, ya que los navegadores móviles estándar suelen bloquear las conexiones con dapps.
Para agregar código personalizado necesitas un espacio de trabajo Core, Growth, Agency o Freelancer, o un sitio con un plan de sitio activo. Esto incluye tanto el código del pie de página para todo el sitio como los elementos Code Embed; échale un ojo a la guía de código personalizado para conocer su ubicación y el tope de 50.000 caracteres. Nuestro equipo de soporte no puede resolver problemas con código personalizado, ¡pero en la comunidad de Webflow te esperan con los brazos abiertos para resolver cualquier duda!
Usa MetaMask Connect EVM para nuevos proyectos. MetaMask marcó el SDK heredado como obsoleto en su lanzamiento del 25 de marzo de 2026, y la guía de migración mapea
new MetaMaskSDK(opts)aawait createEVMClient(opts). Los nuevos proyectos comienzan con el inicio rápido de JavaScript, que requiere Node.js 19 o posterior y una clave de API de Infura.

Descripción
Añade la conexión de billetera MetaMask a las páginas de Webflow con elementos de inserción de código (Code Embed) y código personalizado del sitio, y luego utiliza la API de datos de Webflow para guardar los datos verificados de la billetera.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.
Salesforce Authenticator
Utiliza Salesforce Authenticator como la aplicación de doble factor en tu cuenta de Webflow y como el aviso de MFA en los inicios de sesión de Salesforce que operan detrás de tus formularios de Webflow.
Microsoft Authenticator
Utiliza Microsoft Authenticator como segundo factor en tu cuenta de Webflow y añade MFA de Authenticator a los inicios de sesión de los visitantes del sitio a través de un proveedor de identidad.
Magic
Conecta Magic (magic.link), un SDK de autenticación sin contraseñas, con Webflow para añadir a tu sitio funciones de OTP por correo electrónico, inicio de sesión social y monedero Web3.

LastPass Authenticator
LastPass Authenticator te ofrece una experiencia única de verificación de contraseñas con un solo toque.

Google Authenticator
Google Authenticator genera códigos de verificación en dos pasos de un solo uso en dispositivos móviles Android o Apple

Firebase Authentication
Conecta Firebase Authentication, un servicio de identidad respaldado por Google, con Webflow para añadir funciones de registro, inicio de sesión y gestión de sesiones de usuario mediante correo electrónico, teléfono o proveedores de inicio de sesión social.
Authy
Utiliza la aplicación Authy para la autenticación en dos pasos (2FA) de tu cuenta de Webflow y añade códigos de Twilio Verify a tus formularios e inicios de sesión, ya que la API de Authy ya no acepta nuevos clientes.


