--- title: "Частина 1 Інструкція з користування та налаштування Telegram Bot і TurboSMS" canonical: "https://docs.mocotms.com/space/UAUGMESSAG/17334655/%D0%A7%D0%B0%D1%81%D1%82%D0%B8%D0%BD%D0%B0%201%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 --- ## **Інструкція з налаштування TurboSMS** **Суть** Користувачі мають можливість отримувати повідомлення за допомогою SMS. **Передумови** 1. Ви повинні бути зареєстровані або зареєструватися у сервісі [https://turbosms.ua](https://turbosms.ua) . **Інструкція дій** 1. Авторизуйтесь на сайті [https://turbosms.ua](https://turbosms.ua) . 2. Переходимо до розділу **Шлюз (API) -> Налаштування API** (скрін 1). 3. Включаємо **HTTP API**, вводимо свій **поточний пароль** та натискаємо** Зберегти налаштування**  (скрін 2). 4. Сторінка перезавантажується і ми отримуємо повідомлення, що **“Дані роботи зі шлюзом успішно змінені”**(скрін 3). 5. Копіюємо значення **“Поточний токен HTTP API авторизації”**(скрін 3). 6. Діємо далі згідно з інструкцією **“Інструкція конфігурування Moco”** **Cкрін 1** ![image](media://840411e6-414e-4293-8d78-5ab54f86b702) **Cкрін 2** ![image](media://a25f39e9-7885-4dc9-b5eb-099a7977329f) **Cкрін 3** ![image](media://00f7eb18-e460-47f4-93d4-599841bd7009) **Інструкція конфігурування Moco** 1. Додати змінну оточення. 2. Виконуємо вхід до системи за допомогою облікового запису Адміністратора. 3. Переходимо до розділу **Адміністрування** (скрін 1) секція **Логи, Конфіги -> TurboSMS** (скрін 2). 4. Якщо Ви виконали все правильно, то повинні побачити блок з **Інформацією** -> **Залишок на балансі **(скрін 3). **Cкрін 1** ![image](media://e9d93f1d-60e1-4f46-847b-eb346adcce33) **Скрін 2** ![image](media://b4168457-9cb6-4119-ae60-c3f9c7002c4b) **Cкрін 3** ![image](media://ed092a7c-2c4c-43b7-b4f2-b8d2433509c8) **Першоджерела та додатковий статті** 1. [https://turbosms.ua](https://turbosms.ua) **Підключення користувача до TurboSMS** **Варіант 1:** 1. За допомогою облікового запису **Адміністратора **перейти до розділу **Адміністрування**, **Правила вимагання оновлення номеру телефона** (скрін 4) 2. Встановити правила вимоги натиснув на кнопку **Додати **(скрін 5) 3. У формі **Додавання правила вимагання оновлення номеру телефона** додати певні правила по **Підрозділу** та/або по **Посаді, **обовя’зково вказати** Інтервал відображення форми в днях **та натиснути кнопку** Додати **(скрін 6) **Скрін 4** ![image](media://44a63b96-c80e-4e13-a9b2-e2a308f229c4) **Скрін 5** ![image](media://8c6037a8-02a5-41d2-8002-289dd655908c) **Скрін 6** ![image](media://6732d650-1391-4aaf-8345-8f7bc2cd136b) **Варіант 2:** 1. За допомогою облікового запису **Адміністратора **перейти до розділу **Організаційна структура**, **Особи **(скрін 7) 2. Перейти в **Обліковий запис потрібного користувача **(скрін 8) 3. Редагувати **Обліковий запис користувача**, вибрати **Вимагати оновлення номеру телефона **(скрін 8) **Скрін 7 ** ![image](media://164f9d65-2277-4e00-9b91-75c686ae09a7) **Скрін 8** ![image](media://bb255e6e-4313-43e6-bba1-14f0ae92e3b8) **Налаштування повідомлень для відправки через TurboSMS** **Налаштування шаблонних повідомлень через Канал комунікацій** 1. За допомогою облікового запису **Адміністратора **перейти до розділу **Повідомлення**, **Канал комунікацій **(скрін 9)** ** 2. Увімкнути **TurboSMS **та перейти до даного каналу **TurboSMS **(скрін 10) 3. Вибрати потрібний шаблон для відправки повідомлень. Обрати вкладинку **TurboSMS**, **увімкнути його **(скрін 11), вибрати **потрібну мову**, натиснути **Змінити шаблон **(скрін 12) 4. При заповненні тексту повідомлень прописувати **Тему** не обов’язково, так як в сповіщенні в **TurboSMS **тема відображатись не буде (це специфіка роботи самого TurboSMS). Якщо ви скопіювали текст з шаблону **Електронна пошта** (доприкладу) тоді: - При редагуванні даного шаблону **TurboSMS **в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 13) - Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 14) - Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 15) - Натиснути кнопку **Зберегти **(скрін 16) **Скрін 9** ![image](media://38bdc26f-acbe-4d57-ba31-0b4ef41dcf90) **Скрін 10** ![image](media://500ed449-42f4-4983-aa62-98ca4d68fd46) **Скрін 11** ![image](media://6b1e20b1-e40d-44c1-8dd5-329e15e9c1b0) **Скрін 12** ![image](media://5325202c-509f-4076-8a51-4cd31d585137) **Скрін 13** ![image](media://e82a3033-f1f3-481b-8d9d-a4093bcc409f) **Скрін 14** ![image](media://8294b52f-0944-4aca-a604-c939d0401d0d) **Скрін 15** ![image](media://97635970-b2f1-4b62-b5ea-accacb3ea1f9) **Скрін 16** ![image](media://a30050fe-5762-4761-9ff9-415397562a65) **Налаштування довільних повідомлень через Організаційну структуру** 1. За допомогою облікового запису **Адміністратора** перейти до розділу **Повідомлення**, **Канали комунікацій **(скрін 17) 2. В Каналі комунікацій перейти до **TurboSMS **(скрін 18)**, **у** Найменування каналу комунікацій **обрати** Організаційна структура, Відправка довільних повідомлень **повинно бути увімкнене.** **Перейти до** Відправки довільних повідомлень **(скрін 19) 3. У шаблоні **Редагування шаблону повідомлень **перейти до вкладки** TurboSMS, Увімкнути **(скрін 20) 5. Вибрати потрібний шаблон для відправки повідомлень. Обрати вкладинку **TurboSMS**, **увімкнути його**, вибрати **потрібну мову**, натиснути **Змінити шаблон **(скрін 21) 6. При заповненні тексту повідомлень прописувати **Тему** не обов’язково, так як в сповіщенні в **TurboSMS **тема відображатись не буде (це специфіка роботи самого TurboSMS). Якщо ви скопіювали текст з шаблону **Електронна пошта** (доприкладу) тоді: - При редагуванні даного шаблону **TurboSMS **в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 22) - Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 23) - Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 24) - Натиснути кнопку **Зберегти **(скрін 25) 7. За допомогою облікового запису **Адміністратора** перейти до розділу **Організаційна структура**, **Особи **(скрін 26) 8. Вибрати користувача, в полі **Із вибраними** обрати **Надіслати повідомлення **(скрін 27) 9. Перейти на вкладку **TurboSMS, **в полі** Ваша тема **прописати тему. Якщо текст буде довільний то прописати потрібний текст в полі** Ваш текст **та натиснути** Далі **(скрін 28)**. **Якщо шаблон тексту буде копійований з шаблону** Електронна пошта **тоді треба зробити наступні кроки: - При редагуванні даного шаблону **TurboSMS **в полі **Текст** потрібно натиснути на **Джерело** і тільки після цього вставити текст який скопіювали у шаблоні Електронна пошта (скрін 29) - Після того як вставили текст, треба знов натиснути на **Джерело **(скрін 30) - Далі потрібно довести оформлення тексту пробілами аби він виглядав корректно (скрін 31) - Для того щоб надіслати повідомлення треба натиснути кнопку **Далі **(скрін 31) **Скрін 17** ![image](media://c67fbb37-cf50-489b-abe0-d20cde742e66) **Скрін 18** ![image](media://4185bc4c-f3e8-4193-8dfd-53f660880b83) **Скрін 19** ![image](media://4a6457cb-6951-403e-915f-3c31b485d41a) **Скрін 20** ![image](media://6b1e20b1-e40d-44c1-8dd5-329e15e9c1b0) **Скрін 21** ![image](media://5325202c-509f-4076-8a51-4cd31d585137) **Скрін 22** ![image](media://e82a3033-f1f3-481b-8d9d-a4093bcc409f) **Скрін 23** ![image](media://8294b52f-0944-4aca-a604-c939d0401d0d) **Скрін 24** ![image](media://97635970-b2f1-4b62-b5ea-accacb3ea1f9) **Скрін 25** ![image](media://a30050fe-5762-4761-9ff9-415397562a65) **Скрін 26** ![image](media://11acd824-1fb9-41e9-be31-2eb6f586d383) **Скрін 27** ![image](media://1e8ebacd-3f46-4423-ac91-bb7519b999dd) **Скрін 28** ![image](media://e62a7526-3af9-41c4-9c19-915b9b430f44) **Скрін 29** ![image](media://81fc4aa9-32c3-4196-83ce-fc725d095335) **Скрін 30** ![image](media://449a6ad0-4959-452a-b8c9-6e582de72bdc) **Скрін 31** ![image](media://3b51e71c-addd-4df9-ba20-c6cd97337dc0) **Для того щоб сповіщення прийшло користувачу, треба аби відпрацювала системна задача «Повідомлення/Відправлення повідомлень».  Дана задача відпрацьовує в автоматичному режимі за розкладом. Але якщо потрібно аби повідомлення прийшло якнайшвидше, системну задачу можна запустити вручну. ** **Для цього потрібно:** 1. ** **За допомогою облікового запису **Адміністратора** перейти до розділу **Системні задачі, Управління системними задачами **(скрін 32) 2. Вибрати системну задачу** Повідомлення/Відправлення повідомлень **та натиснути** Запустити вручну **(скрін 33) **Скрін 32** ![image](media://f429ce0e-c915-4a8c-ad63-55f40be9f8f9) **Скрін 33** ![image](media://4f8b6206-eec7-40c3-96b1-b29bbb44c74f) **Щоб перевірити чи відправилось сповіщення, треба:** 1. За допомогою облікового запису **Адміністратора** перейти до розділу **Повідомлення, Журнал відправлених повідомлень **(скрін 34) 2. В полі **Канал комунікацій **обрати** TurboSMS** (скрін 35) 3. В полі **Створено в інтервалі** обрати певну дату (скрін 35) 4. Натиснути **Фільтрувати**(скрін 35) 5. Знайти потрібного вам користувача та побачити **Статус**(скрін 35) **Скрін 34** ![image](media://24a9ade5-513d-43be-bccc-a938b4d2689e) **Скрін 35** ![image](media://0ff7d35b-7bc3-4ecb-a9bd-f5fcb1843919) **Після того коли користувач підтвердить свій номер телефону, в його особовій картці в полі Мобільний номер той котрий підтвердив користувач, а також в полі Час підтвердження номеру відобразиться: день, місяць, рік та час до секунд коли користувач підтвердив номер телефону **(скрін 36)**. ** **Скрін 36** ![image](media://3594d844-9700-45b2-8ae4-ed3dd130f17e) **Як змінити текст повідомлень у формах при підтверджені номеру телефону у системі **(скрін 37)**:** 1. За допомогою облікового запису **Адміністратора** перейти до розділу **Графічний інтерфейс**, **Локалізація графічного інтерфейсу **(скрін 38) 2. В розділі **Локалізація графічного інтерфейсу **вибрати вкладинку **Пошук за файлом **та натиснути на** Оновити індекс **(скрін 39) 3. В полі **Модуль **обрати** usr**, в полі **Файл локалізації **обрати** ViewsConfirmPhonePolicy **та натиснути** Шукати **(скрін 40) 4. Обрати потрібну мову в **Оригінал фрази** та **Змінена фраза**, під **Оригінал фрази **обрати потрібний текст котрий треба змінити, під **Змінена фраза** ввести потрібний текст, натиснути **Зберегти зміни **(скрін 40) **Скрін 37** ![image](media://49b20f71-2838-4490-86ec-24019486d3ab) **Скрін 38** ![image](media://64c72133-5b58-484b-9ee4-a117f31c5c9a) **Скрін 39** ![image](media://c256a6f3-55f8-4262-ab5e-65237c199324) **Скрін 40** ![image](media://535e1fc6-55e3-4552-a01d-c8b4f029fdd4)