Налаштування Приймача даних Телеграм
Інтеграція дозволить вам надсилати повідомлення в Телеграм у відповідь на будь-яку дію в інших системах. Наприклад, якщо в Google Sheets з'явився новий рядок, замовлення CRM перейшло на інший етап воронки або коли нове замовлення з'явилося на вашому сайті, повідомлення буде автоматично надіслано до Телеграм. Це дозволить вам ефективно автоматизувати робочі процеси та заощадити багато часу.
Давайте пройдемо весь етап налаштування Телеграм разом!
Навігація:
1. Що робитиме інтеграція з Телеграм?
2. Як підключити акаунт Телеграм до ApiX-Drive?
Відправити ПОВІДОМЛЕННЯ
Відправити ПОВІДОМЛЕННЯ (ваш бот)
3. Як налаштувати у вибраній дії передачу даних у Телеграм?
4. Приклад даних, які будуть відправлені до вашого Телеграми.
5. Автооновлення та інтервал спрацьовування з'єднання.
Відповіді на часті питання:
1. Не надходить тестове повідомлення чи відповідь, що бот успішно підключено.
2. Вже підключили бот, але потрібно передавати дані до групи чи каналу.
Після налаштування джерела даних, клацніть «Почати налаштування Приймача Даних».
Виберіть систему як Приймач даних. У цьому випадку необхідно вказати Телеграм.
Далі необхідно вказати дію "Відправити ПОВІДОМЛЕННЯ".
Ви зможете додати наш бот і отримувати від нього сповіщення про важливі події з інших систем у своєму Телеграмі або у групі.
Відправити ПОВІДОМЛЕННЯ - на основі даних з Джерела даних будуть відправлятися повідомлення в наш бот ApiX-Drive |Notifications|.
Надіслати ФОТО - на основі даних з Джерела даних будуть відправлятися фото в наш бот ApiX-Drive |Notifications|.
Надіслати ВІДЕО - на основі даних з Джерела даних будуть відправлятися відео в наш бот ApiX-Drive |Notifications|.
Надіслати АУДІО - на основі даних з Джерела даних будуть відправлятися аудіо в наш бот ApiX-Drive |Notifications|.
Надіслати ГОЛОСОВЕ ПОВІДОМЛЕННЯ - на основі даних з Джерела даних будуть відправлятися голосові повідомлення в наш бот ApiX-Drive |Notifications|.
Надіслати ДОКУМЕНТ (ФАЙЛ) - на основі даних з Джерела даних будуть відправлятися документи (файли) в наш бот ApiX-Drive |Notifications|.
Надіслати КОНТАКТ - на основі даних з Джерела даних будуть відправлятися контакти в наш бот ApiX-Drive |Notifications|.
Відправити ПОВІДОМЛЕННЯ (ваш бот) - на основі даних з Джерела даних будуть відправлятися повідомлення у ваш бот, який створений в Телеграм.
Редагувати ПОВІДОМЛЕННЯ (ваш бот) - на основі даних з Джерела даних будуть надсилатись редаговані фото у ваш бот.
Надіслати РЕАКЦІЮ на повідомлення (ваш бот) - на основі даних з Джерела даних будуть надсилатись реакції на повідомлення у ваш бот.
Видалити ПОВІДОМЛЕННЯ (ваш бот) - на основі даних з Джерела даних будуть видалятись повідомлення з вашого бота.
Надіслати ФОТО (ваш бот) - на основі даних з Джерела даних будуть надсилатись фото у ваш бот.
Надіслати ВІДЕО (ваш бот) - на основі даних з Джерела даних будуть надсилатись відео у ваш бот.
Надіслати ДОКУМЕНТ (ФАЙЛ) (ваш бот) - на основі даних з Джерела даних будуть надсилатись документи (файли) у ваш бот.
Надіслати АУДІО (ваш бот) - на основі даних з Джерела даних будуть надсилатись аудіо у ваш бот.
Надіслати ГОЛОСОВЕ ПОВІДОМЛЕННЯ (ваш бот) - на основі даних з Джерела даних будуть надсилатись голосові повідомлення у ваш бот.
Надіслати КОНТАКТ (ваш бот) - на основі даних з Джерела даних будуть надсилатись контакти у ваш бот.
Приклад підключення Телеграм з дією "Відправити ПОВІДОМЛЕННЯ "
Наступний крок - вибір акаунту Телеграм, в який буде відправлятись повідомлення.
Якщо немає підключених акаунтів до системи ApiX-Drive - натисніть "Підключити акаунт".
У вікні вкажіть назву акаунту і клацніть "Зберегти".
Далі відкриється нове вікно, в якому потрібно скопіювати дані в поле "Рядок для підключення Телеграм-бота".
Після цього закрийте це вікно, перезавантажте сторінку та виберіть створений акаунт.
Тепер необхідно перейти у вашу програму Телеграм.
У програмі Телеграм у рядку пошуку введіть @apix_drive_bot .
Натисніть на профіль бота і натисніть "Запустити/Перезапустити".
Надішліть повідомлення боту з рядком з'єднання, яке було скопійовано в системі ApiX-Drive.
Дочекайтеся повідомлення про успішне підключення до системи.
Після цього поверніться до системи ApiX-Drive та продовжіть налаштування.
Закрийте вікно підключення та виберіть підключений акаунт Телеграм, потім клацніть "Продовжити".
Приклад підключення Телеграм з дією "Відправити ПОВІДОМЛЕННЯ (ваш бот) "
Наступний крок - вибір акаунту Телеграм, в який буде відправлятись повідомлення.
Якщо немає підключених акаунтів до системи ApiX-Drive - натисніть "Підключити акаунт".
Заповніть поля відповідними даними, де:
Токен - токен для підключення вашого телеграма бота.
- Створіть новий бот або використовуйте вже створений бот.
- Як створити новий бот описано тут - https://hostiq.ua/blog/ukr/chatbot-telegram
- Щоб дізнатися Токен вже створеного бота, ви можете в BotFather написати команду /mybots . Після чого виберіть потрібного вам бота і натисніть на пункт " API Token ". Скопіюйте Токен та вставте у відповідне поле в системі ApiX-Drive.
Зверніть увагу!
В розділі Доступ можливо підключити приватний чат, канал чи групу, для цього треба створити свій бот і додати його з правами адміністратора, щоб він мав права доступу на запис.
Якщо ви раніше підключали ваш бот до інших сервісів, вам потрібно відключити перше підключення та повторно підключити бота або створити нового бота.
Після внесення токену в необхідне поле, натисніть «Зберегти», цим ви підтверджуєте видалення раніше встановленого вебхука у зазначеному боті, а також даєте згоду на встановлення вебхука ApiX-Drive.
Зверніть увагу, якщо потрібного доступу немає у списку, виконайте дії які описанні при підключенні, а саме, напишіть щось безпосередньо боту та натисніть кнопку «Оновити».
У випадку каналу чи групи додайте бота та натисніть кнопку «Оновити». Якщо бот був доданий раніше, його слід додати знову.
У вашому додатку Телеграм у рядку пошуку введіть @тут_вкажіть_ім'я_користувача_вашого_бота.
Натисніть на профіль бота і натисніть "Запустити". Якщо ви раніше цього бота підключали, то у вас буде кнопка "Перезапустити", натисніть її.
Коли підключений акаунт відобразився у списку активних акаунтів, виберіть його для подальшої роботи.
Тепер вам необхідно скласти повідомлення з даних, які будуть відправлятися в Телеграм-бот.
Щоб додати змінну, клацніть у полі "Повідомлення" і виберіть потрібну змінну зі списку. При необхідності ви можете написати дані вручну в рядок або побудувати повідомлення для зручності в стовпчик (для переходу на наступний рядок потрібно використовувати кнопку "Enter"), як показано в прикладі.
Коли повідомлення буде сформовано, натисніть "Змінити та продовжити".
Тепер ви бачите тестові дані, так виглядатиме ваше повідомлення.
Клацніть "Надіслати тестові дані до Телеграм" і перевірте повідомлення у Телеграм-боті.
Якщо вас все влаштовує - натисніть "Продовжити" для подальшого налаштування.
Зверніть увагу!
Якщо тестове повідомлення не надходить чи немає відповіді, що бот успішно підключений, перевірте якими налаштуваннями ви запустили бот (Доступи - Месенджери-Телеграм), та який акаунт Телеграм (якщо їх кілька) обраний на етапі Доступ. Якщо це не допомогло, виконайте наступний алгоритм дій:Перепідключення Власного Бота
Крок 1: Налаштування в BotFather
Переконайтеся, що ваш бот має наступні параметри (команда /setoptions або через меню Bot Settings):
Allow Groups: Enabled -дозволяє додавати бота в групи.
Chat Access Mode: Enabled (On)- дозвіл на підключення.
Group Admin Rights: Enabled (On) — права адміністратора в групах.
Channel Admin Rights: Enabled (On) — права адміністратора в каналах.
Крок 2: Очищення старих зв’язків
Видаліть бота з групи або каналу, куди ви хочете передавати дані, якщо бота вже було додано раніше.
Для приватного чату повністю видаліть діалог з ботом та очистіть історію повідомлень.
Крок 3: Перепідключення
У вашому з’єднанні на етапі "Доступ" натисніть "Підключити".
Вставте API Token вашого бота та натисніть "Зберегти".
Коли ви побачите статус "Успішно підключено" (з’явиться зелена плашка "Підключено" та порожній список чатів) — САМЕ ЗАРАЗ додайте бота в групу або канал, як учасника.
- Якщо ви хочете передавати дані в ГРУПУ чи КАНАЛ: Додайте бота та обов'язково надайте йому права Адміністратора -бот повинен мати доступ на відправку повідомлень. .
- Якщо ви хочете передавати дані в ПРИВАТНИЙ ЧАТ (особисто боту): Перейдіть у діалог з ботом, натисніть "Start" та напишіть йому будь-яке повідомлення
Крок 4: Оновлення списку
Поверніться в кабінет і натисніть кнопку "Оновити" біля списку чатів.
Ваша група/канал/чат з’являться у випадаючому списку. Виберіть необхідний доступ та завершіть налаштування.
Зверніть увагу: одне підключення через один API Token дозволяє передавати дані лише в один обраний чат (групу, канал або приватний чат). Одночасно передавати дані в кілька пунктів призначення за допомогою одного бота неможливо — для кожного нового чату використовуйте окремого бота.
Перепідключення бота ApiX-Drive |Notifications|
Якщо ви хочете щоб повідомлення надходили до каналу або групи, потрібно додати наш бот до групи або каналу, запустити його там і відправити йому налаштування. У підсумку, в групі або каналі має прийти відповідь, що бот успішно підключений.
Якщо ви вже раніше підключали собі наш бот, а тепер хочете його підключити до групи або каналу, вам потрібно виконати наступний алгоритм:
1. Потрібно відключити наш бот, очистити всю історію і повністю видалити діалог з ботом.
2. У нашій системі перейти до розділу Доступи - Месенджери - Телеграм та видалити всі створені акаунти.
3. Перейти до вашого з'єднання в блок Приймача даних на етап "Доступ" та створити новий акаунт.
4. Згідно з довідкою повторно налаштувати Телеграм, тільки цього разу спочатку створити групу або канал, додати туди нашого бота і туди відправити рядок з підключенням. Після цього відправте тестові дані в Телеграм і перевірте, що прийшло.
Хочемо звернути вашу увагу!
При передачі даних у Телеграм існує обмеження на відправку повідомлень у бот - 1 повідомлення раз на 3 секунди. Наприклад, якщо ви бажаєте передати 10 рядків із таблиці, це займе 30 секунд.
На цьому налаштування Приймача даних завершено!
Тепер можна розпочати вибір інтервалу оновлення та увімкнення автооновлення.
Для цього клацніть "Увімкнути автооновлення".
На головному екрані клацніть на іконку шестерні, щоб вибрати необхідний інтервал оновлення або налаштуйте Запуск за розкладом. Щоб запускати з'єднання за часом, виберіть Запуск за розкладом та вкажіть бажаний час спрацювання оновлення з'єднання або додайте відразу кілька варіантів часу, коли потрібно, щоб спрацювало з'єднання.
Увага! Щоб Запуск за розкладом спрацював у вказаний час, необхідно, щоб інтервал між поточним часом та вказаним часом був більше 5 хвилин. Наприклад, ви вибираєте час 12:10 та поточний час 12:08 - у цьому випадку автооновлення з'єднання відбудеться о 12:10 наступного дня. Якщо ви вибираєте час 12:20 та поточний час 12:13 – автооновлення з'єднання спрацює сьогодні і далі щодня о 12:20.
Для того щоб поточне з'єднання спрацьовувало після іншого з'єднання, поставте галочку "Оновлювати лише після з'єднання" і вкажіть з'єднання, після якого спрацьовуватиме поточне з'єднання.
Щоб увімкнути автооновлення, переведіть повзунок у положення, як показано на малюнку.
Для того щоб виконати примусове спрацювання з'єднання, клацніть по іконці у вигляді стрілки.
На цьому налаштування Телеграм як Приймача даних завершено! Бачите, як все просто!?
Тепер можете не турбуватися, далі ApiX-Drive зробить все самостійно!