crisp

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