راهنمای راه‌اندازی PerfexVoIP

پیش‌نیازها

CRM

Perfex CRM نسخهٔ 3.0 یا جدیدتر

PHP

نسخهٔ 8.0 یا جدیدتر

پایگاه داده

MySQL 5.7 یا MariaDB 10.3 و نسخه‌های جدیدتر

PBX

Asterisk 13 یا بالاتر برای AMI، یا Asterisk 12 یا بالاتر برای ARI (FreePBX و Issabel هر دو را ارائه می‌کنند)

اکستنشن‌های PHP

json، pdo_mysql، curl، sockets، openssl، mbstring (و pcntl فقط برای سرویس‌های پس‌زمینه)

شبکه

سرور CRM باید از طریق AMI (پورت 5038) یا ARI (پورت 8088) به PBX دسترسی داشته باشد؛ معمولاً روی شبکهٔ خصوصی یا VPN

نصب

1. ۱. نصب ماژول در Perfex CRM

   فایل zip ماژول را از مسیر Setup → Modules → Upload Module بارگذاری و PerfexVoIP را فعال کنید، یا آن را در application/modules از حالت فشرده خارج کنید و از همان صفحه فعالش کنید. نخستین فعال‌سازی ۱۵ تا ۳۰ ثانیه طول می‌کشد، چون ماژول جدول‌ها و تنظیمات پیش‌فرض خود را می‌سازد.

2. ۲. اتصال PBX

   بخش PerfexVoIP → Settings را باز کنید، اطلاعات اتصال ARI یا AMI (یا هر دو؛ انتخابگر روش ارتباط مقدارهای auto، ari یا ami را می‌پذیرد) را وارد کنید و روی Test connection کلیک کنید. ARI رابط جدیدتر است و اگر Asterisk شما از آن پشتیبانی کند، توصیه می‌شود.

   [perfexvoip]
   secret = A_STRONG_RANDOM_PASSWORD
   deny   = 0.0.0.0/0.0.0.0
   permit = 127.0.0.1/255.255.255.255
   read   = system,call,user,cdr,dialplan,agent
   write  = system,call,user,originate

3. ۳. انتخاب روش رسیدن رویدادهای تماس به CRM

   رویدادها از سه راه می‌توانند برسند: سرویس رویدادهای ARI (توصیه‌شده؛ از طریق WebSocket رویدادهای Asterisk را دریافت می‌کند)، یک پردازهٔ بریج که هر اتصال PBX را به‌طور دوره‌ای بررسی می‌کند، یا dialplan شما که رویدادها را به نقطهٔ دریافت ماژول می‌فرستد؛ این گزینه برای هاست اشتراکی است که در آن هیچ سرویس پس‌زمینه‌ای نمی‌تواند اجرا شود. نمایش اطلاعات تماس‌گیرنده در هر حالت کار می‌کند: اعلان‌گر درون صفحه در صورت امکان از WebSocket استفاده می‌کند و در غیر این صورت خودکار به polling از طریق HTTP برمی‌گردد.

   [Service]
   Type=simple
   User=www-data
   ExecStart=/usr/bin/php /var/www/perfex/application/modules/perfexvoip/ari_events_daemon.php /var/www/perfex
   Restart=always
   RestartSec=5

4. ۴. اختصاص داخلی‌ها به کارکنان و تعیین مجوزها

   در بخش PerfexVoIP → Peers، هر داخلی SIP را با dial string و context آن اضافه کنید و به کارکنانی که از آن استفاده می‌کنند متصل کنید. همین کار است که تماس ورودی را به شخص درست می‌رساند و تماس با یک کلیک را به داخلی‌های خودِ هر کارمند محدود نگه می‌دارد. سپس مجوزهای ماژول را برای هر نقش تعیین کنید: view_own (تماس‌های خود و اعلان‌گر)، view_all (تماس‌های همه) و click2call.

5. ۵. فعال کردن قابلیت‌های مورد نیاز

   رفتارهای اختیاری در Settings قرار دارند: ساخت خودکار سرنخ (lead) از شمارهٔ ورودی ناشناس، قرار دادن تماس‌گیرندگان مزاحم در فهرست سیاه پس از رسیدن به یک آستانه، و ثبت چند سرور PBX در بخش Connections با یک پردازهٔ بریج برای هر اتصال.

نکات امنیتی

• برای کاربران AMI و ARI از رمزهای تصادفی با دست‌کم ۲۴ نویسه استفاده کنید.
• هرگز AMI (پورت 5038) یا ARI (پورت 8088) را روی اینترنت عمومی در دسترس قرار ندهید؛ آن‌ها را به localhost یا یک شبکهٔ خصوصی محدود کنید.
• اطلاعات دسترسی ذخیره‌شدهٔ PBX در صفحهٔ تنظیمات پوشانده می‌شوند، هرگز به مرورگر فرستاده نمی‌شوند و هرگز در لاگ‌ها ثبت نمی‌شوند.
• تماس با یک کلیک و قطع تماس فقط برای داخلی‌هایی ممکن است که به کارمندِ واردشده اختصاص داده شده‌اند.

اگر چیزی کار نکرد

آزمون اتصال ARI ناموفق است

اطلاعات ورود در ari.conf را بررسی کنید. برای بررسی دستی، دستور curl -u user:pass http://127.0.0.1:8088/ari/asterisk/info را اجرا کنید؛ پاسخ Unauthorized یعنی گذرواژه مطابقت ندارد.

آزمون اتصال AMI ناموفق است

دستور nc -v 127.0.0.1 5038 باید بنر AMI را نمایش دهد. خطای Connection refused یعنی manager.conf فعال نیست یا فایروال مانع اتصال است.

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

لاگ سرویس را دنبال کنید (journalctl -u perfexvoip-ari-events -f). رد شدن handshake معمولاً یعنی سرور HTTP داخلی Asterisk خاموش است یا نام برنامهٔ ARI اشتباه است.

اطلاعات تماس‌گیرنده برای اپراتور نمایش داده نمی‌شود

مطمئن شوید نقش آن کارمند مجوز view_own را دارد، مرورگر اجازهٔ نمایش اعلان را گرفته است و نماد اعلان‌گر قرمز نیست؛ نماد قرمز یعنی اتصال WebSocket قطع است و ماژول به‌جای آن با polling ادامه می‌دهد.

نصب ساده روی سروری که از قبل در اختیار دارید معمولاً کمتر از یک ساعت طول می‌کشد. بستهٔ نرم‌افزار همراه با راهنمای کامل نصب، راهنمای آزمون و یونیت‌های systemd بالا ارائه می‌شود؛ در تنظیمات اتصال PBX هم به‌عنوان بخشی از فرایند شروع کار کمکتان می‌کنیم.