Подключение модуля к Telegram

2. Создание Telegram-бота через BotFather

1. Откройте в Telegram официального бота @BotFather. Проверьте точное имя — @BotFather.
2. Нажмите Start или отправьте команду /start.
3. Отправьте команду /newbot.
4. Введите отображаемое название бота. Например: Уведомления магазина.
5. Придумайте уникальное имя пользователя бота. Оно вводится латиницей и должно оканчиваться на bot. Например: my_shop_notice_bot.
6. BotFather создаст бота и пришлёт токен примерно такого вида: 1234567890:AAExampleToken_123456789. Скопируйте токен полностью — это значение для поля Bot Token в настройках модуля.

3. Выбор места получения уведомлений

4. Получение Chat ID через официальный Telegram Bot API

Необязательно использовать сторонних ботов для определения Chat ID. Идентификатор можно получить напрямую через официальный метод getUpdates.

1. Сначала отправьте созданному боту сообщение:
   • в личном чате — /start;
   • в группе — /start@username_бота;
   • в теме — ту же команду внутри нужной темы.
2. Подставьте Bot Token в адрес вместо текста ВАШ_BOT_TOKEN: https://api.telegram.org/botВАШ_BOT_TOKEN/getUpdates
3. Откройте полученный адрес в браузере. Telegram вернёт ответ в формате JSON.
4. Найдите в последнем объекте сообщения блок chat и поле id. Например: "chat": { "id": -1001234567890, "title": "Заказы" }
5. Скопируйте только значение поля id, сохранив знак минус. В примере Chat ID равен -1001234567890.

5. Получение ID темы Telegram

Если уведомления должны приходить не в общий чат, а в конкретную тему супергруппы:

1. Откройте нужную тему.
2. Отправьте в ней команду /start@username_бота.
3. Снова откройте адрес метода getUpdates.
4. Найдите в сообщении поле message_thread_id.
5. Запишите получателя в формате Chat ID:ID темы.

Пример:

6. Заполнение основных настроек модуля

Несколько получателей можно указать с новой строки, через запятую или точку с запятой:

7. Дополнительные настройки отправки

• Поле покупателя «Telegram» — выберите дополнительное поле OpenCart, в котором хранится @username или ссылка покупателя.
• Отправлять без звука — уведомление появится в чате без звукового сигнала.
• Запретить пересылку/сохранение — включает защиту содержимого сообщения средствами Telegram.
• Тайм-аут запроса — обычно достаточно 10 секунд. На медленном сервере можно увеличить значение.
• Журналирование — записывает результат работы в файл system/storage/logs/ekleo_telegram.log.

Настройка уведомлений

8. Уведомления о заказах

1. Откройте вкладку «Заказы».
2. Включите уведомления о заказах.
3. Отметьте статусы, при которых нужно отправлять сообщение.
4. Выберите режим повторных уведомлений.
5. Отметьте поля, которые должны входить в сообщение.

9. Поля уведомления о заказе

В сообщение можно включить:

Поля «Артикул / модель», «Опции» и «Цена товара» используются вместе с основным полем «Товары».

10. Уведомление о регистрации покупателя

1. Откройте вкладку «Регистрации».
2. Включите уведомление о новом покупателе.
3. Выберите нужные поля: ID, дату, ФИО, телефон, Email, Telegram, группу, подписку, IP или все дополнительные поля.

11. Уведомление о новом отзыве

1. Откройте вкладку «Отзывы».
2. Включите уведомление о новом отзыве.
3. Выберите поля: товар, автор, оценка, текст, дата, магазин и кнопка перехода к отзывам.

Сообщение отправляется сразу после добавления отзыва. Администратор сможет проверить его до публикации на сайте.

12. Проверка подключения

1. Убедитесь, что Bot Token и Chat ID введены без лишних пробелов.
2. Нажмите кнопку «Отправить тест» в правом верхнем углу.
3. Проверьте выбранный чат Telegram. Должно прийти тестовое сообщение.
4. Если тест выполнен успешно, нажмите синюю кнопку «Сохранить».
5. Создайте тестовый заказ или измените его статус на выбранный и проверьте рабочее уведомление.

Возможные ошибки и решения

Обновление и удаление

13. Обновление модуля

Для чистого обновления рекомендуется:

1. Сохранить Bot Token и Chat ID в безопасном месте.
2. Деинсталлировать модуль в списке модулей.
3. Удалить старый установочный пакет в установщике расширений.
4. Загрузить новый архив и снова установить модуль.
5. Открыть настройки, сохранить их и отправить тест.

Настройки модуля сохраняются при штатной деинсталляции, но перед обновлением всё равно рекомендуется записать Token и Chat ID.

14. Полное удаление

1. Деинсталлируйте модуль в списке модулей.
2. Удалите установочный пакет через установщик расширений.

При деинсталляции удаляются зарегистрированные события и таблица защиты от дублей. Заказы, покупатели и отзывы магазина не изменяются.

Рекомендации по безопасности

• создайте отдельного бота только для уведомлений магазина;
• не публикуйте Bot Token и полный URL метода getUpdates;
• добавляйте бота только в рабочие чаты;
• выводите в уведомления только необходимые персональные данные;
• ограничьте доступ сотрудников к настройкам модуля;
• отключите журналирование после завершения диагностики, если оно не требуется.