通話の開始（クリックで発信）通話を終了通話を転送ミュート / ミュート解除リアルタイム通話データ典型的な流れ：CRMからクリックで発信

通話管理

ソフトウェアから通話を開始し（クリックで発信）、進行中の通話を終了、転送、またはミュートできます。すべてのエンドポイントはAPIキー（スコープ call; Authorization: Bearer bt_… ヘッダーで、参照： APIセキュリティ）および GET メソッドで呼び出します。

レート制限：1分あたり10リクエスト。通話ID（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、本文に通話ID。

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`	通話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セキュリティ列