Модуль для 1С 8.x – Stream Telecom – универсальная платформа для рассылок
+7 (812) 326 10 75 Наш офис
8 800 333 10 75 Бесплатно по России

Модуль для 1С 8.x. Совместим со всеми конфигурациями 1C 8.x

ВНИМАНИЕ

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

Пароль для интеграции задается в настройках пользователя во вкладке Настройки API.

Если Вы хотите получить доступ к коду модулю обработки 1С, просьба связаться с технической поддержкой по адресу: support@stream-telecom.ru.

Документация по интеграции Stream Telecom 1C.pdf Обработка для 1С.zip

Функции

Данный модуль подходит для версий 1С 8.2 и 8.3

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

Затем выбрать распакованный файл обработки

После чего, в 1С, откроется обработка.

Для того чтобы отправлять сообщения через 1С, необходимо ввести во вкладке «Настройка»:

  • Ваши личные данные: логин и пароль (задается отдельно через вкладку Настройка > Безопасность)
  • Имя отправителя (отличное от SMS Info), зарегистрированное в личном кабинете.
  • Адрес сервера (вписан в обработку по умолчанию: gateway.api.sc/1c)

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

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

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

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

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

Номер получателя – номер, на который Вы хотите отправить SMS (в формате 79214563763)

После отправки сообщения (если все параметры введены правильно), появится диалоговое окно, с ID, отправленного сообщения. Который запишется в поле «ID последнего SMS».

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

 

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

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

Создание списка получателей сообщения 

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

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

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

  • Заполняя номерами из базы (добавит контакты из регистра контактной информации)

  • Загружая из xls (xlsx) файла

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

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

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

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

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

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

После удачной отправки сообщений, в служебных сообщений появятся ID, отправленных сообщений, и их количество. (В случае, если некоторые данные были заполнены неверно вернется один из статусов операций, который можно посмотреть в разделе "Список статусов операций")

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

Для отправки единичного сообщения Viber следует выбрать вкладку «Отправка», способ отправки «Viber»

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

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

В поле «Адрес картинки», вводите URL изображения в формате: 

https://my.site.com/images/image.jpg
. Длина URL изображения не более 1000 символов.

В поле «Текст кнопки», вводите текст наименования кнопки.

В поле «Адрес перехода», вводите URL кнопки в формате: 

https://my.site.com/

Длина URL кнопки для перехода не более 1000 символов.

Номер получателя – номер, на который Вы хотите отправить сообщения Viber (в формате 79214563763)

После отправки Viber, появится диалоговое окно с номером телефона и ID сообщения, которое запишется в пункт «ID последнего сообщения»

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

В пункте «Время ожидания доставки сообщения» можно установить срок жизни сообщения Viber

Для использования альтернативного канала доставки SMS в случае недоставки сообщения Viber, Вам нужно поставить галочку на одноименном пункте.

После этого у Вас появится новое окно «SMS».

В данном окне Вы сможете настроить SMS – рассылку, подобно тому, что Вы настраивали ранее. В случае, когда сообщение Viber не будет доставлено в течение его срока жизни, абоненту будет отправлено SMS сообщение.

Для того, чтобы стоимость рассылок считалась согласно Вашему тарифу, необходимо перед началом работы с интеграцией изменить в коде обработчика Функцию ПроверитьВозможностьОтправки() . А именно, строчку

Разность = БалансЧисло - КолСМС, на

Разность = БалансЧисло - КолСМС * тариф , где

тариф- стоимость одной смс.

Чтобы изменить код обработки, ее надо открыть в режиме «Конфигуратор» (тем же путем: Файл -> Открыть)

Затем выбрать кнопку «Действия» и «Открыть модуль объекта»

В коде модуля, найти функцию ПроверитьВозможностьОтправки(), и изменить вышеуказанный текст

Значение

Описание

OK_Operation_Completed

Операция выполнена

Error_Not_Enough_Credits

Ошибка: недостаточно кредитов

Error_Invalid_Login

Ошибка: введен неправильный логин или пароль

Invalid_Source_Address

Некорректный адрес отправителя сообщения

No_SourceAdress

Не введен адрес отправителя сообщения

No_SMS_PASS

Не введен пароль пользователя

No_SMS_TEXT

Не введен текст сообщения

No_SMS_USER

Не введен логин пользователя

User blocked

Пользователь заблокирован

Flood_SMS

Ошибка: множественная отправка смс на один номер с одинаковым текстом.

 Значение

 Описание

 Доставлено 

 Сообщение доставлено до абонента

 Не доставлено

 Сообщение не доставлено до абонента

 Отправлено

 Сообщение отправлено абоненту

 Просрочено

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

Статусы Viber

 Статус

 Описание

 delivered

 Доставлено

 undelivered

 Не доставлено

 sent

 Отправлено

 read

 Прочитано

Ошибки Viber

 Статус

 Описание

 user-blocked

 Абонент заблокирован

 not-viber-user

 Абонент не является пользователем Viber

 filtered

 Сообщение не соответствует ни одному зарегистрированному шаблону

Чтобы воспользоваться функцией HLR проверки, Вам нужно:

  1. Пройти в раздел «База абонентов»
  2. Загрузить из excel файла список номеров
  3. После загрузки файла нажать кнопку «Проверить номера»
  4. После проверки номера, можно увидеть статус абонента, который отображается в 1с.

Возможно получение следующих статусов после проверки HLR:

«Доступен» - (Абонент в сети).

«Не доступен» - (Абонент вне зоны доступа длительное время).

«Проверяется…» - (Выполняется проверка).

* Все функции могут быть доработаны на усмотрение разработчиков, внедряющих службы SMS в систему 1С.