Integración de Duda en una plataforma SaaS (2 de 3)

March 26, 2021
0 minute read

En nuestro último blog post, discutimos cómo generar sitios web ricos en contenido que están completamente personalizados con datos producidos por el uso diario de tu plataforma SaaS.

Ahora que hemos cubierto la creación inicial de sitios web, vamos a centrar nuestra atención en la experiencia de tus usuarios, ya que ellos navegan entre el constructor de sitios web de Duda y tu propia interfaz de usuario.

CREACIÓN DE LA MARCA EN EL EDITOR Y LOS SITIOS



El primer paso para la creación de una experiencia perfecta para tus clientes, es etiquetar con tu marca la interfaz de usuario y la URL del constructor de sitios de Duda, junto con las URLs de los sitios que construyes.

Etiquetar con tu Marca la Interfaz de Usuario del Editor

Antes de discutir el proceso real de autenticación de tus usuarios en el constructor de sitios web Duda, vamos a echar un vistazo a cómo podemos presentar una interfaz de usuario de marca (UI), mientras ellos editan sus sitios.

Duda es el constructor de sitios web que realmente puedes llamar de propio, y una de las grandes razones para ello es nuestra amplia capacidad de etiquetar con tu marca.

Con las opciones de personalización disponibles, tienes la posibilidad de renombrar el editor como una extensión de tu propio producto. Para comenzar, ingresa a tu cuenta y selecciona "White Label" en el menú superior y haz clic en "Custom Branding" en el menú desplegable.

Al emprender una integración entre Duda y una plataforma SaaS, las características white label más importantes a configurar son las que controlan el aspecto del editor del sitio.

Mientras que otras opciones están disponibles para reasignar la marca de otros componentes de Duda como la pantalla de inicio de sesión y el dashboard, es más probable que estos aspectos sean totalmente controlados por la aplicación de origen, en lugar de Duda.

Cubriremos cómo podemos omitir la pantalla de inicio de sesión y, en su lugar, pre-autenticar al usuario un poco más adelante. 

Para personalizar la marca del editor del sitio web, cambia a la pestaña "Editor" dentro de la página de white label. Desde aquí, podrás subir tu propio logotipo y personalizar los colores del texto y los botones.

Para un trabajo de branding avanzado, también puedes incluir tu propio CSS y HTML personalizado. Al guardar tu trabajo, podrás realizar una vista previa generada con los cambios.

plataforma SaaS

Una vez que tengas la marca de la interfaz en su lugar, hay un paso adicional importante; el nombre del dominio que tus usuarios verán en el navegador. Por defecto, la URL del editor del sitio de Duda va a ser algún derivado de un dominio genérico de Duda, como "x.responsivewebsite.com".

Es posible actualizar esto a algo más de marca como "editor.midominio.com" o "midominioeditor.com" navegando en “White Label” → “Custom Domain” y seleccionando la pestaña “Dashboard Domain”.

Ten en cuenta que tendrás que añadir una entrada CNAME a las DNS de cualquier dominio que elijas. El valor de esta entrada se proporciona en la página del dominio personalizado.



Etiquetar con tu marca la URL de los sitios



Después de que la experiencia de edición del sitio web esté con tu marca, tenemos que pensar en la experiencia de publicación. Llevar un sitio al aire es donde todo el proceso se detiene para muchas agencias y empresas de SaaS.

Los nombres de dominio y los DNS pueden ser un tema complejo para personas con poco conocimiento técnico. Muchos usuarios pueden no tener un dominio, o pueden tener un sitio existente que ya están utilizando su dominio.

Incluso puede que hayan registrado un dominio, o que alguien lo haya registrado por ellos, y que nunca hayan creado un sitio web para este.

Independientemente de su situación, puede convertirse en un largo proceso conseguir que estos usuarios actualicen sus DNS para que gane puntos en su sitio recién creado.

Para que el proceso de publicación sea lo más sencillo posible, Duda permite que cualquier sitio de su cuenta sea publicado instantáneamente bajo un subdominio de un dominio de tu elección.

Por ejemplo, el cliente "1" podría terminar con una URL como "cliente1.sitios.midominio.com" o "cliente1.midominios.com". Configurar el dominio del sitio proporciona una forma de poner en marcha un sitio sin tener que atar al usuario con las complejidades del DNS y la gestión del dominio.

Una vez que el sitio está en funcionamiento, es el momento perfecto para proporcionar un soporte ligero para ayudar al usuario en la transferencia o el registro de un dominio.

Duda proporciona artículos de soporte sin marca para ayudar a tus usuarios a través del proceso. Además, los puntos finales de la API de creación de sitios y de actualización de sitios te permiten actualizar el dominio o subdominio de un sitio directamente desde tu propia aplicación, para que puedas guiar a tus usuarios a través del proceso desde tu propia interfaz de usuario.

Con todas las opciones disponibles, podrás garantizar que tus usuarios pasen de la creación a un sitio publicado en un tiempo récord.



AUTENTICACIÓN DE USUARIOS EN DUDA



Con nuestra marca configurada, estamos listos para transferir a los usuarios de tu aplicación SaaS al editor de sitios de Duda. Para que este proceso sea completamente fluido, tenemos que añadir un par más de llamadas a la API al proceso que iniciamos en la primera parte de esta serie.

En ese post, hablamos de hacer una llamada para crear el sitio web, y otra para enviar los datos de la plataforma SaaS a la biblioteca de contenidos del nuevo sitio.

Una vez que esas llamadas se hayan completado con éxito, vamos a hacer llamadas adicionales para crear una cuenta de usuario Duda, y luego permitir que el usuario acceda al sitio.


Llamada a la API "Crear usuario"

La llamada a la API "Crear usuario" te permite pasar el identificador real del usuario a Duda, y esto significa que puedes utilizar el mismo identificador de usuario que utilizas en tu propia aplicación.

Al coincidir los identificadores, se simplifican las futuras llamadas a la API que requieran la identificación del usuario, tales como nuestro punto final de SSO o la concesión de acceso de un usuario a un sitio.

Además, debes especificar un "account_type" de "CUSTOMER" en el cuerpo de la solicitud, para distinguir este usuario de las cuentas de tu personal. El cuerpo también puede contener metadatos del usuario, como el nombre y el email.



 

curl --request POST \ 

--url https://api.duda.co/api/accounts/create \ 

--header 'authorization: Basic123abc=' \ 

--header 'content-type: application/json' \ 

--data '{"account_type":"CUSTOMER","account_name":"<unique_user_id>","first_name":"John","last_name":"Doe","email":"john@example.org","lang":"en"}'


Nota: Las llamadas a la API requieren un nombre de usuario y una contraseña para autenticarse.

Debido a que estás eligiendo el identificador de usuario en la llamada, no lo devolveremos después de tener éxito.

En su lugar, recibirás un código de estatus 204 sin datos en el cuerpo de la respuesta.  También es importante señalar que no se especifica ni se recibe ningún tipo de contraseña para estos usuarios.

Como veremos más adelante en este post, esperamos que cualquier usuario creado a través de la API se autentique directamente desde tu aplicación a través de nuestro punto final SSO en lugar de navegar a una página de inicio de sesión.







Llamada a la API "Conceder acceso al sitio"

En este punto del proceso, hemos creado con éxito un usuario en Duda, pero este todavía tiene que recibir permiso para editar un sitio. La llamada "Conceder acceso al sitio" rectificará esto.

Con esta llamada, podemos especificar no solo un sitio al que este usuario debe tener acceso, sino también una lista de permisos para ese sitio. Usando estos permisos, podemos proporcionar una experiencia de edición extremadamente simple, o una más complicada pero inmensamente flexible para el usuario.

 

curl --request POST \ 

--url https://api.duda.co/api/accounts/<unique_user_id>/sites/<site_name>/permissions \

--header 'authorization: Basic123abc=' \ 

--header 'content-type: application/json' \ 

--data '{"permissions":["LIMITED_EDITING","PUBLISH","REPUBLISH"]}'


En este ejemplo, le estamos dando al usuario acceso a un sitio web específico utilizando tanto el ID de usuario que elegimos en el paso anterior, como el "site_name" que recibimos de nuestra llamada a la API para crear un sitio web.

Al pasar los permisos para LIMITED_EDITING, PUBLISH y REPUBLISH, al usuario se le presentará un editor muy simple que solo le permite cambiar el contenido existente. No podrán añadir o eliminar widgets y contenido, ni añadir o eliminar páginas adicionales.

Se puede obtener una lista completa de permisos desde el punto final de la API de todos los permisos. Utilizando los permisos, es posible dar a diferentes usuarios diferentes grados de acceso al mismo sitio.

Envío de usuarios al editor



Con estas llamadas adicionales a la API, tenemos todas las piezas que necesitamos para permitirle a un usuario editar su sitio. El último paso es utilizar el punto final de la API SSO para trasladar al usuario desde su aplicación SaaS al editor de marca blanca. 

Dentro de la interfaz de usuario de tu aplicación, necesitaremos algún tipo de botón como "Editar sitio web" que aparezca después de que se haya creado un sitio para el usuario o la organización que ha iniciado la sesión.

Cuando se haga clic en este botón, se emitirá la llamada al punto final de SSO, utilizando el mismo identificador de usuario que has elegido en el paso de creación de usuario. La respuesta de la API incluirá una URL del editor a la que se podrá redirigir inmediatamente el navegador. 

Es importante que esta llamada se haga en el momento de la intención (no se recomienda hacer la llamada al punto final SSO en la carga de la aplicación y almacenar en caché la URL de retorno durante un largo período).

Las URLs solo son válidas durante un máximo de dos minutos por razones de seguridad. Es mejor hacer la llamada cuando el usuario ha interactuado realmente con el botón.

Además del nombre del sitio y el ID de usuario. Tendrás que proporcionar un parámetro de consulta de destino. Esto te permitirá hacer un enlace profundo en la aplicación de Duda a áreas como el selector de plantillas, la página de estadísticas o el panel de control.

En el caso de las integraciones de SaaS, casi siempre querrás enviar al usuario directamente al editor del sitio, por lo que proporcionamos un valor de "EDITOR".



 

curl --request POST \ 

--url --url 'https://api.duda.co/api/accounts/sso/<unique_user_id>/link?site_name=<site_name>&target=EDITOR'

 \

--header 'authorization: Basic123abc='

A continuación se muestra una respuesta de ejemplo:

 

{  

  "url": "http://example.mobilewebsiteserver.com/home/site/<site_name>?dm_sso=abcde12345"

}


RESUMEN



Hasta ahora en esta serie, hemos visto cómo crear sitios web programadamente y llenándolos de contenido desde una plataforma SaaS. También hemos aprendido a crear usuarios con acceso a estos sitios recién creados.

Con las capacidades de Duda de etiquetar con tu marca, estos usuarios verán una experiencia totalmente de marca propia, sin saber que han salido de la aplicación de origen.

En el último post de esta serie, hablaremos de la integración de estructuras de datos más complejos, y de la generación o eliminación automática de páginas enteras de contenido de un sitio cuando un usuario cambia los datos en tu plataforma.

Hasta entonces, intenta crear algunos usuarios clientes, ya sea por la API o dentro de la aplicación Duda. Cambia la configuración de sus permisos para marcar el tipo de experiencia que mejor funciona para tus usuarios.




Did you find this article interesting?


Thanks for the feedback!
By Shawn Davis April 1, 2026
Core Web Vitals aren't new, Google introduced them in 2020 and made them a ranking factor in 2021. But the questions keep coming, because the metrics keep changing and the stakes keep rising. Reddit's SEO communities were still debating their impact as recently as January 2026, and for good reason: most agencies still don't have a clear, repeatable way to measure, diagnose, and fix them for clients. This guide cuts through the noise. Here's what Core Web Vitals actually measure, what good scores look like today, and how to improve them—without needing a dedicated performance engineer on every project. What Core Web Vitals measure Google evaluates three user experience signals to determine whether a page feels fast, stable, and responsive: Largest Contentful Paint (LCP) measures how long it takes for the biggest visible element on a page — usually a hero image or headline — to load. Google considers anything under 2.5 seconds good. Above 4 seconds is poor. Interaction to Next Paint (INP) replaced First Input Delay (FID) in March 2024. Where FID measures the delay before a user's first click is registered, INP tracks the full responsiveness of every interaction across the page session. A good INP score is under 200 milliseconds. Cumulative Layout Shift (CLS) measures visual stability — how much page elements unexpectedly move while content loads. A score below 0.1 is good. Higher scores signal that images, ads, or embeds are pushing content around after load, which frustrates users and tanks conversions. These three metrics are a subset of Google's broader Page Experience signals, which also include HTTPS, safe browsing, and mobile usability. Core Web Vitals are the ones you can most directly control and improve. Why your clients' scores may still be poor Core Web Vitals scores vary dramatically by platform, hosting, and how a site was built. Some of the most common culprits agencies encounter: Heavy above-the-fold content . A homepage with an autoplay video, a full-width image slider, and a chat widget loading simultaneously will fail LCP every time. The browser has to resolve all of those resources before it can paint the largest element. Unstable image dimensions . When an image loads without defined width and height attributes, the browser doesn't reserve space for it. It renders the surrounding text, then jumps it down when the image appears. That jump is CLS. Third-party scripts blocking the main thread . Analytics pixels, ad tags, and live chat tools run on the browser's main thread. When they stack up, every click and tap has to wait in line — driving INP scores up. A single slow third-party script can push an otherwise clean site into "needs improvement" territory. Too many web fonts . Each font family and weight is a separate network request. A page loading four font files before rendering any text will fail LCP, especially on mobile connections. Unoptimized images . JPEGs and PNGs served at full resolution, without compression or modern formats like WebP or AVIF, add unnecessary weight to every page load. How to measure them accurately There are two types of Core Web Vitals data you should be looking at for every client: Lab data comes from tools like Google PageSpeed Insights, Lighthouse, and WebPageTest. It simulates page loads in controlled conditions. Lab data is useful for diagnosing specific issues and testing fixes before you deploy them. Field data (also called Real User Monitoring, or RUM) comes from actual users visiting the site. Google collects this through the Chrome User Experience Report (CrUX) and surfaces it in Search Console and PageSpeed Insights. Field data is what Google actually uses as a ranking signal — and it often looks worse than lab data because it reflects real-world device and connection variability. If your client's site has enough traffic, you'll see field data in Search Console under Core Web Vitals. This is your baseline. Lab data helps you understand why the scores are what they are. For clients with low traffic who don't have enough field data to appear in CrUX, you'll be working primarily with lab scores. Set that expectation early so clients understand that improvements may not immediately show up in Search Console. Practical fixes that move the needle Fix LCP: get the hero image loading first The single most effective LCP improvement is adding fetchpriority="high" to the hero image tag. This tells the browser to prioritize that resource over everything else. If you're using a background CSS image for the hero, switch it to anelement — background images aren't discoverable by the browser's preload scanner. Also check whether your hosting serves images through a CDN with caching. Edge delivery dramatically reduces the time-to-first-byte, which feeds directly into LCP. Fix CLS: define dimensions for every media element Every image, video, and ad slot on the page needs explicit width and height attributes in the HTML. If you're using responsive CSS, you can still define the aspect ratio with aspect-ratio in CSS while leaving the actual size fluid. The key is giving the browser enough information to reserve space before the asset loads. Avoid inserting content above existing content after page load. This is common with cookie banners, sticky headers that change height, and dynamically loaded ad units. If you need to show these, anchor them to fixed positions so they don't push content around. Fix INP: reduce what's competing for the main thread Audit third-party scripts and defer or remove anything that isn't essential. Tools like WebPageTest's waterfall view or Chrome DevTools Performance panel show you exactly which scripts are blocking the main thread and for how long. Load chat widgets, analytics, and ad tags asynchronously and after the page's critical path has resolved. For most clients, moving non-essential scripts to load after the DOMContentLoaded event is a meaningful INP improvement with no visible impact on the user experience. For websites with heavy JavaScript — particularly those built on frameworks with large client-side bundles — consider breaking up long tasks into smaller chunks using the browser's Scheduler API or simply splitting components so the main thread isn't locked for more than 50 milliseconds at a stretch. What platforms handle automatically One of the practical advantages of building on a platform optimized for performance is that many of these fixes are applied by default. Duda, for example, automatically serves WebP images, lazy loads below-the-fold content, minifies CSS, and uses efficient cache policies for static assets. As of May 2025, 82% of sites built on Duda pass all three Core Web Vitals metrics — the highest recorded pass rate among major website platforms. That baseline matters when you're managing dozens or hundreds of client sites. It means you're starting each project close to or at a passing score, rather than diagnosing and patching a broken foundation. How much do Core Web Vitals actually affect rankings? Honestly, they're a tiebreaker — not a primary signal. Google has been clear that content quality and relevance still dominate ranking decisions. A well-optimized site with thin, irrelevant content won't outrank a content-rich competitor just because its CLS is 0.05. What Core Web Vitals do affect is the user experience that supports those rankings. Pages with poor LCP scores have measurably higher bounce rates. Sites with high CLS lose users mid-session. Those behavioral signals — time on page, return visits, conversions — are things search engines can observe and incorporate. The practical argument for fixing Core Web Vitals isn't just "because Google said so." It's that faster, more stable pages convert better. Every second of LCP improvement can reduce bounce rates by 15–20% depending on the industry and device mix. For client sites that monetize through leads or eCommerce, that's a revenue argument, not just an SEO argument. A repeatable process for agencies Audit every new site before launch. Run PageSpeed Insights and record LCP, INP, and CLS scores for both mobile and desktop. Flag anything in the "needs improvement" or "poor" range before the client sees the live site. Check Search Console monthly for existing clients. The Core Web Vitals report surfaces issues as they appear in field data. Catching a regression early — before it compounds — is significantly easier than explaining a traffic drop after the fact. Document what you've improved. Clients rarely see Core Web Vitals scores on their own. A monthly one-page performance summary showing before/after scores builds credibility and makes your technical work visible. Prioritize mobile. Google uses mobile-first indexing, and field data shows that mobile CWV scores are almost always worse than desktop. If you only have time to optimize one version, do mobile first. Core Web Vitals aren't a one-time fix. Platforms change, new scripts get added, campaigns bring in new widgets. Build the audit into your workflow and treat it like any other ongoing deliverable, and you'll stay ahead of the issues before they affect your clients' rankings. Duda's platform is built with Core Web Vitals performance in mind. Explore how it handles image optimization, script management, and site speed automatically — so your team spends less time debugging and more time building.
By Ilana Brudo March 31, 2026
Vertical SaaS must transition from tools to an AI-powered Vertical Operating System (vOS). Learn to leverage context, end tech sprawl, and maximize retention.
By Shawn Davis March 27, 2026
Automate client management, instant site generation, and data synchronization with an API-driven website builder to create a scalable growth engine for your SaaS platform.
Show More

Latest posts