API-Referenz

Die Schnittstelle der ccaas-Web-SDK-Instanz.

Eigenschaften

Dieser Abschnitt enthält einige der Eigenschaften, die Sie möglicherweise verwenden.

Version

Die Version des Web-SDK.

console.log(ccaas.VERSION)

Client

Dies ist eine Instanz des monitorlosen Clients. Sie enthält alles, was für einen monitorlosen Client verfügbar ist.

Hier ein Beispiel:

const client = ccaas.client
const chat = await client.loadOngoingChat()

Methoden

Verfügbare Methoden für die Widget-Instanz.

.config

Konfiguration des Widgets aktualisieren.

ccaas.config({
  accent: 'green'
})

Weitere Informationen finden Sie im Abschnitt Konfiguration.

.mount

Widget für das angegebene Element bereitstellen. Beispiel: auf Ihrer Webseite:

<div id="my-ccaas"></div>

Anschließend können Sie das Web-SDK-Widget mit folgendem Code bereitstellen:

ccaas.mount('#my-ccaas')

.unmount

Web-SDK-Widget von Ihrer Webseite entfernen.

ccaas.unmount()

.destroy

Bereitstellung aufheben und alles zerstören.

ccaas.destroy()

.show

Widget-UI anzeigen.

ccaas.show()

.hide

Widget-UI ausblenden.

ccaas.hide()

.start

Widget mit den angegebenen Optionen anzeigen und starten.

interface StartOption {
  menuKey?: string;
  ticketId?: string;
  preferredChannel?: string;
}

Beispiel:

ccaas.start({ menuKey: 'vip' })

Ereignisse

In diesem Abschnitt werden die im Web-SDK verfügbaren Ereignisse beschrieben. Eine vollständige Liste der im monitorlosen Web-SDK verfügbaren Ereignisse finden Sie unter Ereignisse des monitorlosen Web-SDK.

Verwenden Sie die Methode .on, um einen Ereignis-Listener hinzuzufügen. Sehen Sie sich folgendes Beispiel an:

const trackChat = (chat) => {
  console.log(chat)
}

ccaas.on('chat.updated', trackChat)

Verwenden Sie die Methode .off, um einen Ereignis-Listener zu entfernen. Sehen Sie sich folgendes Beispiel an:

ccaas.off('chat.updated', trackChat)

Die Methoden .on und .off sind Aliase für die Methoden .on und .off des monitorlosen Web-SDK. Weitere Informationen finden Sie im Leitfaden zum monitorlosen Web-SDK.

sichtbar

Wird ausgegeben, wenn sich die Sichtbarkeit des Widgets ändert (geöffnet oder geschlossen).

Im folgenden Beispiel wird das Ereignis visible gezeigt:

ccaas.on('visible', (visible) => {
  console.log(visible)  // true or false
})

chat.unread

Wird ausgegeben, wenn sich die Anzahl der ungelesenen Nachrichten ändert.

Im folgenden Beispiel wird das Ereignis chat.unread gezeigt:

ccaas.on('chat.unread', (count) => {
  console.log(count)
})

beendet

Wird ausgegeben, wenn der Endnutzer das Widget schließt und die Sitzung beendet wird.

Im folgenden Beispiel wird das Ereignis exited gezeigt:

ccaas.on('exited', () => {
  // widget was exited
})