Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Описание

Операция GetHistoryOfServiceCalls выдает Выдает историю звонков по линиям поддержки за период. Позволяет получить звонки не только по своим клиентам и специалистам, но и по сторонним, подключившим линию поддержки партнера (вендорная схема). При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 7 календарных дней.


Page Properties


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



Запрос

Info

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


ПараметрТипNULLОписание
PeriodFromДатаВремя
Позволяет отбирать звонки, которые начались после этого момента времени.
PeriodToДатаВремя
Позволяет отбирать звонки, которые начались до этой даты. При указании этого параметра значение указывать обязательно. 
ClientIDUUID4.1.2.4. ClientID
Уникальный идентификатор организации, сотрудник которой получал поддержку по линии. Значение параметра берется из функции Чтение Получение списка организаций-клиентов. При указании этого параметра значение указывать обязательно. 
ServiceUserIDUUID4.1.2.5. AccountID
Уникальный идентификатор аккаунта 1С-Коннект, получающего поддержку по линии. При указании этого параметра значение указывать обязательно. 
ServiceIDUUID4.1.2.9. ServiceID
Уникальный идентификатор линии, по которой осуществлялись звонки. При указании этого параметра значение указывать обязательно. 
SpecialistIDUUID4.1.2.5. AccountID
Уникальный идентификатор сотрудника, оказывающего поддержку по линии. При указании этого параметра значение указывать обязательно. 
CallResultЧисло

Отбор по результату звонка:

  • 1 - успешные,
  • 2 - неуспешные не успешные (все остальные).


Code Block
languagexml
titleПример
<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:GetHistoryOfServiceCalls>
         <par:Params>
              <Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodFrom">
             <Value xsi:type="xs:dateTime">2019-09-21T01:00:00</Value>
                  </Property>
     	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodTo">
             <Value xsi:type="xs:dateTime">2019-09-27T01:00:00</Value>
           </Property>
        	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="ClientID">
             <Value xsi:type="xs:string">90028e2b-2003-11e7-80e6-0025904f970f</Value>
           </Property>      	
      	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="ServiceUserID">
             <Value xsi:type="xs:string">0e0a9b78-ee6b-4f6c-2003-ca248f7f9baf</Value>
           </Property>
       	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="ServiceID">
             <Value xsi:type="xs:string">fbe839ae-2003-2003-80e6-0025904f970f</Value>
           </Property>                                           
        	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="SpecialistID">
             <Value xsi:type="xs:string">79d4067b-6f12-451a-8efb-2003d6a61c1e</Value>
           </Property> 
         	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="CallResult">
             <Value xsi:type="xs:decimal">1</Value>
           </Property>           
         </par:Params>
      </par:GetHistoryOfServiceCalls>
   </soap:Body>
</soap:Envelope>


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

ПараметрТипОписание
CallIDUUIDУникальный идентификатор звонка
ClientIDUUID4.1.2.4. ClientIDУникальный идентификатор организации, сотрудник которого получал поддержку по линии
ServiceUserIDUUID4.1.2.5. AccountIDУникальный идентификатор аккаунта 1С-Коннект, подключенного к линии поддержки (с которым происходило голосовое общение)
ServiceIDUUID4.1.2.9. ServiceIDУникальный идентификатор линии, по которой осуществлялись звонки
CallTimeДатаВремяВремя ответа на звонок
CallerIDUUID4.1.2.5. AccountIDИдентификатор звонящего
CalleeIDUUID4.1.2.5. AccountIDИдентификатор ответчика
CallResultЧисло

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

  • 1 - успешный звонок,
  • 2 - не успешный звонок
DurationЧислоДлительность разговора в секундах.


Code Block
languagexml
titleПример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfServiceCallsResponse 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>CallID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>40</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ClientID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceUserID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallTime</Name>
                     <ValueType>
                        <Type>xs:dateTime</Type>
                        <DateQualifiers>
                           <DateFractions>DateTime</DateFractions>
                        </DateQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CallerID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>CalleeID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </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">5f99f58f-2003-4e1c-a049-2cf58efc68a1</Value>
                     <Value xsi:type="xs:string">90028e2b-ff47-11e7-2003-0025904f970f</Value>
                     <Value xsi:type="xs:string">0e0a9b78-ee6b-2003-bd33-ca248f7f2003</Value>
                     <Value xsi:type="xs:string">fbe839ae-07ec-11e8-2003-0025904f970f</Value>
                     <Value xsi:type="xs:dateTime">2019-09-26T18:29:37</Value>
                     <Value xsi:type="xs:string">79d4067b-6f12-451a-8efb-2003d6a61c1e</Value>
                     <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:decimal">1</Value>
                     <Value xsi:type="xs:decimal">13</Value>
                  </row>
                  <row>
                     <Value xsi:type="xs:string">a42bea6c-013b-2003-903f-322a42716719</Value>
                     <Value xsi:type="xs:string">90028e2b-ff47-11e7-2003-0025904f970f</Value>
                     <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">fbe82003-07ec-11e8-80e6-0025904f970f</Value>
                     <Value xsi:type="xs:dateTime">2019-09-26T18:31:04</Value>
                     <Value xsi:type="xs:string">0e0a9b78-ee6b-2003-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">79d4067b-6f12-451a-8efb-2003d6a61c1e</Value>
                     <Value xsi:type="xs:decimal">1</Value>
                     <Value xsi:type="xs:decimal">24</Value>
                  </row>
               </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfServiceCallsResponse>
   </soap:Body>
</soap:Envelope>