Widget web

Le widget web est un petit bundle JS (~30 kB gzip) qui ajoute une bulle de chat dans le coin inférieur de n'importe quelle page.

Chargement

<script src="https://cs.askais.com/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://cs.askais.com"></script>

Identifier les utilisateurs connectés

Pour les visiteurs anonymes, le widget génère automatiquement un contact. Pour les utilisateurs connectés, appelezSingChat.identify() avec les informations de votre utilisateur :

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

Ouverture / fermeture programmatique

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

Écoute des événements

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

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

Personnalisation du thème

Dans Settings → Inboxes, vous pouvez configurer la couleur principale du widget, sa position et le texte d'accueil. La marque blanche (masquer "Powered by AskAIs Customer Service") est disponible à partir du plan Pro.

Sécurité

• L'app-id est public — vous pouvez l'inclure dans le HTML sans risque
• La clé secrète est réservée au serveur — ne l'exposez jamais dans le code du navigateur
• Pour les cas d'usage à haute confiance, signez les charges utiles utilisateur côté serveur avec la clé secrète (HMAC-SHA256) — voir Authentification de l'API