پیامرسان بله¶
ماژول پیامرسان بله امکان اتصال ربات پیامرسان بله را به برنامه پیامرسان فراهم میکند. با این ماژول، پیامهایی که کاربران بله برای ربات شما میفرستند مستقیماً در سازمانیار نمایش داده میشوند و کارشناسان شما میتوانند بدون خروج از سازمانیار و درست مانند یک گفتگوی داخلی به آنها پاسخ دهند.
این یکپارچگی برای تیمهای پشتیبانی، فروش و ارتباط با مشتری بسیار کاربردی است: همهٔ مکالمهها در یک محیط متمرکز میشوند، سابقهٔ گفتگوها حفظ میشود و دیگر نیازی به جابهجایی پیوسته میان سازمانیار و اپلیکیشن بله نیست.
پیشنیازها¶
پیش از شروع، مطمئن شوید که موارد زیر فراهم است:
نسخهٔ ۱۹.۰ سازمانیار نصب باشد.
سرور به اینترنت دسترسی داشته باشد تا بتواند پیامها (webhook) را از بله دریافت کند.
سرور روی یک آدرس HTTPS معتبر در دسترس باشد. بله تنها پورتهای ۴۴۳ و ۸۸ را میپذیرد، بنابراین سرور باید روی یکی از این دو پورت پاسخگو باشد.
یک حساب کاربری در پیامرسان بله داشته باشید.
مهم
اگر سرور سازمانیار شما از طریق اینترنت و با HTTPS در دسترس نباشد، بله نمیتواند پیامها را به سازمانیار تحویل دهد و دریافت پیام کار نخواهد کرد. این مهمترین پیشنیاز فنی است.
ساخت ربات در بله¶
هر ارتباطی با بله از طریق یک «ربات» انجام میشود. درست مانند تلگرام، در بله نیز رباتی رسمی به نام BotFather وجود دارد که کار ساخت و مدیریت رباتها را بر عهده دارد. در پایان این مرحله یک توکن دریافت میکنید؛ این توکن کلید اتصال ربات شما به سازمانیار است.
برای ساخت ربات، مراحل زیر را دنبال کنید:
در اپلیکیشن بله، عبارت
@BotFatherرا جستجو کنید و ربات رسمی آن را باز کنید. سپس دستور/newbotرا برای آن ارسال کنید.BotFather از شما یک نام نمایشی برای ربات میخواهد. میتوانید یک نام فارسی یا انگلیسی وارد کنید، مثلاً «پشتیبانی شرکت من».
سپس باید یک نام کاربری انتخاب کنید. نام کاربری باید به
botختم شود و تنها از حروف انگلیسی، اعداد و زیرخط (_) تشکیل شده باشد، مثلاًmy_company_support_bot.پس از تأیید، BotFather توکنی شبیه نمونهٔ زیر برای شما میفرستد. آن را کپی کنید، چون در مرحلهٔ بعد به آن نیاز دارید.
123456789:abcdIuZmK5qNEm2A1BhUaAg7MPJv1O9KCcBQB2ro
هشدار
توکن را در جایی امن نگه دارید و آن را با کسی به اشتراک نگذارید. هر کسی که این توکن را در اختیار داشته باشد، میتواند کنترل کامل ربات شما را به دست بگیرد.
نصب ماژول¶
ماژول بله را میتوانید به دو روش نصب کنید: از طریق رابط کاربری یا از خط فرمان.
از طریق رابط کاربری¶
وارد سازمانیار شوید و را باز کنید.
فیلتر نصب نشده را فعال کنید تا ماژولهای نصبنشده نمایش داده شوند.
عبارت
Bale Discussرا جستجو کنید.روی دکمهٔ فعالسازی کلیک کنید و منتظر بمانید تا نصب کامل شود.
از طریق خط فرمان¶
اگر به سرور دسترسی دارید، میتوانید ماژول را مستقیماً از خط فرمان نصب کنید. کافی است
نام پایگاهدادهٔ خود را جایگزین <database_name> کنید:
$ ./odoo-bin -d <database_name> -i bale_discuss --stop-after-init
تنظیم حساب بله¶
پس از نصب ماژول، منوی جدیدی به نام بله در نوار بالا ظاهر میشود. در این بخش یک «حساب بله» میسازید و آن را با توکنی که از BotFather گرفتید به ربات خود متصل میکنید.
به مسیر بروید.
روی جدید کلیک کنید و دو فیلد را پر کنید: در نام یک نام نمایشی دلخواه برای حساب وارد کنید (مثلاً «پشتیبانی بله») و در توکن ربات همان توکنی را که از BotFather دریافت کردهاید قرار دهید.
روی تست اتصال کلیک کنید تا درستی توکن بررسی شود. اگر توکن صحیح باشد، پیام سبزرنگ «ربات متصل شد: نام_ربات» نمایش داده میشود و وضعیت حساب به متصل شده تغییر میکند؛ در غیر این صورت پیام خطا میبینید.
روی تنظیم وبهوک کلیک کنید. فیلد URL وبهوک پیشتر بهصورت خودکار پر شده است و با این کار، آدرس آن بهطور خودکار در بله ثبت میشود تا پیامها به سازمانیار ارسال شوند.
در پایان روی ذخیره کلیک کنید تا تنظیمات ذخیره شود.
مهم
برای آنکه ثبت webhook موفق باشد، سرور باید از طریق اینترنت در دسترس بوده و
آدرس آن با https:// آغاز شود. در غیر این صورت بله نمیتواند پیامها را ارسال
کند.
دریافت پیام از بله¶
وقتی کاربری در بله برای ربات شما پیامی میفرستد، سازمانیار بهصورت خودکار سه کار انجام میدهد:
اگر پیشتر کانالی برای آن کاربر وجود نداشته باشد، یک کانال گفتگو برای او میسازد.
یک مخاطب (رکورد
res.partner) برای آن کاربر بله ایجاد میکند.پیام را در کانال مربوط به همان کاربر نمایش میدهد.
توجه
در پیامهایی که داخل یک کانال بله ارسال میشوند، فرستندهٔ واقعی پنهان است
(فیلد from خالی یا ساختگی است و هویت واقعی در sender_chat قرار دارد). به
همین دلیل این پیامها بهجای یک کاربر مشخص، به نام خودِ کانال نسبت داده میشوند.
مشاهده گفتگوها¶
کانالهای بله در نوار کناری ماژول پیامرسان (Discuss) و زیر دستهٔ بله نمایش داده میشوند. نام هر کانال از نام کاربری بله گرفته میشود.
در منوی پیامرسانی (آیکن گفتگو در نوار بالا) نیز گفتگوهای خصوصی بله در تب گفتوگوها و گروهها و کانالهای بله در تب کانالها نمایش داده میشوند. همهٔ این موارد بهمحض خواندهشدن، از تب اعلانها حذف میشوند.
توجه
برای دیدن یک کانال بله باید عضو آن کانال باشید. کاربرانی که در فیلد اعضای پیشفرض حساب بله تعریف شده باشند، بهطور خودکار به هر کانال جدیدی که از آن حساب ساخته میشود اضافه میشوند. اگر کانالهای بله را در نوار کناری نمیبینید، خودتان را به اعضای پیشفرض حساب اضافه کنید.
انواع پیامهای پشتیبانیشده برای دریافت¶
ماژول بله انواع گوناگونی از پیامها را میشناسد و هرکدام را به شکل مناسب در سازمانیار نمایش میدهد:
نوع پیام |
نحوهٔ نمایش |
|---|---|
متن ساده |
متن پیام |
عکس |
فایل ضمیمهٔ تصویر |
فایل/سند |
فایل ضمیمه |
صدا |
فایل صوتی ضمیمه |
ویدیو |
فایل ویدیویی ضمیمه |
پیام صوتی (Voice) |
پخشکنندهٔ صوتی (Voice Message) |
استیکر |
فایل ضمیمه (تصویر WebP؛ استیکرهای متحرک بهصورت فایل قابل دانلود) |
موقعیت مکانی |
کارت موقعیت همراه با لینک OpenStreetMap |
ساخت کانال بله جدید¶
برای شروع گفتگو با یک گروه یا کانال بله که ربات شما از پیش عضو یا ادمین آن است، از داخل ماژول پیامرسان و کنار عنوان دستهٔ بله روی دکمهٔ + کلیک کنید و شناسهٔ چت یا نام کاربری مقصد را وارد کنید.
نکته
دیگر برای ساخت کانال نیازی به مراجعه به منوی تنظیمات یا حالت فنی نیست؛ همهچیز از داخل خود ماژول پیامرسان انجام میشود.
ویرایش و پین کردن پیام¶
ویرایش: اگر کاربری در بله پیامی را ویرایش کند، همان تغییر در سازمانیار نیز اعمال میشود.
پین کردن: پینکردن یا برداشتن پین یک پیام در سازمانیار، روی چت بله نیز اعمال میشود.
توجه
همگامسازی پین یکطرفه است (از سازمانیار به بله). بله هیچ رویدادی برای پینشدن از سمت اپلیکیشن ارسال نمیکند، بنابراین اگر پیامی را در خود بله پین کنید، این تغییر به سازمانیار منتقل نمیشود.
ارسال پیام از سازمانیار به بله¶
پاسخدادن به کاربران بله از داخل سازمانیار دقیقاً مانند گفتگو در یک کانال داخلی است:
کانال موردنظر را در ماژول پیامرسان باز کنید.
پیام خود را در کادر پایین بنویسید.
کلید Enter را بزنید یا روی دکمهٔ ارسال کلیک کنید.
پیام شما بیدرنگ و بهصورت خودکار برای کاربر در بله ارسال میشود.
ارسال فایل¶
برای فرستادن فایل، از آیکن پیوست (گیره) در کادر پیام استفاده کنید. ماژول بله بسته به نوع فایل، آن را به مناسبترین شکل در بله ارسال میکند:
تصویر → بهصورت عکس ارسال میشود.
فایل صوتی با پسوند
oggیاoga→ بهصورت پیام صوتی (Voice) ارسال میشود.فایل صوتی با پسوند
mp3یاm4a→ بهصورت فایل صوتی ارسال میشود.ویدیو → بهصورت ویدیو ارسال میشود.
سایر فایلها → بهصورت سند (Document) ارسال میشوند.
پشتیبانی از انواع فایل¶
دریافت از بله به سازمانیار¶
فرمتهایی که هنگام دریافت از بله پشتیبانی میشوند:
نوع |
فرمتهای پشتیبانیشده |
|---|---|
تصویر |
JPG، PNG، GIF |
ویدیو |
MPEG4 |
صدا |
MP3، M4A |
پیام صوتی |
OGG |
سند |
هر فرمتی |
محدودیتهای اندازهٔ فایل¶
اندازهٔ فایلها طبق محدودیتهای API بله به شرح زیر است:
روش آپلود |
حداکثر اندازه |
|---|---|
آپلود مستقیم (multipart) |
۵۰ مگابایت |
از طریق URL |
۲۰ مگابایت |