VK

Запрос на отправку VK-сообщения

Для формирования тестового запроса с вашими параметрами Открыть генератор запросов

Пример запроса

{
   "login":"ВАШ_ЛОГИН",
   "password":"ВАШ_ПАРОЛЬ",
   "useTimeDiff":true,
   "id":"8770630",
   "scheduleInfo":{
      "timeBegin":"10:00",
      "timeEnd":"12:00",
      "weekdaysSchedule":"123"
      },
   "destAddr":"Номер_Абонента",
   "message":{
      "type":"VK",
      "data":{
      "text":"Текст сообщения",
      "serviceNumber":"НОМЕР_ОТПРАВИТЕЛЯ",
      "ttl":10
      }
   }
}

Параметры запросов

Параметр	Обязат.	Тип	Описание
login	да	string	Имя Партнера в системе.
password	да	string	Пароль Партнера в системе.
useTimeDiff	нет	boolean	Учитывание часового пояса при запуске рассылки. Подробнее Если true, то отправка сообщения осуществляется абоненту согласно расписанию рассылки и его часовому поясу. Если false, то сообщение отправляется согласно расписанию инициатора рассылки UTC+3, не обращая внимание на часовой пояс получателя сообщения. Значение по умолчанию: false.
id	нет	string	Уникальный идентификатор на стороне Партнёра. Подробнее Данный параметр используется для контроля повторных отправок и дублирования (сервис контроля включается отдельно). Партнёр может вызывать Сервис-провайдера (запрос на отправку сообщения) с одним и тем же id несколько раз. При этом: отправка сообщения абоненту будет выполнена только один раз (по первому запросу); в ответах на данные запросы Сервис-провайдер вернет Партнёру один и тот же идентификатор сообщения в системе Сервис-провайдера (тот же, что на первый запрос). Сервис-провайдер опционально возвращает Партнёру данный идентификатор при его наличии в отчёте о доставке сообщения.
shortenLinks	нет	boolean	Параметр управляет включением автоматического сокращения длинных ссылок в сообщении. Подробнее Возможные значения: true — для сокращения ссылок (значение по умолчанию); false — сокращение ссылки не требуется. Если параметр в запросе не приходит, но при этом сервис Партнёру доступен, то ссылки будут сокращаться по умолчанию. Возможность пользоваться данным сервисом предварительно оговаривается и настраивается Сервис-Провайдером. Подробнее: см. Сервис сокращения ссылок.
scheduleInfo	нет	object	Расписание рассылки. Подробнее Если не указано, отправляется сразу же, в момент получения запроса.
scheduleInfo/ timeBegin	нет	string	Время начала. Подробнее Например, 10:00.
scheduleInfo/ timeEnd	нет	string	Время окончания. Подробнее Например, 21:00.
scheduleInfo/ weekdaysSchedule	нет	string	Дни рассылки. Подробнее Задаются цифрами от 1 (понедельник) до 7 (воскресение), например, 12345. Если ограничений по дням недели нет, то данный параметр может быть пустой или не передан в запросе.
scheduleInfo/ deadline	нет	string	Дата окончания рассылки. Подробнее Например, 2019-05-10T16:29:30+0300.
destAddr	да	string	Номер телефона абонента. Подробнее Содержит код страны, код оператора и номер телефона. Для РФ код может быть 8, 7 или +7. Примеры: 72101234567, +72101234567, 8-210-123-45-67, 82101234567.
message	да	object	Параметры отправляемого сообщения.
message/type	да	enum	Тип сообщения. Подробнее Передается значение VK.
message/data	да	object	Параметры отправляемых данных.
message/data/ text	да	string	Текст отправляемого сообщения. Подробнее Количество символов: не более 2000.
message/data/ serviceNumber	да	string	Сервисное имя, от которого осуществляется отправка сообщения.
message/data/ttl	да	integer	Срок жизни сообщения. Подробнее Допустимый диапазон, сек: от 60 до 86400. Примечание При ttl = 0 или отсутствии параметра в запросе берётся значение из настроек по умолчанию, которые задаются при настройке интеграции отдельно для каждого клиента.
message/data/ ttlUnit	нет	enum	Единица измерения периода доставки сообщения. Подробнее Передается только вместе с ttl. Допустимые значения: SECONDS; MINUTES (значение по-умолчанию); HOURS.
registeredDelivery	нет	integer	Необходимость отчётов о доставке. Подробнее Возможные значения: 0 — статусы не нужны; 1 — нужны статусы (по умолчанию); 2 — нужны только статусы НЕ ДОСТАВЛЕНО.
notifyUrl	нет	string	Имя хоста входящего API для получения отчета о доставке. Подробнее При отправке параметра необходимо учитывать следующее: если парметр указан, он не может быть пустым. Длина строки notifyUrl не должна превышать 2048 символов. При невыполнении любого из указанных условий будет сгенерирована ошибка, запрос не будет выполнен.
extraParam	нет	string	Дополнительные параметры, передаваемые в виде param1=value1,param2=value2, где param1 и param2 — названия параметров, value1 и value2 — значения. Подробнее Символ запятой в название параметра входить не может, но может входить в его значение — в этом случае он должен удваиваться. Пример: строка место=абзаково,название=гостевой дом-2,координаты=53.8085896,, 58.6362112,c=23.02.09,по=05.03.09.
cascadeChainLink	нет	object	Параметры каскадных сообщений. Подробнее См. Каскадная рассылка

Ответ на запрос

После отправки сообщения Сервис-провайдер синхронно возвращает ответ. В случае успешной отправки возвращается HTTP-код 200 OK.

Ответ при успешной отправке VK-сообщения

Пример ответаПараметры ответа

{
    "mtNum": "7390612217"
    "id": "8770599"
}

Ошибки при отправке VK-сообщений

Для ошибочных результатов HTTP-код ответа будет отличный от 200 OK (см. Коды ошибок отправки).

Коды ошибок отправки

Код	Описание	HTTP-код
1	Service is unavailable	503
2	Invalid IP-address	403
3	Too many connections	429
4	Invalid request	400
5	Invalid login	401
6	Invalid password	401
7	serviceNumber is not defined	400
8	destAddr is not correct	406
9	Message type is not correct	406
10	Prohibited sending duplicates	409
11	Invalid TTL	406
100	100	500

Статусы доставки VK-сообщений

Для получения статусов VK-сообщений необходимо настроить Сервис получения статусов доставки сообщений.

Коды ошибок доставки

Коды ошибок доставки, в зависимости от типа сообщения, приведены в соответствующей вкладке в разделе Описание кодов ошибок.