Skip to main content

Using @capgo/capacitor-crisp

Crisp Chat SDK Plugin for Capacitor. Provides live chat and customer support functionality through Crisp.chat.

Install

bun add @capgo/capacitor-crisp
bunx cap sync

What This Plugin Exposes

  • configure - Configure the Crisp SDK with your website ID. Must be called before using any other methods.
  • openMessenger - Open the Crisp messenger chat window. Shows the chat interface to the user.
  • setTokenID - Set a unique token ID for the current user session. Used to identify and restore previous conversations.
  • setUser - Set user information for the current session. Updates the user profile visible to support agents.

Example Usage

configure

Configure the Crisp SDK with your website ID. Must be called before using any other methods.

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

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

openMessenger

Open the Crisp messenger chat window. Shows the chat interface to the user.

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

await CapacitorCrisp.openMessenger();

setTokenID

Set a unique token ID for the current user session. Used to identify and restore previous conversations.

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

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

setUser

Set user information for the current session. Updates the user profile visible to support agents.

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

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

Full Reference