URL Pública e Widget

O SquadOS tem dois canais que permitem qualquer pessoa conversar com o agente sem precisar de login: URL Pública (link compartilhável) e Widget de Site (bolinha embedável). Os dois aparecem como cards separados em Gatilhos porque atendem cenários diferentes — escolha o que melhor encaixa.

Quando usar	URL Pública	Widget de Site
Distribuição	Link direto compartilhado por você	Embed no seu próprio site
Aparência	Tela cheia em `squados.io/a/<slug>`	Bolinha flutuante no canto da página
Marca SquadOS	Sempre visível	Pode ocultar em planos pagos
Domínios	Aberto a qualquer um com o link	Limitado por allowlist de domínios
Quota	Sem quota dedicada	Quota diária opcional de créditos

O Hub autenticado (rota /hub) é coisa diferente: é o painel onde colaboradores logados conversam com os agentes da sua organização. Não precisa de configuração no card de Gatilhos — todo agente ativo já aparece lá para os usuários da org.

URL Pública

Cria uma URL única https://squados.io/a/<slug> que qualquer pessoa pode acessar para conversar com o agente em tela cheia, sem login.

Ativando

Abra o agente no painel admin.
Vá para Gatilhos.
No card URL Pública, clique em Conectar.
Escolha um Slug (3 a 64 caracteres, só letras minúsculas, números e hífens). É a parte final do link.
O SquadOS valida o slug em tempo real. Se já estiver em uso, escolha outro.
Clique em Ativar URL Pública.

A URL aparece no próprio card quando ativo, com botão de copiar. Para desativar, clique em Desconectar — a URL fica fora do ar imediatamente.

Antes de divulgar

Teste o agente abrindo a URL você mesmo.
Confirme que o prompt deixa claro o escopo do atendimento.
Garanta que ferramentas sensíveis (envio de e-mail, transações, dados internos) não estão expostas sem guardrails.
Monitore as primeiras conversas em Conversas.

Um snippet <script> que você cola no seu site e ele renderiza uma bolinha de chat flutuante. Visitantes clicam, conversam com o agente, fecham — tudo sem sair da sua página.

Ativando

Abra o agente, vá para Gatilhos.
No card Widget de Site, clique em Conectar.
Configure no modal:
- Slug do widget — identificador único usado no script (3 a 64 caracteres). Aparece no atributo data-agent do snippet.
- Posição da bolinha — canto inferior direito (padrão) ou esquerdo.
- Saudação inicial (opcional) — primeira mensagem que aparece quando o visitante abre o widget. Útil para orientar o uso.
- Domínios permitidos — lista de domínios autorizados a embedar o widget. Use *.exemplo.com para liberar subdomínios. Obrigatório salvar pelo menos um domínio (ou ligar “Permitir qualquer domínio”).
- Permitir qualquer domínio (não recomendado) — qualquer site poderá embedar o widget e consumir os créditos da sua org.
- Quota diária de créditos (opcional) — corta o widget quando o limite é atingido no dia. O visitante recebe mensagem de “limite atingido” até o próximo dia.
- Remover “Powered by SquadOS” — esconde a marca SquadOS no rodapé. Disponível só em planos superiores.
Clique em Salvar e ativar widget.

Snippet de instalação

Após salvar, o modal exibe o snippet pronto para colar:

<script async src="https://squados.io/widget.js" data-agent="seu-slug"></script>

Cole antes do </body> em todas as páginas onde o widget deve aparecer. O loader cuida do resto: pinta a bolinha, abre o iframe quando clicado, controla mensagens.

O modal também oferece Copiar snippet e Testar no /embed (abre /embed/<slug> em nova aba para você ver o iframe puro antes de embedar no site).

Allowlist de domínios

O widget só funciona quando carregado de um domínio listado. O loader compara o Origin da página contra a allowlist e bloqueia se não bater. Use isso para evitar que outros sites embedem seu widget e consumam créditos.

localhost e 127.0.0.1 são sempre aceitos para desenvolvimento.

Diferença vs. /hub (uso interno)

	URL Pública / Widget	/hub
Login	Não exige	Exige (colaborador da org)
Histórico por usuário	Anônimo por sessão	Persistente por usuário
Onde aparece	Qualquer pessoa com link/embed	Só membros da org
Configuração necessária	Sim (card no Gatilhos)	Nada — todo agente ativo aparece

Use URL Pública ou Widget para público externo. Use Hub para operação interna do time.