...

ماژول درخواست تماس (Call Request) ایزابل

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

مشخصات فنی، نکات کلیدی و شرایط پشتیبانی

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

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

Call Request برای Issabel/Asterisk یک API ساده و امنِ ‌HTTP است که به شما اجازه می‌دهد از هر نرم‌افزار بیرونی—مثل CRM، وب‌سایت، اتوماسیون اداری یا حتی تجهیزات سخت‌افزاری—درخواست «برقراری تماس» را مستقیم به سانترال‌تان ارسال کنید. این ماژول با استفاده از AMI تماس را از داخل ایزابل آغاز (originate) می‌کند و سناریوهای مختلف تماس را پوشش می‌دهد.

کاربردهای رایج

  • درخواست تماس از وب‌سایت (Customer Call Back): کاربر شماره می‌گذارد، سیستم تماس می‌گیرد.

  • Click2Call / Click2Dial در CRM: یک کلیک در CRM، تماس روی داخلی کارشناس برقرار می‌شود.

  • Number Masking (تماس امن): تماس دوطرفه بدون نمایش شماره‌های واقعی.

  • تماس اطلاع‌رسانی: یادآوری رویداد، اعلام بدهی/پیگیری سفارش و…

  • کمپین‌های مارکتینگ و اتوماسیون‌ها: اجرای تماس‌های برنامه‌ریزی‌شده یا آنی.

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

ویژگی‌ها و مزایا

  • چهار سناریوی تماس آماده:
    inout (داخلی⇢شماره بیرونی) · outin (شماره بیرونی⇢داخلی) · outout (بیرونی⇢بیرونی) · inin (داخلی⇢داخلی)

  • کالرآیدی سفارشی در هر درخواست (پارامتر cid)

  • همگام با ایزابل/استریسک: استفاده از AMI، بدون نیاز به ماژول‌های پیچیده

  • امنیت قابل تنظیم:
    احراز هویت با توکن (اختیاری) و محدودسازی دسترسی بر اساس IP/رِنج/CIDR

  • تنظیمات متمرکز از دیتابیس: voipiran_callrequest.settings (نام ترانک، پیش‌شماره خروجی، کالرآیدی، لاگ)

  • ثبت لاگ درخواست‌ها برای عیب‌یابی و پیگیری

  • سبک و سریع: مناسب یکپارچه‌سازی با هر سیستم (وب، موبایل، ERP، بات، IoT و…)

پیش‌نیازها

  • Issabel/Asterisk فعال و قابل دسترس

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

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

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

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

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

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

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

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

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

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

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

SCENARIO

داستان های مورد استفاده

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

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

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

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

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

راهنمای فنی استفاده (Usage Guide)

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

راهنمای فنی استفاده (Usage Guide)

آدرس سرویس

 
https://ISSABEL_IP/dialer/dial.php

پیشنهاد: از HTTPS استفاده کنید. اگر توکن روشن است، توکن را در هِدر بفرستید.

✅ پارامترها

  • dir (الزامی): نوع تماس

    • inout : تماس از داخلی به بیرون

    • outin : تماس از بیرون به داخلی

    • outout: تماس بین دو شماره بیرونی

    • inin : تماس بین دو داخلی

  • in1 : داخلی مبدا (در inout و inin و outin)

  • in2 : داخلی مقصد دوم (فقط در inin)

  • out1: شماره بیرونی اول (در inout/outin/outout)

  • out2: شماره بیرونی دوم (فقط در outout)

  • cid : کالرآیدی دلخواه (اختیاری—در صورت مجاز بودن ترانک)

  • token : فقط وقتی لازم است که توکن در تنظیمات فعال باشد (بهتر است در هدر بفرستید)

✅ امنیت (قابل تنظیم در فایل ini)

  • enableToken = ۱|۰
    وقتی ۱ شود، باید توکن صحیح ارسال کنید.

    • مقدار توکن در token داخل ini تنظیم می‌شود.

    • ترجیحاً توکن را در هِدر بفرستید: (در صورت نیاز می‌توانید به‌صورت پارامتر token هم بفرستید.)


    • X-CallRequest-Token: <YOUR_TOKEN>

  • enableIpFilter = ۱|۰
    وقتی ۱ شود، فقط IPهایی که در allowedIps آمده‌اند مجازند.
    فرمت‌های مجاز در allowedIps (با کاما جدا کنید):

    • IP دقیق: ۱۹۲.۱۶۸.۲.۱۴

    • CIDR: ۱۹۲.۱۶۸.۲.۰/۲۴ یا ۱۰.۰.۰.۰/۸

    • بازه IPv4: ۲۰۳.۰.۱۱۳.۵-۲۰۳.۰.۱۱۳.۲۰

    • وایلدکارد IPv4: ۱۹۲.۱۶۸.۲.* یا ۱۰.*.*.*

اگر enableIpFilter=1 باشد و allowedIps خالی بماند، دسترسی رد می‌شود. وقتی خاموش است، به‌صورت پیش‌فرض همه مجازند.

نمونه درخواست‌ها

 
# داخلی ۲۰۰۱ به شماره بیرونی

https://ISSABEL_IP/dialer/dial.php?dir=inout&in1=2001&out1=09121234567

# تماس از شماره بیرونی به داخلی ۲۰۰۱
https://ISSABEL_IP/dialer/dial.php?dir=outin&in1=2001&out1=09121234567
# بیرونی به بیرونی

https://ISSABEL_IP/dialer/dial.php?dir=outout&out1=02122334455&out2=09121234567

# داخلی به داخلی

https://ISSABEL_IP/dialer/dial.php?dir=inin&in1=2001&in2=2002

# با کالرآیدی سفارشی

https://ISSABEL_IP/dialer/dial.php?dir=inout&in1=2001&out1=09121234567&cid=43398000

# با توکن در هدر (ترجیحی)
GET
https://ISSABEL_IP/dialer/dial.php?dir=inout&in1=2001&out1=09121234567
X-CallRequest-Token: YOUR_SECURE_TOKEN

پاسخ‌ها و خطاهای متداول

  • اتصال AMI ناموفق: AMI NOT CONNECTED (زیرساخت/کرِدنشیال AMI را چک کنید)

  • ۴۰۱ Unauthorized: توکن الزامی بوده و نادرست/خالی ارسال شده است.

  • ۴۰۳ Forbidden: فیلتر IP فعال است و IP شما در محدوده مجاز نیست.

  • ۲۰۰ OK: درخواست ثبت شده و Originate ارسال می‌شود (لازم نیست منتظر زنگ واقعی بمانید).

نکات پیاده‌سازی و بهترین‌تمرین‌ها

  • همیشه از HTTPS استفاده کنید و ترجیحاً توکن را در Header بفرستید.

  • ساختار شماره‌ها را در سمت کلاینت اعتبارسنجی کنید (طول/فرمت).

  • اگر کمپین حجیم دارید، ریت‌لیمیت سمت کلاینت/وب‌سرور لحاظ شود.

  • لاگ‌ها را مرتب بررسی کنید (فعال‌سازی dial_logging در تنظیمات DB).

FAQ

سوالات رایج

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

- تعريف داخلي  Extensions

- تعریف صندوق صوتی VoiceMail

- تعریف CallWaiting

- تنظیم داخلی برای رجیستر شدن از روی اینترنت

- تعریف داخلی بر روی IPPhone

- نحوه قرار دادن فايل‌هاي صوتي در سرور و يا ضبط آنها از طريق گوشي

- آَشنایی با ترانک انواع و نحوه تعریف آن

- معرفی کارت شهری و آموزش نحوه استفاده از آن

- آشنایی با نحوه ارتباط و کار با کارت شهری و همچنین Gateway های شهری

- تعریف IVR، منوی منشی دیجیتال

- تعریف صف (Queue) و تنظیمات پیشرفته آن

- تعريف پاركينگ تماس

- تعريف تماس برگشتي Callback

- تعريف دسترسي از بيرون به ويژگي‌هاي سيستم DISA

- تعريف داخلي  Extensions

- تعریف صندوق صوتی VoiceMail

- تعریف CallWaiting

- تنظیم داخلی برای رجیستر شدن از روی اینترنت

- تعریف داخلی بر روی IPPhone

- نحوه قرار دادن فايل‌هاي صوتي در سرور و يا ضبط آنها از طريق گوشي

- آَشنایی با ترانک انواع و نحوه تعریف آن

- معرفی کارت شهری و آموزش نحوه استفاده از آن

- آشنایی با نحوه ارتباط و کار با کارت شهری و همچنین Gateway های شهری

- تعریف IVR، منوی منشی دیجیتال

- تعریف صف (Queue) و تنظیمات پیشرفته آن

- تعريف پاركينگ تماس

- تعريف تماس برگشتي Callback

- تعريف دسترسي از بيرون به ويژگي‌هاي سيستم DISA

نصب آسان و بدون نیاز به دانش تخصصی

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

راهنمای نصب ماژول درخواست تماس بر روی ایزابل نسخه ۵

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


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

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

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

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

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


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

ماژول از دو بخش تشکیل شده:

  1. نصب پلتفرم مرکزی: پلتفرم CCpanel (بستر اجرای ماژول‌ها)

  2. فعالسازی ماژول نظرسنجی با لایسنس

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

 
ccpanel: bash <(curl -fsSL -H \"Voipiran-Key: VOIPIRAN_NIOpFg6kwIv94P1BD69e2Dm8d4Ycgww8Qw1kf86I82vA40F41gN6EG269y1NKz8bTv359WdQ9C1K2b01nqh7q0YEj19O20BR63YiuR949viSnCW8PF6a741CmUP2kps97elEg5IoX57MYYLGjW2H3Pi4640aGYue5UdZ7LJSlMMhJYgSNPQN511174367H8\" https://voipiran.io/clover/install.sh) |survey: VOIPIRAN_zJ6UVMkEq03Zbmqp1J2I16WDtX1D4U36GUf3h2n97XkcUK1L010WLp4ZDw1UY7sI82bVNM220sa93LOa6crYxkvWjXaOt02M3PVEe7X4my2JZ2053LA8Tx3Slmc4S34yOPEBO76tgFta3Fw6479P74q9eQk6G6L4q8724WO3FG3e7FqnmUW1B2U6WdWxxQH
 

این رشته به دو قسمت تقسیم می‌شود:


🛠 مرحله اول: نصب CCpanel

از کلمه ccpanel: به بعد را کپی کرده و در ترمینال SSH وارد کنید:

 
bash <(curl -fsSL -H \”Voipiran-Key: VOIPIRAN_NIOpFg6kwIv94P1BD69e2Dm8d4Ycgww8Qw1kf86I82vA40F41gN6EG269y1NKz8bTv359WdQ9C1K2b01nqh7q0YEj19O20BR63YiuR949viSnCW8PF6a741CmUP2kps97elEg5IoX57MYYLGjW2H3Pi4640aGYue5UdZ7LJSlMMhJYgSNPQN511174367H8\” https://voipiran.io/clover/install.sh)

بعد از زدن Enter، اسکریپت به‌طور خودکار اجرا می‌شود. در این مرحله چند سوال ساده پرسیده می‌شود:

  • رمز عبور دلخواه برای ورود به محیط وب CCpanel

پس از اتمام نصب، آدرس IP و پورت دسترسی به محیط وب CCpanel به شما نمایش داده می‌شود.


🌐 مرحله دوم: وارد کردن لایسنس ماژول نظرسنجی

  1. مرورگر خود را باز کنید و به آدرس داده‌شده در مرحله قبل وارد شوید.

  2. وارد محیط CCpanel شوید.

  3. از منوی بالا، وارد بخش فعال‌سازی لایسنس شوید.

  4. بخش دوم رشته لایسنس را که با |survey: شروع می‌شود، کپی و در محل خواسته‌شده وارد کنید.

 
 
VOIPIRAN_zJ6UVMkEq03Zbmqp1J2I16WDtX1D4U36GUf3h2n97XkcUK1L010WLp4ZDw1UY7sI82bVNM220sa93LOa6crYxkvWjXaOt02M3PVEe7X4my2JZ2053LA8Tx3Slmc4S34yOPEBO76tgFta3Fw6479P74q9eQk6G6L4q8724WO3FG3e7FqnmUW1B2U6WdWxxQH
 
  1. پس از چند ثانیه و تایید موفق لایسنس، منوی ماژول به محیط CCpanel اضافه می‌شود.