ContactSync - синхронизация покупателей с Google Contacts

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. Архитектура модуля предусматривает возможность подключения других провайдеров в следующих версиях.