Acelerar a integração do Calendly

Integre o Calendly sem prejudicar os Core Web Vitals

Arjen Karel
Atualizado a · 4 min de leitura
Partilhar

Acelerar a integração do Calendly

O Calendly é um excelente software de agendamento de reuniões online! Integra-se com o calendário de trabalho e permite que outros marquem reuniões diretamente consigo. Muitos dos meus clientes usam o Calendly e funciona muito bem!

Integrar o Calendly no site

Há basicamente 3 formas de integrar o Calendly no site. Por iframe, por um link clicável ou por um botão. O processo é simples: basta clicar no código de incorporação, copiar o código e colá-lo no site. Pronto, o Calendly está incorporado na página. Mas nem tudo são rosas: pode também ter tornado o site mais lento.

Como é que o Calendly prejudica os Core Web Vitals?

Na incorporação inline, o Calendly adiciona um iframe ao site. Se for bem feita, as métricas de paint (Largest Contentful Paint e First Contentful Paint) não são muito afetadas pela integração do Calendly via iframe. O iframe afeta ligeiramente o Interaction to Next Paint, mas é perfeitamente aceitável na maioria dos casos.

O "problema" com os Core Web Vitals surge quando adiciona o Calendly através de um Popup widget ou de um Popup text. O código fornecido faz com que adicione uma stylesheet (https://assets.calendly.com/assets/external/widget.css) e um script (https://assets.calendly.com/assets/external/widget.js) ao site.

<!-- Calendly badge widget begin -->
<link
 href="https://assets.calendly.com/assets/external/widget.css"
 rel="stylesheet">
<script
  src="https://assets.calendly.com/assets/external/widget.js"
  type="text/javascript"
  async>
</script>
<a href="#"
   onclick="Calendly.initPopupWidget(
      {url: 'https://calendly.com/corewebvitals/pre-audit-meet'});
   return false;">
   Schedule time with me
</a>
<!-- Calendly badge widget end -->

O resultado é um atraso brutal de 370 ms causado pela stylesheet do Calendly. A auditoria da DebugBear ao Calendly descobriu que o CSS do widget tem 464 KB, em grande parte devido a fontes Base64 incorporadas. Isto acontece porque as stylesheets no head da página são render blocking por omissão. Faz sentido: sem os estilos, o browser não sabe qual deve ser o aspeto final do HTML. É por isso que é tão importante ter stylesheets otimizadas ao trabalhar os Core Web Vitals.

O script async também vai competir pelos recursos iniciais, mas, por ser assíncrono, o atraso que provoca é muito inferior ao causado pela stylesheet.

A solução

A solução passa por "tornar o Calendly non-render-blocking" e, como bónus, "melhorar o timing". Há uma forma fácil e outra um pouco mais difícil (e melhor) de o fazer. Vamos a isso!

O fix fácil

A forma mais simples é tornar a stylesheet non-render-blocking através do "truque do preload". Repare nas alterações que fiz ao código a negrito. A stylesheet passa a ter preload (e os recursos com preload são descarregados em paralelo). Quando a stylesheet termina de carregar, o link de preload transforma-se num link de stylesheet, o que efetivamente injeta uma stylesheet que não é render blocking!

<!-- Calendly badge widget begin -->
<link
 href="https://assets.calendly.com/assets/external/widget.css"
 rel="preload"
 as="style"
 onload="this.rel='stylesheet';this.onload=null;"
>
<script
  src="https://assets.calendly.com/assets/external/widget.js"
  type="text/javascript"
  async>
</script>
<a href="#"
   onclick="Calendly.initPopupWidget(
      {url: 'https://calendly.com/corewebvitals/pre-audit-meet'});
   return false;">
   Schedule time with me
</a>
<!-- Calendly badge widget end -->

O melhor fix

Embora o fix fácil melhore claramente as métricas de paint, continuo a não gostar do timing do Calendly. Ninguém na história da internet alguma vez se queixou por não conseguir marcar uma reunião nos primeiros 100 ms de carregamento da página. Prefiro priorizar os elementos mais importantes da página, como o elemento de LCP e os scripts críticos que gerem, por exemplo, a interação com o menu. É o mesmo facade pattern que utilizo em widgets de chat.

Vamos usar essa lógica e carregar tanto o script como o estilo assim que o HTML da página for processado. Este evento chama-se DOMContentLoaded. Quando este evento é disparado, aproveitamos o momento para carregar o estilo e o script de forma assíncrona. Quando o estilo e o script estiverem carregados, criamos um link clicável (na função de callback) que abre o popup quando o link é clicado. Prático, não é? Para mais técnicas como esta, consulte 16 métodos para adiar JavaScript.

O código também utiliza scheduler.yield() para fazer yield à main thread antes de abrir o popup. Isto mantém a interação responsiva e evita bloquear o browser enquanto o Calendly inicializa.

document.addEventListener('DOMContentLoaded', function () {

    var stylesheetPromise = new Promise(function (resolve, reject) {
        var stylesheet = document.createElement('link');
        stylesheet.rel = 'stylesheet';
        stylesheet.href = 'https://assets.calendly.com/assets/external/widget.css';
        stylesheet.onload = resolve;
        stylesheet.onerror = reject;
        document.head.appendChild(stylesheet);
    });

    var scriptPromise = new Promise(function (resolve, reject) {
        var script = document.createElement('script');
        script.src = 'https://assets.calendly.com/assets/external/widget.js';
        script.onload = resolve;
        script.onerror = reject;
        document.head.appendChild(script);
    });

    async function yieldToMainThread() {
        if ('scheduler' in window && 'yield' in window.scheduler) {
          return await window.scheduler.yield();
        }
        return new Promise((resolve) => {
          setTimeout(resolve, 0);
        });
      }

    Promise.all([stylesheetPromise, scriptPromise])
        .then(function () {
            const clickEl = document.getElementById('demo');
            clickEl.innerHTML = '<a>Book a Demo</a>';
            document.getElementById('demo').addEventListener('click', async function () {
                this.innerHTML = 'Loading...';
                await yieldToMainThread();
                Calendly.initPopupWidget({ url: 'https://calendly.com/corewebvitals/pre-audit-meet' }); return false;
            });
        })
        .catch(function (error) {
            console.error('Error loading resources:', error);
        });
});

Demo

Experimente a demo clicando no link abaixo (e, se precisar de uma auditoria, esteja à vontade para marcar uma reunião)

Marcar uma demonstração

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Precisa de um site mais rápido?

Sou o Arjen e há 17 anos que corrijo sites lentos. Se tem problemas que não consegue resolver sozinho, envie-me o seu URL e falamos.

Envie-me o seu URL
Arjen Karel
Arjen Karel, Consultor de web performance desde 2009

Porque é que o nosso fix não está a funcionar?

Por vezes a CDN ainda serve o HTML antigo, ou o fix foi feito no template de desktop e o mobile usa outro. Envie-me o seu URL e o problema, e respondo com alguns horários. Primeiro analiso os seus field data, depois dedicamos uma hora ao seu site, e no prazo de um dia tem as minhas notas por escrito. 350 € sem IVA.

Envie-me o seu URL

Sem programador para fazer o fix? Faço eu o trabalho, numa cópia do seu site.

Arjen KarelCore Web Vitals a vermelho em mobile?Envie-me o seu URL