سانترالتان را بخشی از نرمافزارتان کنید.
یک کلید API، HTTP ساده، پاسخهای JSON. از کلیک برای تماس و کنترل تماس تا کمپینهای تماس خودکار، از مأموریتهای دستیار صوتی تا کد تأیید صوتی همه REST است؛ نتایج با Webhookهای امضاشده با HMAC برمیگردد.
اولین درخواست شما در 2 دقیقه
کلید خود را از تب پنل > تماس خودکار > API (یا از تنظیمات سانترال) بگیرید؛ با هدر Bearer، X-Api-Key یا ?key= ارسال کنید.
- کلید به حساب مشتری شما وصل است؛ به داده مشتری دیگر دسترسی ندارد.
- عملیات خواندن GET، عملیات تغییردهنده POST؛ بدنه JSON یا فرم.
- پاسخ خطا همیشه
{"ok":false,"error":"…","code":"…"}بهصورت است. - محدودیت نرخ: 120 درخواست در دقیقه برای هر کلید؛ در صورت تجاوز 429.
هدرهای API
در هر عنوان نشانی نقطه پایانی، پارامترها، نمونه درخواست و پاسخ.
نمای کلی
احراز هویت، قالب درخواست، کدهای خطا، محدودیت نرخ
بخوانیدامنیت API
کلیدها، دامنهها، IP مجاز، امضای درخواست با HMAC، تمدید کلید، گزارش درخواستها
بخوانیدمدیریت تماس
کلیک برای تماس، پایان، انتقال، بیصدا کردن
بخوانیدصفها
فهرست صف، منتظران، افزودن/حذف عضو
بخوانیدوضعیت نمایندگان
وضعیت داخلیها و عضویت در صف
بخوانیدلیست سیاه
فهرست، افزودن و حذف شمارههای مسدود
بخوانیدفایلهای صوتی
فهرست اعلانها، بارگذاری، بهروزرسانی، حذف
بخوانیدتماس خودکار
ساخت کمپین، افزودن شماره، دریافت نتیجه، Webhook
بخوانیددستیار صوتی
گفتگوها، یادداشتها، نوبتها، تماس مأموریتی، جاسازی
بخوانیدتأیید صوتی (OTP)
ارسال کد، تأیید، وضعیت، Webhook
بخوانیدAPI SMS
SMS انبوه / شخصیسازیشده، SMS OTP، گزارش تحویل، SMS ورودی، لیست سیاه
بخوانیدWebhookها
تأیید امضا، سیاست تکرار، طرحواره رویدادها
بخوانیدجاسازی (iframe CRM)
در صفحههای سانtral و نرمافزار وبفون شما: کد، لینک امضا شده، رویدادهای JavaScript
بخوانیدنتایج به شما بیاید، شما نپرسید.
نتیجه تماس خودکار، خلاصه گفتگوی دستیار صوتی، وضعیت کد تأیید — هر رویداد بهصورت JSON به نشانی شما POST میشود؛ هدر X-Buluthat-Signature امضای HMAC-SHA256 است. تحویل ناموفق با فاصلههای 1 دقیقه → 6 ساعت دوباره تلاش میشود.
پل Byfix CRM
دستیار صوتی در CRM مشتری را پیدا میکند، پرونده سرویس باز میکند، یادداشت میگذارد؛ از CRM «تماس با دستیار» شروع میشود. آماده، یک کلید.
جزئیاتکلاینت PHP
کلاس PHP آماده برای کد تأیید صوتی؛ با دو خط ارسال/تأیید کنید. چون نقاط دیگر HTTP ساده است از هر زبانی فراخوانی میشود.
نمونهصفحه زنده قابل جاسازی
متن زنده گفتگوی دستیار در CRM بهصورت iframe؛ با توکن امضاشده و زماندار، بدون نیاز به نشست پنل.
embed_url