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