Queuerd Quickstart (cliente)

Objetivo: ativar a sala de espera em 10-15 minutos.

1) Antes de comecar

Voce precisa de:

acesso ao dashboard da Queuerd
dominio do site que deseja proteger (exemplo: shop.seudominio.com)
um usuario admin do seu site

2) Configuracao inicial

Faca login na Queuerd.
Conclua o onboarding e registre seu dominio.
Acesse Queue Settings e confirme:
- Queue active ligado quando quiser usar a fila
- capacidade maxima e taxa de admissao configuradas

3) Escolha o metodo de integracao

Voce pode usar um destes metodos:

JavaScript Snippet (mais rapido)
SDK (@queuerd/sdk) para controle no backend
Reverse Proxy (enterprise)

4) Instalacao com JavaScript Snippet (recomendado para lancamento rapido)

Em Integrations > JS Snippet, copie o script e cole no <head> do site ou antes de </body>:

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

Notas:

data-domain deve ser igual ao dominio do tenant na Queuerd.
se usar outro host da Queuerd, ajuste data-api-base-url.

5) Instalacao com SDK (controle backend)

Instale o pacote:

npm install @queuerd/sdk

Exemplo base:

import { withQueue } from "@queuerd/sdk"

const domain = "shop.seudominio.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 se seu app ainda nao envia um visitor id estavel.
    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 exige um visitorId estavel no header x-queuerd-visitor-id.
o redirect para waiting room deve incluir tenant, id e dest.

6) Verificacao rapida

Em Queue Settings, ative a fila.
Abra seu site em janela anonima.
Voce deve ser redirecionado para waiting-room.
No Dashboard, confirme que Visitors in queue aumenta.
Desative a fila e confirme acesso direto ao site.

7) Reverse Proxy (enterprise)

Se escolher Reverse Proxy:

configure DNS como CNAME seu-dominio.com -> proxy.queuerd.com
verifique o dominio na Queuerd antes de habilitar proxy
defina origin com seu upstream HTTPS publico (exemplo: https://origin.seudominio.com)
o fluxo da fila permanece igual (fila primeiro, proxy para trafego admitido)

8) Problemas comuns

Sem redirecionamento: confira data-domain e se a fila esta ativa.
Loop de redirecionamento: valide dest/rotas permitidas e configuracao de dominio.
Sem metricas: confirme que o trafego entra pelo dominio configurado.

9) Checklist de producao

Dominio correto configurado no tenant
Integracao instalada (snippet ou SDK)
Fluxo da fila testado em janela anonima
Admissoes e metricas visiveis no dashboard
Time de suporte sabe pausar/reativar a fila

Quickstart do cliente