选择接入方式
网页 Widget
网站接入
在任意网站嵌入悬浮客服按钮,客户点击即可发起对话。支持自定义样式与位置。
微信公众号
公众号接入
接入微信公众号,客户在公众号内即可与 AI/人工客服对话。支持文本、图片、语音消息。
企业微信
企业微信接入
接入企业微信,员工/客户在企业微信内即可使用 AI 客服。支持会话存档、客户联系 API。
钉钉
钉钉接入
接入钉钉企业内部应用或机器人,员工在钉钉内可咨询 AI 客服。
REST API
API 集成
直接调用 REST API 集成到自有系统。支持对话、知识库、工单、坐席管理全功能。
Webhook 事件
事件订阅
订阅对话、工单、转人工等事件,知心会主动推送到你的回调地址。可用于同步 CRM、触发工作流。
CRM / 客户系统同步
系统集成
将知心客户数据与现有 CRM(Salesforce、HubSpot、自研 CRM)双向同步,统一客户视图。
工单系统集成
系统集成
将知心工单与 Jira、Zendesk、Freshdesk 等工单系统集成,统一工单流转。
详细接入步骤
- 1
获取 Widget Token
在控制台 → 渠道管理 → 网页 Widget 中创建渠道,复制 Token。
- 2
嵌入代码
将以下代码粘贴到网站 <body> 标签底部,替换 YOUR_WIDGET_TOKEN。
<script> window.zhixinConfig = { token: 'YOUR_WIDGET_TOKEN', primaryColor: '#6366f1', position: 'right', // left | right greeting: '您好,有什么可以帮您?', }; </script> <script src="https://cdn.askzhixin.com/widget.js" async></script> - 3
域名白名单
在渠道配置中添加您的域名(如 https://yourdomain.com),防止 Token 被盗用。
- 4
验证
刷新网页,右下角应出现客服悬浮按钮。点击即可发起对话。
- 1
申请公众号
需要已认证的服务号(订阅号权限受限)。在微信公众平台 → 基本配置中获取 AppID、AppSecret。
- 2
配置回调 URL
在知心控制台 → 渠道管理 → 微信公众号中创建渠道,填入 AppID/AppSecret,获得回调 URL。
- 3
微信侧配置
在微信公众平台 → 基本配置 → 服务器配置中,URL 填入回调地址,Token 与 EncodingAESKey 与控制台一致。
URL: https://api.askzhixin.com/api/channels/wechat_official/callback/{tenantId} Token: 在控制台生成 EncodingAESKey: 在控制台生成 消息加解密方式: 兼容模式 - 4
启用服务器配置
在微信公众平台启用服务器配置,微信公众号即可接收并自动回复客户消息。
- 1
创建企业微信应用
登录企业微信管理后台 → 应用管理 → 自建应用,记录 CorpID、AgentID、Secret。
- 2
配置回调域名
在应用详情 → 接收消息 → 设置 API 接收,回调 URL 填入知心回调地址。
URL: https://api.askzhixin.com/api/channels/wecom/callback/{tenantId} Token: 在控制台生成 EncodingAESKey: 在控制台生成 - 3
在知心控制台绑定
控制台 → 渠道管理 → 企业微信 → 新建渠道,填入 CorpID、AgentID、Secret、Token、EncodingAESKey。
- 4
配置可信域名
在企业微信应用配置中,可信域名填入 your-domain.com,下载验证文件放置在域名根目录。
- 5
会话存档(可选)
如需会话内容审计,开启会话存档功能,并配置 RSA 公钥。知心支持自动归档所有会话。
- 1
创建钉钉应用
登录钉钉开放平台 → 应用开发 → 企业内部应用,记录 AppKey、AppSecret。
- 2
配置消息回调
在应用 → 事件订阅中,配置消息卡片回调地址。
URL: https://api.askzhixin.com/api/channels/dingtalk/callback/{tenantId} Token: 控制台生成 AES Key: 控制台生成 - 3
在知心控制台绑定
控制台 → 渠道管理 → 钉钉 → 新建渠道,填入 AppKey、AppSecret、Robot Code。
- 4
发布应用
在钉钉开放平台发布应用,员工即可在工作台看到客服入口。
- 1
获取 API Key
控制台 → 设置 → API 密钥 → 创建密钥,记录 sk-xxxx。
- 2
发起对话
通过 API 创建对话并发送消息。
curl -X POST https://api.askzhixin.com/api/chat/conversations \ -H "Authorization: Bearer sk-xxxx" \ -H "Content-Type: application/json" \ -d '{ "customer_name": "张三", "channel_type": "api" }' - 3
发送消息
在已有对话中发送消息,获取 AI 回复。
curl -X POST https://api.askzhixin.com/api/chat/conversations/{convId}/messages \ -H "Authorization: Bearer sk-xxxx" \ -H "Content-Type: application/json" \ -d '{ "content": "如何申请退款?", "role": "user" }' - 4
查询历史
查询对话历史、消息记录、情感分析结果。
curl https://api.askzhixin.com/api/chat/conversations/{convId}/messages \ -H "Authorization: Bearer sk-xxxx"
- 1
准备回调地址
在你的服务端准备一个 HTTPS POST 接口,能接收 JSON 数据。
- 2
在控制台配置
控制台 → 设置 → Webhook → 新建,填入回调 URL,选择订阅事件。
订阅事件示例: - conversation.created 新对话创建 - message.received 收到客户消息 - emotion.escalated 情感升级 - escalation.triggered 触发转人工 - escalation.assigned 坐席分配 - conversation.closed 会话关闭 - ticket.created 工单创建 - 3
验证签名
知心会在 HTTP Header 中携带 X-Zhixin-Signature,使用 Webhook Secret 校验数据完整性。
Header: X-Zhixin-Signature: sha256=xxxxxx Body: { "event": "escalation.triggered", "data": {...} } 校验: expected = HMAC-SHA256(rawBody, webhookSecret) if (expected !== signature) return 401; - 4
响应 200
收到推送后 3 秒内返回 HTTP 200,否则会重试(最多 3 次,间隔 5/30/300 秒)。
- 1
通过 Webhook 接收客户事件
订阅 conversation.closed 事件,将客户对话历史与情感分析结果同步到 CRM。
- 2
调用知心 API 同步 CRM 客户
从 CRM 拉取客户列表,写入知心客户库,建立 vip_level、tags 等画像字段。
curl -X POST https://api.askzhixin.com/api/customers \ -H "Authorization: Bearer sk-xxxx" \ -d '{ "name": "张三", "email": "zhangsan@example.com", "phone": "138****5678", "vip_level": 3, "tags": ["高价值", "退款"] }' - 3
同步工单到 CRM
知心创建工单后,通过 Webhook 同步到 CRM 工单系统,统一跟进。
- 4
使用外部 ID 关联
在知心客户 metadata 中存储 CRM 客户 ID,建立双向关联,便于跨系统查询。
- 1
订阅工单事件
通过 Webhook 订阅 ticket.created 事件,知心自动创建工单时会推送。
- 2
在工单系统创建对应工单
收到 Webhook 后,调用工单系统 API 创建对应工单,记录知心工单 ID。
- 3
状态回写
工单系统状态变更时,调用知心 API 更新工单状态,保持双向同步。
curl -X PATCH https://api.askzhixin.com/api/tickets/{ticketId} \ -H "Authorization: Bearer sk-xxxx" \ -d '{ "status": "resolved", "resolution": "已退款" }'
Q: 接入是否需要专业开发人员?
网页 Widget 接入无需开发,复制代码粘贴即可。公众号、企业微信、钉钉接入需要对应平台的管理员权限。API/Webhook 集成需要后端开发。
Q: 个人微信能接入吗?
不建议接入个人微信,因违反微信用户协议有封号风险。推荐使用公众号或企业微信,两者均为官方支持的接入方式。
Q: 数据隔离如何保证?
知心采用多租户架构,所有数据按 tenant_id 隔离。你的客户数据、对话、知识库完全独立,不会与其他租户共享。
Q: 支持私有化部署吗?
支持。知心可部署到企业自有 Cloudflare 账号或自建服务器,数据完全自主可控。如需私有化部署方案,请联系我们。