Widget web

El widget web es un pequeño paquete JS (~30 kB gzip) que monta una burbuja de chat en la esquina inferior de cualquier página.

Carga

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

Identificar usuarios con sesión iniciada

Para los visitantes anónimos, el widget genera automáticamente un contacto. Para los usuarios con sesión iniciada, llama aSingChat.identify() con la información de tu usuario:

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

Apertura / cierre programático

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

Escuchar eventos

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

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

Personalización del tema

En Settings → Inboxespuedes configurar el color principal del widget, su posición y el texto de bienvenida. La marca blanca (ocultar "Powered by AskAIs") está disponible en el plan Pro y superiores.

Seguridad

• El app-id es público, se puede incluir en el HTML sin problema
• La clave secreta es solo del lado del servidor, nunca la expongas en el código del navegador
• Para casos de uso de alta confianza, firma las cargas útiles del usuario del lado del servidor con la clave secreta (HMAC-SHA256), consulta Autenticación de la API