ContactSync - синхронізація покупців із Google Contacts

Nova ContactSync — модуль для OkayCMS, який автоматизує перенесення контактних даних покупців із замовлень у Google Contacts. Контакти можна додавати вручну безпосередньо зі сторінки замовлення або автоматично за розкладом через штатний Okay Scheduler.

Модуль зберігає історію синхронізації у власній базі даних, контролює повторне додавання контактів і показує актуальний статус кожної операції.

Основні можливості

• інтеграція з Google Contacts через офіційний Google People API;
• безпечна авторизація через OAuth 2.0 без збереження пароля Google;
• ручне додавання контакту зі сторінки замовлення однією кнопкою біля номера телефону;
• автоматична синхронізація контактів через штатний Okay Scheduler;
• вибір статусів замовлень для автоматичної обробки;
• налаштування затримки перед автоматичною синхронізацією;
• обмеження кількості замовлень, які обробляються за один цикл;
• перевірка вже синхронізованих замовлень перед повторним зверненням до Google API;
• захист від дублювання контактів;
• окремий реєстр синхронізованих контактів у базі даних;
• журнал ручних і автоматичних операцій;
• відображення станів: не додано / в обробці / успішно / помилка;
• автоматичне блокування кнопки після успішного додавання контакту;
• AJAX-оновлення статистики та процесу синхронізації без перезавантаження сторінки;
• Live Sync для відображення поточних операцій у реальному часі;
• покрокова AJAX-обробка Scheduler для зменшення ризику тривалих backend-запитів і timeout;
• адаптивний дизайн адмінпанелі з використанням системних шрифтів.

Налаштування полів контакту

Модуль дозволяє вибрати, які дані із замовлення потрібно передавати в Google Contacts, визначити їх порядок і цільове поле.

Підтримується передавання таких даних:

• ім’я та прізвище покупця;
• номер телефону;
• e-mail;
• номер і дата замовлення;
• назва статусу замовлення;
• адреса покупця;
• сума замовлення;
• коментар покупця;
• примітка адміністратора;
• список товарів.

Назву контакту можна формувати за власним шаблоном із використанням змінних. Наприклад:

Галина № 12585 StopList

або:

{name} № {order_id} {status_name}

Підключення Google OAuth

Для роботи модуля використовується окремий OAuth-клієнт Google. В адмінпанелі доступна вбудована покрокова інструкція з налаштування:

• Google Auth Platform;
• Google People API;
• OAuth Client ID;
• OAuth Client Secret;
• Authorized Redirect URI;
• scope https://www.googleapis.com/auth/contacts.

Адмінпанель

Налаштування та інформація розподілені між окремими вкладками:

• Телефонні книги;
• Поля контакту;
• Scheduler;
• Журнал.

У верхній частині сторінки відображаються активні AJAX-лічильники:

• замовлень у реєстрі;
• успішно синхронізованих контактів;
• помилок синхронізації;
• операцій у процесі обробки.

Підтримувані сервіси

У версії 1.0.0 повністю реалізовано синхронізацію з Google Contacts. Архітектура модуля передбачає можливість підключення інших провайдерів у наступних версіях.