شروع به کار
-
الزامات:
برای اینکه ماژول Appointly از طریق ایمیل، پیامک و Pusher به صورت زنده اعلانها را ارسال کند، به نکات زیر توجه داشته باشید:
- برای ارسال یادآوریها، باید کرون جاب Perfex CRM پیکربندی شود: ادامه مطلب...
- برای ارسال پیامک، ارائه دهنده پیامک Perfex CRM باید پیکربندی شود: ادامه مطلب ...
مقدمه
مقدمهای بر Appointly - ماژول قرار ملاقات برای Perfex CRM
افزونه Appointly با قابلیت ادغام فرم در وبسایتهای شما، برای هر نوع قرار ملاقات کاملاً مناسب است.
Appointly یک ماژول برای Perfex CRM است که میتوانید قرار ملاقاتها را در CRM خود و از فرم خارجی برنامهریزی کنید و قرار ملاقاتهای خود را به راحتی مدیریت کنید. این ماژول برای ایجاد سریع قرار ملاقاتها طراحی شده است تا ارتباط شما با مخاطبینتان را آسان کند و همچنین میتوانید کارکنان را به عنوان شرکتکننده، موضوع، توضیحات، تاریخ و زمان و بسیاری از ویژگیهای دیگر در آن بگنجانید. Appointly به کاربران این امکان را میدهد که فرم درخواست قرار ملاقات را به هر یک از وبسایتهای خود اضافه کنند و مشتریان میتوانند مستقیماً درخواست قرار ملاقات کنند. قرار ملاقاتها را میتوان با زمان شروع و مکان خاص با گزینهای برای گنجاندن مخاطب داخلی، خارجی یا سرنخ و همچنین شامل کارکنان به عنوان شرکتکننده ایجاد کرد. این ماژول با طراحی ساده و زیبا انعطافپذیر و استفاده آسان است. گزینههایی مانند امکان جاسازی (اضافه کردن) فرم خارجی به هر وبسایت، داخلی، مخاطب داخلی، مخاطب خارجی، سرنخ، اعلانهای ایمیل و پیامک ، نام، ایمیل، موقعیت مکانی، تأیید قرار ملاقات، لغو قرار ملاقات (دلیل)، تأیید به عنوان پایان یافته و بسیاری از ویژگیهای دیگر که در آینده ارائه میشوند را ارائه میدهد. Appoinly همچنین شامل گزینه اضافی Callbacks است که ویژگی جدیدی در Appointly است که در آن مشتریان خارجی یا داخلی میتوانند از شرکت شما درخواست تماس مجدد کنند، زیرا همه مشتریان در همان کشوری که ما در آن کار میکنیم، واقع نشدهاند. تماسهای مجدد را میتوان از طریق مدیران یا شخص مسئول برای تماسهای مجدد مدیریت کرد. میتوان به افراد مسئول برای مدیریت تماسهای مجدد و یادداشتبرداری اختصاص داد. این گزینه را میتوان بر اساس نیاز شما فعال/غیرفعال کرد. فیلدهای سفارشی، ردیابی ایمیل و بازخوردها نیز از نسخه ۱.۱.۴ برای قرار ملاقات در دسترس هستند که از اعلانهای زنده و قالبهای ایمیل نیز پشتیبانی میکنند.
نصب
راهنمای نصب و ارتقاء ماژول Appointly - Appointments برای Perfex CRM
- گزینه ۱: زمان نصب (۱-۲ دقیقه)
- محتوای فایل زیپ دانلود شده از CodeCanyon را استخراج کنید. در منوی کناری، در قسمت تنظیمات -> ماژولها ، فایل appointment.zip را در بخش ماژولها آپلود کنید و روی نصب کلیک کنید. به ماژول خود بروید و روی فعالسازی کلیک کنید. اگر ارتقاء پایگاه داده مورد نیاز است، روی ارتقاء پایگاه داده کلیک کنید و آماده شروع هستید. اگر ارتقاء پایگاه داده مورد نیاز است، روی ارتقاء پایگاه داده کلیک کنید و آماده شروع هستید.
- گزینه ۲: زمان نصب (۱-۲ دقیقه)
- فایل فشرده فودلر دانلود شده از CodeCanyon را باز کنید و فایل appointmently.zip را مستقیماً در پوشه modules روی سرور خود از حالت فشرده خارج کنید، مثلاً باید در پوشه modules مانند modules/appointly/[other folders] از حالت فشرده خارج شده باشد و مرورگر خود را مجدداً بارگذاری کنید. به ماژول خود بروید و روی فعالسازی کلیک کنید. اگر ارتقاء پایگاه داده لازم است، روی Upgrade Database کلیک کنید و آماده شروع هستید.
- مهم: همیشه بعد از نصب یا ارتقا، کش مرورگر خود را پاک کنید.
بسته به سیستم عامل خود، تنها کاری که باید انجام دهید این است که از ترکیب کلیدهای زیر استفاده کنید:
ویندوز: ctrl + F5
مک/اپل: اپل + R یا command + R
لینوکس: F5
ویژگیها
- رابط برنامهنویسی تقویم گوگل
- ادغام گوگل میت
- دعوت از مشتری و کارکنان به گوگل میت (از طریق ایمیل)
- رابط برنامهنویسی تقویم اوتلوک
- تماسهای برگشتی
- درخواست تماس مجدد
- فراخوانیهای مجدد
- یادداشتهای فراخوانی مجدد
- فیلدهای سفارشی
- ردیابی ایمیل
- تبدیل به وظیفه (میتواند مربوط به پروژه، فاکتور، مشتری، تخمین، قرارداد، تیکت، هزینه، سرنخ و پیشنهاد باشد)
- تبدیل به سرب
- بازخوردهای مربوط به قرار ملاقات. مشتریانی که قرار ملاقاتهایشان تمام شده است میتوانند امتیاز و نظر خود را اضافه کنند. کارکنان میتوانند درخواست بازخورد کنند.
- فرم (iFrame) را در هر یک از وبسایتهای خود جاسازی کنید (میتوان آن را به چندین وبسایت اضافه کرد)
- مجوزهای کارکنان (مشاهده سراسری، مشاهده شخصی، ویرایش، حذف)
- اعلانهای فوری زنده (یادآوریها، قرار ملاقات جدید، لغو قرار ملاقات، لغو درخواست، بهروزرسانیها، اعلانهای بازخورد، اعلانهای تماسهای برگشتی)
- ابزارک داشبورد
- رابط برنامهنویسی تقویم گوگل
- همگامسازی تقویم قرارهای امروز
- امکان ویرایش نوبت
- گزینه حذف قرار ملاقات
- گزینه لغو قرار ملاقات
- تنظیم گزینه فیلتر پیشفرض جدول
- گزینهای برای رزرو وقت ملاقات توسط مشتریان، چه با ورود به سیستم و چه قبل از ورود به سیستم
- رویدادهای نوع تقویم
- یادداشتهای قرار ملاقات
- انواع قرار ملاقات
- رویدادهای رنگی از نوع تقویم در بخش کارکنان و مشتریان
- رزرو نوبت مستقیماً از بخش مشتریان
- نمای کلی قرار ملاقات
- نمای کلی قرار ملاقات جداگانه برای کلاینت آدرس اینترنتی کلاینت عمومی خارجی (هش شده و منحصر به فرد)
- نمای کلی قرار ملاقات جداگانه برای کارکنان داخلی، آدرس CRM خصوصی شرکتکننده
- چندین کارمند را به شرکت کنندگان اختصاص دهید
- قرار ملاقات داخلی (مخاطبین)
- انتصاب داخلی (سرنخها)
- قرار ملاقات خارجی
- فرم iFrame خارجی (تماس)
- اعلانهای پیامکی و یادآوریهای اعلان
- اعلانهای ایمیلی و یادآوریهای ایمیلی
- اعلانهای یادآوری
- ارسال یادآوری زودهنگام
- گزارشهای دسترسی
- تغییر زمان قرار ملاقات (علامتگذاری به عنوان در حال انجام)
- قالبهای ایمیل
- انتصاب برای (کارکنان و حضار) تأیید شد
- قرار ملاقات برای (کارکنان و شرکتکنندگان) لغو شد
- قرار ملاقات تایید شد (تماس)
- قرار ملاقات لغو شد (تماس با ما)
- یادآوری قرار ملاقات به (کارکنان و شرکتکنندگان)
- یادآوری قرار ملاقات به (تماس)
- فراخوانیهای برگشتی اختصاص داده شده به (کارکنان)
- تماس جدید با (کارکنان)
- بازخورد دریافتی به (کارکنان)
- بازخورد در (کارکنان) بهروزرسانی شد

- قالبهای پیامکی
- توجه: مطمئن شوید که تمام قالبهای پیامک شما در مسیر Setup->Setting->SMS با محتوایی مطابق مثال زیر پر شدهاند، در غیر این صورت اگر قالب پیامک شما خالی باشد، پیامک ارسال نخواهد شد.
- قرار ملاقات تایید شد (تماس)
- قرار ملاقات لغو شد (تماس با ما)
- یادآوری قرار ملاقات به (تماس)

- ویجت قرار ملاقاتهای امروز داشبورد
- ویجت قرار ملاقاتهای امروز را به داشبورد خود اضافه کنید
- تمام قرارهای شما نمایش داده میشوند و با تقویم شما همگامسازی میشوند
- باز کردن مستقیم قرار ملاقات از تقویم
- رویدادهای رنگی تقویم
- دستکاری انعطافپذیر تاریخ و زمان
- نشانگر ساعات و تاریخهای شلوغ
- به صورت خارجی نیز موجود است
- اعلانهای ایمیل و پیامک:
- ارسال ایمیل و پیامک برای مخاطبین/شرکتکنندگان در مورد ایجاد، تأیید یا ویرایش قرار ملاقات موجود
- قالبهای ایمیل برای قرار ملاقاتها (آماده ترجمه)
- محتوا و موضوع سفارشی
- فیلدهای سفارشی
- بازخوردها
- تماسهای برگشتی
- قالبهای ایمیل و پیامک سفارشی برای مدیریت
- تأیید قرار ملاقات
- لغو قرار ملاقات
- محتوای HTML از طریق ویرایشگر TinyMCE در قالبهای ایمیل
- وضعیتهای سفارشی برای وضعیتهای مختلف قرار ملاقاتها: در انتظار، تأیید شده، لغو شده، تأیید شده، در شرف وقوع، از دست رفته
- فیلدهای ادغام قالب، در قالبهای پیامک و ایمیل
- قلابهای اکشن
- فیلترهای جدول
- همه
- تایید شده
- تایید نشده
- لغو شد
- تمام شده
- جستجوی زنده، سرنخهای جستجوی زنده
- منبع: مثلاً داخلی (تماس) / خارجی / سرنخ (میتواند از داخل CRM به عنوان خارجی یا از هر وبسایتی که فرم را به طور موقت جاسازی کردهاید، به عنوان مخاطب خارجی علامتگذاری شود)
- نشانگرهای تاریخ سررسید قرار ملاقات
- نشانگر تاریخهای شلوغ قرار ملاقات (قابل غیرفعال کردن)
- طرحبندی بوتاسترپ واکنشگرا
- زبانهای موجود: انگلیسی، آلمانی، فرانسوی، ایتالیایی، هلندی، پرتغالی، برزیلی و لهستانی
- ترجمه آماده
اطلاعات تکمیلی
- وقتی قرار ملاقات جدید از خارج از فرم خارجی (iFrame) ایجاد میشود، اگر هیچ شرکتکنندهای را انتخاب نکرده باشید و روی تأیید قرار ملاقات کلیک کنید، شما به عنوان شرکتکننده پیشفرض قرار ملاقات تعیین خواهید شد. اعلان تأیید برای همه شرکتکنندگان و مخاطبین ارسال میشود.
- اگر قرار ملاقات خارجی موجود را ویرایش کنید و مخاطب فعلی را تغییر دهید، وقتی مخاطب جدید اضافه شود، ایمیل و پیامک برای مخاطب تازه اضافه شده ارسال میشود، همچنین اگر کارکنان شرکتکننده اضافه شوند، آنها نیز اعلان دریافت خواهند کرد.
- تاریخ و زمان به طور خودکار و مستقیم از تنظیمات CRM شما در مسیر Setup->Setting->Localization دریافت میشوند.
- قرار ملاقات میتواند به صورت داخلی از داخل CRM ایجاد شود.
- داخلی (سرب)
- داخلی (تماس)
- خارجی (تماس)
- قرار ملاقات خارجی
- فرم کلاینت خارجی از طریق جاسازی به هر یک از وبسایتهای شما اضافه شد. به تنظیمات>تنظیمات>قرار ملاقاتها مراجعه کنید.
- اضافه کردن قلاب اکشن به فرم خارجی، این (اختیاری) است
اگر هنوز فایل my_function_helper.php را ایجاد نکردهاید، باید آن را ایجاد کرده و کد خود را درون آن قرار دهید. مثال:
هدر سفارشی فرم خارجی قرار ملاقاتها
/** * هدر سفارشی فرم خارجی قرار ملاقاتها */ قلابها()->افزودن_اکشن('appointly_form_header'، 'my_appointly_form_header')؛ تابع my_appointly_form_header() { ` ... پژواک دریافت_لوگوی_شرکت(); اکو دیو؛ } اکنون در فرم iFrame خارجی خود، یک هدر جدید خواهید داشت.
افزودن قلاب اکشن سفارشی برای ارسال پیامک
hooks()->add_action('ارسال_اساماس_پس_از_ارسال_قرار_ملاقات_خارجی', 'مدیریت_اساماس_خارجی'); تابع handle_external_appointment_sms($appointment_url) { /** * پس از ارسال وقت ملاقات از طریق فرم، شماره تلفنی که پیامک را دریافت خواهد کرد را انتخاب کنید * تلفن شما */ $phoneNumber = '+18182064114'; (شماره تلفن = '+18182064114') /** * پیامک سفارشی شما برای دریافت */ /** * پیامک سفارشی شما برای دریافت * $appointment_url آدرس اینترنتی (url) قرار ملاقات جدید درخواست شده از فرم خارجی است. */ $smsMessage = 'شما درخواست وقت ملاقات جدیدی را از طریق فرم خارجی ارسال کردهاید، میتوانید قرار ملاقات را در آدرس اینترنتی زیر مشاهده کنید.' . $appointment_url; اگر ($gateway = get_instance()->app_sms->get_active_gateway()) { $className = 'sms_'. $gateway['id']; (نام کلاس = 'sms_'). get_instance()->{$className}->send($phoneNumber, $smsNotifyMessage); } }
هدر سفارشی فرم خارجی با قابلیت فراخوانی مجدد
/** * هدر سفارشی Callbackها */ hooks()->add_action('callbacks_form_header', 'my_callbacks_form_header'); تابع my_callbacks_form_header() { echo div class="text=center" style="display: inline-block;">'; // یا هر کلاس دیگری برای قرار دادن تصویر در مرکز صفحه پژواک دریافت_لوگوی_شرکت(); اکو دیو؛ } ادامه مطلب را اینجا بخوانید...
- بازنویسی زبان پیشفرض
- ۱. در پوشه modules خود و سپس پوشه appointmently بروید.
- ۲. به پوشه languages بروید و پوشه english را کپی و پیست کنید.
- ۳. نام پوشه کپی شده به زبان انگلیسی را به زبان خودتان، مثلاً فرانسوی، تغییر دهید (حتماً با حروف کوچک شروع شود).
- ۴. فایل داخل پوشه فرانسوی appointmently_lang.php اکنون میتواند با ترجمههای شما بازنویسی شود.
- ۵. پس از تغییر زبان پیشفرض Perfex CRM به مثلاً فرانسوی، زبان ماژول Appointly به طور خودکار به فرانسوی تغییر خواهد کرد.
- این فقط یک مثال است که پوشههای زبان چگونه باید به نظر برسند.

راهنمای تنظیم تقویم گوگل
توجه: این ویژگی، رویدادهای تقویم Perfex CRM شما را با تقویم گوگل شما همگامسازی نمیکند. ویژگی تقویم گوگل، رویدادهای اضافه شده فعلی شما را به تقویم گوگل شما منتقل نمیکند و آنها را در قرار ملاقاتها اعمال نمیکند. ویژگی تقویم گوگل، تمام تاریخ/زمانهای شلوغ قرار ملاقات را جمعآوری کرده و آنها را به قرار ملاقاتهای فعلی شما، چه داخلی و چه خارجی، اضافه میکند. ساعات شلوغی، حتی زمانی که مشتریان خارجی از Perfex CRM خارجی رزرو میکنند، تاریخهای شلوغ تقویم گوگل شما که قبلاً رزرو شدهاند، در انتخابگر تاریخ و زمان تقویم در دسترس و نمایش داده میشوند.
ویژگی تقویم گوگل به شما این امکان را میدهد که هنگام ایجاد یک قرار ملاقات، انتخاب کنید (که به طور پیشفرض تیک خورده است) که این قرار ملاقات به تقویم گوگل شما نیز اضافه شود. همین امر در صورتی نیز صدق میکند که قرار ملاقاتی که قبلاً در CRM خود ایجاد کردهاید را حذف کنید و آن را به تقویم گوگل خود اضافه کنید و اگر در تنظیمات->تنظیمات->قرار ملاقات فعال باشد (قبل از حذف قرار ملاقات، قرار ملاقات ایجاد شده در تقویم گوگل خود را نیز حذف کنید) روی بله تنظیم شده باشد ، قرار ملاقات (رویداد) از تقویم گوگل شما نیز حذف خواهد شد و تمام ایمیلهای گوگل مرتبط با قرار ملاقات فعلی شما، رویداد آنها از تقویم گوگل آنها نیز حذف خواهد شد زیرا قرار ملاقات شما دیگر در تقویم گوگل شما وجود ندارد. هنگام ویرایش قرار ملاقات، آن در تقویم گوگل شما نیز بهروزرسانی میشود.
وقتی قرار ملاقات خارجی تأیید شد، اگر میخواهید این قرار ملاقات را به تقویم گوگل خود همگامسازی/اضافه کنید، میتوانید روی ویرایش قرار ملاقات، اختصاص دادن شرکتکنندگان بیشتر و کلیک روی ذخیره کلیک کنید، قرار ملاقات به طور خودکار به تقویم گوگل شما اضافه میشود.
اطلاعات: هر یک از کارکنان میتوانند تقویم گوگل خود را به طور جداگانه با Appointly همگامسازی کنند و رویدادها/قرار ملاقاتهای خود را با تقویم گوگل خود مدیریت کنند. همه موارد فوق در صورتی اعمال میشود که فقط به API تقویم گوگل خود متصل باشید.
توجه: اگر از قبل برنامه خود را با APIS و سرویسهای گوگل راهاندازی کردهاید و اعتبارنامههای OAuth دارید ، کافیست رمز کلاینت خود را کپی کرده و به مسیر Setup->Settings->Appointments در CRM خود بروید و کلید مخفی خود را جایگذاری کنید و برای ذخیره تغییرات، روی ذخیره کلیک کنید. با فرض اینکه شناسه کلاینت شما از قبل در Setup->Settings->Google ذخیره شده است ، در صورت مثبت بودن پاسخ، از آنجا دریافت شده و در Setup->Settings->Appointments اعمال میشود ، در غیر این صورت، باید شناسه کلاینت خود را نیز کپی کرده و در Setup->Settings->Google یا مستقیماً در Setup->Settings->Appointments وارد کنید .
بعد از اینکه شناسه مشتری و رمز مشتری خود را وارد کردید، باید کنسول گوگل را باز کنید. کنسول توسعهدهندگان گوگل، شناسههای مشتری OAuth 2.0 خود را پیدا کنید و روی ویرایش همان OAuth که برای CRM خود استفاده میکنید کلیک کنید و URLهای مجوز را اضافه کنید تا تقویم گوگل شما مستقیماً از CRM شما تأیید شود.
صفحه رضایت OAuth
صفحه رضایت OAuth به پایین اسکرول شد
محدودهها
کاربران آزمایشی
اگر هیچ یک از موارد فوق برای شما صدق نمیکند، باید این مراحل را برای تنظیم تقویم گوگل خود دنبال کنید.
ابتدا باید پروژهای ایجاد کنید که با API تقویم گوگل شما مرتبط باشد . کنسول توسعهدهندگان گوگل را باز کنید.

نام پروژه خود را وارد کنید و روی ایجاد کلیک کنید.

پس از اینکه پروژه شما با موفقیت ایجاد شد، به APIS & Services هدایت خواهید شد. اکنون باید کتابخانه API تقویم گوگل را در پروژه برنامهای که ایجاد کردهاید فعال کنید، برای انجام این کار، روی منوی بالا سمت چپ کلیک کنید و سپس APIs & Services->Library را انتخاب کنید و Google Calendar API را جستجو کنید ، روی کتابخانه کلیک کنید و سپس روی Enable کلیک کنید.

اکنون API تقویم گوگل شما فعال شده است، مرحله بعدی ایجاد صفحه رضایت OAuth برای API تقویم گوگل خواهد بود، در نوار کناری منو روی صفحه رضایت OAuth کلیک کنید و روی ایجاد کلیک کنید.

حالا باید با وارد کردن نام برنامه و دامنههای مجاز، صفحه رضایت OAuth خود را تنظیم کنید.
صفحه رضایت OAuth
صفحه رضایت OAuth به پایین اسکرول شد
انتشار برنامه
بازگشت به داشبورد
بعد از اینکه کار با صفحه رضایت OAuth تمام شد، حالا باید برای ایجاد اعتبارنامه برای برنامه تازه ایجاد شده خود، به مسیر زیر بروید.

اکنون اعتبارنامههای شما ایجاد شده است، اما باید آدرسهای مجوز و تغییر مسیر را برای API تقویم گوگل اضافه کنید. آدرس ورود مجوز را میتوانید در CRM خود در مسیر تنظیمات>تنظیمات>قرار ملاقاتها پیدا کنید.
روی Credentials کلیک کنید و روی آیکون ویرایش در OAuth Client ID که تازه ایجاد کردهاید، کلیک کنید.

اتصال به API تقویم گوگل
ابتدا در CRM خود به مسیر Setup->Settings->Appointments بروید و فیلدهای Google Calendar API Client Id و Google Calendar API Secret را پر کنید و روی ذخیره کلیک کنید. اکنون میتوانید در منوی کناری خود روی Appointments و Dashboard کلیک کنید.
بعد از اینکه در داشبورد قرار ملاقاتهایتان روی «ورود» کلیک کردید، اگر تقویم گوگل خود را به درستی تنظیم کرده باشید و اطلاعات کاربری خود را به درستی وارد کرده باشید، باید چیزی شبیه به این دریافت کنید. یک پنجره جدید برای انتخاب حساب گوگل شما که به برنامه اجازه دسترسی به آن را میدهید، نمایش داده میشود.

بعد از انتخاب حساب کاربری خود، احتمالاً پیامی با عنوان « این برنامه تأیید نشده است » مشاهده خواهید کرد. مسئولیت تأیید پروژه/برنامهای که ایجاد کردهاید بر عهده شماست . میتوانید برای مطالعه بیشتر در مورد نحوه تأیید برنامه خود، اینجا را کلیک کنید . در غیر این صورت، برای آزمایش این ویژگی برای حساب کاربری خود، روی «پیشرفته» و سپس «برو به [نام برنامه] (ناامن)» کلیک کنید .

فرآیند تأیید توسط گوگل به وضوح توضیح داده شده است و تمام مراحل نحوه تأیید برنامه شما توضیح داده شده است، از آنجایی که Perfex CRM هیچ دادهای برای شرکت شما نگهداری نمیکند، باید خودتان این موضوع را تأیید کنید زیرا از API تقویم گوگل استفاده خواهید کرد.
تبریک میگویم، کار تمام است و آمادهی استفاده از API تقویم گوگل هستید.
برخی اطلاعات اضافی که باید در نظر گرفته شوند
به طور پیشفرض رویدادهای تقویم گوگل از ۱۲ ماه گذشته و با شروع از ماه جاری، بازیابی میشوند.
۱. پس از ایجاد یک قرار ملاقات و همگامسازی آن با رویدادهای تقویم گوگل خود در داشبورد قرار ملاقاتها، یک آیکون کوچک گوگل نمایش داده میشود. توجه داشته باشید که هر کاربری که قرار ملاقات خود را با گوگل همگامسازی کرده باشد، فقط میتواند به این لینک دسترسی داشته باشد، لینکها فقط به کاربری که جلسه را اضافه/ایجاد کرده است، نمایش داده میشوند. اگر قرار ملاقاتی از طریق فرم خارجی ارسال شود، وقتی مسئول روی ویرایش قرار ملاقات کلیک میکند و قرار ملاقات را ذخیره میکند، در صورت علامت زدن، قرار ملاقات به طور خودکار به رویدادهای تقویم گوگل شما اضافه میشود.
۲. اگر میخواهید برنامه تأیید شده خود را از مرورگر خود حذف کنید یا در ورود به سیستم با API تقویم گوگل مشکلی دارید، به آدرس https://myaccount.google.com/u/0/permissions مراجعه کنید و برنامه اضافه شده خود را حذف کنید تا دوباره بتوانید همگامسازی را انجام دهید. این اتفاق زمانی میافتد که اخیراً رمز عبور جیمیل خود را تغییر داده باشید یا برنامه خود را از برنامههای گوگل حذف کرده باشید و سپس از رایانه دیگری وارد سیستم شده باشید یا شاید به مدت ۶ ماه فعال نبوده باشید.
خطاهای شناخته شده: { "error": "invalid_grant", "error_description": "توکن منقضی یا لغو شده است." } . در این مورد به شماره ۱ مراجعه کنید
راهنمای تنظیم تقویم Outlook
نکته: قابلیت تقویم Outlook API به هر کارمند اجازه میدهد تا هنگام ایجاد قرار ملاقات از طریق Perfex CRM، آن را جداگانه تنظیم کند. در صورت انتخاب این گزینه برای Outlook، قرار ملاقات به تقویم Outlook شما نیز اضافه خواهد شد. اگر قرار ملاقات موجود را از CRM Apointments ویرایش یا حذف کنید، این قرار ملاقات مستقیماً در تقویم Outlook شما نیز بهروزرسانی میشود.
لطفاً این راهنما را با دقت و گام به گام دنبال کنید تا نحوه ایجاد برنامه Outlook Calendar API و اتصال Perfex CRM به آن را بیاموزید.
مرحله ۱: به مایکروسافت آزور بروید https://portal.azure.com/#home
مرحله ۲: اگر در Microsoft Azure حساب کاربری ایجاد کردهاید، اطلاعات ورود خود را وارد کنید، در غیر این صورت یک حساب کاربری ایجاد کنید.

مرحله ۳: ثبت درخواست شما

مرحله ۳: ثبت درخواست شما

مرحله ۴: مانند تصویر انتخاب کنید و روی ثبت نام کلیک کنید

مرحله ۵: پس از ثبت درخواست، باید یک پلتفرم اضافه کنید و آن را پیکربندی کنید.

آدرس URL مربوط به احراز هویت و تغییر مسیر Outlook را میتوانید در تنظیمات>تنظیمات>قرار ملاقاتها پیدا کنید.

مرحله ششم: افزودن مجوزها

روی مجوزهای واگذار شده کلیک کنید و به پایین اسکرول کنید و تقویم را جستجو کنید.

تمام مقادیر مجوزهای تقویم را انتخاب کنید و روی افزودن مجوزها کلیک کنید. مجوزها واقعاً مورد نیاز نیستند، اما ما آنها را فقط در صورتی اضافه خواهیم کرد که API از Outlook تغییر کند و برای برنامه و توسعه بیشتر مورد نیاز باشند.

مرحله ۷: پس از اضافه کردن و ذخیره مجوزها، باید به نمای کلی برگردید و شناسه برنامه (ID) خود را کپی کرده و آن را به Setup->Settings->Appointments Outlook Calendar API اضافه کنید و روی ذخیره کلیک کنید.

این بدان معناست که شما با موفقیت API تقویم Outlook خود را پیکربندی کردهاید و اکنون میتوانید آن را با Perfex CRM همگامسازی کنید.

توصیه میشود ۵ دقیقه صبر کنید تا پیکربندی API و آدرسهای اینترنتی (URI) شما منتشر شوند و سپس سعی کنید وارد سیستم شوید و از API تقویم Outlook خود استفاده کنید.
بعد از اینکه همه چیز پیکربندی شد، روی ورود به Outlook در داشبورد Appointments کلیک کنید، یک پنجره بازشو ظاهر میشود که نشان میدهد آیا برنامه را به درستی پیکربندی کردهاید یا خیر و از شما ایمیل و رمز عبور Outlook را میخواهد. از شما خواسته میشود مجوزهای Outlook تقویم را تأیید کنید، روی اجازه یا پذیرش کلیک کنید. کار تمام است، اکنون میتوانید از API تقویم Outlook خود استفاده کنید.

خطاها/باگهای شناخته شده:
اگر گاهی اوقات با خرابی غیرمنتظرهای مواجه میشوید که به ندرت اتفاق میافتد اما ممکن است رخ دهد، کنسول مرورگر خود را باز کنید (Chrome CTLR+SHIFT+I یا کلیک راست و انتخاب گزینه inspect) و به مسیر Application -> Storage -> Cookies بروید. نام دامنه خود را پیدا کنید و تمام کوکیهایی که با msal ستارهدار هستند را حذف کنید. یا فقط تمام کوکیها را حذف کرده و دوباره وارد سیستم شوید.
مشکل دیگری که ممکن است پیش بیاید و رابط برنامهنویسی Outlook به خوبی از پس آن برنیاید، این است که اگر یک حساب کاربری جدید ایجاد کنید، ممکن است API شما تا زمانی که حساب خود را با Outlook، از طریق شماره تلفن یا ایمیل تأیید نکنید، کار نکند یا از کار بیفتد. فقط این نکته را در نظر داشته باشید که قرار ملاقاتهای شما در تقویم Outlook شما ذخیره نشده باشد.
نمای کلی اسکرینشاتها
ابزارک داشبورد قرار ملاقات

تقویم قرار ملاقات

تقویم مشتریان

نمای جدول

انتصاب جدید

سرنخها شامل میشوند

ایجاد وظیفه از قرار ملاقات و رهبری

مشاهده قرار ملاقات

فیلدهای سفارشی و ردیابی ایمیل

ارسال یادآوریها و یادداشتهای زودهنگام برای قرار ملاقات

بازخوردهای مربوط به قرار ملاقات

ویرایش قرار ملاقات

تماس با ما ورود درخواست وقت ملاقات

تنظیمات قرار ملاقات، فیلترها، انواع

فرم iFrame خارجی برای تعیین وقت ملاقات

آدرس اینترنتی عمومی قرار ملاقات

قرار ملاقات لغو شد

قرار ملاقات لغو شد

قرار ملاقات با مشتری لغو شد

تماسهای برگشتی



آماده برای موبایل


تغییرات
نسخه ۱.۱.۴
- جدید: پشتیبانی از فیلدهای سفارشی در قسمت فرم خارجی مدیریت و قرار ملاقاتها اضافه شد
- جدید: ردیابی ایمیل اضافه شده است (آیا ایمیل قرار ملاقات ارسالی به مشتری خوانده میشود یا خیر)، برای ایمیل تأیید شده قرار ملاقات اعمال میشود
- جدید: بازخورد و نظرات برای قرار ملاقات نهایی اضافه شد
- جدید: وضعیتهای سفارشی بازخورد اضافه شد ، در مجموع ۷ دقیقه و ۱ ثانیه (قابل ترجمه)
- جدید: قالبهای ایمیل برای بازخوردهای قرار ملاقات، بازخورد جدید دریافت شده، بازخورد موجود بهروزرسانی شده، درخواست بازخورد از مشتری
- جدید: گزینهای برای تبدیل و مرتبط کردن قرار ملاقات به سرنخ اضافه شده است
- جدید: گزینهای برای تبدیل و مرتبط کردن وظیفه قرار ملاقات از قرار ملاقات اضافه شده است (میتواند به پروژه، فاکتور، مشتری، تخمین، قرارداد، تیکت، هزینه، سرنخ و پیشنهاد مرتبط باشد )
- رفع شد: مشکل جزئی قرار ملاقاتها-> تنظیمات در زمانی که هیچ کارمندی اضافه نشده بود، برطرف شد.
- رفع اشکال هنگام بهروزرسانی قرار ملاقات داخلی برای شرکتکنندگان در تقویم گوگل (به درستی بهروزرسانی نشده بود)
- رفع شد: مشکل جزئی در زمانی که قرار ملاقاتها با شروع عنوان صادر میشوند، اگر توسط نام مدیر ایجاد شده باشند، در لیست نشان داده میشوند.
- بهبود یافته: مجوزهای شخص مسئول برای قرار ملاقاتها کاملاً اصلاح شد، اکنون شخص مسئول مجوزهای کامل برای قرار ملاقاتها خواهد داشت، به جز مجوزهای حذف که هنگام اضافه شدن از مجوزها لازم خواهند بود.
نسخه ۱.۱.۳ ۰۳/۰۱/۲۰۲۰
- جدید: قابلیت فراخوانیهای مجدد برای Appointly
- جدید: قالبهای ایمیل فراخوان و اعلانهای زنده
- جدید: فراخوانیهای برگشتی (callbacks) برای واگذارکننده
- جدید: تماسهای برگشتی با شخص مسئول
- جدید: یادداشتهای فراخوانیهای برگشتی
- جدید: reCAPTCHA قرار ملاقاتها
- جدید: گزینهای برای غیرفعال کردن/فعال کردن زمانهای شلوغ قرار ملاقاتها اضافه شده است
- جدید: قالب/ویژگی ایمیل جدید اضافه شده است تا فرد مسئول هنگام ارسال قرار ملاقات جدید از طریق فرم خارجی، ایمیل دریافت کند.
- رفع شد: اصلاح زمان و تاریخ اعمال شده برای مناطق زمانی با فرمت تاریخ خاص
نسخه ۱.۱.۲ ۱۳/۰۲/۲۰۲۰
- رفع شد: اصلاح جزئی با فایلهای زبان
نسخه ۱.۱.۱ ۱۳/۰۲/۲۰۲۰
- جدید: ادغام API تقویم گوگل
- جدید: گزینههایی برای اضافه کردن قرار ملاقات به تقویم گوگل شخصی (برای هر عضو پرسنل جداگانه) (نیاز به احراز هویت گوگل دارد)
- جدید: گزینههای مربوط به بهروزرسانی یا حذف قرار ملاقات، مستقیماً در تقویم گوگل شما نیز اعمال میشوند (نیاز به تأیید هویت گوگل دارد)
- جدید: تاریخهای شلوغ تقویم گوگل با رنگ زرد نشان داده میشوند
- جدید: گزینهای برای اضافه کردن ساعات رزرو شخصی (مدیر)
- جدید: گزینه غیرفعال کردن آخر هفتهها (مدیر)
- جدید: گزینهای برای فعال کردن بافر کردن ساعات کاری (مدیر)
- جدید: گزینه تأیید خودکار قرارهای ملاقات خارجی (مدیر)
- جدید: انواع قرار ملاقات (در صورت وجود) اکنون در فرم خارجی مشتریان نمایش داده میشود
- جدید: اگر قرار ملاقات در تقویم گوگل من باشد، این ویژگی به صورت لینک آیکون در داشبورد نمایش داده میشود (فقط برای قرار ملاقاتهای شخصی، نیاز به احراز هویت گوگل دارد)
- جدید: تاریخ/زمان مشغول بودن گوگل اکنون از API تقویم گوگل همگامسازی شده است (نیاز به تأیید هویت گوگل دارد)
- جدید: گزینهای برای کلیک روی پیامک یا ایمیل و تماس یا ارسال پیامک در قرار ملاقات اضافه شده است. مشاهده تکی قرار ملاقات
- جدید: گزینهای برای کلیک روی آدرس مشتری و باز کردن جداگانه آن در نقشههای گوگل در نمای تکی قرار ملاقات اضافه شده است
- بهبود یافته: رابط کاربری / تجربه کاربری
- تغییر کرد: فونت به Roboto برگشت.
- بهروزرسانی: زبانهای فرانسوی و پرتغالی به طور کامل ترجمه شدند
- رفع شد: ساعات شلوغی همیشه نشان داده نمیشود - یک اشکال جزئی
- رفع شد: یادآوریها دارای اشکال جزئی هستند
- رفع شد: توضیحات لغو قرار ملاقات پس از درخواست لغو توسط مشتری در نمای کارکنان نمایش داده نمیشود، اشکال جزئی برطرف شد وقتی مشتری سعی در لغو قرار ملاقات دارد و پاسخی دریافت نمیکند
نسخه ۱.۱.۰ ۰۱/۲۲/۲۰۲۰
- جدید: جستجوی تاریخهای شلوغ (ساعات رزرو شده) در فرم خارجی مشتریان و زبان تقویم اضافه شد
- جدید: مشتریان میتوانند در صورت عدم ورود به سیستم از طریق بخش مشتریان، نوبت رزرو کنند (مدیر میتواند این گزینه را فعال یا غیرفعال کند)
- جدید: مشتریان میتوانند هنگام ورود به سیستم از طریق بخش مشتریان، قرار ملاقات رزرو کنند (مدیر میتواند این گزینه را فعال یا غیرفعال کند)
- جدید: یادداشتهای جلسه با ویرایشگر WYSIWYG اضافه شد، گزینهای برای آپلود تصاویر.
- جدید: گزینه جدیدی برای تنظیم فیلتر پیشفرض جدول (برای هر کاربر) اضافه شده است
- جدید: گزینه جدید اضافه شده است که خلاصه قرار ملاقاتها را میتوان فعال یا غیرفعال کرد (برای هر کاربر)
- جدید: اضافه شدن نقش کارکنان در نمای مشتریان خارجی قرار ملاقات
- جدید: گزینه جدید اضافه شده است ارسال یادآوری قرار ملاقات زودهنگام از طریق ایمیل و پیامک (قابل استفاده مجدد بر اساس نیاز شما)
- جدید: انواع قرار ملاقات (گزینهای برای ایجاد انواع قرار ملاقات سفارشی)
- جدید: انواع قرار ملاقاتها در تقویم کارکنان و مشتریان (در صورت عدم وجود در تقویم مدیر) نمایش داده میشوند.
- جدید: زبانهای جدید آلمانی، فرانسوی، ایتالیایی، پرتغالی، برزیلی و لهستانی اضافه شد
- بهبود یافته: قالب تاریخ برای همه قرارها مطابق با قالب تاریخ پیشفرض تغییر یافته است تا خوانایی بهتر و سراسری برای همه مشتریان فراهم شود. قالب تاریخ در تنظیمات->تنظیمات->محلیسازی است.
- بهبود یافته: نیم ساعت به ساعات رزرو موجود اضافه شد
- رفع شد: هنگام ایجاد جلسه داخلی، اعلان همیشه ارسال نمیشود