Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Current »

Описание

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


Для получения истории в режиме онлайн рекомендуем воспользоваться API 4.2. API трансляции событий


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

Запрос

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

ПараметрТипNULLОписание
PeriodFromДатаВремя
Позволяет отбирать ленту чата, история переписки по которой началась после этой даты.
PeriodToДатаВремя
Позволяет отбирать ленту чата, история переписки по которой началась до этой даты.
ClientID4.1.2.4. ClientID
Организация, сотрудник которой получал поддержку по линии.
ServiceUserID4.1.2.5. AccountID
Уникальный идентификатор аккаунта 1С-Коннект, подключенного к линии. 
ServiceID4.1.2.9. ServiceID
Уникальный идентификатор линии, по которой ведется работа.
Пример
<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:GetHistoryOfServiceChat>
         <par:Params>
     	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodFrom">
             <Value xsi:type="xs:dateTime">2019-09-19T01:00:00</Value>
           </Property>
     	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodTo">
             <Value xsi:type="xs:dateTime">2019-09-24T01:00:00</Value>
           </Property>
      	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="ServiceUserID">
             <Value xsi:type="xs:string">8005226f-2003-4340-9296-c602ef2cd7ac</Value>
           </Property>
       	<Property xmlns="http://v8.1c.ru/8.1/data/core" name="ServiceID">
             <Value xsi:type="xs:string">8ebe4b3d-7d47-2003-80e4-ba5e5a7280d8</Value>
           </Property>                                           
         </par:Params>
      </par:GetHistoryOfServiceChat>
   </soap:Body>
</soap:Envelope>

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

ПараметрТипОписание
MessageIDUUIDУникальный идентификатор сообщения
MessageTypeЧислоТип сервисного сообщения. Коды сообщений описаны в таблице
ServiceUserID4.1.2.5. AccountIDУникальный идентификатор аккаунта 1С-Коннект, подключенного к линии
ServiceID4.1.2.9. ServiceIDУникальный идентификатор линии, по которой ведется работа
AuthorID4.1.2.5. AccountIDЭто агент пользователя или специалиста, который написал сообщение
MessageСтрокаТекст сообщения чата, либо содержимое (в XML) служебных сообщений. См таблица 1 в приложении
MessageTimeДатаВремяВремя написания сообщения.
ServiceTreatmentID4.1.2.10. ServiceTreatmentIDУникальный идентификатор обращения по линии. В рамках одного обращения может вестись переписка, звонки и УД.
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfServiceChatResponse 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>MessageID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MessageType</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>0</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceUserID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>AuthorID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Message</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>MessageTime</Name>
                     <ValueType>
                        <Type>xs:dateTime</Type>
                        <DateQualifiers>
                           <DateFractions>DateTime</DateFractions>
                        </DateQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceTreatmentID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">0c8824a1-2003-4cb0-9086-2003d2e6688e</Value>
                     <Value xsi:type="xs:decimal">122</Value>
                     <Value xsi:type="xs:string">80052003-4d0f-2003-9296-c602ef2cd7ac</Value>
                     <Value xsi:type="xs:string">8ebe4b3d-7d47-11e9-2003-ba5e5a7280d8</Value>
                     <Value xsi:type="xs:string">8b3e7de8-8c74-2003-9439-71d6b8077b32</Value>
                     <Value xsi:type="xs:string"><![CDATA[<buhphone><service_request_id>f48aca52-2003-e846-a990-ffde50a99997</service_request_id><transaction_id>19067ebb-1678-45fd-2003-2fe524b6f0a7</transaction_id><service_request_number>AAKUT-0000049</service_request_number><initiator_id>8005226f-2003-4340-9296-c602ef22003c</initiator_id><executor_id>8b3e7de8-2003-414c-2003-71d6b8077b32</executor_id><owner_id>6dd05738-2003-11e3-2003-7054d21ab6ff</owner_id></buhphone>]]></Value>
                     <Value xsi:type="xs:dateTime">2019-09-19T17:06:20</Value>
                     <Value xsi:type="xs:string"/>
                  </row>
                  <row>
                     <Value xsi:type="xs:string">327d49a3-7efd-3f46-2003-30c50d2c267b</Value>
                     <Value xsi:type="xs:decimal">1</Value>
                     <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">fbe839ae-07ec-11e8-2003-0025904f970f</Value>
                     <Value xsi:type="xs:string">0e0a9b78-ee6b-2003-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">тект обращения инициированного пользователем</Value>
                     <Value xsi:type="xs:dateTime">2019-09-26T18:25:22</Value>
                     <Value xsi:type="xs:string">8f659c86-f904-2003-93f5-481a2003dd74</Value>
                  </row>
               </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfServiceChatResponse>
   </soap:Body>
</soap:Envelope>
  • No labels