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...) - INLINECODE2 - Your Plugin Token Identifier (e.g.,
e47d...) - INLINECODE4 - Your Plugin Token Key (e.g.,
a7d7...)
Common Workflows
Check Inbox Status
CODEBLOCK0
Read Conversation
CODEBLOCK1
Get Messages in Conversation
CODEBLOCK2
Send a Reply
CODEBLOCK3
Search Conversations
CODEBLOCK4
Mark as Read
CODEBLOCK5
Resolve Conversation
CODEBLOCK6
API Reference
Key endpoints used:
- -
GET /v1/website/{website_id}/conversations/{page} - List conversations - INLINECODE7 - Get conversation details
- INLINECODE8 - Get messages
- INLINECODE9 - Send message
- INLINECODE10 - Mark as read
- INLINECODE11 - Update/resolve
Base URL: INLINECODE12
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 客户支持
Crisp 是一个客户支持平台。当用户需要以下操作时，可使用此技能：
- - 查看收件箱中的新消息
- 阅读对话历史记录
- 搜索对话
- 向客户发送回复
- 查看对话状态
凭证信息
Crisp 需要通过 HTTP 标头进行身份验证，使用令牌标识符和密钥（基本认证），以及用于 API URL 的网站 ID。
请将这些设置为环境变量（安全存储，切勿记录）：
- - CRISPWEBSITEID - 您的网站标识符（例如：0f4c...）
- CRISPTOKENID - 您的插件令牌标识符（例如：e47d...）
- CRISPTOKENKEY - 您的插件令牌密钥（例如：a7d7...）
常见工作流程
查看收件箱状态
bash
scripts/crisp.py inbox list --page 1
阅读对话
bash
scripts/crisp.py conversation get
获取对话中的消息
bash
scripts/crisp.py messages get
发送回复
bash
scripts/crisp.py message send 在此输入您的回复文本
搜索对话
bash
scripts/crisp.py conversations search 查询词 --filter unresolved --max 10
标记为已读
bash
scripts/crisp.py conversation read
解决对话
bash
scripts/crisp.py conversation resolve
API 参考
使用的关键端点：
- - GET /v1/website/{websiteid}/conversations/{page} - 列出对话
- GET /v1/website/{websiteid}/conversation/{sessionid} - 获取对话详情
- GET /v1/website/{websiteid}/conversation/{sessionid}/messages - 获取消息
- POST /v1/website/{websiteid}/conversation/{sessionid}/message - 发送消息
- PATCH /v1/website/{websiteid}/conversation/{sessionid}/read - 标记为已读
- PATCH /v1/website/{websiteid}/conversation/{session_id} - 更新/解决
基础 URL：https://api.crisp.chat
注意事项
- - 在发送客户回复前，务必先确认语气和内容
- 检查对话中的 meta.email 以获取客户邮箱
- 运行命令前，请确认 CRISPWEBSITEID、CRISPTOKENID 和 CRISPTOKENKEY 已设置
- 以编程方式解析脚本输出时，请使用 --json 标志
