Добавление собственной линии

Owned by Баданов Владимир (Unlicensed)
Last updated: Sept 24, 2019 by Сушенцева Виктория (Unlicensed)
9 min read

Описание

Добавляет новую линию поддержки.


НаименованиеServiceLineKindAdd
НазначениеСоздание линии поддержки
Дневной лимит (опер/час)250
Ночной лимит (опер/час)1250
Максимум объектов в пакете-

Запрос

Параметр, выделенный жирным, является обязательным к заполнению!

ПараметрТипNULLОписание
NameСтрока(50)
Наименование линии поддержки. 
DisplayedNameСтрока(100)+Отображаемое в агенте название. 
DislpayedHintСтрока(100)+Всплывающая подсказка. 
DescriptionLinkСтрока(300)+Ссылка на описание. 
EMailForNotificationsE-Mail_один
E-Mail для уведомления по линии поддержки. Возможно несколько значений, перечисленных через «,» или «;». 
NotifyBeforeExpiresБулево
Уведомлять об истечении поддержки по линии.
NotifyAtDaysBeforeExpiresЧисло+Количество дней до напоминания о прекращении поддержки по линии.По умолчанию 10 дней.
ServiceUsersAudienСтрока
Доступность услуги. Значения:
  • ALL = всем
  • FORSPECIALISTS = своим сотрудникам
OfferServiceForClientsБулево
Рекламировать линиюв программе клиента. 
OfferServiceForSpecialistsБулево
Рекламировать линиюв программе специалиста. 
AutoConnectServiceForClientsБулево
Автоматически подключать линию клиенту при создании. 
AutoConnectServiceForSpecialistsБулево
Автоматически подключать линию специалисту при создании. 
AutoAcceptRequestForConnectServiceБулево
Автоматически принимать заявку на подключение линии поддержки. 
CloseTreatmentAfterInactivityForSeveralDaysЧисло+Завершать обращение при отсутствии активности более указанного числа дней. Если 0, то автозавершение отключено. Максимум 90 дней.
MaxQueueTimeBySLAЧисло+Нормативное время ожидания в очереди. В минутах. Максимум 99999. Доступно для редактирования только для своих линий.
MaxSpecialistReactionTimeBySLAЧисло+Нормативное время реакции специалиста. В минутах. Максимум 99999. Доступно для редактирования только для своих линий.
MaxTreatmentTimeBySLAЧисло+Нормативное время работы с обращением. В минутах. Максимум 99 999. Доступно для редактирования только для своих линий.
NotifyOfNoAppointedSpecБулево
Отправлять уведомление если обращение поставлено в очередь(отсутствуют свободные специалисты). Доступно для редактирования только для своих линий
NotifyOfCriticalQueueLengthReachedБулево
Отправлять уведомление если длина очереди достигла лимита. Доступно для редактирования только для своих линий
CriticalQueueLengthЧисло
Количество обращений, при достижении которого отправляется уведомление о превышении длины очереди. Доступно для редактирования только для своих линий.
ScheduleOfServiceAvailabilityEnabledБулево
Признак использования расписания доступности услуги. Если Ложь, то элемент "ScheduleOfServiceAvailability" пустой (или неопределенно).
ScheduleOfServiceAvailabilityСтруктура

Время доступности услуги. Все поля структуры должны быть заполнены (существовать).Расписание сохраняется вне зависимости от значения параметра «ScheduleOfServiceAvailabilityEnabled»

Значения:

  • AvailableOnMonday - <Булево> - Вид линии поддержки доступен в понедельник
  • AvailableOnTuesday - <Булево> - Вид линии поддержки доступен во вторник
  • AvailableOnWednesday - <Булево> - Вид линии поддержки доступен в среду
  • AvailableOnThursday - <Булево> - Вид линии поддержки доступен в четверг
  • AvailableOnFriday - <Булево> - Вид линии поддержки доступен в пятницу
  • AvailableOnSaturday - <Булево> -  Вид линии поддержки доступен в субботу
  • AvailableOnSunday - <Булево> -  Вид линии поддержки доступен в воскресенье
  • StartTime - <ДатаВремя> -  Время начала рабочего дня по местному времени партнера. Обязательный параметр. Можно указывать пустое значение. Время в часовом поясе головного региона партнера.
  • EndTime - <ДатаВремя> Время окончания рабочего дня по местному времени партнера. Обязательный параметр. Можно указывать пустое значение. Время в часовом поясе головного региона обслуживающей компании.
MessageDeliveryPriorityСтрока

Приоритет доставки сообщений. Значения:

  • NO_PRIORITY=без персонального приоритета
  • FIRST_TO_SPECIALIST=сервис-инженер-->клиент-менеджер-->остальные по приоритету
  • FIRST_TO_MANAGER=клиент-менеджер-->сервис-инженер-->остальные по приоритету
MaximumQualityMarkToNotifyPartnerЧисло+Уведомлять об оценках. От 1 до 5. Если уведомление отключено то 0.Значение по умолчанию 3. Доступно для редактирования только для своих линий.
ServiceQueueLimitEnabledБулево
Тумблер включения лимитов по количеству обращений на одного специалиста.
ServiceQueueLimitЧисло
Лимит обращений на одного специалиста. Возможные значения 1-99.
AutoAcceptRequestForImportБулево
Автоматически принимать заявку на импорт. 
EnableFirstLineOnImportБулево
Разрешать первую линию при импорте. Значение по умолчанию = Ложь. 
EnableSearchБулево
Разрешение поиска. Значение по умолчанию = Ложь.
SearchAreaVisibilityСтрока

Вариант поиска. Возможные значения:

  • FOR_MY_CUSTOMERS = "Только для моих клиентов и специалистов". Можно установить своей или вендорной линии поддержки. Значение по умолчанию.
  • FOR_CUSTOMERS_IN_MY_REGION= "Всемклиентамвмоемрегионе".

Можно установить только своей линии поддержки:

  • FOR_CUSTOMERS_IN_MY_TIME_ZONE = "Всемвмоемчасовомпоясе". Можно установить только своей линии поддержки
  • FOR_CUSTOMERS_IN_MY_COUNTRY ="Всемклиентамвстране". Можно установить только своей линии поддержки
Пример
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:par="http://buhphone.com/PartnerWebAPI2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:core="http://v8.1c.ru/8.1/data/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Header/>
   <soap:Body>
      <par:ServiceLineKindAdd>
         <par:Params>
            <Property name="Name" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">Линия поддержки</Value>
            </Property>
            <Property name="FullName" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">Линия поддержки клиентов с договором ИТС Проф</Value>
            </Property>
            <Property name="DisplayedName" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">Линия поддержки для клиентов 1С</Value>
            </Property>
            <Property name="DisplayedHint" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">Отображаемая подсказка для линии поддержки</Value>
            </Property>
            <Property name="DescriptionLink" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">нашсайт.рф</Value>
            </Property>
            <Property name="EMailForNotifications" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">mail@mail.com ; mail@company.ru</Value>
            </Property>
            <Property name="NotifyBeforeExpires" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">false</Value>
            </Property>
            <Property name="NotifyAtDaysBeforeExpires" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">30</Value>
            </Property>
            <Property name="ServiceUsersAudience" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">FORSPECIALISTS</Value>
            </Property>
            <Property name="OfferServiceForClients" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">1</Value>
            </Property>
            <Property name="OfferServiceForSpecialists" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">1</Value>
            </Property>
            <Property name="AutoConnectServiceForClients" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">0</Value>
            </Property>
            <Property name="AutoConnectServiceForSpecialists" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">1</Value>
            </Property>
            <Property name="AutoAcceptRequestForConnectService" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">1</Value>
            </Property>
            <Property name="CloseTreatmentAfterInactivityForSeveralDays" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">0</Value>
            </Property>
            <Property name="MaxQueueTimeBySLA" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">10000</Value>
            </Property>
            <Property name="MaxSpecialistReactionTimeBySLA" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">1000</Value>
            </Property>
            <Property name="MaxTreatmentTimeBySLA" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">3600</Value>
            </Property>
            <Property name="ScheduleOfServiceAvailabilityEnabled" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">0</Value>
            </Property>
            <Property name="ScheduleOfServiceAvailability" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="Structure">
                  <Property name="AvailableOnMonday">
                     <Value xsi:type="xs:boolean">true</Value>
                  </Property>
                  <Property name="AvailableOnTuesday">
                     <Value xsi:type="xs:boolean">true</Value>
                  </Property>
                  <Property name="AvailableOnWednesday">
                     <Value xsi:type="xs:boolean">true</Value>
                  </Property>
                  <Property name="AvailableOnThursday">
                     <Value xsi:type="xs:boolean">true</Value>
                  </Property>
                  <Property name="AvailableOnFriday">
                     <Value xsi:type="xs:boolean">true</Value>
                  </Property>
                  <Property name="AvailableOnSaturday">
                     <Value xsi:type="xs:boolean">false</Value>
                  </Property>
                  <Property name="AvailableOnSunday">
                     <Value xsi:type="xs:boolean">false</Value>
                  </Property>
                  <Property name="StartTime">
                     <Value xsi:type="xs:dateTime">0001-01-01T03:00:00</Value>
                  </Property>
                  <Property name="EndTime">
                     <Value xsi:type="xs:dateTime">0001-01-01T18:00:00</Value>
                  </Property>
               </Value>
            </Property>
            <Property name="MessageDeliveryPriority" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">NO_PRIORITY</Value>
            </Property>
            <Property name="MaximumQualityMarkToNotifyPartner" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:integer">1</Value>
            </Property>
            <Property name="AutoAcceptRequestForImport" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">false</Value>
            </Property>
            <Property name="EnableFirstLineOnImport" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">true</Value>
            </Property>
            <Property name="EnableSearch" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:boolean">true</Value>
            </Property>
            <Property name="SearchAreaVisibility" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">FOR_MY_CUSTOMERS</Value>
            </Property>
         </par:Params>
      </par:ServiceLineKindAdd>
   </soap:Body>
</soap:Envelope>

Ответ (структура ResultData)

ПараметрТипОписание
ServiceID4.1.2.9. ServiceIDИдентификатор созданного вида линии поддержки
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:ServiceLineKindAddResponse xmlns:m="http://buhphone.com/PartnerWebAPI2">
         <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
            <Property name="ResultCode" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">SUCCESS</Value>
            </Property>
            <Property name="ResultData" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="Structure">
                  <Property name="ServiceID">
                     <Value xsi:type="xs:string">aaea2003-de92-11e9-2003-30025a722003</Value>
                  </Property>
               </Value>
            </Property>
         </m:return>
      </m:ServiceLineKindAddResponse>
   </soap:Body>
</soap:Envelope>