Перейти к содержанию

Модуль интеграции с сервисом SMS через 1C

Для использования данного вида интеграции необходимо зарегистрироваться на серверной платформе компании либо через менеджера компании. При регистрации вы получите логин и пароль, а так же стандартное имя отправителя DTSMS, которое необходимо будет поменять, запросив другое имя в личном кабинете.

Внимание

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

Скачать модуль

Модуль 1C работает только с версиями 8.1, 8.2, 8.3.

Установка интеграционного модуля в 1С

Чтобы пользоваться интеграционным модулем для 1С, необходимо открыть его через 1С. Для этого во вкладке Файл, необходимо выбрать пункт выпадающего меню Открыть:

06

Затем выбрать путь до интеграционного модуля на вашем компьютере:

2

После чего в 1С откроется интеграционный модуль.

Авторизация в интеграционном модуле

Чтобы отправлять сообщения через 1С, необходимо во вкладке Настройка ввести ваши личные данные: логин и пароль, а так же имя отправителя (отличное от testsms), зарегистрированное в личном кабинете. Адрес сервера вписан в обработку изначально:

https://integrationapi.net/rest

3

Для проверки правильности ввода данных нажмите кнопку обновления баланса. Если логин с паролем введены правильно, вы увидите свой баланс.

55

Если данные для подключения введены неверно, появится ошибка: Result: Error_Invalid_Login.

Единичная отправка сообщений

Мгновенная отправка единичного сообщения

Для отправки одного сообщения следует выбрать вкладку Тестовая отправка.

В поле Отправитель выберите имя отправителя из списка, который вы вводили во вкладке Настройки (все имена отправителей должны быть зарегистрированы в личном кабинете). В поле Текст SMS введите текст отправляемого сообщения. Номер получателя – номер, на который вы хотите отправить SMS (в формате 79214563763).

4

Если все параметры введены правильно, после отправки сообщения появится диалоговое окно с ID отправленного сообщения, который запишется в поле ID последнего SMS.

22

Чтобы узнать статус отправленного сообщения, нужно нажать кнопку Уточнить статус.

6

В появившемся окне будет информация о времени отправки сообщения и о статусе сообщения, ID которого записано в поле ID последнего SMS.

7

Отправка отложенного по времени единичного сообщения

Чтобы задать конкретные дату и время отправки единичного сообщения, необходимо перед отправкой выбрать Отложить до и дату и время отправки сообщения.

8

Пакетная отправка сообщений

С помощью данного модуля для 1С можно осуществлять рассылку множеству получателей.

Для массовой рассылки сообщений, необходимо во вкладке База абонентов добавить список контактов.

9

Это можно сделать разными способами:

  • Добавлять единичные контакты.

11

  • Заполнять номерами из базы (добавить контакты из справочника контрагентов).
  • Загружать из файлов .xls или .xlsx.

12

При выборе третьего типа загрузки в открывшемся окне будет предложено выбрать параметры для загрузки базы абонентов из файла. Здесь нужно выставить соответствие между колонками в файле .xls и наименованиями (телефон, имя адресата) в модуле.

13

Также, если во время работы с уже загруженной базой она будет изменена, можно сохранить базу в формате .xls.

14

Мгновенная отправка сообщений

После того как списки получателей сообщений будут сформированы, во вкладке Отправка выберите вкладку Массовая рассылка.

В поле Отправитель выберите имя отправителя из списка, который вы вводили во вкладке Настройки (все имена отправителей должны быть зарегистрированы в личном кабинете).

В поле Текст SMS введите текст отправляемого сообщения.

15

После нажатия кнопки Отправить модуль посчитает стоимость рассылки и предупредит о том, какой баланс у вас будет после осуществления рассылки SMS.

16

После удачной отправки сообщений в служебных сообщениях появятся ID отправленных сообщений и их количество. Если некоторые данные были заполнены неверно, вернется один из статусов операций.

17

Пакетная отправка отложенных по времени сообщений

Чтобы создать пакетную отложенную отправку сообщений, нужно перед оправкой выбрать дату и время, начиная с которых будет осуществляться рассылка.

18

Статусы операций и сообщений

Статусы операций

Статусы Значение
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 Ошибка: истек срок жизни сообщения
Все остальное Статус не распознан

Статусы передаются на русском языке. Статусы служебных запросов могут быть переданы на английском.