> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/integrations/crisp.md).

# Crisp

See a user's Jimo profile, segments and activity in a Crisp conversation, and launch a Jimo experience for them from the chat.

The Crisp integration adds a Jimo panel to your Crisp conversations. Support agents see the user's Jimo data and history, and launch a tour for them from the chat.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FfmImwlsqrvkRxOsf2BxF%2Fimage.png?alt=media&amp;token=c4f7a69f-ee60-4120-82de-da035195f31c" alt="Jimo panel in a Crisp conversation"><figcaption></figcaption></figure>

## What it does

* Shows the user's Jimo profile, segments and experience activity in the Crisp conversation. Read only.
* Launches a Jimo experience for that user from the chat.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FVQC4oJhLyZozDfAeYOEE%2FF2-57-crisp-flow.png?alt=media&amp;token=eef45c0b-c8fa-41d4-afdb-8a6d88aa4a58" alt="In a Crisp conversation, the Jimo tab reads user detail and activity from Jimo, and Launch a tour posts a tour:start message that starts the experience in your app for that user"><figcaption></figcaption></figure>

{% hint style="info" %}
To hand an Agent conversation over to your team in Crisp, see [Escalation](https://help.usejimo.com/docs/experiences/agent/escalation.md). It is set up from the Agent, not from this plugin.
{% endhint %}

## Before you start

* A Crisp workspace, used in the Crisp web app. The panel is not available in the Crisp desktop or mobile apps.
* A Jimo account with access to the project you want to connect.

## Install the plugin

{% stepper %}
{% step %}

### Install Jimo from the Crisp Marketplace

In the Crisp Marketplace, search for "Jimo" and install the plugin on your Crisp workspace.
{% endstep %}

{% step %}

### Open the Jimo tab in a conversation

Open any conversation. The Jimo tab is in the right-hand sidebar.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Frur8zZyLy9Vrqw8msjsZ%2Fimage.png?alt=media&amp;token=e4ef1938-5220-432e-9cab-9f54e0684f51" alt="Jimo tab in the Crisp sidebar"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Log in to Jimo and pick the project

Log in to your Jimo account from the tab, then select the project to connect. You can switch projects at any time.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FGbRCiKPkV6IOqxNtj3Ox%2Fimage.png?alt=media&amp;token=37c854ad-1f40-405a-ac98-72168210847f" alt="Jimo login from Crisp"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fe1aCl5fN9tEwZMCa4uhu%2Fimage.png?alt=media&amp;token=551dd6f3-a0d6-4246-858f-1b1d12104108" alt="Project selection in the Jimo tab"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## What you see in Crisp

The panel has three tabs.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FWjL9uYaCr9CIce4Kc6T0%2Fimage.png?alt=media&amp;token=535d8d9e-7970-49be-8f94-a59e624d043b" alt="The three tabs of the Jimo panel"><figcaption></figcaption></figure>

### Launch a tour

Pick an experience from the list. The plugin posts a message in the chat, such as `tour:start:49e3d8b6-9cae-4264-ba62-3b7f67cd84fd`, which starts the experience for that user:

* If its **Where** is **Everywhere**, it starts on the user's current page.
* If its **Where** is a **Single URL**, the user is taken to that URL, where it starts.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FyApLzLqYFYI8ESC4Buum%2Fimage.png?alt=media&amp;token=d6f74d79-f90f-46f1-8e2c-504a571c3a08" alt="Launch a tour tab with the list of experiences"><figcaption></figcaption></figure>

{% hint style="warning" %}
The list only shows experiences of the connected project that meet both conditions:

* **Show on** is not **On shared URL**.
* **Where** is **Everywhere** or **Single URL**.
  {% endhint %}

Example: a user asks how to edit their profile. You launch your profile setup tour from the chat, and it guides them on the spot.

### User detail

The user's data from Jimo:

* **Basic information:** ID, username and email, last active, created.
* **Attributes:** every custom attribute of the user.
* **Segments:** the Jimo segments the user belongs to.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FTPGKUrK8FLBNXlEeYxT5%2Fimage.png?alt=media&amp;token=26b0f308-79d1-470e-aea7-8e99499d2a9e" alt="User detail tab"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FpwdWqnMBM61Pb5OyTHjZ%2Fimage.png?alt=media&amp;token=82be954d-3ac2-4b1d-9f62-bbb06b7e3924" alt="Attributes in the User detail tab"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FHpXrYXWHAFtWexFxVtMW%2Fimage.png?alt=media&amp;token=065d5365-8f02-42f3-8441-fb992b0b7cda" alt="Segments in the User detail tab"><figcaption></figcaption></figure>

It is the same view as the user's profile in [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md).

### User activity

A timeline of the user's interactions with Jimo experiences: tours and surveys started or completed, and other experiences they engaged with.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FszckUhZpyxIzXcsqcQ7v%2Fimage.png?alt=media&amp;token=50c6ad81-133a-4338-a361-d0c90565c7e9" alt="User activity timeline"><figcaption></figcaption></figure>

## Verify

Open a conversation with a user you know is in Jimo. The User detail tab shows their ID and attributes. If it is empty, check that you selected the right project.

## Limits

#### Web app only

The panel is available in the Crisp web app only.

#### Read-only on user data

The plugin shows Jimo data in Crisp. It does not update Jimo attributes from Crisp.

## Related

* [Escalation](https://help.usejimo.com/docs/experiences/agent/escalation.md)
* [Where](https://help.usejimo.com/docs/publish/target-specific-urls-domains-where.md)
* [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md)
