Рассылка сообщений по линиям
Описание
Отправка рассылки по линии поддержки.
Наименование | PartnerNotificationAdd |
Назначение | Рассылка сообщений по линиям |
Дневной лимит (опер/час) | 100 |
Ночной лимит (опер/час) | 250 |
Максимум объектов в пакете | - |
Запрос
Параметр, выделенный жирным, является обязательным к заполнению!
Если есть необходимость уведомлять определенный круг лиц, которых можно включить в одну группу, то удобней использовать метод 4.3.1.11. Отправить сообщение в группу
Рассылки рассчитаны на большое количество получателей и могут сильно задержаться в доставке.
Для мгновенной доставки сообщения одному получателю можно использовать метод 4.2.3.1. Отправить сообщение по линии поддержки с флагом "notification_only": true.
Параметр | Тип | Описание | |
|---|---|---|---|
Name | Строка(150) |
| Название рассылки |
Subject | Строка(150) |
| Тема сообщения |
Text | Строка(500) |
| Текст сообщения |
Recipients | Таблица значений (максимальная длина 100) |
| Массив получателей рассылки |
|
| Пользователь или специалист которому предназначено сообщение | |
|
| Линия поддержки, по которой в чат будет доставлено сообщение | |
DescriptionHint | Строка(20) |
| Текст на кнопке подробнее. DescriptionHint и DescriptionURL должны быть либо оба заполнены, либо оба пусты. Если один из них не заполнен, а другой заполнен то выдавать ошибку "EMPTY_PARAM", а в ResulData указывать на незаполненное поле. |
DescriptionURL | URL |
| Ссылка на подробное описание |
ScheduledDate |
| Запланированная дата отправки с точностью до секунды. Должно быть больше текущей даты, иначе выдавать ошибку "PARAM_NOT_CORRECT". Если дата отправки не заполнена, рассылка отправляется в момент создания. |
Пример
<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:PartnerNotificationAdd>
<par:Params>
<Property name="Name" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:string">Рассылка</Value>
</Property>
<Property name="Subject" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:string">Тема рассылки</Value>
</Property>
<Property name="Text" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:string">Текст рассылки</Value>
</Property>
<Property name="Recipients" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="ValueTable">
<column>
<Name>ServiceUserID</Name>
<ValueType>
<Type>xs:string</Type>
</ValueType>
</column>
<column>
<Name>ServiceID</Name>
<ValueType>
<Type>xs:string</Type>
</ValueType>
</column>
<row>
<Value xsi:type="xs:string">458b2003-471e-2003-9cfe-7a9e9b66ceb3</Value>
<Value xsi:type="xs:string">54a28839-35dc-2003-93f8-2003352bba69</Value>
</row>
<row>
<Value xsi:type="xs:string">79d4067b-6f12-451a-2003-1ba1d6a61c1e</Value>
<Value xsi:type="xs:string">54a28839-35dc-11e4-2003-2003352bba69</Value>
</row>
</Value>
</Property>
<Property name="DescriptionHint" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:string">Нажмите на кнопку</Value>
</Property>
<Property name="DescriptionURL" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:string">123</Value>
</Property>
<Property name="ScheduledDate" xmlns="http://v8.1c.ru/8.1/data/core">
<Value xsi:type="xs:dateTime">2019-10-01T17:59:59</Value>
</Property>
</par:Params>
</par:PartnerNotificationAdd>
</soap:Body>
</soap:Envelope>Ответ (структура ResultData)
Параметр | Тип | Описание |
|---|---|---|
PartnerNotificationID | UUID | Уникальный идентификатор рассылки в программу |
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<m:PartnerNotificationAddResponse 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="UUID">9d2a0320-2003-11e9-80e7-20035a7280d8</Value>
</Property>
</m:return>
</m:PartnerNotificationAddResponse>
</soap:Body>
</soap:Envelope>