Відправлення форм до Telegram v1.1 для Opencart 3х

Модуль дозволяє відправляти будь-які форми (зворотний зв'язок, зворотний дзвінок, контактна форма, швидке замовлення і т.д.) в телеграм в особистий чат, або в групу (зручно, якщо у вас є кілька менеджерів).

Можливості:

•  Створювати необмежену кількість екземплярів модуля та прив'язувати їх до різних форм з різними налаштуваннями.
•  Використовувати різні чати для різних форм.
•  Прив'язуватися до форми або кнопки (кнопка ОБОВ'ЯЗКОВО повинна бути всередині форми) за CSS-селектором.
•  Встановлювати індивідуальний формат повідомлень для кожної форми.
•  Надсилати в чат картинки та інші файли.
•  Відображати користувачеві повідомлення про успішне надсилання або помилку.
•  Власний код валідації/перевірки полів. За замовчуванням модуль не перевіряє помилки, а відразу надсилає повідомлення.

Принцип роботи:
Модуль знаходить кнопку або форму, яка вказана в полі "Селектор форми або кнопки" і вішає обробник події click (на кнопку) або submit (на форму). Всередині обробника викликається метод validate (ви можете самостійно написати код для перевірки полів у налаштуваннях модуля), який за умовчанням повертає true. Якщо валідація пройшла успішно, то форма серіалізується (саме тому кнопка має бути всередині тега , якщо як селектор ви вказуєте кнопку) і надсилається запит AJAX на контролер модуля, який з урахуванням заповненого в адмінці формату повідомлень формує повідомлення і відправляє його в чат.
Якщо як селектор вказана форма, то переконайтеся, що вона реально відправляється на сервер (відбувається submit). Якщо цього не відбувається, то краще прив'язувати відправку до кнопки.

Встановлення модуля:
1. Зайдіть до адміністративної панелі свого інтернет-магазину.
2. На вкладці Модулі/Розширення виберіть Установка розширень.
3. Натисніть кнопку Завантажити та виберіть formInTelegram.ocmod.zip.
4. Після інсталяції перейдіть на вкладку Модулі/Розширення — Модифікатори та оновіть модифікатори.
5. Перейдіть на вкладку Модулі/Розширення — Модулі/Розширення.
6. У списку, що випадає, виберіть тип розширення — Модулі.
7. У списку модулів знайдіть [AppDevStudio] Надсилання форм у Telegram та активуйте модуль.
8. Натисніть кнопку редагування [AppDevStudio] Надсилання форм у Telegram, введіть дані форми, токен-бота та ідентифікатор чату і натисніть Зберегти.
9. У меню Дизайн/Макети виведіть створений модуль на тій же сторінці, де є дана форма або поставте галочку «Форма знаходиться на всіх сторінках», якщо форма реально присутня на всіх сторінках сайту.


Як зареєструвати бота та отримати токен:
1. Знайти в телеграмі користувача @botfather
2. Біля вікна введення тексту натисніть кнопку Меню і вибрати "/newbot" або ввести цю команду в поле введення і відправити повідомлення.
3. Вам буде запропоновано ввести назву бота, а потім його ім'я користувача, яке закінчується на «bot».
4. Ввести потрібні дані.
5. У повідомленні у відповідь після рядка «Use this token to access the HTTP API:» буде написано токен у форматі «цифри:символи»
6. Скопіювати і зберегти кудись токен.
7. Відкрити налаштування модуля та ввести туди токен у відповідне поле.

Як дізнатися про особистий чат:
1. Знайти свого бота в телеграмі на ім'я користувача.
2. Написати йому довільне повідомлення.
3. Перейти в браузері за URL https://api.telegram.org/bot/getUpdates де замість потрібно вписати отриманий раніше токен. Браузер Firefox відображає дані структуровано, а не просто текстом. Це зручніше для пошуку інформації.
4. Якщо не видно повідомлень, то оновити сторінку можна написати повторно повідомлення.
5. У розділі "chat" буде підрозділ "id". Це і ваш chat_id (Ідентифікатор чату). Копіюємо його та вставляємо в налаштування модуля.

Як надсилати повідомлення до групи:
1а. Створити групу телеграм через стандартне меню, знайти на кроці додавання користувачів свого бота і додати його до групи.
1б. Якщо група вже існує, то знайти свого бота в телеграмі на ім'я користувача. У меню праворуч натиснути кнопку «Додати до групи» та вибрати відповідну групу.
2. Написати у групі повідомлення латиницею, що починається зі знака «/».
3. Перейти в браузері за URL https://api.telegram.org/bot/getUpdates де замість потрібно вписати отриманий раніше токен. Браузер Firefox відображає дані структуровано, а не просто текстом. Це зручніше для пошуку інформації.
4. Якщо не видно повідомлень, то оновити сторінку можна написати повторно повідомлення.
5. У розділі "chat" буде підрозділ "id". Це і ваш chat_id (у групи він починається зі знака «-» і далі містить цифри). Копіюємо його повністю разом зі знаком «-» і вставляємо в налаштування модуля.

Теги: модуль відправлення форм до Telegram опенкарт, модуль відправлення форм до Telegram Opencart