Инструкция по интеграции и использованию модуля ePochta SMS для 1С

Модуль ePochta SMS для 1С предусмотрен для работы в 1С:Предприятие версии 8.3. Файлы модулей отличаются конфигурациями для разных форм (обычных и управляемых). Чтобы загрузить модуль и начать работу не потребуется большого количества времени или специальных навыков.

Внимание!
Для корректной работы модуля в разделе Настройки - закладка API персонального аккаунта ePochta SMS в пункте «Включить XML интерфейс» выберите пункт «Вкл», а в пункте «Режим XML интерфейса» выберите «Рабочий».

1. Загрузка

Скачайте файл модуля ePochta SMS для используемой вами версии 1С со страницы /api/1c-api.php и сохраните в любой папке на вашем компьютере, например, создайте папку СМС:

Рис.1

2. Регистрация и настройка

Для начала работы ePochta SMS для 1С запустите файл, содержащий номер вашей версии программы 1С, из папки, в которую производилось сохранение.

Окно модуля ePochta SMS для 1С выглядит следующим образом:

Рис.2

Нажмите кнопку Настройки, чтобы ввести и сохранить логин (регистрационный email) и пароль вашего аккаунта сервиса ePochta SMS (если у вас еще нет аккаунта ePochta SMS, зарегистрируйте его).

Рис.3

В случае использования прокси-сервера, необходимо отметить пункт Использовать прокси-сервер и заполнить остальные поля.

Нажмите Сохранить, чтобы запомнить введенную информацию.

3. Проверка баланса

Чтобы узнать баланс вашего аккаунта ePochta SMS в основном окне модуля  ePochta SMS для 1C,  нажмите кнопку Баланс. Под полем Получатели появится информация о количестве СМС кредитов, имеющихся в вашем распоряжении.

Рис.4

Внимание! Заранее позаботьтесь о том, чтобы в личном кабинете сервиса ePochta SMS баланс был достаточным для планируемой СМС рассылки (узнать стоимость отправки 1 СМС в любую страну мира, рассчитать необходимую для планируемой СМС рассылки сумму можно в разделе Калькулятор).

4. СМС рассылки

Текст СМС и имя отправителя

После настройки и проверки баланса можно приступать к составлению текста СМС уведомления.

В поле Текст сообщения введите текст вашего СМС. В качестве переменной можно использовать Фамилию, Имя, Отчество (см.Рис.2) и/или Название организации (Рис.4).

В поле SMS от укажите имя отправителя сообщения – номер телефона, имя или название организации (не длинее 11 цифр или букв латиницы). В зависимости от выбранного маршрута может потребоваться регистрация имени отправителя.

Выбор получателей СМС рассылки из Справочника

Выберите получателей вашего СМС уведомления с помощью выпадающего списка Тип справочника. В рамках справочника можно ограничить абонентов таким параметром, как Пол получателя.

При необходимости отправить СМС не всем, а только некоторым получателям из справочника, нажмите + в окне Получатели и выберите нужных абонентов.

Выбор получателей СМС рассылки – Дополнительные номера

С помощью нашего модуля непосредственно из 1С можно оправить СМС на любые другие номера, не обязательно из справочника 1С, для этого необходимо ввести телефонные номера в поле Дополнительные номера – каждый номер на новой строке, предварительно выделив соответствующий пункт.

5. Планирование времени СМС рассылки (отложенная СМС рассылка)

Смс рассылка может быть отправлена как моментально, так и назначена на любое время. Для этого выделите пункт Отправить и назначьте дату и время отправки.

После подготовки своего СМС уведомление нажмите кнопку «Отправить».

6. Отчеты о доставке

Отчеты о доставке отправленных СМС рассылок можно увидеть в разделе Статистика личного кабинета ePochta SMS.

7. Правила задания имени отправителя, телефонных номеров, длины текста сообщения

Виды имен отправителя:

• Альфа имя - это имя отправителя, содержащее только буквы.
• Нумерическое имя - это имя отправителя, содержащее только цифры.
• Альфанумерическое имя - имя отправителя, содержащие как буквы, так и цифры.
• Динамическое имя - возможность указывать любое имя отправителя без предварительной его регистрации.

Сервис ePochta SMS позволяет использовать динамическое альфанумерическое имя. Это значит, что вы можете указать любое имя, название компании или телефон в качестве имени отправителя без предварительной его регистрации, если это разрешено операторами страны, куда осуществляется отправка СМС.

По России доступна отправка по любому из трех маршрутов:

1. Прямой маршрут - отправка СМС с заданным буквенным именем (необходима регистрация имени)
2. Маршрут на котором заданное имя отправителя подменяется на стандартное фиксированное буквенное имя
3. Цифровой маршрут с подменой заданного имени отправителя на произвольный номер телефона

Имя отправителя должно соответствовать ряду правил:

1. Используйте только латинские буквы в имени отправителя, т.к. в противном случае, абонент получит сообщение с пустым полем От, или info вместо заданного имени, либо не получит СМС вообще.
2. Имя отправителя ограничено количеством используемых символов - максимум 11 латинских букв или цифр.
3. Не допускается использование коротких платных номеров, символов {| , ; % ' # % *! ^ = [ ] ( ) / ~ < >}" , а также русских, украинских букв и других символов.
4. Некоторые операторы вводят дополнительные ограничения к формату задания имени отправителя для коммерческого траффика.

Телефонные номера должны быть заданы в международном формате:
иметь федеральную запись вида, например, для России: 7xxxyyyyyyy, где 7 – международный код России, xxx - код оператора, yyyyyyy – номер абонента в сети соответствующего оператора; прямые мобильные номера должны быть представлены в федеральном виде; не должно присутствовать номеров городских телефонных сетей; в телефонном номере не должно быть лишних символов, например, букв.

Длина 1 смс: 70 символов в кириллице и 160 - в латинице. При превышении указанных объемов формируется несколько СМС, которые автоматически склеиваются в одно сообщение. При склеивании сообщений, каждое из них становится меньше на три символа для кириллицы (67 символов вместо 70) и семь символов для латиницы (153 символа вместо 160).

Подробнее о правилах задания имени отправителя читайте в разделе Вопросы-Ответы личного кабинета ePochta SMS.

8. Техническая поддержка модуля ePochta SMS для 1С

Разработчик модуля - компания Rond Service - оказывает техническую консультацию по вопросам интеграции и доработки модуля.