https://wiki.hesabix.ir/index.php/%D9%88%DB%8C%DA%98%D9%87:%D8%AA%D8%BA%DB%8C%DB%8C%D8%B1%D8%A7%D8%AA_%D8%A7%D8%AE%DB%8C%D8%B1 آخرین تغییرات ویکی را در این خوراک پیگیری کنید. fa MediaWiki 1.45.1 Mon, 24 Aug 2026 04:47:34 GMT https://wiki.hesabix.ir/index.php?title=%D8%B1%D8%A7%D9%87%D9%86%D9%85%D8%A7%DB%8C_%D8%A7%D8%AA%D8%B5%D8%A7%D9%84_%D9%85%D8%B1%DA%A9%D8%B2_%D8%AA%D9%84%D9%81%D9%86_%D8%A7%DB%8C%D8%B2%D8%A7%D8%A8%D9%84_%D9%88_%D8%A7%D8%B3%D8%AA%D8%B1%DB%8C%DA%A9%D8%B3_%D8%A8%D9%87_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3&diff=52&oldid=0 https://wiki.hesabix.ir/index.php?title=%D8%B1%D8%A7%D9%87%D9%86%D9%85%D8%A7%DB%8C_%D8%A7%D8%AA%D8%B5%D8%A7%D9%84_%D9%85%D8%B1%DA%A9%D8%B2_%D8%AA%D9%84%D9%81%D9%86_%D8%A7%DB%8C%D8%B2%D8%A7%D8%A8%D9%84_%D9%88_%D8%A7%D8%B3%D8%AA%D8%B1%DB%8C%DA%A9%D8%B3_%D8%A8%D9%87_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3&diff=52&oldid=0 <p>صفحه‌ای تازه حاوی « = راهنمای اتصال مرکز تلفن به حسابیکس (Hesabix Telephony Connector) = این راهنما برای &#039;&#039;&#039;مدیران سیستم&#039;&#039;&#039;، &#039;&#039;&#039;مدیران تلفن&#039;&#039;&#039; و &#039;&#039;&#039;کاربران نهایی&#039;&#039;&#039; نوشته شده است. هدف آن توضیح سادهٔ نصب، پیکربندی و استفاده از کانکتور تلفنی حسابیکس روی سرور &#039;&#039;&#039;Issabel&#039;&#039;&#039; یا &#039;&#039;&#039;Asterisk&#039;&#039;&#039; است. &#039;&#039;&#039;ای...» ایجاد کرد</p> <p><b>صفحهٔ تازه</b></p><div><br /> = راهنمای اتصال مرکز تلفن به حسابیکس (Hesabix Telephony Connector) =<br /> این راهنما برای &#039;&#039;&#039;مدیران سیستم&#039;&#039;&#039;، &#039;&#039;&#039;مدیران تلفن&#039;&#039;&#039; و &#039;&#039;&#039;کاربران نهایی&#039;&#039;&#039; نوشته شده است. هدف آن توضیح سادهٔ نصب، پیکربندی و استفاده از کانکتور تلفنی حسابیکس روی سرور &#039;&#039;&#039;Issabel&#039;&#039;&#039; یا &#039;&#039;&#039;Asterisk&#039;&#039;&#039; است.<br /> <br /> &#039;&#039;&#039;این راهنما برای توسعه‌دهندگان نیست.&#039;&#039;&#039;<br /> ----<br /> <br /> == کانکتور چیست و چه کاری انجام می‌دهد؟ ==<br /> &#039;&#039;&#039;Hesabix Telephony Connector&#039;&#039;&#039; یک برنامهٔ سبک است که روی &#039;&#039;&#039;سرور تلفن شما&#039;&#039;&#039; (Issabel/Asterisk) نصب می‌شود و آن را به &#039;&#039;&#039;حسابیکس&#039;&#039;&#039; وصل می‌کند.<br /> <br /> === بدون کانکتور ===<br /> <br /> * حسابیکس نمی‌تواند تماس‌های ورودی/خروجی را ببیند<br /> * Screen Pop، Click-to-Call و تاریخچه تماس کار نمی‌کند<br /> * وضعیت مرکز تلفن در حسابیکس «آفلاین» می‌ماند<br /> <br /> === با کانکتور ===<br /> <br /> * رویدادهای تماس از Asterisk به حسابیکس ارسال می‌شود<br /> * حسابیکس می‌تواند دستور تماس (مثل برقراری تماس خروجی) را به سرور تلفن بفرستد<br /> * اپراتورها در وب، موبایل و دسکتاپ می‌توانند:<br /> ** هنگام زنگ خوردن، &#039;&#039;&#039;اطلاعات تماس‌گیرنده&#039;&#039;&#039; را ببینند (Screen Pop)<br /> ** از روی پروفایل مشتری &#039;&#039;&#039;تماس خروجی&#039;&#039;&#039; بگیرند (Click-to-Call)<br /> ** &#039;&#039;&#039;تاریخچه تماس&#039;&#039;&#039; را ببینند<br /> ** وضعیت &#039;&#039;&#039;آنلاین/آفلاین&#039;&#039;&#039; مرکز تلفن را مشاهده کنند<br /> <br /> === نکته مهم درباره معماری ===<br /> کانکتور روی &#039;&#039;&#039;سرور تلفن شما&#039;&#039;&#039; نصب می‌شود، نه روی سرور حسابیکس.<br /> {|<br /> |+نمای ساده اتصال<br /> |&#039;&#039;&#039;کاربر (اپراتور)&#039;&#039;&#039;<br /> |← →<br /> |&#039;&#039;&#039;حسابیکس (ابر/سرور شما)&#039;&#039;&#039;<br /> |-<br /> |&#039;&#039;&#039;کانکتور&#039;&#039;&#039;<br /> |← →<br /> |&#039;&#039;&#039;Issabel / Asterisk (سرور تلفن)&#039;&#039;&#039;<br /> |}<br /> کانکتور فقط از سرور تلفن به سمت حسابیکس &#039;&#039;&#039;خروجی HTTPS&#039;&#039;&#039; می‌زند؛ معمولاً نیازی به باز کردن پورت ورودی روی فایروال سرور تلفن نیست.<br /> ----<br /> <br /> == پیش‌نیازها ==<br /> <br /> === سخت‌افزار و شبکه ===<br /> <br /> * یک سرور &#039;&#039;&#039;Issabel&#039;&#039;&#039; یا &#039;&#039;&#039;Asterisk&#039;&#039;&#039; فعال<br /> * دسترسی &#039;&#039;&#039;root&#039;&#039;&#039; به سرور تلفن (با یا بدون دستور &lt;code&gt;sudo&lt;/code&gt;)<br /> * اتصال اینترنت از سرور تلفن به آدرس API حسابیکس (پورت ۴۴۳ / HTTPS)<br /> * Asterisk AMI فعال (پورت پیش‌فرض: ۵۰۳۸)<br /> <br /> === نرم‌افزار ===<br /> اسکریپت نصب در صورت نبود، این موارد را خودکار نصب می‌کند:<br /> <br /> * Python 3<br /> * rsync<br /> * curl<br /> * git<br /> <br /> === توزیع‌های پشتیبانی‌شده ===<br /> {| class=&quot;wikitable&quot;<br /> !خانواده<br /> !نمونه توزیع‌ها<br /> !مدیر بسته<br /> |-<br /> |Debian<br /> |Debian، Ubuntu<br /> |&lt;code&gt;apt-get&lt;/code&gt;<br /> |-<br /> |RHEL<br /> |CentOS، Rocky، Alma، &#039;&#039;&#039;Issabel&#039;&#039;&#039;<br /> |&lt;code&gt;yum&lt;/code&gt; یا &lt;code&gt;dnf&lt;/code&gt;<br /> |}<br /> <br /> === دسترسی‌های لازم در حسابیکس ===<br /> قبل از نصب کانکتور، در پنل حسابیکس این کارها انجام شود:<br /> <br /> # افزونه &#039;&#039;&#039;تلفنی / Telephony&#039;&#039;&#039; برای کسب‌وکار فعال باشد<br /> # یک &#039;&#039;&#039;مرکز تلفن (PBX)&#039;&#039;&#039; ساخته شود<br /> # &#039;&#039;&#039;توکن Connector&#039;&#039;&#039; از تنظیمات مرکز تلفن کپی شود<br /> # (در صورت نیاز) &#039;&#039;&#039;شناسه کسب‌وکار&#039;&#039;&#039; و &#039;&#039;&#039;شناسه مرکز تلفن&#039;&#039;&#039; یادداشت شود<br /> <br /> ----<br /> <br /> == آماده‌سازی در حسابیکس (قبل از نصب) ==<br /> <br /> === گام ۱: فعال‌سازی افزونه ===<br /> <br /> # وارد حسابیکس شوید<br /> # به بخش &#039;&#039;&#039;مارکت‌پلیس / افزونه‌ها&#039;&#039;&#039; بروید<br /> # افزونه تلفنی (Telephony) را برای کسب‌وکار خود فعال کنید<br /> <br /> === گام ۲: ساخت مرکز تلفن ===<br /> <br /> # به بخش &#039;&#039;&#039;مرکز تلفن / Telephony&#039;&#039;&#039; بروید<br /> # یک مرکز تلفن جدید بسازید (نام، توضیحات و …)<br /> # نوع اتصال: &#039;&#039;&#039;Issabel / Asterisk&#039;&#039;&#039; (یا معادل آن در رابط کاربری)<br /> <br /> === گام ۳: دریافت اطلاعات اتصال ===<br /> از صفحهٔ تنظیمات مرکز تلفن این موارد را یادداشت کنید:<br /> {| class=&quot;wikitable&quot;<br /> !مورد<br /> !توضیح<br /> !مثال<br /> |-<br /> |آدرس API حسابیکس<br /> |آدرس سرویس حسابیکس شما<br /> |&lt;code&gt;https://hsxn.hesabix.ir&lt;/code&gt;<br /> |-<br /> |شناسه کسب‌وکار (Business ID)<br /> |عدد شناسه کسب‌وکار<br /> |&lt;code&gt;12&lt;/code&gt;<br /> |-<br /> |شناسه مرکز تلفن (PBX ID)<br /> |عدد شناسه مرکز تلفن<br /> |&lt;code&gt;3&lt;/code&gt;<br /> |-<br /> |توکن Connector<br /> |رشتهٔ امن اتصال<br /> |&lt;code&gt;hsx_tel_...&lt;/code&gt;<br /> |}<br /> &#039;&#039;&#039;هشدار امنیتی:&#039;&#039;&#039; توکن را مثل رمز عبور نگه دارید. در اختیار کسی قرار ندهید.<br /> ----<br /> <br /> == نصب کانکتور ==<br /> نصب روی &#039;&#039;&#039;سرور تلفن&#039;&#039;&#039; انجام می‌شود (SSH به Issabel/Asterisk).<br /> <br /> === روش پیشنهادی: نصب یک‌خطی ===<br /> &#039;&#039;&#039;اگر سیستم شما &lt;code&gt;sudo&lt;/code&gt; دارد&#039;&#039;&#039; (مثلاً Ubuntu):&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> curl -fsSL https://source.hesabix.ir/hesabix/arc/raw/branch/master/extraScripts/HesabixTelephonyConnector/install.sh | sudo bash<br /> &lt;/syntaxhighlight&gt;&#039;&#039;&#039;اگر &lt;code&gt;sudo&lt;/code&gt; ندارید&#039;&#039;&#039; (مثلاً Debian یا Issabel با ورود مستقیم root):&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> curl -fsSL https://source.hesabix.ir/hesabix/arc/raw/branch/master/extraScripts/HesabixTelephonyConnector/install.sh | bash<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === تغییر آدرس API هنگام نصب ===<br /> پیش‌فرض آدرس API برابر &lt;code&gt;https://hsxn.hesabix.ir&lt;/code&gt; است. اگر سرور اختصاصی دارید:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> curl -fsSL https://source.hesabix.ir/hesabix/arc/raw/branch/master/extraScripts/HesabixTelephonyConnector/install.sh \<br /> | HESABIX_API_URL=https://my-api.example.com bash<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === مراحلی که اسکریپت خودکار انجام می‌دهد ===<br /> <br /> # تشخیص سیستم‌عامل (Debian/Ubuntu یا Issabel/CentOS/RHEL)<br /> # نصب پیش‌نیازها در صورت نیاز<br /> # دانلود کانکتور از مخزن حسابیکس<br /> # نصب دستور &lt;code&gt;hesabix-pbx&lt;/code&gt; در سیستم<br /> # اجرای &#039;&#039;&#039;ویزارد پیکربندی&#039;&#039;&#039;<br /> # ثبت و فعال‌سازی سرویس &lt;code&gt;systemd&lt;/code&gt;<br /> <br /> === مسیر نصب پیش‌فرض ===<br /> &lt;syntaxhighlight lang=&quot;text&quot;&gt;<br /> /opt/HesabixTelephonyConnector<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == ویزارد پیکربندی (اولین بار) ==<br /> بعد از نصب، ویزارد از شما می‌پرسد:<br /> {| class=&quot;wikitable&quot;<br /> !سؤال<br /> !توضیح<br /> !پیش‌فرض<br /> |-<br /> |آدرس API حسابیکس<br /> |آدرس سرویس حسابیکس<br /> |&lt;code&gt;https://hsxn.hesabix.ir&lt;/code&gt;<br /> |-<br /> |شناسه کسب‌وکار<br /> |Business ID از حسابیکس<br /> |—<br /> |-<br /> |شناسه مرکز تلفن<br /> |PBX ID از حسابیکس<br /> |—<br /> |-<br /> |توکن Connector<br /> |از تنظیمات مرکز تلفن<br /> |—<br /> |-<br /> |آدرس AMI<br /> |معمولاً همان سرور محلی<br /> |&lt;code&gt;127.0.0.1&lt;/code&gt;<br /> |-<br /> |پورت AMI<br /> |پورت Asterisk Manager<br /> |&lt;code&gt;5038&lt;/code&gt;<br /> |-<br /> |کاربر AMI<br /> |نام کاربری AMI<br /> |&lt;code&gt;hesabix&lt;/code&gt;<br /> |-<br /> |رمز AMI<br /> |رمز کاربر AMI<br /> |—<br /> |-<br /> |ساخت کاربر AMI؟<br /> |آیا کانکتور کاربر را در &lt;code&gt;manager.conf&lt;/code&gt; بسازد؟<br /> |معمولاً &lt;code&gt;N&lt;/code&gt; مگر مطمئن نباشید<br /> |}<br /> &#039;&#039;&#039;نکته:&#039;&#039;&#039; اگر Issabel از قبل کاربر AMI دارد، همان را وارد کنید. در غیر این صورت می‌توانید با پاسخ &lt;code&gt;y&lt;/code&gt; اجازه دهید کانکتور کاربر را بسازد.<br /> <br /> پیکربندی در این فایل ذخیره می‌شود:&lt;syntaxhighlight lang=&quot;text&quot;&gt;<br /> /opt/HesabixTelephonyConnector/.env<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == تست اتصال ==<br /> بعد از نصب، حتماً تست کنید:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx test<br /> &lt;/syntaxhighlight&gt;این دستور دو تست انجام می‌دهد:<br /> <br /> # &#039;&#039;&#039;تست AMI&#039;&#039;&#039; — اتصال به Asterisk و ورود با کاربر AMI<br /> # &#039;&#039;&#039;تست Heartbeat حسابیکس&#039;&#039;&#039; — ارسال سیگنال زنده به API حسابیکس<br /> <br /> اگر هر دو موفق باشند، در حسابیکس وضعیت مرکز تلفن باید &#039;&#039;&#039;آنلاین (Online)&#039;&#039;&#039; شود.<br /> <br /> برای مشاهده وضعیت کلی:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx status<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == دستورات روزمره (CLI) ==<br /> همهٔ دستورات زیر روی &#039;&#039;&#039;سرور تلفن&#039;&#039;&#039; و با دسترسی root اجرا می‌شوند.<br /> {| class=&quot;wikitable&quot;<br /> !دستور<br /> !کاربرد<br /> |-<br /> |&lt;code&gt;hesabix-pbx status&lt;/code&gt;<br /> |نمایش وضعیت سرویس، سیستم‌عامل، API، AMI و …<br /> |-<br /> |&lt;code&gt;hesabix-pbx test&lt;/code&gt;<br /> |تست AMI و اتصال به حسابیکس<br /> |-<br /> |&lt;code&gt;hesabix-pbx configure&lt;/code&gt;<br /> |تغییر توکن، آدرس API، تنظیمات AMI<br /> |-<br /> |&lt;code&gt;hesabix-pbx start&lt;/code&gt;<br /> |شروع سرویس کانکتور<br /> |-<br /> |&lt;code&gt;hesabix-pbx stop&lt;/code&gt;<br /> |توقف سرویس<br /> |-<br /> |&lt;code&gt;hesabix-pbx restart&lt;/code&gt;<br /> |ری‌استارت سرویس<br /> |-<br /> |&lt;code&gt;hesabix-pbx update&lt;/code&gt;<br /> |به‌روزرسانی کانکتور از مخزن حسابیکس<br /> |-<br /> |&lt;code&gt;hesabix-pbx reinstall&lt;/code&gt;<br /> |نصب مجدد (فایل &lt;code&gt;.env&lt;/code&gt; حفظ می‌شود)<br /> |-<br /> |&lt;code&gt;hesabix-pbx logs&lt;/code&gt;<br /> |مشاهده آخرین لاگ‌ها (پیش‌فرض ۸۰ خط)<br /> |-<br /> |&lt;code&gt;hesabix-pbx logs 200&lt;/code&gt;<br /> |مشاهده ۲۰۰ خط آخر لاگ<br /> |-<br /> |&lt;code&gt;hesabix-pbx follow&lt;/code&gt;<br /> |مشاهده زندهٔ لاگ (مثل &lt;code&gt;tail -f&lt;/code&gt;)<br /> |-<br /> |&lt;code&gt;hesabix-pbx uninstall&lt;/code&gt;<br /> |حذف سرویس و دستور CLI<br /> |-<br /> |&lt;code&gt;hesabix-pbx help&lt;/code&gt;<br /> |نمایش راهنمای دستورات<br /> |}<br /> <br /> === مثال: اجرا با sudo ===<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> sudo hesabix-pbx status<br /> sudo hesabix-pbx test<br /> sudo hesabix-pbx update<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === مثال: اجرا بدون sudo (کاربر root) ===<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx status<br /> hesabix-pbx test<br /> hesabix-pbx update<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == به‌روزرسانی کانکتور ==<br /> برای دریافت آخرین نسخه:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx update<br /> &lt;/syntaxhighlight&gt;این دستور:<br /> <br /> * پیش‌نیازها را بررسی می‌کند<br /> * فایل‌های جدید را دانلود می‌کند<br /> * سرویس را ری‌استارت می‌کند<br /> * فایل &lt;code&gt;.env&lt;/code&gt; شما را &#039;&#039;&#039;حفظ&#039;&#039;&#039; می‌کند<br /> <br /> بعد از به‌روزرسانی:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx status<br /> hesabix-pbx test<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == تغییر تنظیمات بعد از نصب ==<br /> <br /> === تغییر توکن، API یا AMI ===<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx configure<br /> hesabix-pbx restart<br /> hesabix-pbx test<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === موارد رایج تغییر ===<br /> <br /> * &#039;&#039;&#039;توکن جدید&#039;&#039;&#039; بعد از لو رفتن توکن قبلی<br /> * &#039;&#039;&#039;آدرس API&#039;&#039;&#039; بعد از تغییر دامنه حسابیکس<br /> * &#039;&#039;&#039;رمز AMI&#039;&#039;&#039; بعد از تغییر در Asterisk<br /> <br /> ----<br /> <br /> == پیکربندی دستی (بدون ویزارد) ==<br /> اگر ترجیح می‌دهید فایل را مستقیم ویرایش کنید:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> cp /opt/HesabixTelephonyConnector/config.example.env /opt/HesabixTelephonyConnector/.env<br /> nano /opt/HesabixTelephonyConnector/.env<br /> hesabix-pbx restart<br /> hesabix-pbx test<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === نمونه محتوای فایل &lt;code&gt;.env&lt;/code&gt; ===<br /> &lt;syntaxhighlight lang=&quot;ini&quot;&gt;<br /> HESABIX_API_URL=https://hsxn.hesabix.ir<br /> HESABIX_BUSINESS_ID=1<br /> HESABIX_PBX_ID=1<br /> HESABIX_CONNECTOR_TOKEN=hsx_tel_replace_me<br /> AMI_HOST=127.0.0.1<br /> AMI_PORT=5038<br /> AMI_USER=hesabix<br /> AMI_SECRET=change_me<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == کاربرد برای کاربران حسابیکس ==<br /> بعد از اتصال موفق، این امکانات (بسته به فعال بودن افزونه و دسترسی کاربر) در دسترس است:<br /> <br /> === برای اپراتور (فروش / پشتیبانی) ===<br /> <br /> * &#039;&#039;&#039;Screen Pop:&#039;&#039;&#039; هنگام زنگ خوردن، نام مشتری، مانده حساب و اطلاعات مرتبط نمایش داده می‌شود<br /> * &#039;&#039;&#039;Click-to-Call:&#039;&#039;&#039; از پروفایل مشتری می‌توان تماس خروجی گرفت<br /> * &#039;&#039;&#039;تاریخچه تماس:&#039;&#039;&#039; مشاهده تماس‌های قبلی هر مشتری<br /> * &#039;&#039;&#039;ثبت نتیجه تماس:&#039;&#039;&#039; یادداشت و پیگیری بعد از مکالمه<br /> <br /> === برای مدیر تلفن ===<br /> <br /> * مشاهده وضعیت &#039;&#039;&#039;آنلاین/آفلاین&#039;&#039;&#039; مرکز تلفن<br /> * نگاشت &#039;&#039;&#039;کاربر حسابیکس ↔ داخلی تلفن&#039;&#039;&#039;<br /> * تنظیمات شناسایی شماره و رفتار Screen Pop<br /> <br /> === برای مدیر سیستم ===<br /> <br /> * مانیتورینگ اتصال از طریق &lt;code&gt;hesabix-pbx status&lt;/code&gt;<br /> * بررسی لاگ‌ها با &lt;code&gt;hesabix-pbx logs&lt;/code&gt;<br /> * به‌روزرسانی و نگهداری با &lt;code&gt;hesabix-pbx update&lt;/code&gt;<br /> <br /> ----<br /> <br /> == عیب‌یابی (مشکلات رایج) ==<br /> <br /> === ۱. مرکز تلفن در حسابیکس آفلاین است ===<br /> <br /> # روی سرور تلفن: &lt;code&gt;hesabix-pbx status&lt;/code&gt;<br /> # تست اتصال: &lt;code&gt;hesabix-pbx test&lt;/code&gt;<br /> # بررسی لاگ: &lt;code&gt;hesabix-pbx logs&lt;/code&gt;<br /> # مطمئن شوید توکن، Business ID و PBX ID درست است<br /> # مطمئن شوید سرور تلفن به آدرس API دسترسی HTTPS دارد<br /> <br /> === ۲. تست AMI ناموفق است ===<br /> <br /> * Asterisk در حال اجرا باشد<br /> * پورت AMI (معمولاً ۵۰۳۸) باز باشد — فقط روی localhost کافی است<br /> * کاربر و رمز AMI درست باشد<br /> * در صورت نیاز: &lt;code&gt;asterisk -rx &quot;manager reload&quot;&lt;/code&gt;<br /> <br /> === ۳. تست API حسابیکس ناموفق است ===<br /> <br /> * آدرس &lt;code&gt;HESABIX_API_URL&lt;/code&gt; را بررسی کنید (بدون اسلش اضافه در انتها)<br /> * DNS و فایروال سرور تلفن را بررسی کنید<br /> * توکن را در حسابیکس تجدید کنید و با &lt;code&gt;hesabix-pbx configure&lt;/code&gt; وارد کنید<br /> <br /> === ۴. دستور &lt;code&gt;sudo&lt;/code&gt; شناخته نمی‌شود ===<br /> با کاربر root وارد شوید و دستور را بدون sudo اجرا کنید:&lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx status<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === ۵. بعد از به‌روزرسانی مشکل پیش آمد ===<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx reinstall<br /> hesabix-pbx test<br /> &lt;/syntaxhighlight&gt;<br /> <br /> === ۶. سرویس اجرا نمی‌شود ===<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx status<br /> hesabix-pbx logs<br /> systemctl status hesabix-telephony-connector<br /> &lt;/syntaxhighlight&gt;<br /> ----<br /> <br /> == نکات امنیتی ==<br /> <br /> * کانکتور فقط به حسابیکس &#039;&#039;&#039;خروجی HTTPS&#039;&#039;&#039; می‌زند — نیازی به باز کردن پورت ورودی روی اینترنت نیست<br /> * پورت AMI (۵۰۳۸) را &#039;&#039;&#039;به اینترنت باز نکنید&#039;&#039;&#039; — فقط localhost یا شبکه داخلی<br /> * فایل &lt;code&gt;.env&lt;/code&gt; حاوی توکن و رمز AMI است؛ مجوز آن &lt;code&gt;600&lt;/code&gt; است<br /> * اگر توکن لو رفت:<br /> <br /> ## در حسابیکس توکن جدید بسازید<br /> ## روی سرور: &lt;code&gt;hesabix-pbx configure&lt;/code&gt;<br /> ## سپس: &lt;code&gt;hesabix-pbx restart&lt;/code&gt;<br /> <br /> ----<br /> <br /> == حذف کانکتور ==<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> hesabix-pbx uninstall<br /> &lt;/syntaxhighlight&gt;در پایان از شما پرسیده می‌شود آیا فایل &lt;code&gt;.env&lt;/code&gt; نگه داشته شود یا نه.<br /> <br /> * &#039;&#039;&#039;نگه داشتن .env&#039;&#039;&#039; — برای نصب مجدد بعدی مفید است<br /> * &#039;&#039;&#039;حذف کامل&#039;&#039;&#039; — همهٔ فایل‌ها پاک می‌شود<br /> <br /> ----<br /> <br /> == سوالات متداول (FAQ) ==<br /> <br /> === آیا کانکتور روی سرور حسابیکس نصب می‌شود؟ ===<br /> خیر. روی &#039;&#039;&#039;سرور Issabel/Asterisk&#039;&#039;&#039; نصب می‌شود.<br /> <br /> === آیا باید پورت جدیدی روی فایروال باز کنم؟ ===<br /> معمولاً خیر. فقط خروجی HTTPS به حسابیکس لازم است.<br /> <br /> === آیا با FreePBX هم کار می‌کند؟ ===<br /> اگر Asterisk AMI استاندارد داشته باشد، معمولاً بله. تمرکز رسمی روی &#039;&#039;&#039;Issabel&#039;&#039;&#039; است.<br /> <br /> === آدرس پیش‌فرض API چیست؟ ===<br /> &lt;code&gt;https://hsxn.hesabix.ir&lt;/code&gt;<br /> <br /> === چطور بفهمم همه‌چیز درست کار می‌کند؟ ===<br /> <br /> # &lt;code&gt;hesabix-pbx test&lt;/code&gt; هر دو تست را پاس کند<br /> # در حسابیکس وضعیت مرکز تلفن «آنلاین» باشد<br /> # یک تماس تست بگیرید و Screen Pop را در حسابیکس ببینید<br /> <br /> ----<br /> <br /> == خلاصه دستورات پرکاربرد ==<br /> &lt;syntaxhighlight lang=&quot;bash&quot;&gt;<br /> # نصب (یک‌خطی)<br /> curl -fsSL https://source.hesabix.ir/hesabix/arc/raw/branch/master/extraScripts/HesabixTelephonyConnector/install.sh | bash<br /> <br /> # وضعیت و تست<br /> hesabix-pbx status<br /> hesabix-pbx test<br /> <br /> # تغییر تنظیمات<br /> hesabix-pbx configure<br /> hesabix-pbx restart<br /> <br /> # به‌روزرسانی<br /> hesabix-pbx update<br /> <br /> # لاگ<br /> hesabix-pbx logs<br /> hesabix-pbx follow<br /> &lt;/syntaxhighlight&gt;<br /> ----</div> Mon, 03 Aug 2026 16:33:58 GMT Alizadeh.babak https://wiki.hesabix.ir/index.php/%D8%A8%D8%AD%D8%AB:%D8%B1%D8%A7%D9%87%D9%86%D9%85%D8%A7%DB%8C_%D8%A7%D8%AA%D8%B5%D8%A7%D9%84_%D9%85%D8%B1%DA%A9%D8%B2_%D8%AA%D9%84%D9%81%D9%86_%D8%A7%DB%8C%D8%B2%D8%A7%D8%A8%D9%84_%D9%88_%D8%A7%D8%B3%D8%AA%D8%B1%DB%8C%DA%A9%D8%B3_%D8%A8%D9%87_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3 https://wiki.hesabix.ir/index.php?title=%D8%A8%D9%87_%D8%B1%D9%88%D8%B2_%D8%B1%D8%B3%D8%A7%D9%86%DB%8C_%D8%B1%D8%A7%D8%A8%D8%B7_%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%DB%8C_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3&diff=51&oldid=0 https://wiki.hesabix.ir/index.php?title=%D8%A8%D9%87_%D8%B1%D9%88%D8%B2_%D8%B1%D8%B3%D8%A7%D9%86%DB%8C_%D8%B1%D8%A7%D8%A8%D8%B7_%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%DB%8C_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3&diff=51&oldid=0 <p>صفحه‌ای تازه حاوی «این صفحه توضیح می‌دهد چطور نسخهٔ &#039;&#039;&#039;رابط کاربری حسابیکس&#039;&#039;&#039; را در ویندوز، اندروید و وب به‌روز کنید. نسخه‌های جدید ویندوز و اندروید از طریق ریلیزهای رسمی منتشر می‌شوند: [https://source.hesabix.ir/hesabix/arc/releases صفحه ریلیزها] نسخهٔ وب معمولاً به‌صورت خودکار ر...» ایجاد کرد</p> <p><b>صفحهٔ تازه</b></p><div>این صفحه توضیح می‌دهد چطور نسخهٔ &#039;&#039;&#039;رابط کاربری حسابیکس&#039;&#039;&#039; را در ویندوز، اندروید و وب به‌روز کنید.<br /> <br /> نسخه‌های جدید ویندوز و اندروید از طریق ریلیزهای رسمی منتشر می‌شوند: [https://source.hesabix.ir/hesabix/arc/releases صفحه ریلیزها]<br /> <br /> نسخهٔ وب معمولاً به‌صورت خودکار روی سرور اعمال می‌شود و نیاز به نصب جداگانه ندارد.<br /> ----<br /> <br /> == به‌روزرسانی در ویندوز ==<br /> <br /> === روش ۱: به‌روزرسانی از داخل برنامه (پیشنهادی) ===<br /> <br /> # برنامهٔ حسابیکس را باز کنید و به اینترنت متصل باشید.<br /> # اگر نسخهٔ جدید آماده باشد، پنجره‌ای با عنوان نسخهٔ جدید و فهرست تغییرات نمایش داده می‌شود.<br /> # روی &#039;&#039;&#039;دانلود و نصب&#039;&#039;&#039; بزنید و صبر کنید تا دانلود تمام شود.<br /> # نصب‌کننده را تأیید کنید. ممکن است پنجرهٔ مجوز ویندوز (UAC) ظاهر شود؛ آن را تأیید کنید.<br /> # پس از نصب، دوباره حسابیکس را باز کنید.<br /> <br /> اگر الان نمی‌خواهید به‌روز کنید، می‌توانید &#039;&#039;&#039;بعداً&#039;&#039;&#039; را بزنید.<br /> <br /> === روش ۲: بررسی دستی از تنظیمات ===<br /> <br /> # وارد حسابیکس شوید.<br /> # بروید به: &#039;&#039;&#039;تنظیمات حساب کاربری&#039;&#039;&#039; ← &#039;&#039;&#039;به‌روزرسانی برنامه (ویندوز)&#039;&#039;&#039;<br /> # روی &#039;&#039;&#039;بررسی به‌روزرسانی&#039;&#039;&#039; بزنید.<br /> # اگر نسخهٔ جدید وجود داشت، &#039;&#039;&#039;دانلود و نصب&#039;&#039;&#039; را انتخاب کنید.<br /> <br /> === اگر به‌روزرسانی ویندوز انجام نشد ===<br /> <br /> * اتصال اینترنت را بررسی کنید.<br /> * برنامه را یک‌بار ببندید و دوباره باز کنید.<br /> * از مسیر تنظیمات بالا، دوباره «بررسی به‌روزرسانی» را بزنید.<br /> * در صورت نیاز، فایل نصب را از [https://source.hesabix.ir/hesabix/arc/releases صفحه ریلیزها] دانلود و نصب کنید (معمولاً فایل با پسوند &lt;code&gt;.msi&lt;/code&gt;).<br /> <br /> ----<br /> <br /> == به‌روزرسانی در اندروید ==<br /> حسابیکس اندروید از طریق فایل APK به‌روز می‌شود (نصب مستقیم روی گوشی).<br /> <br /> === روش ۱: به‌روزرسانی از داخل برنامه (پیشنهادی) ===<br /> <br /> # برنامه را باز کنید و به اینترنت متصل باشید.<br /> # اگر نسخهٔ جدید آماده باشد، پیام «نسخه جدید» نمایش داده می‌شود.<br /> # &#039;&#039;&#039;دانلود و نصب&#039;&#039;&#039; را بزنید.<br /> # پس از دانلود، نصب‌کنندهٔ اندروید باز می‌شود؛ نصب را تأیید کنید.<br /> <br /> اگر الان نمی‌خواهید، گزینهٔ &#039;&#039;&#039;بعداً&#039;&#039;&#039; را بزنید.<br /> <br /> === روش ۲: بررسی دستی از تنظیمات ===<br /> <br /> # وارد حسابیکس شوید.<br /> # بروید به: &#039;&#039;&#039;تنظیمات حساب کاربری&#039;&#039;&#039; ← &#039;&#039;&#039;به‌روزرسانی برنامه&#039;&#039;&#039;<br /> # &#039;&#039;&#039;بررسی به‌روزرسانی&#039;&#039;&#039; را بزنید.<br /> # در صورت وجود نسخهٔ جدید، &#039;&#039;&#039;دانلود و نصب&#039;&#039;&#039; را انتخاب کنید.<br /> <br /> === اجازهٔ نصب از منابع ناشناس ===<br /> اگر اندروید اجازهٔ نصب نداد:<br /> <br /> # در همان صفحهٔ به‌روزرسانی، &#039;&#039;&#039;تنظیمات نصب از منابع ناشناس&#039;&#039;&#039; را باز کنید.<br /> # اجازهٔ نصب برای &#039;&#039;&#039;حسابیکس&#039;&#039;&#039; را فعال کنید.<br /> # دوباره به برنامه برگردید و &#039;&#039;&#039;دانلود و نصب&#039;&#039;&#039; را بزنید.<br /> <br /> === اگر به‌روزرسانی اندروید انجام نشد ===<br /> <br /> * اینترنت پایدار داشته باشید (حجم فایل نصب معمولاً زیاد است).<br /> * فضای کافی روی گوشی آزاد کنید.<br /> * اجازهٔ «نصب از منابع ناشناس» را برای حسابیکس فعال کنید.<br /> * در صورت نیاز، فایل APK را از [https://source.hesabix.ir/hesabix/arc/releases صفحه ریلیزها] دانلود و نصب کنید.<br /> <br /> ----<br /> <br /> == به‌روزرسانی در نسخهٔ وب ==<br /> نسخهٔ وب معمولاً خودش به‌روز می‌شود و نیازی به دانلود یا نصب نیست.<br /> <br /> === رفتار عادی ===<br /> <br /> * وقتی نسخهٔ جدید روی سرور منتشر شود، ممکن است پیام زیر را ببینید:<br /> <br /> :: &#039;&#039;&#039;نسخه جدید حسابیکس در حال اعمال است، صفحه به زودی به‌روزرسانی می‌شود.&#039;&#039;&#039;<br /> <br /> * صفحه معمولاً به‌صورت خودکار رفرش می‌شود و نسخهٔ جدید اعمال می‌گردد.<br /> <br /> === اگر نسخهٔ جدید وب اعمال نشد ===<br /> به‌ترتیب این کارها را انجام دهید:<br /> <br /> # صفحه را با کلیدهای میانبر سخت‌رفرش کنید:<br /> #* ویندوز / لینوکس: &lt;kbd&gt;Ctrl&lt;/kbd&gt; + &lt;kbd&gt;F5&lt;/kbd&gt; یا &lt;kbd&gt;Ctrl&lt;/kbd&gt; + &lt;kbd&gt;Shift&lt;/kbd&gt; + &lt;kbd&gt;R&lt;/kbd&gt;<br /> #* مک: &lt;kbd&gt;Cmd&lt;/kbd&gt; + &lt;kbd&gt;Shift&lt;/kbd&gt; + &lt;kbd&gt;R&lt;/kbd&gt;<br /> # یک‌بار از حساب خارج شوید، تب را ببندید، دوباره سایت را باز کنید و وارد شوید.<br /> # کش مرورگر را پاک کنید (حداقل برای سایت حسابیکس):<br /> #* Chrome / Edge: تنظیمات ← حریم خصوصی و امنیت ← پاک کردن داده‌های مرور ← گزینهٔ &#039;&#039;&#039;تصاویر و فایل‌های ذخیره‌شده در حافظه پنهان&#039;&#039;&#039; (Cache)<br /> #* Firefox: تنظیمات ← حریم خصوصی و امنیت ← کوکی‌ها و داده‌های سایت ← پاک کردن داده‌ها ← &#039;&#039;&#039;محتوای وب ذخیره‌شده در حافظه نهان&#039;&#039;&#039;<br /> # اگر حسابیکس را به‌صورت PWA / میانبر صفحهٔ اصلی نصب کرده‌اید، آن را ببندید و دوباره باز کنید؛ در صورت ادامهٔ مشکل، میانبر را حذف و دوباره از مرورگر باز کنید.<br /> # مرورگر را کامل ببندید و دوباره باز کنید.<br /> <br /> {{نکته}} پاک کردن کامل تاریخچه یا کوکی‌ها معمولاً لازم نیست؛ پاک کردن &#039;&#039;&#039;کش (Cache)&#039;&#039;&#039; برای اعمال نسخهٔ جدید وب کافی است. اگر فقط کش را پاک کنید، معمولاً نیازی به ورود دوباره نیست؛ ولی اگر کوکی‌ها را هم پاک کنید، باید دوباره وارد حساب شوید. {{پایان نکته}}<br /> ----<br /> <br /> == نکات مشترک ==<br /> <br /> * برای دیدن نسخهٔ فعلی در اندروید و ویندوز، از صفحهٔ &#039;&#039;&#039;به‌روزرسانی برنامه&#039;&#039;&#039; در تنظیمات حساب کاربری استفاده کنید.<br /> * هنگام به‌روزرسانی، کار ذخیره‌نشده را ذخیره کنید و تا پایان نصب صبر کنید.<br /> * اگر پیام خطا دیدید، اتصال اینترنت را بررسی کنید و چند دقیقه بعد دوباره امتحان کنید.<br /> * ریلیزهای رسمی ویندوز و اندروید:<br /> <br /> :: https://source.hesabix.ir/hesabix/arc/releases</div> Sun, 02 Aug 2026 13:54:21 GMT Alizadeh.babak https://wiki.hesabix.ir/index.php/%D8%A8%D8%AD%D8%AB:%D8%A8%D9%87_%D8%B1%D9%88%D8%B2_%D8%B1%D8%B3%D8%A7%D9%86%DB%8C_%D8%B1%D8%A7%D8%A8%D8%B7_%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%DB%8C_%D8%AD%D8%B3%D8%A7%D8%A8%DB%8C%DA%A9%D8%B3