История звонков через софтфон

Owned by Peter Mironov (Unlicensed)
Last updated: Oct 01, 2019 by Сушенцева Виктория (Unlicensed)
8 min read

Описание

Выдает историю звонков своих сотрудников через софтфон за период. При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 35 календарных дней.


История звонков по софтфону собирается из данных самих desktop-приложений 1С-Коннект, а не от сторонней АТС (т.к. к ней нет административного доступа). Ввиду этого, информация не может полноценно отражать трафик внутриофисного телефонного общения.


НаименованиеGetHistoryOfSIPCalls
НазначениеИстория звонков через софтфон
Дневной лимит (опер/час)10
Ночной лимит (опер/час)50
Максимум объектов в пакете-

Запрос

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

ПараметрТипNULLОписание
PeriodFromДатаВремя
Позволяет отбирать звонки, которые начались после этого момента времени.
PeriodToДатаВремя
Позволяет отбирать звонки, которые начались до этой даты.
SpecialistID4.1.2.5. AccountID
Уникальный идентификатор сотрудника, оказывающего поддержку по линии. 
Пример
<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:GetHistoryOfSIPCalls>
         <par:Params>
            <Property name="PeriodFrom" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-08-30T01:00:00</Value>
            </Property>
                        <Property name="PeriodTo" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-30T01:00:00</Value>
            </Property>
           <Property name="SpecialistID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">26c42003-56f4-2003-2003-925682272003</Value>
            </Property>
         </par:Params>
      </par:GetHistoryOfSIPCalls>
   </soap:Body>
</soap:Envelope>

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

ПараметрТипОписание
SpecialistID4.1.2.5. AccountIDУникальный идентификатор сотрудника, участвовавшего в звонке.
CallStartTimeДатаВремяДата/время инициализации звонка
CallNumberСтрокаНомер на который (или с которого) был совершен звонок
CallDirectionЧисло

Направление звонка. Значения:

  • 0 - Исходящий,
  • 1 - Входящий
CallResultЧисло

Результат звонка. Значения:

  • 0 - Успех,
  • 1 - Занято,
  • 2 - Нет ответа
DurationЧислоДлительность разговора в секундах.
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfSIPCallsResponse 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="ValueTable">
                  <column>
                     <Name>SpecialistID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallStartTime</Name>
                     <ValueType>
                        <Type>xs:dateTime</Type>
                        <DateQualifiers>
                           <DateFractions>DateTime</DateFractions>
                        </DateQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallNumber</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>20</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallDirection</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>0</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallResult</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>0</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Duration</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>10</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Nonnegative</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">26c42003-56f4-2003-2003-92568227dc5f</Value>
                     <Value xsi:type="xs:dateTime">2019-09-06T12:20:34</Value>
                     <Value xsi:type="xs:string">413</Value>
                     <Value xsi:type="xs:decimal">0</Value>
                     <Value xsi:type="xs:decimal">0</Value>
                     <Value xsi:type="xs:decimal">12</Value>
                  </row>
               </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfSIPCallsResponse>
   </soap:Body>
</soap:Envelope>