با نصب ماژول Call Request یک API قدرتمند روی ایزابل خواهید داشت که به شما اجازه می‌دهد نرم‌افزارها و سرویس‌های بیرونی مثل CRM، وب‌سایت، اپلیکیشن‌های اداری یا حتی تجهیزات سخت‌افزاری، تنها با یک درخواست ساده (API Call) تماس تلفنی را از طریق سیستم تلفنی ایزابل برقرار کنند.
این ماژول تخصصی با مجموعه‌ای از امکانات هوشمند، نکات فنی مهم برای بهره‌برداری صحیح، و شرایط دقیق صدور لایسنس و ارائه پشتیبانی طراحی شده تا پاسخگوی نیازهای سازمانی در حوزه مدیریت بازخورد و تحلیل رضایت مشتریان باشد.
Call Request یک API فوق‌العاده ساده و امن است که تلفن سازمان شما را به هر نرم‌افزاری که بخواهید متصل می‌کند – فقط با یک درخواست HTTP!
تصور کنید مشتری در سایت شماره می‌گذارد → فوری یا در زمان دلخواه با او تماس گرفته می‌شود. مدیر فروش در CRM کلیک می‌کند → تلفن کارشناس زنگ می‌خورد. سیستم حسابداری بدهی را یادآوری می‌کند → تماس خودکار برقرار می‌شود.
همه این‌ها بدون دردسر، بدون برنامه‌نویسی پیچیده، در چند دقیقه!
تماس با یک کلیک از CRM، سایت فروش، اپلیکیشن موبایل
Call Back هوشمند وب‌سایت (مشتری درخواست تماس می‌دهد)
تماس اطلاع‌رسانی خودکار (یادآوری نوبت، پیگیری سفارش، اعلام تخفیف)
کمپین‌های مارکتینگ و نظرسنجی تلفنی
تماس امن (Number Masking) بدون نمایش شماره واقعی
اتصال آسان نرم‌افزارهای حسابداری، انبار، تیکتینگ، بات و IoT به تلفن
۴ نوع تماس آماده: داخلی به بیرونی، بیرونی به داخلی، بیرونی به بیرونی و داخلی به داخلی
کالرآیدی دلخواه: تعیین شناسه تماس‌گیرنده با پارامتر cid
تماس زمان‌بندی‌شده: برنامه‌ریزی تماس برای آینده با پارامتر schedule_time
شناسه منحصربه‌فرد تماس (UniqueID – اختیاری): دریافت شناسه تماس با want_uniqueid=1 برای پیگیری و اتصال به CRM
تگ‌گذاری تماس‌ها: ثبت برچسب اختصاصی با پارامتر tag در فیلد Account Code گزارش CDR
محدودیت مدت تماس (جدید!): تعیین حداکثر زمان تماس با پارامتر max_duration
هشدار صوتی پیش از پایان تماس (جدید!): پخش صدای هشدار در زمان باقی‌مانده مشخص؛ قابل تنظیم از طریق فایل callrequest-params.ini
فعال و غیرفعال کردن هشدار صوتی (جدید!): کنترل هشدار با پارامتر warning_enabled بدون غیرفعال شدن محدودیت مدت تماس
تنظیم زمان و فایل هشدار: تعیین زمان هشدار با warning_time و انتخاب فایل صوتی با warning_file
امنیت: امکان استفاده از توکن احراز هویت و محدودسازی IPهای مجاز
سبک و سریع: مناسب برای اتصال نرم‌افزارهای مختلف به زیرساخت تلفنی مبتنی بر Asterisk
Issabel یا FreePBX با Asterisk فعال
اتصال HTTPS توصیه می‌شود
نصب در کمتر از ۱۵ دقیقه!
ارزش واقعی Call Request: شما دیگر نیازی به توسعه‌دهنده گران یا راه‌حل‌های پیچیده ندارید. تلفن سازمان‌تان را به هر سیستمی که دارید وصل کنید و تجربه مشتریان را متحول کنید.
آماده اولین تماس هوشمند هستید؟ همین حالا تست کنید و ببینید چقدر ساده و قدرتمند است! 🚀
📄 شرایط لایسنس، پشتیبانی و اصلاحات ماژول
قبل از استفاده، لطفاً تب مربوط به شرایط لایسنس و خدمات پشتیبانی را با دقت مطالعه فرمایید.
شرایط لایسنس، پشتیبانی و بروزرسانی محصول
لطفاً پیش از نصب یا استفاده، شرایط زیر را به دقت مطالعه فرمایید:
🔐 شرایط صدور لایسنس
🤝 شرایط پشتیبانی
🔧 شرایط دریافت بروزرسانی
این بخش به‌عنوان یک نمونه‌ای از کاربرد عملی، به شما کمک می‌کند تا به‌طور کامل با توانایی‌های افزونه‌های ایزابل و استریسک آشنا شوید و تصمیم‌گیری‌های بهتری در مورد استفاده از آن‌ها بگیرید.
این ماژول به صورت یک صفحه بر روی وب سایت شما قرار میگیرد و در تنظیمات امکان قرار گیری چند دکمه بر روی آن وجود دارد، هر دکمه می تواند به یک شماره داخلی و یا صف به ایزابل متصل شود.
مشتری شما پس از ورود به صفحه ماژول و زدن دکمه انتخابی، می تواند از طریق وب با صف یا اپراتور های شما ارتباط برقرار کند و مکالمه صوتی داشته باشد.
فرض کنید یک CRM در یک مجموعه آزمایشگاهی در صورت نتیجه آزمایش آماده است و به صورت خودکار با مشتری تماس گرفته شود و این اطلاع رسانی صورت گیرد.
یک مجموعه بیمه هر روز صبح توسط CRM مجموعه درخواست تماس با کسانی که یک سال قبل خرید بیمه داشتند را ارسال کند و این اطلاع رسانی توسط این ماژول صورت گیرد.
با ماژول نظرسنجی ایزابل ویپ ایران، تجربه‌ای سریع و ساده از نصب و راه‌اندازی نظرسنجی تلفنی را تجربه کنید؛ بدون نیاز به دانش فنی، تنها با چند کلیک! مناسب برای شرکت‌هایی که به دنبال راهکاری مقرون‌به‌صرفه، قدرتمند و قابل اعتماد هستند. همراه با راهنمای کامل نصب و امکان پشتیبانی در صورت نیاز.
نصب این ماژول کاملاً خودکار است و هیچ نیازی به دانش برنامه‌نویسی یا مهارت‌های پیشرفته لینوکس ندارد. تنها کافی‌ست به سرور ایزابل دسترسی SSH داشته باشید.
دسترسی به سرور ایزابل با کاربر root از طریق SSH (مثلاً با نرم‌افزار PuTTY)
اتصال اینترنت روی سرور (فقط در زمان نصب اولیه)
دریافت لایسنس اختصاصی که پس از خرید به ایمیل شما ارسال می‌شود
💡 نکته مهم: نصب این ماژول تأثیری بر عملکرد سیستم تلفنی فعلی شما ندارد. با این حال، توصیه می‌شود قبل از نصب از سرور بکاپ تهیه کنید.
این ماژول بخشی از پلتفرم مرکزی Connect panel (بستر اجرای ماژول‌ها) است. اگر قبلاً ماژول دیگری خریداری کرده‌اید و پلتفرم نصب شده است، نیازی به اجرای مجدد فرمان نصب نیست و فقط لایسنس را در محیط وب وارد کنید.
ایمیلی که بعد از خرید دریافت می‌کنید، حاوی یک فرمان کامل شبیه زیر است:
bash <(curl -fsSL -H 'Voipiran-Key: |
این فرمان شامل کلید لایسنس (رشته بلند بعد از Voipiran-Key:) است که برای نصب و فعال‌سازی استفاده می‌شود.
نکته: اگر پلتفرم قبلاً نصب شده باشد، این فرمان فقط لایسنس را بررسی و ماژول‌های جدید را آماده می‌کند بدون نصب مجدد کامل.
آدرس پایه سرویس:
https://ISSABEL_IP/dial.php
ISSABEL_IP را با IP یا دامنه سرور Issabel جایگزین کنید.
| پارامتر | الزامی | توضیحات | مثال |
|---|---|---|---|
dir | بله | نوع تماس: inout، outin، outout یا inin | dir=inin |
in1 | بسته به نوع تماس | داخلی اول | in1=2001 |
in2 | برای inin | داخلی دوم | in2=2002 |
out1 | بسته به نوع تماس | شماره بیرونی اول | out1=09122103200 |
out2 | برای outout | شماره بیرونی دوم | out2=09121234567 |
schedule_time | خیر | زمان اجرای تماس در آینده | schedule_time=2026-10-11%2014:30:00 |
want_uniqueid | خیر | درخواست انتظار برای دریافت شناسه تماس؛ مقدار 1 | want_uniqueid=1 |
tag | خیر | شناسه اختصاصی درخواست؛ حداکثر ۶۴ کاراکتر | tag=CRM-456 |
max_duration | خیر | حداکثر مدت تماس بر حسب ثانیه؛ از ۱ تا ۸۶۴۰۰ | max_duration=60 |
dir | مبدأ | مقصد |
|---|---|---|
inout | داخلی | شماره بیرونی |
outin | شماره بیرونی | داخلی |
outout | شماره بیرونی اول | شماره بیرونی دوم |
inin | داخلی اول | داخلی دوم |
نکته: کاراکترهای غیرعددی شماره‌ها حذف می‌شوند. موفقیت تماس‌های بیرونی به تنظیمات ترانک و مسیرهای تماس سانترال وابسته است.
پارامتر max_duration حداکثر مدت تماس را بر حسب ثانیه تعیین می‌کند.
برای مثال:
max_duration=60
برای فعال کردن هشدار صوتی، فایل callrequest-params.ini را تنظیم کنید:
warning_enabled = yes
warning_time = 20
warning_file = en/beep
| تنظیم | کاربرد |
|---|---|
warning_enabled | فعال یا غیرفعال کردن هشدار با yes یا no |
warning_time | تعداد ثانیه‌های باقی‌مانده هنگام پخش هشدار |
warning_file | نام فایل صوتی نسبت به مسیر صداهای Asterisk، بدون پسوند |
مثال: با max_duration=60 و warning_time=20، هشدار باید حدود ثانیه ۴۰ پخش شود و تماس در محدودیت ۶۰ ثانیه پایان یابد.
برای غیرفعال کردن هشدار:
warning_enabled = no
غیرفعال کردن هشدار، محدودیت مدت تماس را غیرفعال نمی‌کند.
فایل صوتی باید در مسیر صداهای Asterisk موجود و قابل پخش باشد. برای مثال، en/beep به فایل beep.gsm در پوشه en اشاره می‌کند.
در مثال‌ها، ISSABEL_IP را با آدرس واقعی سرور جایگزین کنید.
https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002
https://ISSABEL_IP/dial.php?dir=inout&in1=2001&out1=09122103200
https://ISSABEL_IP/dial.php?dir=outin&out1=09122103200&in1=2001
https://ISSABEL_IP/dial.php?dir=outout&out1=09122103200&out2=09121234567
https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&max_duration=60
ابتدا تنظیمات هشدار را در فایل INI فعال کنید، سپس درخواست زیر را بفرستید:
https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&max_duration=60
https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&want_uniqueid=1&tag=CRM-456
https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&schedule_time=2026-10-11%2014:30:00&tag=CRM-456&max_duration=60
زمان باید در آینده باشد تا تماس زمان‌بندی شود. اجرای تماس‌های زمان‌بندی‌شده به پیکربندی Cron وابسته است.
{
"status": "success",
"message": "Originate sent",
"UniqueID": "1710321456.123",
"tag": "CRM-456",
"max_duration": 60
}
فیلد max_duration فقط زمانی در پاسخ وجود دارد که محدودیت مدت تماس تعیین شده باشد.
{
"status": "queued",
"message": "Originate queued (no UniqueID yet)",
"UniqueID": null,
"tag": "CRM-456"
}
وضعیت queued به معنای شکست قطعی تماس نیست. همچنین پذیرش درخواست یا دریافت UniqueID تضمین نمی‌کند که مقصد پاسخ داده باشد.
{
"status": "scheduled",
"time": "2026-10-11 14:30:00",
"tag": "CRM-456"
}
{
"status": "failed",
"message": "Originate failed",
"tag": "CRM-456"
}
| خطا | علت یا اقدام پیشنهادی |
|---|---|
AMI not connected | بررسی اتصال AMI، نام کاربری، رمز عبور و دسترسی شبکه |
Invalid parameters | بررسی dir و شماره‌های موردنیاز |
Invalid schedule_time format | ارسال تاریخ و ساعت معتبر |
Invalid max_duration | ارسال عدد صحیح بین ۱ تا ۸۶۴۰۰ |
Originate failed | بررسی ترانک، Dialplan و شماره مقصد |
| هشدار صوتی پخش نمی‌شود | بررسی warning_enabled، مقدار warning_time، نام فایل و لاگ Asterisk |
برای ارتباط امن، از HTTPS استفاده کنید.
max_duration اختیاری است؛ در صورت حذف، محدودیت زمانی این قابلیت اعمال نمی‌شود.
تنظیمات هشدار از فایل callrequest-params.ini خوانده می‌شوند.
tag در فیلد Account Code تماس به Asterisk ارسال می‌شود و در پاسخ API نیز برگردانده می‌شود.
برای دریافت UniqueID، مقدار want_uniqueid=1 را ارسال کنید؛ API تا حدود ۵ ثانیه منتظر می‌ماند.
تماس‌های زمان‌بندی‌شده به اجرای صحیح Cron نیاز دارند.
لاگ اصلی برنامه در فایل callrequest.log کنار فایل PHP ذخیره می‌شود؛ برای نصب در /var/www/html/dialer مسیر آن /var/www/html/dialer/callrequest.log است.
پیشنهاد: پیش از استفاده عملیاتی، هر چهار نوع تماس، محدودیت مدت تماس، هشدار صوتی و زمان‌بندی را با شماره‌های آزمایشی بررسی کنید.