Рассылка SMS
E-mail рассылка
Уведомления VKontakte
Рассылки в Telegram
Голосовая рассылка
8 800 500-80-16
API
SMS
- HTTP/GET - запросов
- HTTP/POST - запросов
- SMPP
ВКонтакте (Одноклассники)
Звонки и голосовые сообщения
- Отправка кода звонком
- Отправка кода голосом
- Голосовые оповещения
Telegram
- Отправка в чат-бот
- Отправка по номеру телефона/имени пользователя
- Отправка кодов авторизации
- Как подключить чат-бота в Telegram
Каскад
- Добавление домена в сервис рассылок SMSGOLD
- API
Использование протокола НТТP (GET-запросы) для отправки и приема смс сообщений
Все запросы отправляются на адрес: https://web.smsgold.ru/http2/
навигация
Отправка сообщения
Список обязательных параметров:
| Имя параметра | Значение параметра |
|
user |
Зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X |
|
pass |
Пароль пользователя. |
|
action |
sendvk |
|
number |
Телефонный номер получателя сообщения в международном формате без символа "+". |
|
vk_template_name |
Имя шаблона, зарегистрированного ранее. Приходит при создании шаблона в письме с подтверждением от ВК ОК. Также можно получить при просмотре списка шаблонов. |
|
vk_service |
Присылается с первым одобренным шаблоном для подключаемой группы на указанный при запросе шаблона e-mail. |
Список необязательных параметров:
| Имя параметра | Значение параметра |
|
vk_template_data(json_string) |
Передача переменных из шаблона {"var_name1":"value","var_name2":"value"} (Если в шаблоне используются переменные, то данный параметр обязателен). |
|
vk_routes |
Маршрут отправки (vk - значение по умолчанию ВКонтакте, ok - Одноклассники, vk,ok - оба, т.е. доставка производится до первого получения уведомления на физическое устройство. При указании нескольких каналов доставки в итоге использован и тарифицирован будет только один из каналов.) |
|
vk_delivery_policy |
(any, mobile_device_required, verified_phone_number) |
|
vk_ttl |
Время жизни сообщения в секундах (от 60 до 24*60*60). |
|
vk_type |
S - режим “каскад”, отправка sms если сообщение ВК ОК не доставлено/прочитано. |
|
sender |
Имя отправителя для sms (будет использовано имя отправителя по умолчанию в случае если параметр пустой). |
|
sms_text |
Текст для sms если сообщение ВК ОК не доставлено/прочитано. |
|
vk_read_ttl |
Принимает значения от 0 сек. (не использовать каскад по непрочтению) до 24*60*60 сек. Работает по принципу: если сообщение не было прочитано в течении установленного количества секунд - осуществляется отправка sms, даже если сообщение было доставлено. Денежные средства за отправку сообщения ВК ОК не возвращаются, а в отчете появляется еще одно сообщение sms, т.е обновления старого объекта не происходит. Работает только если [vk_type]=S |
Добавление шаблона
Список обязательных параметров:
| Имя параметра | Значение параметра |
|
user |
Зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X |
|
pass |
Пароль пользователя. |
|
action |
sendvk |
|
vk_template_name |
Имя шаблона, допустимые символы: A-Za-z0-9_ |
|
notificationEmail |
Электронный адрес на который будут приходить извещения о активировании/удалении шаблонов |
|
vkGroupUrl|okGroupUrl |
URL групп VK и OK. Обязательно указать хотя бы один параметр, можно указывать оба. |
|
template|vkTemplate|okTemplate |
Текстовый шаблон (общий или отдельный для групп VK и OK). В именах переменных допускаются следующие символы: A-Za-z0-9_ Пример шаблона: Уважаемый #username# вам предоставляется скидка в размере #percent#% на покупку #goods# |
Список необязательных параметров:
| Имя параметра | Значение параметра |
|
service |
Идентификатор клиента и его продукта\проекта. Для новой группы (первый шаблон) этот параметр может быть пустым. Название придет в ответе о подтверждении вашего шаблона в письме на указанный email |
|
attachments[filename.ext] |
BASE_64_BODY_OF_IMAGE |
Редактирование шаблона
Список обязательных параметров:
| Имя параметра | Значение параметра |
|
user |
Зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X |
|
pass |
Пароль пользователя. |
|
action |
sendvk |
|
vk_template_name |
Имя шаблона, допустимые символы: A-Za-z0-9_ |
|
notificationEmail |
Электронный адрес на который будут приходить извещения о активировании/удалении шаблонов |
|
vkGroupUrl|okGroupUrl |
URL групп VK и OK. Обязательно указать хотя бы один параметр, можно указывать оба. |
|
template|vkTemplate|okTemplate |
Текстовый шаблон (общий или отдельный для групп VK и OK). В именах переменных допускаются следующие символы: A-Za-z0-9_ Пример шаблона: Уважаемый #username# вам предоставляется скидка в размере #percent#% на покупку #goods# |
|
service |
Идентификатор клиента и его продукта\проекта. Для новой группы (первый шаблон) этот параметр может быть пустым. Название придет в ответе о подтверждении вашего шаблона в письме на указанный email |
Список необязательных параметров:
| Имя параметра | Значение параметра |
|
new_vk_template_name |
|
|
drop_attachments |
|
|
attachments[filename.ext] |
BASE_64_BODY_OF_IMAGE |
Просмотр списка шаблонов
Список обязательных параметров:
| Имя параметра | Значение параметра |
|
user |
Зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X |
|
pass |
Пароль пользователя. |
|
action |
get_vk_templates |
Удаление шаблона
Список обязательных параметров:
| Имя параметра | Значение параметра |
|
user |
Зарегистрированное в системе ID пользователя вида XXXXX или ХХХХХ.X |
|
pass |
Пароль пользователя. |
|
action |
delete_vk_template |
|
vk_template_name |
Имя шаблона, зарегистрированного ранее. Приходит при создании шаблона в письме с подтверждением от ВК ОК. Также можно получить при просмотре списка шаблонов. |