开始使用

sem.chat API 允许您以编程方式管理对话、发送消息和访问分析。所有 API 请求都需要使用 API 密钥进行身份验证。

基地 URL

https://api.sem.chat/v1

认证

在所有请求的授权标头中包含您的 API 密钥:

Authorization: Bearer your_api_key_here

对话

列出对话

GET /对话

检索您帐户的所有对话列表。

参数 类型 描述
限制 整数 要返回的结果数(最多 100)
偏移量 整数 要跳过的结果数
状态 字符串 按状态过滤:活动、已关闭、待处理

进行对话

GET /对话/{id}

检索特定对话的详细信息,包括所有消息。

创建对话

POST /对话

以编程方式开始新对话。

留言

发送消息

POST /对话/{id}/消息

向现有对话发送消息。

// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" }

网络钩子

设置 Webhooks 以接收有关对话事件的实时通知。

可用的活动

活动 描述
对话.开始 新的对话已经开始
已收到消息 收到一位访客发来的新消息
对话.关闭 对话已结束
捕获铅 联系信息已被收集

速率限制

API 请求受到限制以确保公平使用:

计划 速率限制
试用 100 个请求/小时
专业版 1,000 个请求/小时
商务 10,000 个请求/小时