برقراری تماس (کلیک برای تماس)پایان تماس انتقال تماس بی‌صدا کردن / فعال کردن صدا داده تماس زنده جریان معمول: کلیک برای تماس از 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`	خیر	شناسه اعلانی که هنگام اتصال برای داخلی پخش می‌شود
`announcement_to_callee`	خیر	شناسه اعلانی که هنگام اتصال برای شماره مورد تماس پخش می‌شود

پاسخ موفق: 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 صف‌ها