返回首页
企业对接

对接到你的客服体系

知心支持 8 种主流接入方式,覆盖网页、公众号、企业微信、钉钉、API、Webhook、CRM、工单系统。 按下方步骤操作即可完成对接,无需专业开发能力。

选择接入方式

详细接入步骤

网页 Widget
简单
在任意网站嵌入悬浮客服按钮,客户点击即可发起对话。支持自定义样式与位置。
  1. 1

    获取 Widget Token

    在控制台 → 渠道管理 → 网页 Widget 中创建渠道,复制 Token。

  2. 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. 3

    域名白名单

    在渠道配置中添加您的域名(如 https://yourdomain.com),防止 Token 被盗用。

  4. 4

    验证

    刷新网页,右下角应出现客服悬浮按钮。点击即可发起对话。

微信公众号
中等
接入微信公众号,客户在公众号内即可与 AI/人工客服对话。支持文本、图片、语音消息。
  1. 1

    申请公众号

    需要已认证的服务号(订阅号权限受限)。在微信公众平台 → 基本配置中获取 AppID、AppSecret。

  2. 2

    配置回调 URL

    在知心控制台 → 渠道管理 → 微信公众号中创建渠道,填入 AppID/AppSecret,获得回调 URL。

  3. 3

    微信侧配置

    在微信公众平台 → 基本配置 → 服务器配置中,URL 填入回调地址,Token 与 EncodingAESKey 与控制台一致。

    URL:      https://api.askzhixin.com/api/channels/wechat_official/callback/{tenantId}
    Token:    在控制台生成
    EncodingAESKey: 在控制台生成
    消息加解密方式: 兼容模式
  4. 4

    启用服务器配置

    在微信公众平台启用服务器配置,微信公众号即可接收并自动回复客户消息。

企业微信
中等
接入企业微信,员工/客户在企业微信内即可使用 AI 客服。支持会话存档、客户联系 API。
  1. 1

    创建企业微信应用

    登录企业微信管理后台 → 应用管理 → 自建应用,记录 CorpID、AgentID、Secret。

  2. 2

    配置回调域名

    在应用详情 → 接收消息 → 设置 API 接收,回调 URL 填入知心回调地址。

    URL: https://api.askzhixin.com/api/channels/wecom/callback/{tenantId}
    Token: 在控制台生成
    EncodingAESKey: 在控制台生成
  3. 3

    在知心控制台绑定

    控制台 → 渠道管理 → 企业微信 → 新建渠道,填入 CorpID、AgentID、Secret、Token、EncodingAESKey。

  4. 4

    配置可信域名

    在企业微信应用配置中,可信域名填入 your-domain.com,下载验证文件放置在域名根目录。

  5. 5

    会话存档(可选)

    如需会话内容审计,开启会话存档功能,并配置 RSA 公钥。知心支持自动归档所有会话。

钉钉
中等
接入钉钉企业内部应用或机器人,员工在钉钉内可咨询 AI 客服。
  1. 1

    创建钉钉应用

    登录钉钉开放平台 → 应用开发 → 企业内部应用,记录 AppKey、AppSecret。

  2. 2

    配置消息回调

    在应用 → 事件订阅中,配置消息卡片回调地址。

    URL: https://api.askzhixin.com/api/channels/dingtalk/callback/{tenantId}
    Token: 控制台生成
    AES Key: 控制台生成
  3. 3

    在知心控制台绑定

    控制台 → 渠道管理 → 钉钉 → 新建渠道,填入 AppKey、AppSecret、Robot Code。

  4. 4

    发布应用

    在钉钉开放平台发布应用,员工即可在工作台看到客服入口。

REST API
进阶
直接调用 REST API 集成到自有系统。支持对话、知识库、工单、坐席管理全功能。
  1. 1

    获取 API Key

    控制台 → 设置 → API 密钥 → 创建密钥,记录 sk-xxxx。

  2. 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. 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. 4

    查询历史

    查询对话历史、消息记录、情感分析结果。

    curl https://api.askzhixin.com/api/chat/conversations/{convId}/messages \
      -H "Authorization: Bearer sk-xxxx"
Webhook 事件
中等
订阅对话、工单、转人工等事件,知心会主动推送到你的回调地址。可用于同步 CRM、触发工作流。
  1. 1

    准备回调地址

    在你的服务端准备一个 HTTPS POST 接口,能接收 JSON 数据。

  2. 2

    在控制台配置

    控制台 → 设置 → Webhook → 新建,填入回调 URL,选择订阅事件。

    订阅事件示例:
    - conversation.created       新对话创建
    - message.received           收到客户消息
    - emotion.escalated          情感升级
    - escalation.triggered       触发转人工
    - escalation.assigned        坐席分配
    - conversation.closed        会话关闭
    - ticket.created             工单创建
  3. 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. 4

    响应 200

    收到推送后 3 秒内返回 HTTP 200,否则会重试(最多 3 次,间隔 5/30/300 秒)。

CRM / 客户系统同步
进阶
将知心客户数据与现有 CRM(Salesforce、HubSpot、自研 CRM)双向同步,统一客户视图。
  1. 1

    通过 Webhook 接收客户事件

    订阅 conversation.closed 事件,将客户对话历史与情感分析结果同步到 CRM。

  2. 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. 3

    同步工单到 CRM

    知心创建工单后,通过 Webhook 同步到 CRM 工单系统,统一跟进。

  4. 4

    使用外部 ID 关联

    在知心客户 metadata 中存储 CRM 客户 ID,建立双向关联,便于跨系统查询。

工单系统集成
中等
将知心工单与 Jira、Zendesk、Freshdesk 等工单系统集成,统一工单流转。
  1. 1

    订阅工单事件

    通过 Webhook 订阅 ticket.created 事件,知心自动创建工单时会推送。

  2. 2

    在工单系统创建对应工单

    收到 Webhook 后,调用工单系统 API 创建对应工单,记录知心工单 ID。

  3. 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 账号或自建服务器,数据完全自主可控。如需私有化部署方案,请联系我们

需要协助对接?

我们的团队提供 1 对 1 对接支持,帮助快速集成到你的客服体系。