00. Документация по настройкам и возможностям Okdesk
00. Как обратиться к тех. поддержку?
01. С чего начать?
1. Введение в Okdesk
1. Какие задачи можно решать с Okdesk?
2. Учет и выполнение поступающих клиентских заявок
3. Платные заявки и планово-профилактические регламентные работы
4. Создание документов по шаблонам
5. Модуль CRM: ведем справочники всех клиентов и договоров в едином месте
6. Объекты обслуживания и оборудование: инвентаризация обслуживаемой инфраструктуры
7. Работа "в полях": мобильное рабочее место инженера и отображение заявок на карте
8. Планирование загрузки сотрудников: календарь
9. Ещё больше возможностей Okdesk!
2. Быстрый старт
Шаг 1. Регистрация новой заявки
Шаг 2: Заполняем базу клиентов
Шаг 3: Подключаем к работе коллег
Шаг 4: Настраиваем обработку писем от клиентов
Шаг 5: Настраиваем оповещения по заявкам
Шаг 6: Автоматическое назначение ответственных (маршрутизация)
Шаг 7. Ознакомьтесь с расширенными возможностями списка заявок (видео)
02. Заявки и регламентные работы
1. Бизнес-процессы обработки заявок
1. Начало работы с бизнес-процессами
1. Стандартный бизнес-процесс в Okdesk
2. Как бизнес-процессы помогают организовать обработку заявок
3. Как описать процесс обработки заявок до настройки в Okdesk
2. Подготовка элементов бизнес-процесса
1. Типы заявок
1. Что такое типы заявок
2. Как настроить типы заявок
2. Статусы заявок
1. Что такое статусы заявок
2. Как настроить статусы заявок
4. Дополнительные атрибуты заявок
1. Что такое дополнительный атрибут заявки
2. Как настроить дополнительный атрибут заявки
5. Приоритеты заявок
1. Что такое приоритет заявки
2. Как настроить приоритет заявки
6. Графики обслуживания
1. Что такое график обслуживания
2. Как настроить график обслуживания
3. Настройка бизнес-процесса
1. Как создать бизнес-процесс
2. Как добавить статусы, переходы и кнопки переходов
3. Как использовать атрибуты в бизнес-процессе
4. Как настроить маршрутизацию заявок
5. Как настроить нормативы обработки заявки (SLA)
4. Дополнительные элементы бизнес-процессов
1. Чек-листы
2. Права доступа
3. Оценка качества выполнения заявок
4. Запрет на совершение действий, если сотрудник не на объекте
2. Email-переписка по заявкам
1. Сквозная аутентификация в Okdesk по ссылкам из Email-уведомлений
2. Кто получает email-уведомления по заявке?
3. Реквизиты отправителя, внешний вид и содержание писем
4. Переписка по заявкам: настройка подключения к почтовому серверу
5. Алгоритм обработки входящих писем
6. Зацикливание переписки и попадание в СПАМ: как с этим бороться?
7. "Черные списки" на отправку и на прием почты
Основные поля в карточке заявки
Повторяющиеся заявки
Спецификация работ и материалов в заявке
Тиражирование однотипных заявок (массовое создание заявок)
Трудозатраты на выполнение заявок
03. Клиенты, сервисные договоры и инфраструктура
1. Карточки компаний
2. Контактные лица клиентов
3. Клиентский портал и клиентское приложение для подачи заявок
4. Объекты обслуживания и оборудование
5. Интерактивный план
6. Договоры и сервисные периоды
04. Обслуживание оборудования
Планы ТО
Как настроить плановое ТО
01. Типы, производители и модели оборудования
2. Карточка оборудования
3. Регламентное обслуживание оборудования
4. Список оборудования
5. Использование QR-кодов и NFC-меток для обслуживания оборудования и инфраструктуры
6. Публичные QR-метки для оборудования. Подача заявок без регистрации и мобильного приложения.
05. Склад запчастей, расходных материалов, оборудования и инструментов
1. Номенклатура запчастей и расходных материалов
2. Список складов и остатков
3. Оприходование, перемещение и списание запчастей и расходных материалов
4. Списание запчастей и расходных материалов в заявке
5. Складской учет оборудования и инструментов
6. Движение оборудование со склада и на склад в рамках заявки
06. Сотрудники и группы
1. Добавление и деактивация сотрудников
2. Группы сотрудников
3. Роли и права доступа
4. Просмотр маршрута сотрудников за день
5. Двухфакторная аутентификация сотрудников
07. Отчеты и аналитика
Встроенные отчеты и аналитика
Готовые отчеты в Microsoft Power BI
Готовые отчеты и коннектор к Яндекс DataLens
08. Дополнительные возможности
1. Печатные формы
2. Подпись клиента на экране смартфона
3. Обмен заявками с партнером
4. Автоматические программируемые сценарии
Список контекстных переменных
09. Интеграции Okdesk с другими системами
Интеграции с АТС (телефония)
1. Интеграция с АТС через сервис "Простые Звонки"
2. Интеграция с АТС через REST API
Интеграция с Wialon
1. Загрузка данных по объектам (ТС) и датчикам из Wialon
2. Аутентификация в клиентском портале из интерфейса Wialon
01. Интеграция с платформой Albato
02. Интеграция с МАХ
03. Telegram-бот для клиентов
04. Интеграция с Navixy
05. Интеграция с ГЛОНАССсофт
06. Интеграция с мониторингом Streletz-Cloud (АРГУС-СПЕКТР)
07. Интеграция с охранной системой Bolid
08. Интеграция с PRO32Connect (ex. GetScreen)
09. Интеграция с центром охраны C.Nord
10. Интеграция с MS Active Directory
11. SMS-оповещения (Интеграция с SMS-шлюзами)
11. Интеграция с Camkeeper
13. Интеграция с Axenta
14. Интеграция с Omnicomm Online
15. Настройка единого входа (SSO) в Okdesk через SAML
10. REST API & SQL API
REST API
SQL API
Вебхуки
Онлайн-школа Okdesk
Курс 1. Знакомство с Okdesk
Урок 1. Okdesk: интерфейс и возможности
Урок 2. Как создать заявку в Okdesk
Урок 3. Как добавить сотрудников и объединить их в группы
Урок 4. Как работать в мобильном приложении инженера
Урок 5. Как добавить заявителей в Okdesk
Урок 6. Как организовать переписку с заявителями по e-mail
Урок 7. Как подключить Telegram-бот для заявителей
Урок 8. Клиентский портал и мобильное приложение для заявтелей
Курс 2. Список заявок. Настройка под себя.
Урок 1. Как работать со списком заявок и настраивать его под свои задачи
Урок 2. Как разобраться в устройстве списка заявок и настроить столбцы
Урок 3. Как определять состояние заявки прямо из списка
Урок 4. Как выполнять действия с заявкой прямо из списка
Урок 5. Как применять фильтры для отбора нужных заявок
Урок 6. Как организовать работу со списком с помощью вкладок
Урок 7. Как выгрузить список заявок при необходимости
Урок 8. Как использовать уведомления, поиск и сортировку для ежедневной работы
Урок 9. Скринкаст
Курс 3. Работа в мобильном приложении инженера
Урок 1. Как мобильное приложение Okdesk помогает выполнять заявки на выезде
Урок 2. Как работать со списком заявок
Урок 3. Как создать заявку в мобильном приложении
Урок 4. Как работать с заявкой в мобильном приложении
Урок 5. Как работать с оборудованием
Урок 6. Как работать с заявителями, адресами и выездами
Урок 7. Как работать в мобильном приложении без интернета
Урок 8. Как использовать дополнительные возможности мобильного приложения
Урок 9. Скринкаст
Курс 4. Работа с базой знаний
Урок 1. Что такое база знаний и зачем она нужна
Урок 2. Как создать структуру разделов
Урок 3. Как создать и оформить статью
Урок 4. Как настроить права доступа
Урок 5. Как создать приватный раздел для заявителя
Урок 6. Как использовать базу знаний при работе с заявками
Урок 7. Как поддерживать базу знаний в актуальном состоянии
Урок 8. Скринкаст: как работать с Базой знаний
Курс 5. Разделение контуров видимости заявок
Урок 1. Как разделить заявки между отделами
Урок 2. Как разделить заявки между сотрудниками по заявителям
Урок 3. Как добавить подрядчика на платформу и ограничить доступ
Ответы на типовые вопросы
Выявление причин неработоспособности Okdesk
Импорт с помощью REST API
Интерфейс для интеграции с системами построения отчетов и аналитики (BI), SQL API
Информация по ошибке при проблеме с телефонией
Как редактировать текст и внешний вид email-оповещений
Как скачать файл из заявки с помощью API?
Как удалить доп. атрибут
Клиенту не пришло email-оповещение о добавлении комментария
Надо ли отображать клиентам трудозатраты?
Настройка Oauth2 для обработки почты с сервисов Gmail
Настройка Oauth2 для обработки почты с сервисов Microsoft
Не приходят sms-оповещения
Не работает интеграция с телефонией
Обработки для 1С
Отправка писем от публичных адресов (@mail.ru, @gmail.com и т.д.)
Ошибки при выполнении API-запросов
Ошибки при проверке подключения к почтовому серверу
Ошибки при проверке подключения к почтовому серверу SMTP
Парковка домена
Письма от Okdesk попадают в Spam
Подключение отчетов Okdesk в Yandex DataLens
Проблемы с кодировкой в скаченных файлах
Проверка корректности API-запросов
Работа глобального поиска
Разделение доп. атрибутов по столбцам в MS Power BI
Скачивание писем при подключении по IMAP
Советы по решению проблемы с добавлением файлов на телефонах Huawei/Honor
Советы по решению проблемы с добавлением файлов на телефонах Realme
Советы по решению проблемы с добавлением файлов на телефонах Samsung
Советы по решению проблемы с добавлением файлов на телефонах Xiaomi
Стилизация печатных форм
Требования к логотипу
Чем отличаются статусы "Решена" и "Закрыта"
Что такое "автоматические правила"?
Шаблоны для импорта
Шаблоны отчетов для MS Power BI
Содержание статьи
Файлы (0)

Импорт с помощью REST API

Массовую загрузку данных в систему можно провести самостоятельно с помощью нашего API -- https://okdesk.ru/apidoc#!oborudovanie-sozdanie-oborudovaniya в связке с Goggle Apps Script https://developers.google.com/apps-script и Google таблицами https://www.google.ru/intl/ru/sheets/about/

Разберем на пример GET запроса по массовому поиску компаний, в нашем случае получению id компаний по их наименованию с примерами кодов

https://okdesk.ru/apidoc#!kompanii-poisk-kompanii

Создаем Google таблицу с полями, куда указываем название компании и полем, куда будет выводится id компании при нахождении по наименованию

Предварительно в Goggle Apps Script создаем панель для запуска наших проверок

function onOpen() {

  var ui = SpreadsheetApp.getUi();

  ui.createMenu('OkDesk')
    .addItem('Copy Data', 'copyData')
    .addItem('Check Company', 'checkCompanyAndPrepareData')
    .addItem('Create Company', 'createCompanyFromData')
    .addToUi();
}

 

В итоге получаем меню из которого проводим массовый запуск запросов по данным, которые находятся в таблице

 

 

Для запуска Check Company предварительно создаем fetchCompanyData_(companyName), где указываем наш get запрос

function fetchCompanyData_(companyName){  

  var url =  “https://<account>.okdesk.ru/api/v1/companies/?api_token=3e9a214215f493c4&name=" + encodeURIComponent (companyName); //--- Запрос API

  var response = UrlFetchApp.fetch(url, {'muteHttpExceptions': true});
  var json = response.getContentText();
  var companyData = JSON.parse(json);

  return companyData;
}

 

Далее создаем function checkCompanyAndPrepareData() где указываем номера столбцов

COMPANY_NAME_COLUMN (столбец с названием компании) и COMPANY_ID_COLUMN (Столбец с получаемым id компании) из Google таблицы

function checkCompanyAndPrepareData(){

    var COMPANY_NAME_COLUMN = 0; //------ номера столбцов в таблице, начиная с 0
    var COMPANY_ID_COLUMN = 9;

    // Get the information in the active sheet. The data
    // is placed into a 2D array.

    var dataRange = SpreadsheetApp.getActiveSpreadsheet().getDataRange();
    var companyValues = dataRange.getValues();

    for(var row = 1; row < 2; row++){   //-------------- номера строк в таблице, по которым проводится загрузка

        var companyName = companyValues[row][COMPANY_NAME_COLUMN]; 
        if(companyName != ""){

            var companyData = fetchCompanyData_(companyName);
            if ((companyData != "[]") && (companyData != null)) {
                if(companyData.id){
                    companyValues[row][COMPANY_ID_COLUMN] = companyData.id;
                    continue;
                }
            }
            companyValues[row][COMPANY_ID_COLUMN] = "Не найдено"; //--- вывод информации если по заданным параметрам ничего не найдено
        }
    }
}

 

Перед запуском указываем номера строк Google таблицы, которые передаем в запросе for(var row = 1; row < 2; row++)

По результату запуска получаем массовый список id компаний по их наименованию

 

Массовое создание компаний на примере POST запроса с примерами кодов

https://okdesk.ru/apidoc#!kompanii-sozdanie-kompanii

Создаем Google таблицу с полями, куда указываем названия параметров, по которым необходимо создать компанию

 

Для запуска Create Company создаем function createCompanyFromData()

Пример кода, в котором указаны блоки полей, где указаны столбцы таблицы, из которых заполняются данные, сам api запрос и тело запроса var data:

function createCompanyFromData(){  

    var COMPANY_NAME_COLUMN = 0; //------ номера столбцов в таблице, начиная с 0
    var COMPANY_ADD_NAME_COLUMN = 1;
    var COMPANY_SITE_COLUMN = 2;
    var COMPANY_EMAIL_COLUMN = 3;
    var COMPANY_PHONE_COLUMN = 4;
    var COMPANY_COMMENT_COLUMN = 5;
    var COMPANY_CUST_ATTR1_COLUMN = 6;
    var COMPANY_CUST_ATTR2_COLUMN = 7;
    var COMPANY_Coordinates_1_COLUMN = 8;
    var COMPANY_Coordinates_2_COLUMN = 9;
    var COMPANY_CUST_ATTR3_COLUMN = 10;
    var COMPANY_ADRESS_COLUMN = 11; 

    var COMPANY_NEW_ID_COLUMN = 13;
    var COMPANY_NEW_NAME_ID_COLUMN = 14;
    var CREATE_COMPANY_RESPONSE_COLUMN = 15; 

    var dataRange = SpreadsheetApp.getActiveSpreadsheet().getDataRange();
    var companyValues = dataRange.getValues();

    for(var row = 1; row < 2; row++){ //-------------- номера строк в таблице, по которым проводится загрузка
        var companyName = companyValues[row][COMPANY_NAME_COLUMN]; //---- запись столбцов в переменные
        var companyAddName = companyValues[row][COMPANY_ADD_NAME_COLUMN];
        var companySite = companyValues[row][COMPANY_SITE_COLUMN];
        var companyPhone = companyValues[row][COMPANY_PHONE_COLUMN];
        var companyEmail = companyValues[row][COMPANY_EMAIL_COLUMN];
        var companyComment = companyValues[row][COMPANY_COMMENT_COLUMN];
        var companyCustAttr1 = companyValues[row][COMPANY_CUST_ATTR1_COLUMN];
        var companyCustAttr2 = companyValues[row][COMPANY_CUST_ATTR2_COLUMN];
        var companyCustAttr3 = companyValues[row][COMPANY_CUST_ATTR3_COLUMN];
        var companyCoordinates_1 = companyValues[row][COMPANY_Coordinates_1_COLUMN];
        var companyCoordinates_2 = companyValues[row][COMPANY_Coordinates_2_COLUMN];
        var companyAddress = companyValues[row][COMPANY_ADRESS_COLUMN];

        var url = "https://<account>.okdesk.ru/api/v1/companies/?api_token=3e9a214215f493c4 "; //—- api запрос
        var data = { //-----тело запроса с подстановкой переменных столбцов

            "company": {
                "name": companyName.toString(), 
                "additional_name": companyAddName.toString(),
                "site": companySite.toString(),
                "email": companyEmail,
                "phone": companyPhone.toString(), 

                "coordinates": [companyCoordinates_1,companyCoordinates_2],

                "address": companyAddress,
                "comment": companyComment,
                "custom_parameters": {
                    "custom_parameters_code1": companyCustAttr1.toString(),
                    "custom_parameters_code2": companyCustAttr2.toString(),
                    "custom_parameters_code3": companyCustAttr3.toString()
                }, 
            },
        }; 

        var options = {
            'muteHttpExceptions': true,
            'method' : 'post',
            'contentType': 'application/json',
            'payload' : JSON.stringify(data)
        };

        var response = UrlFetchApp.fetch(url, options);
        var json = response.getContentText();
        var companyData = JSON.parse(json);

        Utilities.sleep(400);    

        if(companyName != ""){
            if ((companyData != "[]") && (companyData != null)) { 
                if(companyData.id){
                    companyValues[row][COMPANY_NEW_ID_COLUMN] = companyData.id;
                    companyValues[row][COMPANY_NEW_NAME_ID_COLUMN] = companyData.name;
                    continue;
                }
            }
            companyValues[row][COMPANY_NEW_ID_COLUMN] = "Не создан"; //---вывод информации если по заданным параметрам ничего не найдено 
            companyValues[row][CREATE_COMPANY_RESPONSE_COLUMN] = json;
        }
    }    
    dataRange.setValues(companyValues);
}


По итогу успешной загрузки в поле Response получаем лог с ответом по заполненным данным 

Таким образом по аналогии можно проводить загрузку других сущностей в Okdesk таких как объекты, оборудование, контактных лиц.

ВАЖНО. Приведенные выше блоки кодов указаны для примера. Рекомендуем проводить массовый импорт данных с привлечением IT специалистов со своей стороны для написания своих скриптов.

Загрузка данных...