Carga lazy: cuándo el widget habla con nuestros servidores

Para responder la pregunta que más nos hacen al instalar el widget: "¿esto me frena la carga de la página?". No — y acá te mostramos exactamente cuándo entra en juego cada llamado de red, para que puedas confirmarlo vos mismo.

Lo más importante primero

El widget no descarga nada de nuestros servidores hasta que está por entrar en pantalla. Si el visitante nunca scrollea hasta ahí, esa visita no genera ningún tráfico hacia nuestro backend.
No hace falta agregar ningún script adicional — el widget resuelve solo todas sus dependencias, vos solo pegás el tag y un único <script>.

Al cargar la página, solo se define el componente

Con esto antes de </body>, el navegador registra el <civis-community> y muestra un esqueleto (placeholder gris con líneas, sin datos reales) en su lugar. En este punto no se hizo ningún llamado a nuestra API — para cuando el navegador llega a ejecutar el script, el resto de tu página ya terminó de parsearse, así que no hay nada que esperar.

<civis-community containerName="mi-articulo"></civis-community>
<script src="https://widget.civis.live/main.js"></script>

Al estar por entrar en pantalla, se activa todo lo demás

El widget observa su propia posición (margen de 200px). Recién cuando el visitante scrollea hasta quedar cerca, se dispara en paralelo:

el llamado de bootstrap a nuestra API (resuelve el sitio/container),
la carga de los comentarios existentes,
la conexión en tiempo real (WebSocket) para recibir comentarios nuevos en vivo,
la descarga de las librerías de terceros que usa esa conexión — no tenés que incluirlas a mano, y tampoco se bajan si el widget nunca llega a activarse.

Por qué te importa esto

Widget al final de una nota larga

Si el lector no llega a scrollear hasta ahí, esa visita no genera tráfico hacia nuestro backend ni descarga las librerías de tiempo real — cero impacto en la performance de esa carga de página.

La métrica "Widgets cargados" se cuenta en la etapa 2

No cuando se abre la página. Si comparás esa métrica contra tus propias visitas de pageview y ves un número menor, es esperable: la diferencia son los visitantes que nunca llegaron a scrollear hasta el widget.

No hay integración extra que mantener

Si tu integración es vieja y todavía tiene los <script> de SockJS/STOMP.js pegados a mano, podés sacarlos sin que se rompa nada — el widget los resuelve por su cuenta hoy.

Preguntas frecuentes

¿El widget frena la carga de mi página?

No. El único archivo que se descarga siempre es el módulo del widget (liviano, no bloqueante); todo lo que implica hablar con nuestros servidores espera a que el widget esté por entrar en pantalla.

¿Puedo hacer que cargue apenas se abre la página, sin esperar el scroll?

Hoy no es configurable — el comportamiento lazy es el mismo para todos los sitios. Si tenés un caso puntual que lo necesite (por ejemplo, un widget que siempre está arriba de todo, "above the fold"), contanos y lo evaluamos.

¿Sigo necesitando agregar los scripts de SockJS/STOMP.js?

No — el widget los carga por su cuenta y de forma lazy (recién cuando se activa). Si una integración vieja todavía los tiene puestos a mano, no rompe nada, pero ya no son necesarios y se pueden retirar.

¿Tenés dudas sobre esto?

Escribinos