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

پیش‌نیازها

WordPress

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

PHP

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

WooCommerce

نسخهٔ 7.0 یا جدیدتر برای تطبیق مشتری و سفارش (با پشتیبانی از HPOS)؛ افزونه بدون WooCommerce هم کار می‌کند

PBX

Asterisk، FreePBX یا Issabel که از طریق AMI (پورت 5038) یا ARI (پورت 8088) در دسترس باشد

HTTPS

همه‌جا توصیه می‌شود؛ اگر PBX مستقیماً از dialplan به WordPress اطلاع می‌دهد، الزامی است

هاستینگ

هاست اشتراکی با polling کار می‌کند؛ ارسال بی‌درنگ از طریق WebSocket به VPS نیاز دارد که بتوان در آن پردازهٔ پس‌زمینه اجرا کرد

نصب

1. ۱. نصب و فعال‌سازی افزونه

   فایل zip افزونه را از مسیر Plugins → Add New → Upload بارگذاری و فعال کنید و کلید لایسنس خود را در VoIPPress → License وارد کنید. پس از فعال‌سازی، به راه‌انداز گام‌به‌گام هدایت می‌شوید.

2. ۲. اتصال PBX

   در VoIPPress → Settings نوع PBX خود را انتخاب کنید، اطلاعات اتصال AMI یا ARI را وارد کنید و روی Test connection کلیک کنید. راه‌انداز دقیقاً همان بلوک پیکربندی‌ای را که باید در سمت PBX قرار دهید تولید می‌کند، از جمله خط permit برای IP سرور WordPress شما.

   [voippress]
   secret = YOUR_SECRET
   deny   = 0.0.0.0/0.0.0.0
   permit = YOUR_WORDPRESS_SERVER_IP/255.255.255.255
   read   = system,call,user,cdr
   write  = system,call,originate

3. ۳. رساندن تماس‌های ورودی به WordPress

   برای نمایش اطلاعات تماس‌گیرنده، PBX باید به WordPress اطلاع دهد. یا عامل بریجِ همراه افزونه را به‌صورت سرویس روی PBX اجرا کنید (توصیه‌شده؛ یک اتصال AMI را باز نگه می‌دارد و رویدادها را ارسال می‌کند)، یا قطعهٔ dialplan تولیدشده را در context ورودی خود قرار دهید که برای هاست اشتراکی مناسب است.

   php voippress-bridge.php \
     --wp=https://your-site \
     --secret=INGEST_SECRET \
     --ami-user=voippress \
     --ami-secret=AMI_SECRET

4. ۴. افزودن ارسال بی‌درنگ (اختیاری)

   روی VPS می‌توانید رلهٔ WebSocket را اجرا کنید تا اطلاعات تماس‌گیرنده بلافاصله نمایش داده شود، نه در فاصله‌های polling. برای TLS، nginx را جلوی آن قرار دهید و نشانی WebSocket مرورگر را در Settings تنظیم کنید.

5. ۵. تعیین داخلی هر اپراتور

   هر اپراتور داخلی SIP خود را در پروفایل WordPress خودش تنظیم می‌کند. همین باعث می‌شود تماس با یک کلیک دستگاه درست را به صدا درآورد و تماس‌ها به شخص درست نسبت داده شوند.

6. ۶. سافت‌فون مرورگر (Pro)

   برای تماس از داخل مرورگر، حساب‌های SIP مبتنی بر WebRTC را در VoIPPress → Softphone اضافه کنید و به اپراتورها اختصاص دهید؛ هر اپراتور فقط می‌تواند روی حساب‌هایی که به او اختصاص داده شده ثبت شود. در Asterisk به یک transport از نوع wss، تنظیم webrtc=yes روی endpointها و یک گواهی TLS روی پورت 8089 نیاز دارید؛ افزونه یک مولد دارد که این پیکربندی را برایتان می‌نویسد.

نکات امنیتی

• درخواست‌های دریافت رویداد با یک رمز HMAC احراز هویت می‌شوند و محدودیت نرخ دارند.
• اطلاعات دسترسی SIP رمزنگاری‌شده ذخیره می‌شوند و هرگز در اختیار مرورگر قرار نمی‌گیرند.
• خروجی‌های CSV تزریق فرمول صفحه‌گسترده را بی‌اثر می‌کنند.
• فایل‌های نمودار همراه افزونه ارائه می‌شوند و با هیچ CDN شخص ثالثی ارتباط برقرار نمی‌شود.
• خروجی‌گیری و حذف داده‌های تماس ذخیره‌شده طبق GDPR پشتیبانی می‌شود.

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

Test connection ناموفق است

فایروال میان WordPress و PBX را بررسی کنید: AMI روی پورت 5038 و ARI روی پورت 8088 کار می‌کند. خط permit در manager.conf باید IP عمومی سرور WordPress شما را شامل شود.

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

مطمئن شوید عامل بریج در حال اجراست یا قطعهٔ dialplan در context ورودی قرار دارد، و در VoIPPress → Call history دنبال ردیف‌های تماس ورودی بگردید.

تماس‌ها در وضعیت «در حال زنگ خوردن» می‌مانند

PBX رویدادهای CDR یا قطع تماس را ارسال نمی‌کند. مطمئن شوید کاربر AMI مجوز خواندن cdr را دارد و عامل بریج متصل است.

بیشتر فروشگاه‌ها ظرف یک بعدازظهر راه‌اندازی می‌شوند. پیش از خرید می‌توانید درخواست یک جلسهٔ نمایش هم بدهید: افزونه شبیه‌ساز تماس آزمایشی دارد که نمایش اطلاعات تماس‌گیرنده را بدون اتصال به PBX نشان می‌دهد.