How do I install the Crisp skill?

Run npx skillmds@latest add modbender/crisp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Crisp safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Crisp?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Crisp free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Crisp by modbender — Agent Skill

Name: Crisp
Rating: 4.2 (5 reviews)
Author: modbender

Crisp

Customer support via Crisp API. Use when the user asks to check, read, search, or respond to Crisp inbox messages. Requires Crisp website ID and plugin token (authenticated via environment variables CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY).

modbender Updated Sep 9, 2026 12 repo stars

File contents

Crisp Customer Support

Crisp is a customer support platform. Use this skill when the user needs to:

Check for new messages in the inbox
Read conversation history
Search conversations
Send replies to customers
Check conversation status

Credentials

Crisp requires authentication via HTTP headers with a token identifier and key (Basic Auth), plus the website ID for the API URL.

Set these as environment variables (stored securely, never logged):

CRISP_WEBSITE_ID - Your website identifier (e.g., 0f4c...)
CRISP_TOKEN_ID - Your Plugin Token Identifier (e.g., e47d...)
CRISP_TOKEN_KEY - Your Plugin Token Key (e.g., a7d7...)

Common Workflows

Check Inbox Status

scripts/crisp.py inbox list --page 1

Read Conversation

scripts/crisp.py conversation get <session_id>

Get Messages in Conversation

scripts/crisp.py messages get <session_id>

Send a Reply

scripts/crisp.py message send <session_id> "Your reply text here"

Search Conversations

scripts/crisp.py conversations search "query terms" --filter unresolved --max 10

Mark as Read

scripts/crisp.py conversation read <session_id>

Resolve Conversation

scripts/crisp.py conversation resolve <session_id>

API Reference

Key endpoints used:

GET /v1/website/{website_id}/conversations/{page} - List conversations
GET /v1/website/{website_id}/conversation/{session_id} - Get conversation details
GET /v1/website/{website_id}/conversation/{session_id}/messages - Get messages
POST /v1/website/{website_id}/conversation/{session_id}/message - Send message
PATCH /v1/website/{website_id}/conversation/{session_id}/read - Mark as read
PATCH /v1/website/{website_id}/conversation/{session_id} - Update/resolve

Base URL: https://api.crisp.chat

Notes

Always ask before sending customer replies to confirm tone/content
Check for meta.email in conversation for customer email
Verify CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY are set before running commands
Use --json flag for script output when parsing programmatically

---name: crispdescription: Customer support via Crisp API. Use when the user asks to check, read, search, or respond to Crisp inbox messages. Requires Crisp website ID and plugin token (authenticated via environment variables CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY).--- # Crisp Customer Support Crisp is a customer support platform. Use this skill when the user needs to: - Check for new messages in the inbox - Read conversation history - Search conversations - Send replies to customers - Check conversation status ## Credentials Crisp requires authentication via HTTP headers with a token identifier and key (Basic Auth), plus the website ID for the API URL. Set these as environment variables (stored securely, never logged): - `CRISP_WEBSITE_ID` - Your website identifier (e.g., `0f4c...`) - `CRISP_TOKEN_ID` - Your Plugin Token Identifier (e.g., `e47d...`) - `CRISP_TOKEN_KEY` - Your Plugin Token Key (e.g., `a7d7...`) ## Common Workflows ### Check Inbox Status ```bash scripts/crisp.py inbox list --page 1 ``` ### Read Conversation ```bash scripts/crisp.py conversation get <session_id> ``` ### Get Messages in Conversation ```bash scripts/crisp.py messages get <session_id> ``` ### Send a Reply ```bash scripts/crisp.py message send <session_id> "Your reply text here" ``` ### Search Conversations ```bash scripts/crisp.py conversations search "query terms" --filter unresolved --max 10 ``` ### Mark as Read ```bash scripts/crisp.py conversation read <session_id> ``` ### Resolve Conversation ```bash scripts/crisp.py conversation resolve <session_id> ``` ## API Reference Key endpoints used: - `GET /v1/website/{website_id}/conversations/{page}` - List conversations - `GET /v1/website/{website_id}/conversation/{session_id}` - Get conversation details - `GET /v1/website/{website_id}/conversation/{session_id}/messages` - Get messages - `POST /v1/website/{website_id}/conversation/{session_id}/message` - Send message - `PATCH /v1/website/{website_id}/conversation/{session_id}/read` - Mark as read - `PATCH /v1/website/{website_id}/conversation/{session_id}` - Update/resolve Base URL: `https://api.crisp.chat` ## Notes - Always ask before sending customer replies to confirm tone/content - Check for `meta.email` in conversation for customer email - Verify `CRISP_WEBSITE_ID`, `CRISP_TOKEN_ID`, and `CRISP_TOKEN_KEY` are set before running commands - Use `--json` flag for script output when parsing programmatically

Frequently asked questions