Данное руководство поможет Вам настроить виртуальную АТС (ВАТС) Манго для работы с панелью телефонии. Следуйте инструкциям шаг-за-шагом в том порядке, в котором они представлены.

• Шаг 1: Установите сервер интеграции
• Шаг 2: Настройте подключение к API
• Шаг 3: Настройте подключение к веб-сервису 1С
• Шаг 4: Запустите службу сервера интеграции

Сервер интеграции обеспечивает взаимосвязь между всеми компонентами панели телефонии. Он может быть установлен на терминальный сервер Windows, либо отдельный компьютер. Сервер интеграции устанавливается как служба Windows. Для установки требуются права администратора.

1. Откройте личный кабинет МИКО https://telefon.miko.ru/personal/update-files/.
2. Скачайте дистрибутив сервера интеграции.
3. Запустите мастер установки сервера интеграции. Следуйте указаниям мастера.

Сервер интеграции подключается к серверу API Манго. Для подключения необходимо получить код и ключ уникальные для каждой ВАТС.

1. Откройте личный кабинет Манго и выберите виртуальную АТС, с которой будет выполнятся интеграция панели телефонии.
2. Перейдите в раздел Настройки АТС → Интеграции. На этой странице указаны код и ключ для доступа к API.
3. Чтобы сервер интеграции мог подключиться к API манго:
   а. Откройте файл настроек подключения к Манго c:\ProgramData\MIKO LLC\Nightbird Server\mango\config.json. Не рекомендуется использовать блокнот Windows, т.к. он не верно отображает содержимое и может повредить кодировку файла. Используйте альтернативные редакторы, такие как Notepad++.
   б. Скопируйте уникальный код в параметр api_key, а ключ в параметр salt.

   {
     "url_client": "https://api-client.mango-office.ru/api",
     "url_server": "https://app.mango-office.ru/vpbx",
     "api_key": "jd1uilpo7zxau6v82ruhbw8ge84dx0t7",
     "salt": "4lrdw7rtwfugcge4xzcyla4q8ytwpdtj",
     "mq": {
       "host": "127.0.0.1",
       "port": "4222"
     },
     "http": {
       "port": "8000",
       "limit": 20
     },
     "database": {
       "path": "%ProgramData%/MIKO LLC/Nightbird Server/mango/history.db"
     },
     "work_dir": "%ProgramData%/MIKO LLC/Nightbird Server/mango",
       "log_level": 4,
       "log_path": "%ProgramData%/MIKO LLC/Nightbird Server/mango/logs"
   }

   
   в. Сохраните изменения в файле. Важно: сохраняйте кодировку файла UTF-8 без BOM.

4. Вернитесь к личному кабинету и настройте доступ по IP адресу. Оставьте свободный доступ с любого адреса. Позже Вы сможете изменить эту настройку, когда будете уверены, что компоненты системы работают нормально.
5. Установите флажок «Предоставлять возможность генерации и использования ссылок».

Веб-сервис 1С обеспечит доступ к телефонной книге Вашей информационной базы. Если база 1С еще не опубликована на веб-сервисе, то это нужно сделать по инструкции.

1. Откройте файл настроек подключения к 1С c:\ProgramData\MIKO LLC\Nightbird Server\crm\config.json (Не рекомендуется использовать блокнот Windows).
2. В разделе wsdl в параметре host укажите адрес веб-сервера, на котором опубликована информационная база. Укажите порт в параметре port (по умолчанию порт 80).
3. В параметре login укажите имя служебного пользователя, от имени которого будет выполнятся вход в базу. В параметре password укажите его пароль.
4. Параметре url должен содержать адрес веб-сервиса вида:
   /имя_публикации/ws/miko_crm_api.1cws, где имя_публикации - имя под которым опубликована база на веб-сервере.

   {
       "mq": {
           "host": "127.0.0.1",
           "port": "4222"
       },
       "wsdl": {
           "host": "127.0.0.1",
           "port": "80",
           "login": "WebService",
           "password": "Password",
           "url": "/base1c/ws/miko_crm_api.1cws",
           "keeap-alive": 20
       },
       "cleanup_period": 600,
       "log_level": 4,
       "log_path": "%ProgramData%/MIKO LLC/Nightbird Server/crm/logs"
   }

По завершению настройки необходимо запустить службу. Если в последствии вносятся изменения в файлы настроек сервера интеграции (такие как файл config.json), то службу необходимо останавливать и запускать повторно.

После запуска службы будут заняты порты: 4222, 8000, 8222.

1. Откройте Пуск и найдите Nightbird сервер.
2. Запустите сервер Nightbird.