crisp
Access Crisp conversations, send messages, manage contacts, and handle customer support chats through the Crisp API
Quick Install
npm install @openpets/crisp pnpm add @openpets/crisp Required Environment Variables
-
CRISP_IDENTIFIERCrisp plugin token identifier
-
CRISP_KEYCrisp 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
list all conversations - 2
show me recent chats
send message
- 1
send hello to conversation session_abc123 - 2
reply to the customer
manage state
- 1
resolve conversation session_abc123 - 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.
Related Plugins
discord
Search and read messages from Discord servers, list channels, send messages using a Discord bot, and connect personal Discord accounts via mautrix-discord Matrix bridge
telegram
Interact with Telegram via Bot API or connect personal accounts through mautrix-telegram Matrix bridge
slack
Slack integration plugin for OpenCode - search channels, read messages, and post to Slack