Página pública e Widget

O SquadOS tem dois canais em que qualquer pessoa conversa sem precisar de login: a Página pública (um endereço que você compartilha) e o Widget (uma bolha de chat no seu próprio site). Os dois são caixas de entrada — conectam-se, editam-se e pausam-se na tela Caixas de Entrada, como qualquer outro canal.

	Página pública	Widget
Como chega ao visitante	Link que você compartilha	Bolha no seu site
Aparência	Tela cheia em app.squados.io/a/<endereço>	Bolha flutuante no canto da página
Endereço	Você escolhe, e pode trocar	Gerado automaticamente e fixo
Quem pode usar	Qualquer um com o link	Só os domínios que você autorizar
Limite de gasto	Sem quota dedicada	Quota diária de créditos, opcional

O Hub é outra coisa: é onde os membros da sua organização conversam com os agentes já logados. Não precisa de caixa nenhuma — todo agente ativo já aparece lá.

Criando a caixa

O caminho é o mesmo para os dois. Em Caixas de Entrada, clique em Conectar caixa de entrada e escolha o canal em Outros canais:

Depois você diz quem atende — um agente da organização, ou o atendimento humano — e por fim configura o canal. Os detalhes do wizard estão em Caixas de entrada.

Página pública

Cria um endereço https://app.squados.io/a/<endereço> que qualquer pessoa abre para conversar em tela cheia, sem login.

• Endereço da página — letras minúsculas, números e hífens, no mínimo 3 caracteres. É a parte final do link, e o SquadOS avisa na hora se já estiver em uso.
• Mensagem de boas-vindas (opcional) — aparece antes da primeira mensagem de quem abre a página.

Trocar o endereço depois quebra o link antigo. Quem já tem a URL cai numa página não encontrada. A tela avisa quando você edita uma caixa que já tem conversas.

Com a caixa criada, o menu Ações da linha oferece Abrir página e Copiar link.

Antes de divulgar

• Abra a URL você mesmo e converse.
• 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.
• Acompanhe as primeiras conversas em Conversas.

Widget

Um trecho de <script> que você cola no site e que renderiza uma bolha de chat flutuante. O visitante clica, conversa e fecha sem sair da sua página.

Domínios permitidos é o único campo obrigatório. Digite o domínio e clique em Adicionar; use *.exemplo.com para incluir todos os subdomínios. O loader compara o domínio da página contra essa lista e só desenha a bolha em site autorizado — é o que impede outro site de embedar o seu widget e consumir os seus créditos.

Se quiser testar rápido, ligue Liberar qualquer domínio. Desligue quando terminar.

O resto é opcional:

• Aparência — o ícone da bolha (seis opções) e a cor de destaque, que tinge a bolha e o chat. Aceita cor personalizada.
• Posição da bolinha — canto inferior direito (padrão) ou esquerdo.
• Saudação inicial — primeira mensagem que o visitante vê ao abrir o widget.
• Quota diária de créditos — quando atingida, o widget exibe “limite atingido” até o dia seguinte.

Código de instalação

No menu Ações da caixa, escolha Copiar código de instalação. O snippet tem esta forma:

<!-- SquadOS Widget — Minha caixa -->
<script async src="https://app.squados.io/widget.js" data-agent="minha-caixa-4a5d8010"></script>

Cole antes do </body> em todas as páginas onde a bolha deve aparecer. O loader cuida do resto.

O identificador em data-agent é o endereço da caixa widget, gerado a partir do nome quando a caixa nasce — você não digita nem edita. Ele é fixo de propósito: mudá-lo invalidaria todo snippet já colado nos sites dos clientes. (Na página pública é o contrário: lá o endereço é o produto, e você escolhe.)

Para ver o chat sem embedar em lugar nenhum, abra https://app.squados.io/embed/<endereço> — essa página funciona independentemente da lista de domínios.

Identificando o visitante (opcional)

Por padrão cada conversa do widget é anônima e aparece em Conversas como contato externo. Se o seu site já sabe quem é o visitante (login, formulário, CRM), passe essa identidade com window.SquadOS.identify():

window.SquadOS.identify({
  name: "Maria Silva",
  email: "[email protected]",
  external_id: "usr_8231", // o ID do visitante no seu sistema, se tiver
  metadata: { plano: "pro", empresa: "Acme" }, // opcional, livre
});

Chame a qualquer momento depois do snippet — antes ou depois de o visitante abrir o chat. O SquadOS guarda o valor e aplica assim que o widget termina de carregar; chamadas seguintes (o visitante logou no meio da sessão, por exemplo) atualizam a identidade da conversa em andamento.

Campo	Efeito
name	Vira o nome exibido em Conversas, no lugar do contato externo.
email ou external_id	Cria ou vincula um contato na sua organização, pesquisável e reaproveitado nas próximas conversas do mesmo visitante. Se os dois vierem, external_id tem prioridade — use quando o seu sistema já tem um ID estável, mais confiável que e-mail.
metadata	Pares livres (texto, número ou booleano) salvos junto com o contato. Não aparecem na conversa nem são lidos pelo agente.

Enviar só name troca o nome exibido sem criar contato. Não chamar identify() mantém tudo anônimo.

Precisa chamar antes de o script carregar? Crie um stub que guarda a chamada até o loader assumir:

<script>
  window.SquadOS = window.SquadOS || { q: [], identify: function () { this.q.push(arguments); } };
  window.SquadOS.identify({ name: "Maria Silva" });
</script>
<script async src="https://app.squados.io/widget.js" data-agent="minha-caixa-4a5d8010"></script>

O loader drena essa fila assim que carrega — nenhuma chamada se perde.

Os dados vêm do navegador do visitante, então o SquadOS não os verifica. Não use identify() para nada sensível a fraude: no pior caso alguém forja um valor e o efeito é um registro incorreto no seu próprio contato.