Event Listener
Reagiere mit JavaScript-Callbacks in Echtzeit auf Chat-Ereignisse.
Überblick
Das eingebettete Widget löst benutzerdefinierte Ereignisse aus, auf die deine Anwendung reagieren kann. Damit kannst du Nutzerinteraktionen erfassen, Analysen auslösen oder andere Werkzeuge integrieren.
Verfügbare Ereignisse
| Ereignis | Wird ausgelöst, wenn |
|---|---|
agent:ready | das Widget geladen und bereit ist |
agent:open | das Chat-Widget geöffnet wird |
agent:close | das Chat-Widget geschlossen wird |
agent:message:sent | ein Nutzer eine Nachricht sendet |
agent:message:received | der Agent mit einer Nachricht antwortet |
agent:conversation:start | eine neue Unterhaltung beginnt |
Verwendung
window.addEventListener("agent:message:sent", (event) => {
console.log("User sent:", event.detail.message);
});
window.addEventListener("agent:message:received", (event) => {
console.log("Agent replied:", event.detail.message);
});
window.addEventListener("agent:ready", () => {
console.log("Chat widget is ready");
});Ereignisdaten
Die detail-Eigenschaft jedes Ereignisses enthält die zugehörigen Daten:
// agent:message:sent
interface MessageSentDetail {
message: string;
conversation_id: string;
timestamp: string;
}
// agent:message:received
interface MessageReceivedDetail {
message: string;
conversation_id: string;
timestamp: string;
sources?: string[];
}Programmatische Steuerung
Du kannst das Widget auch programmatisch steuern:
// Chat-Widget öffnen
window.AgentWidget.open();
// Chat-Widget schließen
window.AgentWidget.close();
// Nachricht programmatisch senden
window.AgentWidget.sendMessage("Hallo!");