Queuerd Quickstart (cliente)

Objetivo: activar la sala de espera en 10-15 minutos.

1) Antes de empezar

Necesitas:

acceso al dashboard de Queuerd
dominio del sitio que quieres proteger (ejemplo: shop.midominio.com)
un usuario admin del sitio

2) Alta inicial

Inicia sesion en Queuerd.
Completa onboarding y registra tu dominio.
Entra a Queue Settings y confirma:
- Queue active encendido cuando vayas a usar la cola
- capacidad maxima y ritmo de admision definidos

3) Elige metodo de integracion

Puedes usar uno de estos metodos:

JavaScript Snippet (mas rapido)
SDK (@queuerd/sdk) para control en backend
Reverse Proxy (enterprise)

4) Instalacion con JavaScript Snippet (recomendado para ir rapido)

En Integrations > JS Snippet, copia el script y pegalo en el <head> o antes de </body> de tu sitio:

<script src="https://www.queuerd.com/q.js" data-domain="shop.midominio.com" data-api-base-url="https://www.queuerd.com" defer></script>

Notas:

data-domain debe coincidir con tu tenant en Queuerd.
si usas otro host para Queuerd, cambia data-api-base-url.

5) Instalacion con SDK (control backend)

Instala paquete:

npm install @queuerd/sdk

Ejemplo base:

import { withQueue } from "@queuerd/sdk"

const domain = "shop.midominio.com"
const waitingRoomBase = "https://www.queuerd.com"

const guard = withQueue({
  domain,
  apiBaseUrl: waitingRoomBase,
})

export async function handler(request: Request) {
  const visitorId = request.headers.get("x-queuerd-visitor-id")
  if (!visitorId) {
    // Fail open si tu app aun no adjunta un visitor id estable.
    return new Response("ok")
  }

  const result = await guard(request)
  if (!result.allow && result.status === "waiting") {
    const destination = new URL(request.url).pathname
    const waitingRoomUrl = new URL(`${waitingRoomBase}/waiting-room`)
    waitingRoomUrl.searchParams.set("tenant", domain)
    waitingRoomUrl.searchParams.set("id", visitorId)
    waitingRoomUrl.searchParams.set("dest", destination)
    return Response.redirect(waitingRoomUrl.toString(), 302)
  }
  return new Response("ok")
}

Importante:

withQueue requiere un visitorId estable en el header x-queuerd-visitor-id.
la redireccion al waiting room debe incluir tenant, id y dest.

6) Verificacion rapida

En Queue Settings, activa cola.
Abre tu sitio en incognito.
Debes ver redireccion a waiting-room.
En Dashboard, verifica que suba Visitors in queue.
Desactiva cola y confirma acceso directo al sitio.

7) Reverse Proxy (enterprise)

Si eliges Reverse Proxy:

configura DNS como CNAME tu-dominio.com -> proxy.queuerd.com
verifica el dominio en Queuerd antes de habilitar proxy
define origin con tu upstream HTTPS publico (ejemplo: https://origin.tudominio.com)
el flujo de cola no cambia (primero queue, luego proxy para trafico admitido)

8) Problemas comunes

No redirige: revisa data-domain y que la cola este activa.
Redirige en loop: valida dest/rutas permitidas y configuracion del dominio.
No ves metricas: revisa que el trafico este entrando por el dominio configurado.

9) Checklist de salida a produccion

Dominio correcto en tenant
Integracion instalada (snippet o sdk)
Cola activa probada en incognito
Admisiones y metricas visibles en dashboard
Equipo de soporte conoce donde pausar/reactivar cola

Quickstart cliente