مرکز توسعه‌دهندگان

سانترال‌تان را بخشی از نرم‌افزارتان کنید.

یک کلید API، HTTP ساده، پاسخ‌های JSON. از کلیک برای تماس و کنترل تماس تا کمپین‌های تماس خودکار، از مأموریت‌های دستیار صوتی تا کد تأیید صوتی همه REST است؛ نتایج با Webhookهای امضاشده با HMAC برمی‌گردد.

شروع سریع

اولین درخواست شما در 2 دقیقه

کلید خود را از تب پنل > تماس خودکار > API (یا از تنظیمات سانترال) بگیرید؛ با هدر Bearer، X-Api-Key یا ?key= ارسال کنید.

  • کلید به حساب مشتری شما وصل است؛ به داده مشتری دیگر دسترسی ندارد.
  • عملیات خواندن GET، عملیات تغییردهنده POST؛ بدنه JSON یا فرم.
  • پاسخ خطا همیشه {"ok":false,"error":"…","code":"…"} به‌صورت است.
  • محدودیت نرخ: 120 درخواست در دقیقه برای هر کلید؛ در صورت تجاوز 429.
# کلیک برای تماس: ابتدا داخلی 1001 زنگ می‌خورد، با پاسخ‌دادن مقصد شماره‌گیری می‌شود curl "https://api.buluthat.com/api/begin_call.php?key=K1234-…&extension=1001&destination=905321234567" # ساخت کمپین curl -X POST "https://api.buluthat.com/api/autocall.php?action=create_campaign" \ -H "Authorization: Bearer bt_xxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"name":"Ödeme hatırlatma","campaign_type":"ivr", "tts_template":"Merhaba {sayin}, {tutar} tutarındaki ödemeniz…", "digit_labels":{"1":"Ödedim","2":"Yetkili"}}' # ارسال کد تأیید صوتی curl -X POST "https://api.buluthat.com/api/voice_otp.php?action=send" \ -H "X-Api-Key: bt_xxxxxxxx" -d "phone=905321234567" → {"ok":true,"id":8812,"code":"472915","expires_in":300}
مستندات

هدرهای API

در هر عنوان نشانی نقطه پایانی، پارامترها، نمونه درخواست و پاسخ.

نمای کلی

احراز هویت، قالب درخواست، کدهای خطا، محدودیت نرخ

بخوانید
امنیت API

کلیدها، دامنه‌ها، IP مجاز، امضای درخواست با HMAC، تمدید کلید، گزارش درخواست‌ها

بخوانید
مدیریت تماس

کلیک برای تماس، پایان، انتقال، بی‌صدا کردن

بخوانید
صف‌ها

فهرست صف، منتظران، افزودن/حذف عضو

بخوانید
وضعیت نمایندگان

وضعیت داخلی‌ها و عضویت در صف

بخوانید
لیست سیاه

فهرست، افزودن و حذف شماره‌های مسدود

بخوانید
فایل‌های صوتی

فهرست اعلان‌ها، بارگذاری، به‌روزرسانی، حذف

بخوانید
تماس خودکار

ساخت کمپین، افزودن شماره، دریافت نتیجه، Webhook

بخوانید
دستیار صوتی

گفتگوها، یادداشت‌ها، نوبت‌ها، تماس مأموریتی، جاسازی

بخوانید
تأیید صوتی (OTP)

ارسال کد، تأیید، وضعیت، Webhook

بخوانید
API SMS

SMS انبوه / شخصی‌سازی‌شده، SMS OTP، گزارش تحویل، SMS ورودی، لیست سیاه

بخوانید
Webhookها

تأیید امضا، سیاست تکرار، طرح‌واره رویدادها

بخوانید
جاسازی (iframe CRM)

در صفحه‌های سانtral و نرم‌افزار وب‌فون شما: کد، لینک امضا شده، رویدادهای JavaScript

بخوانید
Webhookها

نتایج به شما بیاید، شما نپرسید.

نتیجه تماس خودکار، خلاصه گفتگوی دستیار صوتی، وضعیت کد تأیید — هر رویداد به‌صورت JSON به نشانی شما POST می‌شود؛ هدر X-Buluthat-Signature امضای HMAC-SHA256 است. تحویل ناموفق با فاصله‌های 1 دقیقه → 6 ساعت دوباره تلاش می‌شود.

مستندات Webhook
// PHP: تأیید امضا $raw = file_get_contents('php://input'); $sig = $_SERVER['HTTP_X_BULUTHAT_SIGNATURE'] ?? ''; $calc = hash_hmac('sha256', $raw, $secret); if (!hash_equals($calc, $sig)) { http_response_code(401); exit; } $event = json_decode($raw, true); // $event['event'] = 'call_finished' | 'session_ended' | 'otp_result' …
پل Byfix CRM

دستیار صوتی در CRM مشتری را پیدا می‌کند، پرونده سرویس باز می‌کند، یادداشت می‌گذارد؛ از CRM «تماس با دستیار» شروع می‌شود. آماده، یک کلید.

جزئیات
کلاینت PHP

کلاس PHP آماده برای کد تأیید صوتی؛ با دو خط ارسال/تأیید کنید. چون نقاط دیگر HTTP ساده است از هر زبانی فراخوانی می‌شود.

نمونه
صفحه زنده قابل جاسازی

متن زنده گفتگوی دستیار در CRM به‌صورت iframe؛ با توکن امضاشده و زمان‌دار، بدون نیاز به نشست پنل.

embed_url