Crisp Skill

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