Einstieg

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer AI-Werkzeugleiste hinzu, indem Sie den folgenden Befehl verwenden:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Verwenden Sie dann den folgenden Vorschlag:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-crisp` plugin in my project.

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten aufgeführten plattform-spezifischen Anweisungen befolgen:

bun add @capgo/capacitor-crisp
bunx cap sync

Importieren

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

API Übersicht

configure

Konfigurieren Sie den Crisp SDK mit Ihrer Website-ID. Muss vor der Verwendung von anderen Methoden aufgerufen werden.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.configure({ websiteID: 'YOUR_WEBSITE_ID' });

openMessenger

Öffnen Sie das Crisp-Messenger-Chattfenster. Zeigt dem Benutzer die Chat-Oberfläche.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CapacitorCrisp.openMessenger();

setTokenID

Setzen Sie eine eindeutige Token-ID für die aktuelle Benutzersitzung. Wird verwendet, um vorherige Gespräche zu identifizieren und wiederherzustellen.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CapacitorCrisp.setTokenID({} as { tokenID: string });

setUser

Setzen Sie Benutzerinformationen für die aktuelle Sitzung. Aktualisiert das Benutzerprofil, das für Supportmitarbeiter sichtbar ist.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.setUser({
  nickname: 'John Doe',
  email: 'john@example.com',
  phone: '+1234567890'
});

pushEvent

Schieben Sie einen benutzerdefinierten Ereignis in Crisp. Zum Tracking von Benutzeraktionen und Verhalten nützlich.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.pushEvent({
  name: 'completed_purchase',
  color: 'green'
});

setCompany

Setzen Sie Unternehmensinformationen für die aktuelle Sitzung. Assoziieren Sie den Benutzer mit einem Unternehmen in Crisp.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.setCompany({
  name: 'Acme Corp',
  url: 'https://acme.com',
  employment: ['CEO', 'Executive'],
  geolocation: ['USA', 'San Francisco']
});

setInt

Setzen Sie eine benutzerdefinierte Ganzzahl-Datenfeld. Speichern Sie numerische Daten, die mit der Benutzersitzung verbunden sind.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.setInt({ key: 'user_level', value: 42 });

setString

Einen benutzerdefinierten String-Datenfeld setzen. Speichert Textdaten, die mit der Benutzersitzung verbunden sind.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.setString({ key: 'subscription_tier', value: 'premium' });

sendMessage

Ein Nachricht von dem Benutzer an den Chat senden. Programmatisch eine Nachricht senden, als ob der Benutzer sie getippt hätte.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.sendMessage({ value: 'Hello, I need help!' });

setSegment

Einen Benutzersegment für Ziele und Organisation setzen. Wird verwendet, um Benutzer in der Crisp-Dashboard zu kategorisieren.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CrispPlugin.setSegment({ segment: 'premium-users' });

reset

Die Crisp-Sitzung zurücksetzen. Löscht alle Benutzerdaten und startet eine frische Sitzung. Wird verwendet, wenn der Benutzer abmeldet.

import { CapacitorCrisp } from '@capgo/capacitor-crisp';

await CapacitorCrisp.reset();

Typenreferenz

ConfigureOptions

Konfiguration für die Initialisierung von Crisp.

export interface ConfigureOptions {
  /**
   * Your Crisp website ID from dashboard.
   */
  websiteID: string;
  /**
   * Optional - Locale to force in the Crisp chat widget (ISO 639-1), eg. `en`, `fr`, `es`.
   * Web + Android: overrides the runtime locale. iOS follows the device/app locale.
   */
  locale?: string;
  /**
   * Optional - Unique token identifier for the user session continuity.
   */
  tokenID?: string;
}

eventColor

Verfügbare Farben für Crisp-Ereignisse. Wird verwendet, um Ereignisse in der Crisp-Dashboard visuell zu kategorisieren.

export type eventColor =
  | 'red'
  | 'orange'
  | 'yellow'
  | 'green'
  | 'blue'
  | 'purple'
  | 'pink'
  | 'brown'
  | 'grey'
  | 'black';

Quelle der Wahrheit

Diese Seite wurde aus dem Plugin generiert. src/definitions.tsRe-run die Synchronisierung, wenn die öffentliche API upstream geändert wird.

Weitermachen von Getting Started

Wenn Sie Getting Started zum Planen von Dashboard und API-Operationen verwenden, verbinden Sie es mit Mithilfe von @capgo/capacitor-crisp für die native Fähigkeit in Mithilfe von @capgo/capacitor-crisp API-Übersicht für die Implementierungsdetails in API-Übersicht Einführung für die Implementierungsdetails in Einführung API-Schlüssel für die Implementierungsdetails in API Schlüsseln und Geräte für die Implementierungsdetails in Geräten.