CR

crisp

Open Source CommunicationSupport

Access Crisp conversations, send messages, manage contacts, and handle customer support chats through the Crisp API

crisp chat customer-support messaging conversations

Quick Install

npm install @openpets/crisp
pnpm add @openpets/crisp

Required Environment Variables

  • CRISP_IDENTIFIER

    Crisp plugin token identifier

  • CRISP_KEY

    Crisp plugin token key

Available Tools (15)

These tools are available when you install the crisp plugin in your AI assistant.

crisp-list-conversations

List conversations for a Crisp website. Returns paginated list of chat conversations with their status, participants, and metadata.

crisp-get-conversation

Get details of a specific conversation including messages, metadata, and participant info.

crisp-get-messages

Get messages from a conversation. Returns the message history with content, timestamps, and sender info.

crisp-send-message

Send a message in a conversation. Can send text, files, or other message types as an operator.

crisp-get-conversation-metas

Get metadata for a conversation including user info, segments, custom data, and contact details.

crisp-update-conversation-metas

Update metadata for a conversation. Can update nickname, email, segments, and custom data.

crisp-change-conversation-state

Change the state of a conversation. States: pending, unresolved, resolved.

crisp-create-conversation

Create a new conversation in Crisp.

crisp-list-people

List people profiles for a website. These are your end-users/contacts.

crisp-get-person

Get a person

crisp-get-routing-assign

Get the routing assignment for a conversation (who it

crisp-assign-conversation

Assign a conversation to a specific operator.

crisp-mark-messages-read

Mark messages as read in a conversation.

crisp-list-operators

List all operators for a website.

crisp-get-website

Get details about a Crisp website.

Example Queries

list conversations from crisp
get messages from conversation
send a message to customer
list people in crisp
resolve this conversation

Usage Scenarios

list conversations

  1. 1 list all conversations
  2. 2 show me recent chats

send message

  1. 1 send hello to conversation session_abc123
  2. 2 reply to the customer

manage state

  1. 1 resolve conversation session_abc123
  2. 2 mark conversation as pending

Optional Configuration

Variable Description
CRISP_WEBSITE_ID Default website ID to use for operations

Use crisp with Your AI Assistant

This open source plugin works with OpenCode-compatible AI assistants including ChatGPT, Claude, Perplexity, and other LLM-powered coding tools. Install the plugin and start using natural language to interact with crisp.

Works with ChatGPT Works with Claude Works with Perplexity MCP Compatible