Уведомления о заказах в MAX с фото товаров

---

---

Модуль «Уведомления о заказах в MAX» отправляет уведомления о заказах интернет-магазина 1С-Битрикс напрямую в мессенджер MAX.

Главная отличительная особенность модуля — отправка фотографий товаров из заказа. При создании нового заказа модуль может автоматически отправить в MAX не только текстовое уведомление с данными заказа, но и фотографии товаров из состава заказа. Это помогает менеджеру быстрее понять, что именно заказал клиент, без перехода в административную часть сайта.

Возможности модуля:
— отправка уведомления о новом заказе;
— отправка уведомления об оплате заказа;
— отправка уведомления при изменении статуса заказа;
— отправка уведомления при отмене заказа;
— отправка состава заказа;
— отправка суммы заказа;
— отправка данных клиента, получателя, доставки и оплаты;
— отправка ссылки на заказ в административной части сайта;
— отправка фотографий товаров при создании нового заказа;
— ограничение максимального количества фотографий на один заказ;
— настройка получателей уведомлений;
— поддержка HTML, Markdown или текста без форматирования;
— редактирование шаблонов уведомлений;
— отправка тестового сообщения из настроек модуля;
— ведение диагностического лога.

Фотографии товаров берутся из изображений товаров в каталоге: детальной картинки или картинки анонса. Если в заказе используется торговое предложение, модуль пытается получить изображение связанного товара.

Модуль отправляет уведомления напрямую с сайта пользователя в API MAX с использованием токена, указанного администратором сайта. Данные не передаются на серверы разработчика модуля.

Для работы требуется:
— установленный и настроенный модуль «Интернет-магазин»;
— настроенный каталог товаров для отправки фотографий товаров;
— токен бота MAX;
— идентификатор чата или пользователя MAX для получения уведомлений;
— возможность исходящих HTTPS-запросов с сайта к API MAX;
— PHP-расширения curl, json и mbstring.

Модуль предназначен для сайтов на 1С-Битрикс: Управление сайтом с функциональностью интернет-магазина. Решение не является готовым интернет-магазином, не содержит публичных компонентов, шаблонов сайта и не изменяет публичную часть сайта.

1. Установите модуль «Уведомления о заказах в MAX» через Marketplace в административной части сайта 1С-Битрикс.

2. После установки откройте настройки модуля:
Настройки → Настройки продукта → Настройки модулей → Уведомления о заказах в MAX.

3. Включите опцию «Модуль активен».

4. Получите токен бота MAX и укажите его в поле «Токен бота MAX».

5. Укажите получателей уведомлений в поле «Получатели».
Каждый получатель указывается с новой строки или через запятую.
Поддерживаемые форматы:
— число — chat_id;
— user:123 — пользователь MAX;
— chat:123 — чат MAX.

6. Выберите формат текста уведомлений:
— HTML;
— Markdown;
— без форматирования.

7. При необходимости включите или отключите опцию «Включать уведомление в MAX».

8. В блоке «Фото товаров» настройте отправку фотографий:
— включите опцию «Отправлять фото товаров для нового заказа»;
— укажите максимальное количество фотографий на один заказ.

По умолчанию модуль может отправлять до 8 фотографий товаров на один новый заказ.

9. В разделе «Шаблоны» настройте тексты уведомлений для событий:
— новый заказ;
— заказ оплачен;
— статус заказа изменён;
— заказ отменён.

В шаблонах можно использовать переменные заказа, клиента, доставки, оплаты и состава корзины.

10. Нажмите «Сохранить».

11. Для проверки настроек нажмите «Отправить тестовое сообщение».
Если сообщение не отправилось, проверьте токен, получателей, доступность API MAX с сервера сайта и диагностические логи.

12. После настройки модуль будет автоматически отправлять уведомления при наступлении выбранных событий заказа.

Диагностические логи находятся в каталоге:
/local/modules/knk.maxnotify/logs/

Техническая поддержка модуля «Уведомления о заказах в MAX» осуществляется разработчиком решения.

Разработчик:
Комлев Кирилл

Сайт разработчика:
https://knkomlev.ru

E-mail для обращений:
knkomlev@yandex.ru

Регламент технической поддержки:
— заявки принимаются в рабочие дни с понедельника по пятницу;
— рабочее время поддержки: с 06:00 до 14:00 по московскому времени;
— время первичной реакции на обращение: до 1 рабочего дня;
— срок решения обращения зависит от сложности вопроса, возможности воспроизведения ошибки и необходимости выпуска обновления.

В обращении желательно указать:
— адрес сайта;
— редакцию и версию 1С-Битрикс;
— версию PHP;
— версию модуля;
— описание проблемы;
— шаги для воспроизведения;
— скриншоты настроек без токена бота;
— фрагмент диагностического лога без персональных данных и секретных ключей.

Поддержка не включает настройку сторонних сервисов, доработку индивидуальной логики интернет-магазина, изменение бизнес-процессов сайта и работы, не связанные с функциональностью модуля.