نمایش مبدأ برای دستور /crm* در روبات بله و تلگرام


= چت وب CRM از طریق تلگرام و بله (راهنمای اپراتور) =
[[پرونده:Screenshot 2026-04-29 060049.png|بندانگشتی|نمونه بازگشتی /crmchat]]
این بخش برای '''کاربرانی است که قرار است به '<nowiki/>'''''بازدیدکنندگان ویجت چت وب CRM'<nowiki/>'' '''پاسخ بدهند'''، نه برای مهمان ویجت. اتصال ربات از داخل برنامهٔ Hesabix انجام می‌شود (لینک اتصال تلگرام/بله). بعد از اتصال، پیام‌ها از طریق همان ربات به مکالمهٔ ویجت در CRM ارسال می‌شود.

'''پیش‌نیاز دسترسی:''' فقط روی '''کسب‌وکارهایی''' می‌توانید کار کنید که '''مالک''' آن باشید یا به‌عنوان '''عضو''' با مجوز '''پاسخ‌گویی چت وب CRM''' در آن عضو شده باشید. فهرست انتخاب کسب‌وکار در ربات '''فقط''' همین موارد را نشان می‌دهد؛ امکان دیدن یا انتخاب بقیهٔ کسب‌وکارهای سیستم وجود ندارد.
----

== شروع سریع ==

# در برنامه Hesabix، '''اتصال تلگرام''' یا '''اتصال بله''' را انجام دهید.
# در ربات، دستور <code>/crmchat</code> را بفرستید یا از '''دکمه‌های شیشه‌ای (inline)''' استفاده کنید (مثلاً «شروع چت وب»).
# از '''فهرست کسب‌وکارها''' یک مورد را با '''دکمه''' انتخاب کنید (در صورت زیاد بودن، '''صفحه بعد/قبل''' دارید).
# با <code>/list</code> یا دکمهٔ «فهرست مکالمات»، مکالمات را ببینید و با دکمه یا <code>/open</code> یکی را باز کنید.
# متن پاسخ را '''بدون''' علامت <code>/</code> بفرستید؛ پاسخ در چت وب ثبت می‌شود.

'''ورود مستقیم به انتخاب کسب‌وکار (لینک عمیق):'''

* تلگرام: <code>https://t.me/&#x3C;نام‌کاربری‌ربات&#x3E;?start=crm</code> (بعد از اتصال حساب)
* بله: لینک مشابه با پارامتر <code>start=crm</code> (طبق لینک‌هایی که برنامه می‌دهد)

----

== دکمه‌ها در مقابل تایپ دستور ==
ربات برای اکثر مراحل '''دکمهٔ اینلاین''' می‌فرستد. با زدن هر دکمه همان کاری انجام می‌شود که معادل آن با '''دستور متنی''' است؛ برای راحتی روی موبایل، '''اولویت با دکمه‌ها''' است.

در '''بله''' هم پس از به‌روزرسانی سرور، کلیک روی دکمه‌ها همان '''callback''' را می‌فرستد؛ اگر دکمه‌ای جواب نداد، از دستورهای متنی همان بخش استفاده کنید.
----

== خلاصهٔ دستورها ==
{| class="wikitable"
!دستور
!کاربرد
|-
|<code>/crmchat</code>
|شروع: نمایش فهرست کسب‌وکارهای مجاز برای انتخاب
|-
|<code>/bizpick</code>
|باز کردن دوبارهٔ فهرست انتخاب کسب‌وکار (مشابه شروع؛ با صفحه‌بندی)
|-
|<code>/biz &#x3C;شناسه&#x3E;</code>
|انتخاب '''دستی''' کسب‌وکار با شماره؛ '''فقط''' اگر برای آن کسب‌وکار مجوز داشته باشید. در غیر این صورت پیام خطا و عبور به مرحلهٔ بعد '''نیست'''
|-
|<code>/list</code>
|فهرست مکالمه‌های چت وب برای '''کسب‌وکار انتخاب‌شده'''
|-
|<code>/more</code>
|صفحهٔ '''بعدی''' فهرست مکالمات (وقتی دکمهٔ «بیشتر» دارید)
|-
|<code>/open &#x3C;شناسه&#x3E;</code>
|باز کردن یک مکالمه و نمایش آخرین پیام‌ها؛ بعد از آن هر متنِ بدون <code>/</code> به‌عنوان '''پاسخ عامل''' ارسال می‌شود
|-
|<code>/history</code>
|بارگذاری '''پیام‌های قدیمی‌تر''' همان مکالمهٔ باز
|-
|<code>/cancel</code>
|خروج از مکالمهٔ باز (بدون پاک کردن انتخاب کسب‌وکار)
|-
|<code>/exit</code>
|'''پاک‌سازی نشست''' در ربات (انتخاب کسب‌وکار و حالت‌ها reset می‌شود)
|-
|<code>/status</code>
|نمایش حالت فعلی (کدام کسب‌وکار، مکالمهٔ باز، …)
|-
|<code>/crmhelp</code>
|همین راهنمای دستوری به‌صورت خلاصه در پیام
|}
'''میانبر عددی (در بعضی حالت‌ها):'''

* وقتی در مرحلهٔ '''انتخاب کسب‌وکار''' هستید، اگر '''فقط یک عدد''' بفرستید، همانند <code>/biz همان_عدد</code> بررسی می‌شود؛ بدون مجوز، پیام خطا می‌گیرید و حالت عوض نمی‌شود.
* وقتی کسب‌وکار را قبلاً انتخاب کرده‌اید و در حالت '''آماده''' یا '''مرور فهرست''' هستید، '''فقط عدد''' می‌تواند به‌عنوان <code>/open همان_عدد</code> تفسیر شود.

----

== توضیح تک‌تک دستورها ==

=== <code>/crmchat</code> ===

* '''کاربرد:''' ورود به جریان اپراتور چت وب.
* '''خروجی:''' اگر فقط '''یک''' کسب‌وکار مجاز داشته باشید، همان به‌صورت خودکار انتخاب می‌شود و مستقیم به مرحلهٔ مکالمات نزدیک می‌شوید.
* اگر '''چند''' کسب‌وکار داشته باشید، '''دکمهٔ هر کسب‌وکار''' و در صورت نیاز '''صفحهٔ بعد/قبل''' و '''از اول''' نمایش داده می‌شود.
* اگر '''هیچ''' کسب‌وکار مجازی نباشد، پیام مناسب می‌گیرید (با راهنمایی برای بررسی نقش و مجوز در برنامه).

=== <code>/bizpick</code> ===

* '''کاربرد:''' وقتی می‌خواهید دوباره از اول '''فهرست انتخاب کسب‌وکار''' را ببینید (مثلاً بعد از عوض کردن نیت کاری).
* معمولاً همان کار را دکمه‌های «از اول» یا «عوض کردن کسب‌وکار» هم انجام می‌دهند.

=== <code>/biz &#x3C;شناسه&#x3E;</code> ===

* '''کاربرد:''' وقتی شناسهٔ کسب‌وکار را از جای دیگر (مثلاً پنل) می‌دانید و می‌خواهید '''بدون دکمه''' انتخاب کنید.
* '''امنیت:''' اگر آن شناسه '''کسب‌وکار مجاز شما نباشد'''، فقط '''هشدار''' دریافت می‌کنید و '''به مرحلهٔ بعد نمی‌روید''' (کسب‌وکار در نشست ست نمی‌شود).

=== <code>/list</code> ===

* '''پیش‌نیاز:''' یک کسب‌وکار باید قبلاً انتخاب شده باشد.
* '''خروجی:''' فهرست مکالمات با '''دکمهٔ باز کردن''' برای هر ردیف (و در صورت وجود، دکمهٔ صفحه‌بندی).

=== <code>/more</code> ===

* '''کاربرد:''' دیدن '''صفحهٔ بعد''' همان فهرست مکالماتی که با <code>/list</code> شروع شده است.
* اگر صفحهٔ بعدی نباشد، پیام راهنما دریافت می‌کنید.

=== <code>/open &#x3C;شناسه&#x3E;</code> ===

* '''کاربرد:''' ورود به یک مکالمهٔ مشخص برای '''خواندن و پاسخ دادن'''.
* مکالمه باید متعلق به '''همان کسب‌وکار انتخاب‌شده''' باشد؛ در غیر این صورت «مکالمه پیدا نشد» یا خطای دسترسی.

=== حالت «داخل مکالمه» (بعد از <code>/open</code>) ===

* هر متنی که '''با <code>/</code> شروع نشود''' به‌عنوان '''پاسخ عامل''' به بازدیدکننده در ویجت ارسال می‌شود.
* اگر '''دستور ناشناخته''' با <code>/</code> بفرستید، ربات یادآوری می‌کند که برای پاسخ فقط متن معمولی بفرستید یا از <code>/cancel</code> استفاده کنید.
* '''فایل/عکس''' در این مسیر '''به‌عنوان پاسخ عامل''' پشتیبانی نمی‌شود (فقط متن).

=== <code>/history</code> ===

* '''کاربرد:''' دیدن '''پیام‌های قدیمی‌تر''' در همان مکالمهٔ باز؛ برای ادامهٔ بارها می‌توانید دوباره بزنید تا به ابتدای مکالمه برسید.

=== <code>/cancel</code> ===

* '''کاربرد:''' بیرون آمدن از مکالمهٔ فعال؛ '''کسب‌وکار''' همچنان انتخاب شده می‌ماند تا بتوانید دوباره <code>/list</code> بزنید.

=== <code>/exit</code> ===

* '''کاربرد:''' ریست کامل نشست ربات (مثل شروع دوباره از صفر برای این قابلیت).

=== <code>/status</code> ===

* '''کاربرد:''' دیدن '''حالت فعلی''' (انتخاب کسب‌وکار، باز بودن مکالمه، …) همراه دکمه‌های میانبر.

=== <code>/crmhelp</code> ===

* '''کاربرد:''' دریافت متن خلاصهٔ دستورها و یادآوری میانبرها.

----

== نکات تلگرام و بله ==

* '''تلگرام:''' منوی اصلی ربات (اگر برای شما فعال باشد) ممکن است گزینهٔ «چت وب CRM» داشته باشد؛ همان جریان <code>/crmchat</code> است.
* '''بله:''' اگر متنی خارج از این جریان بفرستید و اپراتور نباشید یا ربات متوجه نشود، ممکن است پیام راهنما با '''دستورهای پیشنهادی''' دریافت کنید.
* '''قطع اتصال:''' طبق راهنمای برنامه (مثلاً دستور اختصاصی ربات یا تنظیمات کاربر) انجام شود.

----

== جمع‌بندی ==

* '''دکمه‌ها''' سریع‌ترین راه هستند؛ '''دستورها''' همان کار را پوشش می‌دهند.
* '''امنیت''' با '''محدود بودن فهرست کسب‌وکار''' و '''کنترل <code>/biz</code>''' رعایت می‌شود.
* برای '''پاسخ واقعی به مشتری'''، حتماً داخل مکالمه باشید و '''فقط متن''' (بدون <code>/</code>) بفرستید.

[[دسته:آموزش]] [[دسته:CRM]]