====== Модуль интеграции с Telegram ======

Модуль предназначен для взаимодействия с телефонной станцией через месенджер Telegram. 
Основные возможности:
  * Отображение истории звонков с АТС
  * Получение файла записи звонка с АТС
  * Отображение текущего и последнего звонка на номер сотрудника
  * Функция обратного звонка клиенту
<note important>**Обратите внимание**! С АТС необходимо предоставить доступ к ресурсу [[https://api.telegram.org/bot]].  </note>
===== Регистрация бота =====
Для начала через чат Telegram следует написать боту "**BotFather**". Этот бот позволит создать и настроить вашего нового бота для интеграции с MIKOPBX.

  - Отправляем боту команду <code>/start</code>
  - Команда создания нового бота <code>/newbot</code>
  - Отправляем имя нашего нового бота. К примеру <code>MIKOPBX_NEW_BOT</code>
  - Диалог с ботом примет следующий вид: {{ ::bot_api_telegram.jpg |}}
  - **Сохраните значение "token"** он понадобится для настройки со стороны АТС
  - Далее для удобства опишем команды бота <code>/setcommands</code>
  - Вводим имя команды <code>menu - Основное меню бота
start - начало работы с ботом</code>
  - Диалог с ботом примет следующий вид: {{ ::bot_api_telegram2.jpg |}}

===== Настройка MIKOPBX =====

  - В интерфейсе модуля введите значение **token** {{ ::bot_api_telegram3.jpg |}}
  - В карточке сотрудников следует указать мобильные номера. Именно по ним будет производиться авторизация сотрудников: {{ ::bot_api_telegram4.jpg |}}

===== Начало работы =====

  - Напишите в Telegram своему боту  <code>/start</code> {{ ::bot_api_telegram5.jpg |}}
  - Появится запрос авторизации {{ ::bot_api_telegram6.jpg |}}
  - При согласии на авторизацию диалог примет вид: {{ ::bot_api_telegram7.jpg |}}

===== Мои звонки =====

  - При переходе по кнопке "**Мои звонки**" будет отображена история звонков {{ ::bot_api_telegram8.jpg |}}
  - Есть возможность получить расшифровку звонка: {{ ::bot_api_telegram9.jpg |}}
  - Из расшифровки есть возможность получить файл записи разговора и перезвонить абоненту

===== Обработка звонков =====
  - При поступлении звонка будет отображена информация в чате: {{ ::bot_api_telegram10.jpg |}}
  - Из меню есть возможность перезвонить по номеру абонента и вернутся к основному меню