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	Sempre visível
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

1. Abra o agente no painel admin.
2. Vá para Gatilhos.
3. No card URL Pública, clique em Conectar.
4. Escolha um Slug (3 a 64 caracteres, só letras minúsculas, números e hífens). É a parte final do link.
5. O SquadOS valida o slug em tempo real. Se já estiver em uso, escolha outro.
6. 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.

Widget de Site

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

1. Abra o agente, vá para Gatilhos.
2. No card Widget de Site, clique em Conectar.
3. No modal, o único campo obrigatório fica na seção Essencial:
   • Domínios permitidos — os sites autorizados a usar o widget. Digite o domínio e tecle Enter (ou Adicionar). Use *.exemplo.com para liberar todos os subdomínios. Sem ao menos um domínio o widget não funciona em lugar nenhum.
4. A seção Avançado (recolhida por padrão) tem ajustes opcionais — os valores padrão servem para a maioria dos casos:
   • Posição da bolinha — canto inferior direito (padrão) ou esquerdo.
   • Saudação inicial — primeira mensagem que aparece quando o visitante abre o widget.
   • Quota diária de créditos — corta o widget quando o limite do dia é atingido; o visitante vê “limite atingido” até o próximo dia.
5. Clique em Salvar e ativar widget.

O slug do widget (o identificador no atributo data-agent) é gerado automaticamente a partir do nome do agente — você não digita nem escolhe. Ele não muda depois de criado, para não invalidar snippets já colados nos sites.

Com o widget ativo, o card fica verde com Conectado e três ações: Acessar (abre o /embed numa aba), Informações (reabre a configuração e o código de instalação) e Desconectar.

Código de instalação

Clique em Informações no card para reabrir a configuração — o bloco Código de instalação mostra 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 as mensagens.

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

Allowlist de domínios

Quando o widget é carregado pelo snippet, o loader compara o domínio da página contra a allowlist e só pinta a bolinha em domínios autorizados. Use isso para evitar que outros sites embedem seu widget e consumam seus créditos.

Para testar antes de colar no site, use o botão Testar no /embed — ele abre o chat hospedado no próprio SquadOS, que sempre funciona independentemente da allowlist.

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.