Документация Сообщение клиенту в мессенджеры

Установка:

  1. Разархивируйте архив
  2. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите архив artcmessage.ocmod.zip
  3. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
  4. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Сообщение клиенту в WhatsApp, Viber, Telegram, Skype (при отсутвии данного модуля в меню воспользуйтесь установкой вручную описанной ниже)
  5. Зайдите в настройки модуля (ссылка Изменить)
  6. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке).
  7. Включить модуль (статус включено). Сохранить настройки.
  8. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

Установка вручную:

  1. Разархивируйте архив
  2. Разархивируйте архив artcmessage.ocmod.zip, внутри папка upload и файл install.xml
  3. С помощью файлового доступа к сайту (ftp или ssh) загрузите все содержимое папки upload в корень сайта
  4. Для магазинов 2.0-2.1 Переименуйте install.xml в artcmessage.ocmod.xml
  5. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите файл artcmessage.ocmod.xml
  6. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
  7. Установите модуль в разделе Админ панель - Дополнения - Модули - ART&PR Сообщение клиенту в WhatsApp, Viber, Telegram, Skype
  8. Зайдите в настройки модуля (ссылка Изменить)
  9. Введите настройки. (Если Вы не получили лицензионный ключ, то запросите его по ссылке)
  10. Включить модуль (статус включено). Сохранить настройки.
  11. Для магазинов 3.0 Очистите кеш шаблонов (главная страница админ панели -> шестеренка справа вверху)

 

Обновление на новую версию:

  1. Создайте резервную копию базы данных и файлов сайта
  2. Для магазинов 2.0-2.1 Удалите модификатор модуля
  3. Установите модуль согласно инструкции УСТАНОВКА выше с перезаписью файлов (не забудте обновить модификаторы)
  4. Внимание! Обязательно пересохраните настройки.

Сокращение ссылок и использование шаблонов с сылками на оплату:

Функционал доступен только для магазинов 2.3 и 3.0.
Для корректной передачи ссылок с параметрами используется сокращение ссылок. (Сокращение работает только для WhatsApp и ссылок которые содержат в себе параметры со знаком &)
Зарегистрируйтесь по ссылке https://hm.ru/ и получите API_KEY, вставьте ключ в настройки модуля.
Теперь вы можете использовать ссылки с параметрами, например для формирования шаблона с использованием переменной ~paylink~
эта переменная работает только когда в заказе установлен метод оплаты из списка поддерживаемых ниже:


Инструкция по работе:

WhatsApp:

  1. Установите приложение whatsapp
  2. В админ панели перейдите в просмотр заказа
  3. Нажмите кнопку WhatsApp
  4. Убедитесь что в поле введен корректный номер телефона (код и номер, без знаков), при необходимости внесите правки в поле
  5. Выберите шаблон или используйте пустой
  6. В поле сообщение удостоверьтесь в корректности текста, при необходимости внесите правки в поле
  7. Нажмите кнопку отправить
  8. После открытия приложения, отправьте сообщение.

Viber:

  1. Установите приложение Viber
  2. В админ панели перейдите в просмотр заказа
  3. Нажмите кнопку Viber
  4. Убедитесь что в поле введен корректный номер телефона (код и номер, без знаков), при необходимости внесите правки в поле
  5. Нажмите кнопку начать чат
  6. После открытия приложения, отправьте любое приветственное сообщение (например Здравствуйте)
  7. Вернитесь в админ панель сайта
  8. Выберите шаблон или используйте пустой
  9. В поле сообщение удостоверьтесь в корректности текста, при необходимости внесите правки в поле
  10. Нажмите кнопку отправить
  11. После открытия приложения, выбирите получателя и отправьте сообщение.

Telegram:

  1. Установите приложение Telegram
  2. В админ панели перейдите в просмотр заказа
  3. Нажмите кнопку Telegram
  4. Введите имя пользователя в поле Никнейм
  5. Нажмите кнопку начать чат
  6. После открытия приложения, отправьте любое приветственное сообщение (например Здравствуйте)
  7. Вернитесь в админ панель сайта
  8. Выберите шаблон или используйте пустой
  9. В поле сообщение удостоверьтесь в корректности текста, при необходимости внесите правки в поле
  10. Нажмите кнопку отправить (у вас должен быть авторизирован нужный аккаунт на https://web.skype.com/, контакты подрузяться с него)
  11. После открытия приложения, выбирите получателя и отправьте сообщение.

Skype:

  1. Установите приложение Skype
  2. В админ панели перейдите в просмотр заказа
  3. Нажмите кнопку Telegram
  4. Введите имя пользователя в поле Никнейм
  5. Нажмите кнопку начать чат
  6. После открытия приложения, отправьте любое приветственное сообщение (например Здравствуйте)
  7. Вернитесь в админ панель сайта
  8. Выберите шаблон или используйте пустой
  9. В поле сообщение удостоверьтесь в корректности текста, при необходимости внесите правки в поле
  10. Нажмите кнопку отправить
  11. После открытия приложения, выберите получателя и отправьте сообщение.

Переменные и использование полей из Simple:

Свои поля стандартного оформления заказа

Расположение Адрес оплаты
~payAddrCustom_IDПОЛЯ~

Расположение Адрес доставки
~shipAddrCustom_IDПОЛЯ~

Расположение Аккаунт
~accCustom_IDПОЛЯ~

ID поля можно найти в адресной строке браузера при редактировании поля.

 

Свои поля simple

ID поля берется из вкладки "Настройка полей"


Для Simple 4.x
~paymentsimple4_IDполя~ - поле привязанное к адресу оплаты
~shippingsimple4_IDполя~ - поле привязанное к адресу доставки
~simple4_IDполя~ - поле привязанное к учетной записи покупателя или поле привязанное к методу

Выбор отображения отчества покупателя
Пример: 
Отчество: ~simple4_otchestvo~


Также доступны переменные:


~order_id~ - номер заказа
~totals~ - итого заказа в валюте заказа
~paylink~ - ссылка на оплату (см. пункт Сокращение ссылок и использование шаблонов с сылками на оплату)
~dateNumOrder~ - дата заказа в формате 20.12.2021
~invoice_no~ - номер счета 
~invoice_prefix~ - префикс счета 
~store_id~ - id магазина 
~store_name~ - название магазина 
~store_url~ - url магазина 
~customer_id~ - id покупателя 
~customer_group_id~ - id группы покупателя
~fax~ - факс 
~email~ - почта 
~payment_firstname~ - имя плательщика 
~payment_lastname~ - фамилия плательщика 
~payment_company~ - компания плательщика 
~payment_address_1~ - адрес плательщика 
~payment_address_2~ - адрес2 плательщика 
~payment_postcode~ - индекс плательщика 
~payment_city~ - город плательщика 
~payment_zone_id~ - id гео зоны плательщика 
~payment_zone~ - гео зона плательщика 
~payment_zone_code~ - код зоны плательщика 
~payment_country_id~ - id страны плательщика 
~payment_country~ - страна плательщика 
~payment_iso_code_2~ - iso код плательщика 
~payment_iso_code_3~ - iso код плательщика 
~payment_address_format~ - формат адреса плательщика 
~payment_method~ - метод оплаты 
~payment_code~ - код оплаты    
~shipping_firstname~ - имя для доставки 
~shipping_lastname~ - фамилия для доставки 
~shipping_company~ - компания для доставки 
~shipping_address_1~ - адрес доставки 
~shipping_address_2~ - адрес2 доставки 
~shipping_postcode~ - индекс для доставки 
~shipping_city~ - город доставки 
~shipping_zone_id~ - id гео зоны доставки 
~shipping_zone~ - гео зона доставки 
~shipping_zone_code~ - код зоны доставки 
~shipping_country_id~ - id страны доставки 
~shipping_country~ - страна доставки 
~shipping_iso_code_2~ - iso код доставки 
~shipping_iso_code_3~ - iso код доставки 
~shipping_address_format~ - формат адреса доставки 
~shipping_method~ - метод доставки 
~shipping_code~ - код метода доставки 
~comment~ - комментарий 
~total~ - итого (в валюте по умолчанию) 
~order_status_id~ - id статуса заказа 
~order_status~ - статус заказа 
~language_id~ - id языка 
~language_code~ - код языка 
~language_filename~ - файл языка 
~language_directory~ - дирректория языка 
~currency_id~ - id валюты 
~currency_code~ - код валюты 
~currency_value~ - курс валюты 
~ip~ - ip 
~forwarded_ip~ - переадресованный ip 
~user_agent~ - юзер агент 
~accept_language~ - язык 
~date_modified~ - дата изменения заказа 
~date_added~ - дата создания заказа