---
title: "Частина 2 Інструкція з користування та налаштування Telegram Bot і TurboSMS"
canonical: "https://docs.mocotms.com/space/UAUGMESSAG/17301873/%D0%A7%D0%B0%D1%81%D1%82%D0%B8%D0%BD%D0%B0%202%20%D0%86%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D1%96%D1%8F%20%D0%B7%20%D0%BA%D0%BE%D1%80%D0%B8%D1%81%D1%82%D1%83%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F%20%D1%82%D0%B0%20%D0%BD%D0%B0%D0%BB%D0%B0%D1%88%D1%82%D1%83%D0%B2%D0%B0%D0%BD%D0%BD%D1%8F%20Telegram%20Bot%20%D1%96%20TurboSMS"
format: markdown
---
## **Інструкція з налаштування Telegram Bot**
**Суть**
**Користувачі можуть додатися в telegram bot, щоб у подальшому отримувати інформацію у ньому.**
**Передумови**
1. У вас має бути встановлена програма** Telegram.**
2. Ви повинні бути зареєстровані або зареєструватися у сервісі [https://turbosms.ua](https://turbosms.ua)
3. У вас має бути налаштовано **TurboSMS **у системі
**Інструкція дій з налаштування Telegram Bot**
1. Зпускаємо програму** Telegram.**
2. Відкриваємо чат** **із** ****[@BotFather](https://t.me/botfather)**. Будьте уважні, якщо самі шукаєте чат, а не переходите по посиланню. Потрібно обрати саме** @BotFather**, а не** @BotFatherDev @BotFatherFast @BotFastFather.**
3. Натискаємо** "Запустити".**
4. Відправляємо повідомлення з текстом **/newbot **або натискаємо на** **Меню** /newbot create a new bot.**
5. У відповідь отримуємо повідомлення від робота з проханням вказати ім'я Вашого робота.
6. Вводимо ім'я бота і надсилаємо повідомлення.
7. Якщо Ви ввели коректне значення ім'я, то отримуємо повідомлення з проханням вказати **username **Вашого бота. Будьте уважні Ваш** username **обов'язково має закінчуватися на** 'bot'.**
8. Вводимо** username **бота і надсилаємо повідомлення.
9. Якщо Ви ввели коректне значення username, отримуємо повідомлення з вітанням і токеном. Приклад токена** 4839574812:AAFD39kkdpWt3ywyRZergyOLMaJhac60qc.**
# **Інструкція конфігурування Moco**
**Додати змінну оточення. (Дану зміну додає DevOps)**
1. Виконуємо вхід до системи за допомогою облікового запису** Адміністратора.**
2. Переходи до розділу** Адміністрування **(скрін 1)** **секція** Логи, Конфіги Telegram bot **(скрін 2).
3. Якщо Ви виконали все правильно, але повинні побачити блок з Інформацією про роботу (скрін 3).
4. У блоці Інформація про роботу необхідно натиснути на кнопку** Встановити вебхук **(скрін 3).
5. Якщо вебхук буде успішно встановлений Ви побачите** url вебхука **та кнопку** Видалити вебхук **(скрін 4).
6. Ваш бот готовий до використання.
7. Для перевірки його роботи переходимо в чат з ботом за допомогою посилання (скрін 5) або вручну виконуємо пошук** **у** telegram.**
8. Натискаємо кнопку** Запустити.**
9. Якщо бот Вам відповідає, то все налаштовано коректно.
**Скрін 1**
**Скрін 2**
**Скрін 3**
**Скрін 4**
**Скрін 5**
**Першоджерела та додатковий статті**
1. **[From BotFather to 'Hello World'](https://core.telegram.org/bots/tutorial)**
**Підключення користувача до Telegram Bot**
Підключення такє саме як і в TurboSMS. Для Telegram Bot і TurboSMS діють одні і ті ж правила
**Варіант 1:**
1. За допомогою облікового запису **Адміністратора **перейти до розділу **Адміністрування**, **Правила вимагання оновлення номеру телефона** (скрін 6)
2. Встановити правила вимоги натиснув на кнопку **Додати **(скрін 7)
3. У формі **Додавання правила вимагання оновлення номеру телефона** додати певні правила по **Підрозділу** та/або по **Посаді, **обовя’зково вказати** Інтервал відображення форми в днях **та натиснути кнопку** Додати **(скрін 8)
**Скрін 6**
**Скрін 7**
**Скрін 8**
**Варіант 2:**
1. За допомогою облікового запису **Адміністратора **перейти до розділу **Організаційна структура**, **Особи **(скрін 9)
2. Перейти в **Обліковий запис потрібного користувача **(скрін 10)
3. Редагувати **Обліковий запис користувача**, вибрати **Вимагати оновлення номеру телефона **(скрін 10)
**Скрін 9 **
**Скрін 10**
**Налаштування повідомлень для відправки через Telegram Bot **
**Налаштування шаблонних повідомлень через Канал комунікацій**
1. За допомогою облікового запису **Адміністратора **перейти до розділу **Повідомлення**, **Канал комунікацій **(скрін 11)** **
2. Увімкнути **Telegram** та перейти до даного каналу **Telegram **(скрін 12)
3. Вибрати потрібний шаблон для відправки повідомлень. Обрати вкладинку **Telegram**, **увімкнути його**, вибрати **потрібну мову**, натиснути **Змінити шаблон **(скрін 13)
4. При заповненні тексту повідомлень прописувати **Тему** не обов’язково, так як в сповіщенні в **Telegram **тема відображатись не буде (це специфіка роботи самого Telegram).
Якщо ви скопіювали текст з шаблону **Електронна пошта** (доприкладу) тоді:
- При редагуванні даного шаблону **Telegram** в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 14)
- Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 15)
- Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 16)
- Натиснути кнопку **Зберегти **(скрін 17)
**Скрін 11**
**Скрін 12**
**Скрін 13**
**Скрін 14**
**Скрін 15**
**Скрін 16**
**Скрін 17**
**Налаштування довільних повідомлень через Організаційну структуру**
5. За допомогою облікового запису **Адміністратора** перейти до розділу **Повідомлення**, **Канали комунікацій **(скрін 18)
6. В Каналі комунікацій перейти до **Telegram, **у** Найменування каналу комунікацій **обрати** Організаційна структура, Відправка довільних повідомлень **повинно бути увімкнене.** **Перейти до** Відправки довільних повідомлень **(скрін 19)
7. У шаблоні **Редагування шаблону повідомлень **перейти до вкладки** Telegram, Увімкнути **(скрін 20)
8. Вибрати потрібний шаблон для відправки повідомлень. Обрати вкладинку **Telegram**, **увімкнути його**, вибрати **потрібну мову**, натиснути **Змінити шаблон **(скрін 21)
9. При заповненні тексту повідомлень прописувати **Тему** не обов’язково, так як в сповіщенні в **Telegram **тема відображатись не буде (це специфіка роботи самого Telegram).
Якщо ви скопіювали текст з шаблону **Електронна пошта** (до прикладу) тоді:
- При редагуванні даного шаблону **Telegram** в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 22)
- Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 23)
- Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 24)
- Натиснути кнопку **Зберегти **(скрін 25)
10. За допомогою облікового запису **Адміністратора** перейти до розділу **Організаційна структура**, **Особи **(скрін 26)
11. Вибрати користувача, в полі **Із вибраними** обрати **Надіслати повідомлення **(скрін 27)
12. Перейти на вкладку **Telegram, **в полі** Ваша тема **прописати тему. Якщо текст буде довільний то прописати потрібний текст в полі** Ваш текст **та натиснути** Далі **(скрін 28)**. **Якщо шаблон тексту буде копійований з шаблону** Електронна пошта **тоді треба зробити наступні кроки:
- При редагуванні даного шаблону **Telegram** в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 29)
- Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 30)
- Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 31)
- Для того щоб надіслати повідомлення треба натиснути кнопку **Далі **(скрін 31)
**Скрін 18**
**Скрін 19**
**Скрін 20**
**Скрін 21**
**Скрін 22**
**Скрін 23**
**Скрін 24**
**Скрін 25**
**Скрін 26**
**Скрін 27**
**Скрін 28**
**Скрін 29**
**Скрін 30**
**Скрін 31**
**Для того щоб сповіщення прийшло користувачу, треба аби відпрацювала системна задача «Повідомлення/Відправлення повідомлень». Дана задача відпрацьовує в автоматичному режимі за розкладом. Але якщо потрібно аби повідомлення прийшло якнайшвидше, системну задачу можна запустити вручну. **
**Для цього потрібно:**
1. ** **За допомогою облікового запису **Адміністратора** перейти до розділу **Системні задачі, Управління системними задачами **(скрін 32)
2. Вибрати системну задачу** Повідомлення/Відправлення повідомлень **та натиснути** Запустити вручну **(скрін 33)
**Скрін 32**
**Скрін 33**
**Щоб перевірити чи відправилось сповіщення, треба:**
1. За допомогою облікового запису **Адміністратора** перейти до розділу **Повідомлення, Журнал відправлених повідомлень **(скрін 34)
2. В полі **Канал комунікацій **обрати** Telegram **(скрін 35)
3. В полі **Створено в інтервалі** обрати певну дату (скрін 35)
4. Натиснути **Фільтрувати**(скрін 35)
5. Знайти потрібного вам користувача та побачити **Статус**(скрін 35)
**Скрін 34**
**Скрін 35**
**Якщо до прикладу користувача звільнили і автоматично відпрацювала за розкладом системна задача ****Управління користувачами/Видалення звільнених користувачів з Telegram Bot.**** то даного користувача автоматично система видаляє з ****Telegram Bot****. Для того щоб системна задача відпрацювала якомога швидше, її можна запустити вручну. Для цього потрібно:**
1. За допомогою облікового запису **Адміністратора** перейти до розділу **Системні задачі, Управління системними задачами **(скрін 36)
2. Вибрати системну задачу** Управління користувачами/Видалення звільнених користувачів з Telegram Bot **та натиснути** Запустити вручну **(скрін 37)
Після того як користувача видалили з** Telegram Bot, **автоматично в системі, в** Обліковому записі користувача**, напроти** Час приєднання до чат-боту: **стоїть прочерк (скрін 38).
Якщо користувач намагається почати роботу в **Telegram Bot **йому приходить сповіщення про те що треба додати номер телефону (скрін 39). Коли людина додає свій номер телефону, а в системі він уже звільнений йому надходить повідомлення про те що його не знайдено в системі (скрін 40).
Якщо користувача знов відновили у системі. Тоді йому треба пройти підтвердження номеру телефону з самого початку. І під’єднатись до **Telegram Bot**
**Скрін 36**
**Скрін 37**
**Скрін 38**
**Скрін 39**
**Скрін 40**
**Як змінити текст повідомлень в самому повідомленні Telegram Bot при початку роботи (по іншому це називається команди)** (скрін 41)** **
**Скрін 41**
Для цього потрібно:
1. За допомогою облікового запису **Адміністратора** перейти до розділу **Адміністрування, Telegram bot **(скрін 42)
2. Обрати поле в якому потрібно змінити текст та натиснути на знак питання. Скопіювати ключ (скрін 43)
3. Перейти до розділу **Графічний інтерфейс**, **Локалізація графічного інтерфейсу **(скрін 44)
4. В розділі **Локалізація графічного інтерфейсу **вибрати вкладинку **Пошук за ключем **та натиснути на** Оновити індекс **(скрін 45)
5. У поле вставити скопійований ключ, натиснути **Шукати** (скрін 46)
6. Обрати потрібну мову в **Оригінал фрази** та **Змінена фраза**, під **Змінена фраза** ввести потрібний текст, натиснути **Зберегти зміни** (скрін 46)
**Скрін 42**
**Скрін 43**
**Скрін 44**
**Скрін 45**
**Скрін 46**
**Як змінити текст повідомлень у формах при підтверджені номеру телефону у системі:**
1. За допомогою облікового запису **Адміністратора** перейти до розділу **Графічний інтерфейс**, **Локалізація графічного інтерфейсу **(скрін 47)
2. В розділі **Локалізація графічного інтерфейсу **вибрати вкладинку **Пошук за файлом **та натиснути на** Оновити індекс **(скрін 48)
3. В полі **Модуль **обрати** usr**, в полі **Файл локалізації **обрати** ViewsConfirmPhonePolicy **та натиснути** Шукати **(скрін 49)
4. Обрати потрібну мову в **Оригінал фрази** та **Змінена фраза**, під **Оригінал фрази **обрати потрібний текст котрий треба змінити, під **Змінена фраза** ввести потрібний текст, натиснути **Зберегти зміни **(скрін 49)
**Скрін 47**
**Скрін 48**
**Скрін 49**
**Інструкція користування TurboSMS для користувача **
1. Виконуємо вхід до системи за допомогою логіну та паролю
2. Вводимо **мобільний номер телефону**, натискаємо **погодитись** с правилами підтвердження, натискаємо **Надіслати код підтвердження **(скрін 1)
3. В полі **Код підтвердження** ввести код який надійде на телефон у SMS, після натиснути **Підтвердити** (скрін 2)
4. Після введення коду підтвердження переходимо до форми **Номер телефону підтверджено **(скрін 3)
5. Натиснути кнопку** Завершити **(скрін 3)
**Скрін 1**
**Скрін 2**
**Скрін 3**
**Інструкція користування чат-ботом для користувача **
6. Виконуємо вхід до системи за допомогою логіну та паролю
7. Вводимо **мобільний номер телефону**, натискаємо **погодитись** с правилами підтвердження, натискаємо **Надіслати код підтвердження** (скрін 1)
8. В полі **Код підтвердження** ввести код який надійде на телефон у SMS, після натиснути **Підтвердити** (скрін 2)
9. Після введення коду підтвердження переходимо до форми **Номер телефону підтверджено **(скрін 3)
10. Натиснути кнопку** Завершити **(скрін 3)
11. Перейти до** Telegram Bot, **натиснути** Почати **(скрін 4)**, Поділитися номером. **(скрін 5)
12. Після того як поділились номером телефону, приходить повідомлення про те що ви успішно прив’язали свій номер телефону (скрін 6).
**Після того як користувач приєднався до Telegram Bot йому будуть надходити смс повідомлення з системи **(скрін 7)**. **
**Скрін1**
**Скрін2**
**Скрін3**
**Скрін4**
**Скрін5**
**Скрін6**
**Скрін7**
