Globale Events

Es wird zwischen globalen und clientseitigen Events unterschieden. Globale Events werden auf dem window Objekt verteilt, clientseitige Events über lcapi.messageBus.

Die LiveChat Clients lösen folgende Events im window Objekt aus.

lcapi-ready

Wird einmalig ausgelöst, sobald die LiveChat API initialisiert ist, und das globale Objekt window.lcapi existiert.

lcapi-connected

Wird immer dann ausgelöst, sobald sich ein Benutzer erfolgreich am Server angemeldet hat.

Dieses Event kann mehrfach ausgelöst werden, bspw. nach einem Reconnect eines Clients.

Als Argument wird das Objekt des eingeloggten Benutzers übergeben. Siehe Datenstruktur Kontakt - öffentliche Felder.

Im folgenden Beispiel wird eine Notiz gesetzt, sobald sich ein Agent eingeloggt hat.

window.addEventlister('lcapi-connected', function() {

    lcapi.me.setCustomNote('Logged in at ' + new Date().toISOString());

});

Warning

Das Event lcapi-connected kann öfters ausgelöst werden. Bspw. nach einem Verbindungsabbruch und anschließendem Reconnect.

Um das Event nur einmalig zu bekommen, können Sie folgendes Pattern verwenden:

var eventWrapper = function() {
    window.removeEventlister('lcapi-connected', eventWrapper);

    // ... your code
}

window.addEventlister('lcapi-connected', eventWrapper);