ping · bots sessions · session notes · POST note_done appointments · POST appointment_status history · memory task_start — 任务呼叫 task · tasks embed_url — 嵌入实时界面 faq_suggestions 将助手连接到您的 CRM Webhook

语音助手

读取助手的通话、备注和预约；在 CRM 中发起任务呼叫（报价/催款）；将实时通话界面嵌入您自己的软件。 集成密钥 (bt_…，权限范围 voicebot 或 autocall).

接口： https://api.buluthat.com/api/voicebot_api.php?action=<işlem> — 读取 GET，更改 POST。参数可通过 query、form 或 JSON 正文发送。

GETping · bots

GET https://api.buluthat.com/api/voicebot_api.php?action=bots

{ "ok": true, "data": [ { "id": 3, "name": "Teknik Servis Asistanı", "status": "active", "language": "tr" } ] }

GETsessions · session

通话列表及单次通话的摘要。

参数	说明
`bot_id`	助手筛选
`from`, `to`	日期范围（`Y-m-d`)
`outcome`	结果筛选（`resolved`, `transferred`, `note`, `appointment`, `failed` …)
`caller`	主叫号码
`limit`, `offset`	分页（最多 200）

{ "ok": true, "data": [ {
  "id": 8812, "bot_id": 3, "direction": "inbound", "caller_number": "05321234567",
  "started_at": "2026-09-18 10:12:03", "duration_seconds": 84, "status": "ended",
  "summary": "Arayan robot süpürgesinin servis durumunu sordu; parça bekleniyor bilgisi verildi.",
  "intent": "servis_durumu", "sentiment_label": "notr", "outcome": "resolved"
} ] }

action=session&id=8812 返回单条记录及其工具调用和结果字段； action=session_messages&id=8812 返回完整记录（角色、文本、时间）。

GETnotes · POST note_done

助手记录的备注和回电请求。

GET  https://api.buluthat.com/api/voicebot_api.php?action=notes&status=new
POST https://api.buluthat.com/api/voicebot_api.php?action=note_done   { "id": 512 }

备注类型： note, callback, approval （价格确认）。 note_done 关闭该备注。

GETappointments · POST appointment_status

GET  ?action=appointments&from=2026-09-18
POST ?action=appointment_status   { "id": 77, "status": "done" }     // booked | cancelled | done

GEThistory · memory

history 某个号码在所有助手中的历史通话（记忆来源）， memory 返回提供给助手的该号码的记忆文本——用于排查“助手为什么这么说”。

GET ?action=history&phone=05321234567&limit=20
GET ?action=memory&phone=05321234567

POSTtask_start — 任务呼叫

让助手立即致电客户：维修报价（quote）或自由任务（brief）。报价时会保留底价；若客户要求低于底价，助手会请示授权人（“我请示一下负责人再回复您”）。

curl -X POST "https://api.buluthat.com/api/voicebot_api.php?action=task_start" \
  -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \
  -d '{
    "bot_id": 3, "phone": "05321234567", "caller_id": "02124119610",
    "kind": "quote", "customer_name": "Ayşe Yılmaz", "external_ref": "SERVIS-48211",
    "title": "Robot süpürge onarım teklifi",
    "brief": "Batarya değişimi gerekiyor. Cihaz garanti dışı. Teslim 3 iş günü.",
    "offer_price": 3500, "floor_price": 2900, "currency": "TRY",
    "payment_options": "online,havale",
    "fields": { "cihaz": "Roborock S7", "takip_no": "7K2M9QX4AB" }
  }'

区域	必填	说明
`bot_id`	是	负责呼叫的助手
`phone`	是	被叫号码
`kind`	是	`quote` （报价）或 `brief` （自由任务）
`brief`	是	助手需要了解的背景（诊断、条件）
`offer_price`, `floor_price`	用于 quote	起始报价以及可让步的底价；底价不会告知客户，并且在服务器端同样强制执行
`payment_options`	否	`online,havale` → 接受后询问付款方式
`caller_id`, `trunk_slug`	否	主叫号码与线路（`caller_ids` / `trunks` 列出）
`external_ref`	否	您自己录音的标识（`tasks` 用于查找）
`followup_of`, `decision`, `decision_note`	否	授权人决定后的回电： `approved` / `counter` / `rejected`

响应： { "ok": true, "data": { "id": 91, "status": "calling", … }, "embed_url": "https://…/api/voicebot_embed.php?t=…" }

GETtask · tasks

GET ?action=task&id=91
GET ?action=tasks&external_ref=SERVIS-48211

任务状态： calling → active → ended; failed （无法接通）。结果字段： outcome (accepted, rejected, manager_approval, callback, not_reached), agreed_price, requested_price, payment_method, summary, callback_time.

GETembed_url — 嵌入实时界面

生成有时效的签名地址，用于将通话的实时/历史 Messenger 界面通过 iframe 嵌入您的软件；无需面板登录。

GET ?action=embed_url&phone=05321234567&label=crm&ttl=43200

参数	说明
`phone`	界面仅显示此号码的通话（并仅对其下达指令）
`task_id` / `session_id`	特定任务或通话
`listener_extension`	用于“监听”的分机
`ttl`	秒（默认 12 小时）

到 iframe allow="microphone" 请提供；授权人耳语功能使用浏览器自带的语音识别（Chrome/Edge）。

GETfaq_suggestions

从通话中挖掘出的问答建议（待确认）。确认在面板中完成。

将助手连接到您的 CRM

要让助手在您的系统中查找/创建记录，请在助手表单中定义 REST 工具（URL、方法、请求头、参数）。Byfix CRM 已有现成的对接；对于您自己的 CRM，只需提供根据号码查询客户和创建记录的接口。详情： CRM 集成.

Webhook

通话结束后 session_ended 将发送该事件（摘要、结果、工具调用）。参见 Webhook.

← 自动外呼语音验证 (OTP)