How do I install the Crisp skill?

Run npx skillmds@latest add kbarbel640-del/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.

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

Crisp by kbarbel640-del — Agent Skill

Name: Crisp
Rating: 4.5 (4 reviews)
Author: kbarbel640-del

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).

kbarbel640-del Updated Sep 8, 2026 1 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 SupportCrisp 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## CredentialsCrisp 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```bashscripts/crisp.py inbox list --page 1```### Read Conversation```bashscripts/crisp.py conversation get <session_id>```### Get Messages in Conversation```bashscripts/crisp.py messages get <session_id>```### Send a Reply```bashscripts/crisp.py message send <session_id> "Your reply text here"```### Search Conversations```bashscripts/crisp.py conversations search "query terms" --filter unresolved --max 10```### Mark as Read```bashscripts/crisp.py conversation read <session_id>```### Resolve Conversation```bashscripts/crisp.py conversation resolve <session_id>```## API ReferenceKey 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/resolveBase 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