crisp – OpenClaw Skill

---

name: crisp description: 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

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

Crisp Skill for Clawdbot

This skill allows your AI agent to interact with Crisp customer support directly (read inbox, reply to customers, search history).

Setup

1. Copy the folder

Place the crisp folder into your Clawdbot skills directory (e.g., ~/clawd/skills/crisp).

2. Get Your Crisp Credentials

You need to create a Crisp Plugin Token to authenticate with the API.

Steps:

1. Go to Crisp Marketplace
2. Click "Create a Private Plugin"
3. Choose a name for your plugin (e.g., "My Clawdbot Integration")
4. Request a Development Token (instant) or Production Token (requires approval)
5. Required scopes when creating the token:
   • ✅ website:conversation:sessions (Read)
   • ✅ website:conversation:messages (Read/Write)
   • ✅ website:conversation:actions (Read/Write)
6. Copy your Token Identifier and Token Key
7. Get your Website ID from the Crisp dashboard URL (e.g., https://app.crisp.chat/website/YOUR_WEBSITE_ID/...)

3. Configure Environment Variables

Add these to your shell profile (.zshrc or .bashrc) or export them before running Clawdbot:

export CRISP_WEBSITE_ID='YOUR_WEBSITE_ID'
export CRISP_TOKEN_ID='YOUR_TOKEN_IDENTIFIER'
export CRISP_TOKEN_KEY='YOUR_TOKEN_KEY'

Example:

export CRISP_WEBSITE_ID='abc12345-1234-5678-90ab-cdef12345678'
export CRISP_TOKEN_ID='e47d4438-f169-4487-86fc-fe2406a382b3'
export CRISP_TOKEN_KEY='a7d7103c3352683d0cdf7bf17f782facb6e41583a8906da1e05aaf9b91fcc40e'

4. Install Dependencies

The script uses Python 3 and the requests library.

pip3 install requests

Usage

Once set up, you can ask your agent:

• "Check my Crisp inbox"
• "Draft a reply to the customer about X"
• "What was the last conversation with [email]?"
• "Show me unresolved conversations"
• "Send a message to session_xyz saying 'Thanks for reaching out!'"

Troubleshooting

❌ "CRISP_WEBSITE_ID, CRISP_TOKEN_ID, and CRISP_TOKEN_KEY environment variables required"

• Make sure you've exported the environment variables in your current shell session
• Run echo $CRISP_WEBSITE_ID to verify it's set

❌ "Error: invalid_data"

• Check that your Website ID is correct
• Verify your token has the required scopes

❌ "Error: unauthorized" or "Error: forbidden"

• Your token may have expired or been revoked
• Regenerate a new token in the Crisp Marketplace

Manual Testing

You can test the CLI directly:

# List inbox
python3 /path/to/skills/crisp/scripts/crisp.py inbox list --page 1 --max 5

# Search conversations
python3 /path/to/skills/crisp/scripts/crisp.py conversations search "email@example.com" --max 3

# Get messages from a conversation
python3 /path/to/skills/crisp/scripts/crisp.py messages get session_abc123 --max 10