Widget web

O widget web é um pequeno bundle JS (~30 kB gzip) que monta um balão de chat no canto inferior de qualquer página.

Carregamento

<script src="https://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"></script>

Identificar usuários autenticados

Para visitantes anônimos, o widget gera automaticamente um contato. Para usuários autenticados, chameSingChat.identify() com as informações do seu usuário:

window.SingChat.identify({
  externalId: "user_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
  customAttributes: { plan: "pro", signupAt: "2025-01-12" },
});

Abertura / fechamento programático

SingChat.open();
SingChat.close();
SingChat.toggle();

Escutando eventos

SingChat.on("message:new", (msg) => {
  console.log("new message", msg);
});

SingChat.on("ai:stream:end", ({ messageId }) => {
  // AI finished streaming
});

Personalização do tema

Em Settings → Inboxesvocê pode configurar a cor principal do widget, a posição e o texto de saudação. White-label (ocultar "Powered by AskAIs") está disponível no plano Pro e superiores.

Segurança

• O app-id é público, pode ser incluído no HTML sem problemas
• A chave secreta é apenas para o lado do servidor, nunca a exponha no código do navegador
• Para casos de uso de alta confiança, assine os payloads do usuário no lado do servidor com a chave secreta (HMAC-SHA256), veja Autenticação da API