Модуль интеграции с сервисом SMS через 1C¶
Для использования данного вида интеграции необходимо зарегистрироваться на серверной платформе компании либо через менеджера компании. При регистрации вы получите логин и пароль, а так же стандартное имя отправителя DTSMS, которое необходимо будет поменять, запросив другое имя в личном кабинете.
Внимание
Для использования данного вида интеграции необходимо обратиться к менеджеру компании либо в техническую поддержку для настройки доступа.
Модуль 1C работает только с версиями 8.1, 8.2, 8.3.
Установка интеграционного модуля в 1С¶
Чтобы пользоваться интеграционным модулем для 1С, необходимо открыть его через 1С. Для этого во вкладке Файл, необходимо выбрать пункт выпадающего меню Открыть:
Затем выбрать путь до интеграционного модуля на вашем компьютере:
После чего в 1С откроется интеграционный модуль.
Авторизация в интеграционном модуле¶
Чтобы отправлять сообщения через 1С, необходимо во вкладке Настройка ввести ваши личные данные: логин и пароль, а так же имя отправителя (отличное от testsms), зарегистрированное в личном кабинете. Адрес сервера вписан в обработку изначально:
https://integrationapi.net/rest
Для проверки правильности ввода данных нажмите кнопку обновления баланса. Если логин с паролем введены правильно, вы увидите свой баланс.
Если данные для подключения введены неверно, появится ошибка: Result: Error_Invalid_Login.
Единичная отправка сообщений¶
Мгновенная отправка единичного сообщения¶
Для отправки одного сообщения следует выбрать вкладку Тестовая отправка.
В поле Отправитель выберите имя отправителя из списка, который вы вводили во вкладке Настройки (все имена отправителей должны быть зарегистрированы в личном кабинете). В поле Текст SMS введите текст отправляемого сообщения. Номер получателя – номер, на который вы хотите отправить SMS (в формате 79214563763).
Если все параметры введены правильно, после отправки сообщения появится диалоговое окно с ID отправленного сообщения, который запишется в поле ID последнего SMS.
Чтобы узнать статус отправленного сообщения, нужно нажать кнопку Уточнить статус.
В появившемся окне будет информация о времени отправки сообщения и о статусе сообщения, ID которого записано в поле ID последнего SMS.
Отправка отложенного по времени единичного сообщения¶
Чтобы задать конкретные дату и время отправки единичного сообщения, необходимо перед отправкой выбрать Отложить до и дату и время отправки сообщения.
Пакетная отправка сообщений¶
С помощью данного модуля для 1С можно осуществлять рассылку множеству получателей.
Для массовой рассылки сообщений, необходимо во вкладке База абонентов добавить список контактов.
Это можно сделать разными способами:
- Добавлять единичные контакты.
- Заполнять номерами из базы (добавить контакты из справочника контрагентов).
- Загружать из файлов .xls или .xlsx.
При выборе третьего типа загрузки в открывшемся окне будет предложено выбрать параметры для загрузки базы абонентов из файла. Здесь нужно выставить соответствие между колонками в файле .xls и наименованиями (телефон, имя адресата) в модуле.
Также, если во время работы с уже загруженной базой она будет изменена, можно сохранить базу в формате .xls.
Мгновенная отправка сообщений¶
После того как списки получателей сообщений будут сформированы, во вкладке Отправка выберите вкладку Массовая рассылка.
В поле Отправитель выберите имя отправителя из списка, который вы вводили во вкладке Настройки (все имена отправителей должны быть зарегистрированы в личном кабинете).
В поле Текст SMS введите текст отправляемого сообщения.
После нажатия кнопки Отправить модуль посчитает стоимость рассылки и предупредит о том, какой баланс у вас будет после осуществления рассылки SMS.
После удачной отправки сообщений в служебных сообщениях появятся ID отправленных сообщений и их количество. Если некоторые данные были заполнены неверно, вернется один из статусов операций.
Пакетная отправка отложенных по времени сообщений¶
Чтобы создать пакетную отложенную отправку сообщений, нужно перед оправкой выбрать дату и время, начиная с которых будет осуществляться рассылка.
Статусы операций и сообщений¶
Статусы операций¶
| Статусы | Значение |
|---|---|
| OK_Operation_Completed | Операция выполнена |
| Error_Not_Enough_Credits | Ошибка: недостаточно кредитов |
| Error_Message_Rejected | Ошибка: сообщение отклонено |
| Error_Invalid_Source_Address | Ошибка: некорректный адрес отправителя сообщения |
| Error_Invalid_Destination_Address | Ошибка: некорректный номер получателя сообщения |
| Error_SMS_User_Disabled | Ошибка: SMS - пользователь заблокирован |
| Error_Invalid_MessageID | Ошибка: некорректный ID сообщения |
| Error_Invalid_Header | Ошибка: некорректно переданы параметры |
| Error_Invalid_Login | Ошибка: неправильный логин |
| Error_Invalid_Password | Ошибка: неправильный пароль |
| Error_Unauthorised_IP_Address | Ошибка: неавторизованный IP-адрес |
| Error_SMS_User_Not_Activated | Ошибка: SMS - пользователь не активирован |
| Error_Message_Queue_Full | Ошибка: очередь сообщений полна |
| Error_Gateway_Offline | Ошибка: сервер недоступен |
| Error_Gateway_Busy | Ошибка: сервер занят другим запросом |
| Error_Database_Offline | Ошибка: сервер базы данных недоступен |
Статусы сообщений¶
| Статусы | Значение |
|---|---|
| Enqueued | Ожидает отправки |
| Delivered_To_Gateway | Отправлено |
| Sent | Отправлено |
| Delivered_To_Recipient | Доставлено |
| Error_Invalid_Destination_Address | Ошибка: некорректный номер получателя сообщения |
| Error_Invalid_Source_Address | Ошибка: некорректный адрес отправителя сообщения |
| Error_Rejected | Ошибка: сообщение отклонено |
| Error_Expired | Ошибка: истек срок жизни сообщения |
| Все остальное | Статус не распознан |
Статусы передаются на русском языке. Статусы служебных запросов могут быть переданы на английском.