名称: crisp
描述: 通过 Crisp API 提供客户支持。当用户需要查看、阅读、搜索或回复 Crisp 收件箱消息时使用此技能。需要 Crisp 网站 ID 和插件令牌(通过环境变量 CRISP_WEBSITE_ID、CRISP_TOKEN_ID 和 CRISP_TOKEN_KEY 进行身份验证)。
Crisp 是一个客户支持平台。当用户需要以下操作时,请使用此技能:
- 检查收件箱中的新消息
- 阅读对话历史记录
- 搜索对话
- 向客户发送回复
- 检查对话状态
Crisp 需要通过 HTTP 头部使用令牌标识符和密钥(Basic Auth)进行身份验证,同时 API URL 中需要包含网站 ID。
请将以下信息设置为环境变量(安全存储,切勿记录):
- CRISP_WEBSITE_ID - 您的网站标识符(例如:0f4c...)
- CRISP_TOKEN_ID - 您的插件令牌标识符(例如:e47d...)
- CRISP_TOKEN_KEY - 您的插件令牌密钥(例如:a7d7...)
scripts/crisp.py inbox list --page 1
scripts/crisp.py conversation get <session_id>
scripts/crisp.py messages get <session_id>
scripts/crisp.py message send <session_id> "您要回复的文本内容"
scripts/crisp.py conversations search "搜索关键词" --filter unresolved --max 10
scripts/crisp.py conversation read <session_id>
scripts/crisp.py conversation resolve <session_id>
使用的主要端点:
- GET /v1/website/{website_id}/conversations/{page} - 列出对话
- GET /v1/website/{website_id}/conversation/{session_id} - 获取对话详情
- GET /v1/website/{website_id}/conversation/{session_id}/messages - 获取消息
- POST /v1/website/{website_id}/conversation/{session_id}/message - 发送消息
- PATCH /v1/website/{website_id}/conversation/{session_id}/read - 标记为已读
- PATCH /v1/website/{website_id}/conversation/{session_id} - 更新/解决对话
基础 URL:https://api.crisp.chat
meta.email 以获取客户邮箱CRISP_WEBSITE_ID、CRISP_TOKEN_ID 和 CRISP_TOKEN_KEY 已正确设置--json 标志