...

ماژول درخواست تماس | Connect Dial API

با نصب ماژول Call Request یک API قدرتمند روی ایزابل خواهید داشت که به شما اجازه می‌دهد نرم‌افزارها و سرویس‌های بیرونی مثل CRM، وب‌سایت، اپلیکیشن‌های اداری یا حتی تجهیزات سخت‌افزاری، تنها با یک درخواست ساده (API Call) تماس تلفنی را از طریق سیستم تلفنی ایزابل برقرار کنند.

توضیحات فنی و کاربردی

این ماژول تخصصی با مجموعه‌ای از امکانات هوشمند، نکات فنی مهم برای بهره‌برداری صحیح، و شرایط دقیق صدور لایسنس و ارائه پشتیبانی طراحی شده تا پاسخگوی نیازهای سازمانی در حوزه مدیریت بازخورد و تحلیل رضایت مشتریان باشد.

معرفی محصول: ماژول درخواست تماس هوشمند (Call Request) برای Issabel

Call Request یک API فوق‌العاده ساده و امن است که تلفن سازمان شما را به هر نرم‌افزاری که بخواهید متصل می‌کند – فقط با یک درخواست HTTP!

تصور کنید مشتری در سایت شماره می‌گذارد → فوری یا در زمان دلخواه با او تماس گرفته می‌شود. مدیر فروش در CRM کلیک می‌کند → تلفن کارشناس زنگ می‌خورد. سیستم حسابداری بدهی را یادآوری می‌کند → تماس خودکار برقرار می‌شود.

همه این‌ها بدون دردسر، بدون برنامه‌نویسی پیچیده، در چند دقیقه!

 

کاربردهای واقعی و پرارزش

  • تماس با یک کلیک از CRM، سایت فروش، اپلیکیشن موبایل
  • Call Back هوشمند وب‌سایت (مشتری درخواست تماس می‌دهد)
  • تماس اطلاع‌رسانی خودکار (یادآوری نوبت، پیگیری سفارش، اعلام تخفیف)
  • کمپین‌های مارکتینگ و نظرسنجی تلفنی
  • تماس امن (Number Masking) بدون نمایش شماره واقعی
  • اتصال آسان نرم‌افزارهای حسابداری، انبار، تیکتینگ، بات و IoT به تلفن

 

ویژگی‌های کلیدی که کار شما را راحت می‌کند

  • ۴ نوع تماس آماده داخلی به بیرونی · بیرونی به داخلی · بیرونی به بیرونی · داخلی به داخلی
  • کالرآیدی دلخواه در هر تماس (پارامتر cid)
  • تماس زمان‌بندی‌شده (جدید!) با schedule_time تماس را برای آینده برنامه‌ریزی کنید مثال: یادآوری نوبت فردا ساعت ۱۰ صبح
  • شناسه منحصربه‌فرد تماس (UniqueID – اختیاری) با want_uniqueid=1 شناسه دقیق تماس را دریافت کنید برای ردیابی، اتصال به CRM و گزارش‌گیری زنده
  • تگ‌گذاری تماس‌ها (جدید!) با tag=your_code هر تماس را علامت‌گذاری کنید این کد در گزارش CDR (فیلد Account Code) ثبت می‌شود مثال: tag=CRM-456 یا tag=کمپین_بهمن
  • امنیت بالا توکن احراز هویت + محدود کردن IPهای مجاز
  • سبک و سریع بدون نیاز به تغییر سانترال یا نصب ماژول اضافی مناسب سرورهای کوچک تا مراکز تماس بزرگ

 

پیش‌نیاز ساده

  • Issabel یا FreePBX با Asterisk فعال
  • اتصال HTTPS توصیه می‌شود
  • نصب در کمتر از ۱۵ دقیقه!

ارزش واقعی Call Request شما دیگر نیازی به توسعه‌دهنده گران یا راه‌حل‌های پیچیده ندارید. تلفن سازمان‌تان را به هر سیستمی که دارید وصل کنید و تجربه مشتریان را متحول کنید.

آماده اولین تماس هوشمند هستید؟ همین حالا تست کنید و ببینید چقدر ساده و قدرتمند است! 🚀

📄 شرایط لایسنس، پشتیبانی و اصلاحات ماژول 

قبل از استفاده، لطفاً تب مربوط به شرایط لایسنس و خدمات پشتیبانی را با دقت مطالعه فرمایید.

  • امکان شخصی‌سازی ماژول بنا به درخواست مشتری تنها در صورتی فراهم است که جزئیات زمان و هزینه مورد بررسی و تأیید تیم ویپ ایران قرار گیرد. در غیر این صورت، هیچ تغییری در محصول امکان‌پذیر نخواهد بود.
  • رفع باگ‌های احتمالی در عملکرد سیستم (به معنی بروز رفتار نادرست در بخشی از برنامه)، در بازه زمانی دو ماهه پس از اعلام مشتری توسط تیم فنی ویپ ایران بررسی و در نسخه جدید اصلاح خواهد شد.

شرایط لایسنس، پشتیبانی و بروزرسانی محصول

لطفاً پیش از نصب یا استفاده، شرایط زیر را به دقت مطالعه فرمایید:

🔐 شرایط صدور لایسنس

  • لایسنس برنامه مختص یک دستگاه است و تنها یک‌بار نصب بر روی آن امکان‌پذیر می‌باشد. نصب بر روی چند دستگاه مجاز نیست.
  • مدت زمان استفاده از لایسنس نامحدود بوده و پس از نصب، می‌توانید تا هر زمان از محصول استفاده نمایید.

🤝 شرایط پشتیبانی

  • مدت زمان پشتیبانی یک‌ساله از تاریخ خرید محصول فعال است.
  • در صورت بروز مشکل سخت‌افزاری یا نرم‌افزاری مرتبط با ماشین نصب‌شده، صدور مجدد لایسنس تنها برای یک‌بار و طی سال اول امکان‌پذیر است.
  • تا یک سال پس از خرید، می‌توانید از طریق راه‌های ارتباطی اعلام‌شده، سوالات و مشکلات خود را مطرح نمایید؛ پس از اتمام این دوره، خدمات پشتیبانی غیرفعال خواهد شد.

🔧 شرایط دریافت بروزرسانی

  • دریافت بروزرسانی‌ها و آپدیت‌های فنی محصول فقط در طول دوره یک‌ساله پشتیبانی امکان‌پذیر است.
  • درخواست دریافت بروزرسانی‌ها باید توسط خریدار به صورت رسمی مطرح گردد.

داستان‌های واقعی و موارد کاربردی

این بخش به‌عنوان یک نمونه‌ای از کاربرد عملی، به شما کمک می‌کند تا به‌طور کامل با توانایی‌های افزونه‌های ایزابل و استریسک آشنا شوید و تصمیم‌گیری‌های بهتری در مورد استفاده از آن‌ها بگیرید.

این ماژول به صورت یک صفحه بر روی وب سایت شما قرار میگیرد و در تنظیمات امکان قرار گیری چند دکمه بر روی آن وجود دارد، هر دکمه می تواند به یک شماره داخلی و یا صف به ایزابل متصل شود.

مشتری شما پس از ورود به صفحه ماژول و زدن دکمه انتخابی، می تواند از طریق وب با صف یا اپراتور های شما ارتباط برقرار کند و مکالمه صوتی داشته باشد.

  • امکان قراردادن چند دکمه برای بخش های مختلف بر روی صفحه وب فون
  • امکان برقراری تماس صوتی با صف یا اپراتور
  • نسخه استریسک سرور ایزابل شما باید ۱۶ باشد
  • کیفیت مکالمه یا داشتن صدای کامل بستگی به اینترنت و بسترارتباطی مشتری دارد، مثلا در صورت استفاده از فیلتر شکن یا موانع شبکه ممکن است صدای کامل و دو طرفه را نداشته باشند.
  • یک دامنه یا زیر دامنه برای دسترسی به آی پی ایزابل
  • یک دامنه یا زیر دامنه برای دسترسی به صفحه ماژول بر روی وب سایت 
  • امکان نصب ماژول Sourcegaurdian بر روی هاست وب سایت
  • فرض کنید یک CRM در یک مجموعه آزمایشگاهی در صورت نتیجه آزمایش آماده است و به صورت خودکار با مشتری تماس گرفته شود و این اطلاع رسانی صورت گیرد.

    یک مجموعه بیمه هر روز صبح توسط CRM مجموعه درخواست تماس با کسانی که یک سال قبل خرید بیمه داشتند را ارسال کند و این اطلاع رسانی توسط این ماژول صورت گیرد.

  • ارسال درخواست تماس از صوی CRM یا برنامه مجموعه می تواند هدف تبلیغ محصول کنید به افرادی و مشتیران خاص آن مجموعه باشد.
     
  • در بسیاری از پروژه ها درخواست تماس فقط از سمت CRM ها ارسال نمی وشد، ممکن است که برنامه نظارتی همچون نظارت بر شبکه، محصولات امنیتی و یا ایمنی ارسال گردد.
     به طور مثال دستگاه نظارت بر امنیت یک ساختمان در صورت بروز مشکل درخواست تماس با پلیس را به استریسک ارسال کند.

نصب و راه اندازی

با ماژول نظرسنجی ایزابل ویپ ایران، تجربه‌ای سریع و ساده از نصب و راه‌اندازی نظرسنجی تلفنی را تجربه کنید؛ بدون نیاز به دانش فنی، تنها با چند کلیک! مناسب برای شرکت‌هایی که به دنبال راهکاری مقرون‌به‌صرفه، قدرتمند و قابل اعتماد هستند. همراه با راهنمای کامل نصب و امکان پشتیبانی در صورت نیاز.

راهنمای نصب ماژول بر روی ایزابل 

نصب این ماژول کاملاً خودکار است و هیچ نیازی به دانش برنامه‌نویسی یا مهارت‌های پیشرفته لینوکس ندارد. تنها کافی‌ست به سرور ایزابل دسترسی SSH داشته باشید.


پیش‌نیازهای نصب

  • دسترسی به سرور ایزابل با کاربر root از طریق SSH (مثلاً با نرم‌افزار PuTTY)

  • اتصال اینترنت روی سرور (فقط در زمان نصب اولیه)

  • دریافت لایسنس اختصاصی که پس از خرید به ایمیل شما ارسال می‌شود

💡 نکته مهم: نصب این ماژول تأثیری بر عملکرد سیستم تلفنی فعلی شما ندارد. با این حال، توصیه می‌شود قبل از نصب از سرور بکاپ تهیه کنید.


مراحل نصب گام‌به‌گام

این ماژول بخشی از پلتفرم مرکزی Connect panel (بستر اجرای ماژول‌ها) است. اگر قبلاً ماژول دیگری خریداری کرده‌اید و پلتفرم نصب شده است، نیازی به اجرای مجدد فرمان نصب نیست و فقط لایسنس را در محیط وب وارد کنید.

ایمیلی که بعد از خرید دریافت می‌کنید، حاوی یک فرمان کامل شبیه زیر است:

 
bash <(curl -fsSL -H 'Voipiran-Key:
VOIPIRAN_zJ6UVMkEq03Zbmqp1J2I16WDtX1D4U36GUf3h2n97XkcUK1L010WLp4ZDw1UY7sI82bVNM220sa93LOa6crYxkvWjXaOt02M3PVEe7X4my2JZ2053LA8Tx3Slmc4S34yOPEBO76tgFta3Fw6479P74q9eQk6G6L4q8724WO3FG3e7FqnmUW1B2U6WdWxxQH' https://voipiran.io/clover/install.sh)

این فرمان شامل کلید لایسنس (رشته بلند بعد از Voipiran-Key:) است که برای نصب و فعال‌سازی استفاده می‌شود.

 


مرحله اول: نصب Connect

مرحله اول: نصب یا به‌روزرسانی پلتفرم مرکزی (Connect panel)

  1. فرمان کامل را از ایمیل کپی کنید.
  2. در ترمینال SSH سرور خود (روی Issabel یا FreePBX) وارد کنید و Enter بزنید.
  3. اسکریپت به‌طور خودکار اجرا می‌شود. در این مرحله ممکن است چند سوال ساده پرسیده شود، مانند:
    • رمز عبور دلخواه برای ورود به محیط وب CCpanel (اگر قبلاً نصب شده، از رمز موجود استفاده کنید).
  4. پس از اتمام، آدرس IP و پورت دسترسی به محیط وب CCpanel (مثلاً http://your-ip:9000) به شما نمایش داده می‌شود.

نکته: اگر پلتفرم قبلاً نصب شده باشد، این فرمان فقط لایسنس را بررسی و ماژول‌های جدید را آماده می‌کند بدون نصب مجدد کامل.


مرحله دوم: فعال‌سازی لایسنس ماژول در محیط وب

  1. مرورگر خود را باز کنید و به آدرس پلتفرم Connect Panel (که بعد از نصب نمایش داده شده، مثلاً http://your-ip:9000) وارد شوید.
  2. با نام کاربری و رمز عبوری که در مرحله نصب تنظیم کردید، وارد محیط CCpanel شوید.
  3. از منوی بالا یا بخش تنظیمات، وارد قسمت فعال‌سازی لایسنس (یا Licence Activation) شوید.
  4. کل لایسنس دریافتی از ایمیل را کامل کپی کنید و در فیلد مربوطه جای‌گذاری (Paste) کنید:
 
VOIPIRAN_zJ6UVMkEq03Zbmqp1J2I16WDtX1D4U36GUf3h2n97XkcUK1L010WLp4ZDw1UY7sI82bVNM220sa93LOa6crYxkvWjXaOt02M3PVEe7X4my2JZ2053LA8Tx3Slmc4S34yOPEBO76tgFta3Fw6479P74q9eQk6G6L4q8724WO3FG3e7FqnmUW1B2U6WdWxxQH
 

نکته مهم: لایسنس دقیقاً با پیشوند VOIPIRAN_ شروع می‌شود و کل رشته (شامل پیشوند) باید وارد شود. نیازی به ویرایش یا حذف بخشی نیست.

  1. روی دکمه تأیید یا فعال‌سازی کلیک کنید.
  2. پس از چند ثانیه، اگر لایسنس معتبر باشد، پیام موفقیت‌آمیز نمایش داده می‌شود و منوی محصول(های) خریداری‌شده (مانند نظرسنجی، گزارش‌گیری، درخواست تماس و سایر ماژول‌ها) به صورت خودکار به پنل اضافه می‌گردد.

نکات اضافی در این مرحله

  • اگر قبلاً لایسنس دیگری وارد کرده‌اید، این لایسنس جدید می‌تواند ماژول‌های اضافی را به همان پلتفرم اضافه کند.
  • در صورت خطای «لایسنس نامعتبر»، مطمئن شوید کل رشته را دقیق و بدون فضای اضافی کپی کرده‌اید.
  • پس از فعال‌سازی موفق، صفحه را رفرش کنید تا منوهای جدید ظاهر شوند.

 

آدرس پایه سرویس https://ISSABEL_IP/dial.php

پیشنهاد مهم امنیتی همیشه از HTTPS استفاده کنید. اگر توکن فعال است، ترجیحاً آن را در هدر بفرستید (نه در URL).

پارامترهای اصلی (Query String)

 
 
پارامترتوضیحالزامی؟مثالنکات جدید / مهم
dirنوع تماسبلهinout / outin / outout / ininچهار سناریو آماده
in1شماره داخلی مبدأ (کارشناس / داخلی اول)بسته به dir۲۰۰۱فقط در inout، outin، inin
in2شماره داخلی مقصد (داخلی دوم)فقط در inin۲۰۰۲
out1شماره بیرونی اول (شهری/موبایل اول)بسته به dir۰۹۱۲۲۱۰۳۲۰۰در inout، outin، outout
out2شماره بیرونی دومفقط در outout۰۹۱۲۱۲۳۴۵۶۷
cidکالرآیدی سفارشی (شماره یا نام + شماره)خیر۴۳۳۹۸۰۰۰ یا “حامد ۰۹۱۲۲۱۰۳۲۰۰”قابل ارسال در هر درخواست
schedule_timeزمان اجرای تماس (جدید)خیر۲۰۲۶-۰۲-۱۵ ۱۴:۳۰:۰۰فرمت: YYYY-MM-DD HH:MM:SS فاصله → %۲۰ آینده → زمان‌بندی گذشته/حال → فوری
want_uniqueidدرخواست شناسه منحصربه‌فرد تماس (جدید – اختیاری)خیر۱اگر =۱ باشد: تا ۵ ثانیه منتظر UniqueID می‌ماند و در JSON برمی‌گرداند
tagکد/شناسه سفارشی برای پیگیری (جدید – اختیاری)خیرCRM-20260211-001 یا ticket_456در CDR → فیلد accountcode در لاگ و پاسخ JSON هم ثبت می‌شود
 

توکن و امنیت

  • token (اختیاری) → فقط وقتی enableToken = 1 باشد بهترین روش: هدر → X-CallRequest-Token: YOUR_TOKEN روش جایگزین: ?token=YOUR_TOKEN (کمتر امن)
  • enableIpFilter = 1 → فقط IPهای مجاز در allowedIps (در ini) دسترسی دارند فرمت مجاز: IP دقیق، CIDR، بازه IPv4، وایلدکارد (*)

نمونه درخواست‌ها (کپی و تست کنید)

تماس فوری ساده https://ISSABEL_IP/dial.php?dir=inout&in1=2001&out1=09122103200

با کالرآیدی سفارشی https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&cid=43398000

زمان‌بندی‌شده https://ISSABEL_IP/dial.php?dir=inin&in1=2001&in2=2002&schedule_time=2026-02-15%2014:30:00

با تگ و درخواست UniqueID https://ISSABEL_IP/dial.php?dir=outin&in1=2001&out1=09122103200&want_uniqueid=1&tag=support_20260211

زمان‌بندی + تگ + UniqueID + کالرآیدی https://ISSABEL_IP/dial.php?dir=inout&in1=2001&out1=09122103200&schedule_time=2026-02-20%2009:45:00&want_uniqueid=1&tag=campaign_feb_001&cid=43398000

خروجی سرویس (همیشه JSON)

موفق فوری

JSON
 
{
  "status": "success",
  "message": "Originate sent",
  "UniqueID": "1710321456.123",
  "tag": "support_20260211"
}
 
 

زمان‌بندی موفق

JSON
 
{
  "status": "scheduled",
  "time": "2026-02-15 14:30:00",
  "tag": "campaign_feb_001"
}
 
 

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

JSON
 
{
  "status": "queued",
  "message": "Originate queued (no UniqueID yet)",
  "UniqueID": null,
  "tag": "ticket_456"
}
 
 

خطاهای رایج و راه‌حل

  • AMI NOT CONNECTED → مشکل اتصال AMI (کاربر/رمز یا فایروال)
  • ۴۰۱ Unauthorized → توکن اشتباه یا ارسال نشده (اگر فعال باشد)
  • ۴۰۳ Forbidden → IP شما مجاز نیست (فیلتر IP فعال)
  • Invalid parameters → dir یا شماره‌های لازم ارسال نشده
  • Originate failed → مشکل در originate (ترانک، dialplan یا شماره اشتباه)

نکات مهم پیاده‌سازی (برای توسعه‌دهنده/کاربر فنی)

  • همیشه HTTPS استفاده کنید (امنیت توکن و tag)
  • توکن را در هدر بفرستید (X-CallRequest-Token) – امن‌تر است
  • ساختار شماره‌ها را سمت کلاینت چک کنید (طول، پیش‌شماره)
  • برای کمپین‌های حجیم → rate limiting اعمال کنید (سمت کلاینت یا وب‌سرور)
  • لاگ را فعال کنید (dial_logging = 1) و مرتب چک کنید
  • لاگ زمان‌بندی‌ها → /var/log/makeCall-cron.log
  • لاگ کلی درخواست‌ها → /var/www/html/callrequest.log
  • تگ‌ها در CDR → فیلد accountcode (جستجو و گزارش‌گیری آسان)
  • UniqueID → فقط وقتی want_uniqueid=1 باشد درخواست می‌شود (بار اضافی ندارد)

توصیه نهایی قبل از استفاده در محیط واقعی، حتماً با شماره‌های آزمایشی تست کامل انجام دهید (فوری، زمان‌بندی، با/بدون tag و UniqueID). اگر مشکلی دیدید، لاگ‌ها را بررسی کنید – همه چیز شفاف ثبت شده است.