发起呼叫（点击拨号）结束通话转接通话静音 / 取消静音实时通话数据典型流程：从 CRM 点击拨号

通话管理

通过您的软件发起通话（点击拨号）、结束进行中的通话、转接或静音。所有接口均需 API 密钥（权限范围 call; Authorization: Bearer bt_… 在请求头中，参见 API 安全）和 GET 通过该方法调用。

速率限制：每分钟 10 次请求。通话标识（call_uuid) begin_call 在响应和实时通话数据中返回。

GET发起呼叫（点击拨号）

先拨打指定的分机；分机接听后再拨打目标号码，双方接通。

GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567

参数	必填	说明
`Authorization` （标题）	是	`Bearer bt_…`，权限范围 `call`
`extension`	是	通话要接入的分机（例如 `1001`)
`destination`	是	被叫号码。土耳其境内请使用 `905321234567`，国际号码请用 `00` + 国家代码
`caller_id`	否	外呼时显示的号码；若未提供则使用分机默认值。不属于您账户的号码 `400` 返回
`manual_answer`	否	`true` 则需分机手动接听；若不提供，则在支持的设备上自动应答
`timeout`	否	振铃时长，10-60 秒（默认 30）
`announcement_to_caller`	否	连接时向分机播放的语音提示 ID
`announcement_to_callee`	否	连接时向被叫方播放的语音提示 ID

成功响应： 200 OK，响应正文中为通话标识。

358c20bc-fd86-11e5-87a2-157d41a07454

错误响应示例：

400 Bad Request   extension 1005 not found
400 Bad Request   caller_id 02120000000 not allowed
401 Unauthorized  Geçersiz anahtar: K…

GET结束通话

GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>

id 也接受路径形式来代替： /api/hangup/<call_uuid>。响应 200 OK.

GET转接通话

将进行中的通话转接到分机或外部号码。

GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002

参数	说明
`id`	通话标识
`user_number`	目标分机（例如 `1002`）或外部号码（`905321234567`)

GET静音 / 取消静音

GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=on

state: on （静音）或 off （开启声音）。

实时通话数据

进行中通话的列表（主叫、被叫、分机、状态、时长）可从 CRM 对接接口读取；来电时若要弹出客户卡片，请使用该数据或 Webhook。详情请通过帮助中心索取“CRM 对接”文档；Byfix CRM 的对接已就绪。

典型流程：从 CRM 点击拨号

1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir

← API 安全队列