Для разработчиков

Для разработчиков, Новости

Модуль SMS.BY по отправке смс для 1С-Битрикс

Любой бизнес в современном мире стремится к автоматизации всех процессов. Главным помощником в решении этой задачи является CRM-система, ведь именно она выполняет вместо людей всю рутинную и однообразную работу.
«1С-Битрикс» — одна из самых популярных платформ для создания сайтов среднего и крупного бизнеса. «1С-Битрикс» имеет достаточно широкий спектр возможностей в сфере создания, оптимизации и поддержания работы сайта за счет модулей, встроенных в платформу. Каждый модуль отвечает за определенные параметры Вашего проекта. Например, модуль «Реклама» позволяет размещать баннеры и управлять рекламой в целом. Кроме того, есть целая череда самых разнообразных модулей, отвечающих за форумы и чаты, социальные сети, управление валютами и подписками. SMS.BY, в свою очередь, выпустили модуль, который поможет Вам автоматизировать процесс СМС-рассылки. Ознакомится с кодом Вы можете перейдя по ссылке.

Для чего нужен модуль “SMS.BY: СМС-рассылки и уведомления»?

С помощью модуля SMS.BY Вы можете отправлять СМС-уведомления по заданным событиям, а также одиночные или массовые СМС-сообщения Вашим сотрудникам и клиентам.

Основной функционал модуля:

1. Поддержка отправки системных сообщений из 1С-Битрикс (messageservice).
2. Автоматическая отправка СМС при смене статусов заказов (администраторам и покупателям).
3. Гибкая настройка уведомлений по событиям/статусам.
4. Поддержка шаблонов СМС-сообщений (например, СМС-уведомление о новом заказе, смене статуса заказа и многое другое).
5. Персонификация текстов СМС-сообщений.
6. Отправка одиночных и массовых СМС-сообщений (из формы отправки).
7. Отправка СМС-сообщений на кириллице или в транслите (функция автоматического перевода текста сообщения в транслит).
8. Настройка даты и времени отправки СМС.
9. Выбор различных подписей отправителя при рассылке СМС-сообщений (Alphanames).
10. Сохранение истории всех отправленных сообщений.
11. Поддержка макросов и php кода в шаблонах сообщений.
12. Возможность добавлять в модуль свои события по отправке СМС.
13. Поддержка любых почтовых событий в системе.

Установка и активация приложения «SMS.BY: СМС-рассылки и уведомления» в 1С-Битрикс

Первым делом Вам необходимо пройти регистрацию в нашем сервисе СМС-рассылок SMS.BY. Далее подайте заявку на регистрацию Альфа-имени (ЛК SMS.BY > Альфа-имена > SMS имена), которая занимает в среднем 5 рабочих дней.
После завершения регистрации Вы получите логин, пароль и тестовый баланс для проверки работы сервиса СМС-рассылок.
Далее Вы можете приступить к установке приложения «SMS.BY: СМС-рассылки и уведомления», выбрав один двух способов, описанных ниже:
Вручную (например, если закончились активные обновления):
1. Скачать архив с модулем UTF-8 версия, Windows-1251 версия.
2. Разархивировать архив и загрузить папку SMS.BY.sms в /bitrix/modules/.
3. Открыть администраторскую панель 1С-Битрикс и перейти на вкладку «Маркетплейс» > «Установленные решения» и установить модуль » SMS.BY: СМС-рассылки и уведомления», следуя указаниям системы.
Установка приложения «SMS.BY: СМС-рассылки и уведомления» из маркетплейса 1С-Битрикс:
1. Зайдите на страницу нашего приложения и нажмите кнопку «Установить».
2. В всплывающем окне введите адрес Вашего сайта или портала, после этого нажмите «Установить».

Как настроить приложением «SMS.BY: СМС-рассылки и уведомления»

После установки приложения «SMS.BY: СМС-рассылки и уведомления» Вы будете автоматически перенаправлены на страницу настроек модуля. Если по каким-либо причинам страница не открылась, то Вам необходимо перейти в меню вручную: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > выбрать» SMS.BY: СМС-рассылки и уведомления».
Обязательно выберите правильный гейт для рассылки уведомлений, в частности, для Республики Беларусь https://app.sms.by, а также введите токен (его можно взять в личном кабинете SMS.BY).
После нажатия кнопки “Сохранить параметры» произойдет проверка доступа к сервису СМС-рассылок. Далее Вы увидите список Ваших Альфа-имен, а также доступный баланс.

25
Если вы хотите изменить Альфа-имя (подпись отправителя сообщений), тогда необходимо выбрать его на данном этапе.

Создание шаблонов СМС-сообщений

Для создания шаблона Вашего сообщения, перейдите во вкладку «Маркетинг» > «SMS.BY: СМС-рассылки и уведомления» > «Шаблоны смс».
Нажмите кнопку «Добавить шаблон», выберите код события и заполните форму настроек.

26
Как отправить одно произвольное СМС?

Для отправки одиночного СМС-сообщения перейдите в вкладку «Маркетинг» > «SMS.BY: СМС-рассылки и уведомления» > «Отправить смс».
В открывшейся форме выберите нужное имя отправителя, введите номер мобильного телефона получателя в международном формате +375291234567, текст сообщения, а также задайте дату и время отправки СМС. Нажмите кнопку «Отправить СМС».
Отправить произвольное СМС-сообщение и посмотреть историю отправок СМС по конкретному заказу можно в карте этого заказа.

Как проверить баланс?

Для проверки баланса пройдите в вкладку «Маркетинг» > «SMS.BY: СМС-рассылки и уведомления» > «Остаток на счету».

Отправка системных СМС из 1С-Битрикс

Начиная с версии 18.5.0 в 1С-Битрикс появился встроенный «Главный модуль», с помощью которого можно настроить отправку СМС для штатной авторизации, регистрации и восстановления пароля. Кроме того, он позволяет использовать наш СМС-шлюз для отправки СМС из любого стороннего модуля или приложения, которые поддерживают отправку системных СМС из 1С-Битрикс.
Наше приложение «SMS.BY: СМС-рассылки и уведомления» и СМС-шлюз совместимы с любым функционалом и модулем, работающим на стандартном модуле 1С-Битрикс.
Что нужно для использования нашего приложения для отправки системных СМС из 1С-Битрикс?
1. Обновите 1С-Битрикс до версии 18.5.0 или выше.
2. Перейдите в настройки главного модуля («Настройки» > «Настройки продукта» > «Настройки модулей» > «Главный модуль»).
3. Перейдите на вкладку «Почта и СМС» и найдите раздел «Отправка СМС».
4. В селекторе «Служба отправки СМС по умолчанию:» выберите наш шлюз «SMS.BY.sms» (предварительно Вы должны авторизоваться в нашем приложении «SMS.BY: СМС-рассылки и уведомления» (см. пункт «Настройка приложения «SMS.BY: СМС-рассылки и уведомления» данной инструкции).
5. В селекторе «Номер отправителя по умолчанию» выберите Ваше Альфа-имя (для регистрации имени отправителя обратитесь к Вашему менеджеру — сотруднику нашей компании).
6. Выберите наш СМС-шлюз SMS.BY.sms > Нажмите кнопку «Применить».
7. Для настройки регистрации новых пользователей по телефону, СМС-авторизации, восстановления паролей по СМС перейдите на вкладку «Авторизация» Главного модуля.

Кстати, на нашем YouTube-канале, Вы можете увидеть пример как настроить отправку СМС из 1С-Битрикс по статусу заказа. Для просмотра, кликните по ссылке (в видео отображается настройка для двух сервисов SMS.BY, а также StartSend.ru).
А если у вас все равно возникают вопросы, наш отдел заботы о клиентах с большим удовольствием может вас проконсультировать.

Читать дальше

Для разработчиков, Интеграции, Новости

Интеграция SMS.BY и OpenCart

CMS OpenCart — современная и простая в использовании платформа, которая позволяет реализовать все функции, необходимые для полноценного ведения интернет-магазина и совершения сделок в режиме онлайн.

Платформа легка в настройке, имеет невысокие системные требования и широкие возможности кастомизации системы под конкретного пользователя. OpenCart позволяет не только вносить изменения в оформление интернет-магазина, но и добавлять основные категории и товары с подробным описанием и ценами, а также запускать акции для привлечения новых покупателей. Интеграция OpenCart с SMS.BY расширила список инструментов для полноценной работы интернет-магазина возможностью создавать и отправлять как системные, так и рекламные СМС своим клиентам.

Как настроить и запустить первую СМС-рассылку в OpenCart?

Находим на платформе OpenCart слева меню выбираем вкладку «Модули и расширения» —> Настройки. Далее, нужно заполнить пустые поля, а именно:
1. В поле «Сервис для API отправки» выбираете как агрегатора SMS.BY.
2. Вписываете API-токен, который можно взять в Вашем кабинете SMS.BY —> АPI —> Токен. Можно просто нажать кнопку «Получить токен» и Вы будете автоматически переброшены на страничку, где его можно скопировать.
3. В поле СМС-подписи, необходимо выбрать Ваше Альфа-имя, иначе по-умолчанию будет использоваться имя отправителя SMS.BY. Если у Вас еще нет Альфа-имени, то в ЛК SMS.BY Вам необходимо подать заявку на его регистрацию, которая будет осуществлена в течение 5 рабочих дней.

4. Далее можно провести тестовую отправку СМС, указав в соответствующих полях номер телефона и текст.

5. Нажмите «Создать учетную запись» и «Отправить тестовое сообщение».

Рассылка СМС с помощью модуля OpenCart, предусматривает отправку сообщений по группам. Выбрав вкладку «Отправка смс», Вы можете установить необходимый Вам параметр отправки: указанные телефоны, подписанные на новости, всем из группы Default или же отправлять рассылку всем пользователям. Во вкладке «Шаблоны смс», Вы можете прописать шаблоны смс-сообщений, которые будут получать пользователи в зависимости от статуса заказа, например «Аннулированный», «В обработке», «Возврат» и другие.

Раз уж мы заговорили о такой платформе, как OpenСart, хотим поделиться с Вами одним лайфхаком. Если Вы хотите настроить интеграцию с системой, с которой на данный момент у SMS.BY пока нет прямой интеграции, попробуйте ApiX-Drive.

ApiX-Drive — это онлайн коннектор, с помощью которого Вы сможете создавать интеграции между разными системами и приложениями без программистов. Никакого дорогого ПО, кода и сложных настроек, только простой интуитивный интерфейс в режиме онлайн на сайте ApiX-Drive. По каждой интеграции можно просмотреть подробную статью, где пошагово расписаны все необходимые настройки. ApiX-Drive взаимодействует более чем с 300 различными системами, начиная от CMS-систем для интернет-магазинов, заканчивая всеми самыми популярными CRM-ками, мессенджерами, сервисами рассылок и электронными таблицами. Так что шанс, что в списке не окажется вашей системы крайне мал, а это значит можно приступать к интеграции. Чтобы убедиться, что все максимально просто, ApiX-Drive предоставляет при регистрации всем пользователям 14-дневный пробный период.

Читать дальше

Для разработчиков, Новости

Двухфакторная авторизация (2FA) на Java

Сегодня мы расскажем как сделать двухфакторную авторизацию (2FA) на Java

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


После нажатия на “получить смс” пользователь получит сообщение вида CODE20.
Где CODE20 — это строка от 1 до 16 символов, состоящая из букв, цифр или букв и цифр одновременно. 

Итак, пользователь нажал “получить смс”.
Вы отправляете запрос на SMS.BY — sendSmsWithCode()
Данный вызов API вернет вам код сообщения “CODE20” и этот же код будет отправлен пользователю.
Пользователь вводит код и вы проверяете, кто код совпадает, и если все ОК — то пропускаете пользователя дальше.

Теперь подробнее с примерами кода. 

Для начала давайте распишем алгоритм: 

  1. Создать объект класса SMS_BY 
  2. Указать токен 
  3. Настроить PasswordObject 
  4. Получить ID PasswordObject
  5. Вызвать метод sendSmsWithCode
  6. Сравнить вводимый код от пользователя с тем, который вернут метод sendSmsWithCode

Качаем исходники отсюда

Двухфакторная авторизация работает следующим образом.

Вы настраиваете длину и конфигурацию пароля, после этого у вас будет ID.
Далее по этому ID вы отправляете смс и в ответ вам приходит код, который отправляется пользователю.
В нашей системе такая настройка реализуется через PasswordObject.
PasswordObject — это настройки, которые вы можете использовать в двухфактороной верификации.
Например вам надо, чтобы пароль состоял только из только букв или только цифр или и то и другое, с длиной пароля в 5 символов.

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

1
2
3
4
5
6
7
// настройка длины пароля при двухфакторной авторизации с длиной пароля в 5 символов.

createPasswordObject(SMS_BY.PASS_TYPE_LETTERS, 5) ; // только буквы латиницы

createPasswordObject(SMS_BY.PASS_TYPE_NUMBERS, 5) ; // только цифры

createPasswordObject(SMS_BY.PASS_TYPE_BOTH, 5) ;    // и буквы и цифры

Чтобы отправить смс с кодом нужно сделать вызов:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
oStart.sendSmsMessageWithCode("Ваш пароль: %CODE%", "245", phone,alphaname_id  );

"Ваш пароль: %CODE%" - текст сообщения, <b>%CODE%</b>
- обязательный параметр, вместо %CODE% будет подставлен<

сгененированный пароль для получателя.

"245" - это ID PasswordObject созданный ранее

phone - номер телефона

alphaname_id - ID Альфа-имени, если Альфа-имени пока нет, нужно передавать 0

sendSmsMessageWithCode вернет:

{"status":"ok","parts":1,"len":21,"sms_id":2208471,"code":"GAYXILYZOX"}

Из этого сообщения вам надо получить код, который будет вводить пользователь на форме двухфакторной авторизации:

1
code = GAYXILYZOX

Пример кода:     

1
2
3
4
5
6
7
String password_object_id  = oStart.createPasswordObject("both",4);

Integer alphaname_id       = new Integer(0);

str = oStart.sendSmsMessageWithCode ("Ваш пароль: %CODE%", password_object_id,SMS_BY_Sample.phone,alphaname_id  );

SMS_BY_Sample.print(str);

Читать дальше

Для разработчиков, Интеграции, Новости

Отправка СМС на php

SMS.BY делает все, чтобы разработчикам было удобно использовать API для интеграции с нашим сервисом.

Чтобы Вам было быстрее и проще сделать интеграцию, мы написали пример кода на Php, доступный на GitHub.
Кстати, в конце статьи Вас ждет видео с разбором отправки СМС на Php.

В данном репозитории содержится 4 файла:

1
2
3
4
SMS_BY.php
CountSmsParts.php
Transliterate.php
examples.php

SMS_BY.php — это базовый класс, содержащий все методы по отправке смс, проверку статусов, отправку запроса и так далее.

CountSmsParts.php — класс для подсчета длины строки с учетом кодировок ascii / unicode.

Если вы ранее не сталкивались с отправкой смс, то в целом должны помнить что русский символ требует 2 байта в unicode, поэтому длина смс на русском — 70 символов, а на английском — 140.

1
2
3
4
"lengths" => [
      "ascii" => [160, 306, 459, 628, 785, 942, 1071, 1224, 1377, 1530],
      "unicode" => [70, 134, 201, 252, 315, 378, 469, 536, 603, 670],
]

Но, в тоже время, если у Вас более 2 смс в одном сообщении, то длина будет уже менее 70 символов (68 если точнее), так как для отправки смс требуется добавление системной информации.

Это стоит учитывать при отправке длинных смс, или стараться делать смс короче.
Transliterate.php — как уже можно догадаться, класс по транслитерации русского текста в латиницу.
examples.php — содержит примеры вызова функций по подсчету длины смс-сообщения, а также транслитерации русского текста в английский.
Функция транслитерации также учитывает регистр, поэтому Вам не придется делать дополнительный ucfirst.

Итак, разберем основные моменты в examples.php: 

В самом верху идет подключение классов.

1
2
3
4
5
6
7
8
include('SMS_BY.php');
require_once('Transliterate.php');
require_once('CountSmsParts.php').
// Код токена вы можете получить здесь: https://app.sms.by/user-api/token

$token = ''; // КОД_ВАШЕГО_ТОКЕНА
// Номер телефона для теста
$phone = ''; // НОМЕР ТЕЛ ДЛЯ ТЕСТА

После того, как Вы вставите свой токен и номер телефона, Вы сможете отправить себе тестовое сообщение (проверьте, что у вас включен CURL).

Код в example.php состоит из блоков if(false).

Вы можете выбрать какой именно метод вы хотите протестировать и поставить там if (true).

Например, отправка смс:

1
2
3
4
5
6
7
8
9
10
11
12
13
if (false) {
     echo("Отправка простого sms-сообщения на номер: $phone");
     /** Отправка простого сообщения: */
     $sms = new SMS_BY($token);
     $res = $sms->createSMSMessage('Моё сообщение');
     $message_id = $res->message_id;
     $res2 = $sms->sendSms($message_id, $phone);
     if ($res2 == false) {
         echo("Во время отправки сообщения произошла ошибка");
     } else {
         echo("Сообщение успешно отправлено, его ID: {$res2->sms_id}");
     }
}

Меняем в блоке выше if(false) на if(true) вызываем и на указанный вами телефон будет доставлена смс.

Пример запуска из командной строки:

отправка смс на Php пример

Как вы видите в конце выводится сообщение об ошибке.

Это происходит, потому что у отправителя пока что нет одобренных Альфаимен (имен отправителя). Заявку на Альфаимя вы можете сделать в кабинете по ссылке: https://app.sms.by/alphanames

 

Смс, полученное на телефон:

photo_2021-04-01_12-05-445

Видео, в котором подробно описана отправка СМС на php:

Читать дальше

Для разработчиков, Интеграции

Отправка SMS/Viber из Bitrix24

Отправляйте одиночные и массовые СМС и Viber-рассылки сразу из Bitrix24!

Наше приложение для BITRIX24 позволит вам:

  • Отправлять смс из карточки клиента/сделки
  • Отправлять смс нескольким клиентам по фильтру
  • Отправлять каскадные рассылки (сначала Viber, а при недоставке — смс)

Как установить приложение SMS.BY?

Чтобы установить приложение SMS.by, вам нужно войти в ваш портал Bitrix24 и в разделе Поиск ввести «SMS.BY».

Чтобы попасть в поиск приложений нужно:

  • Открыть раздел «Карта сайта»
  • Прокрутить до раздела «Приложения»
  • Перейти по ссылке «Все приложения»

smsby_search_all_apps

В открывшемся окне будет поле поиска, в котором ввести «SMS.BY»:

Внизу вы увидите приложение «SMS.BY», которое нужно будет установить.

smsby_bitrix24_search

После установки приложение запросит API-ключ вашей учётной записи SMS.BY. Чтобы
долго не искать его в личном кабинете, под формой есть прямая ссылка на страницу с
API-ключом:

bitrix1

Подставьте API-ключ и нажмите на кнопку «Сохранить».

Выберите Альфа-имя с соответствующем поле:

bitrix1

Как только Вы установили приложение Bitrix24 и сохранили ключ API, можете запускать
рассылку через интерфейс Bitrix24.

Заходите в CRM:

bitrix1

Выбираем Контакты или Компании:

bitrix2

Выбираем контакт или компанию из списка:

bitrix3

В карточке контакта есть пункт SMS.

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

bitrix4

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

Вы также можете посмотреть видео по установке приложения SMS.BY:

Читать дальше

Для разработчиков, Интеграции

Как отправлять смс из AmoCRM

Наша платформа позволяет делать рассылки вашим клиентам сразу из AmoCRM:

Отправка смс прямо из карточка контакта/сделки/компании

amocrm_send_text

Отправка смс со событию из цифровой воронки

Вы можете добавить действие в цифровой воронке и дополнительные условия. Можно отправлять к примеру при создании новой сделки, при переходе на новый этап, либо смене ответственного у сделки и так далее, в зависимости от ваших требований.

digital_pipeline_amocrm

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

 

Как найти и установить витжет SMS.by

Для перехода к настройкам приложения необходимо пройти по ссылкам Настройки -> Интеграции -> SMS.BY.
Там нужно указать ваш API-ключ и выбрать альфа-имя, от которого будут идти отправки.

1

После установки виджета он становится доступен в списках контактов, компаний и сделок, в карточке контакта, компании или сделки, в цифровой воронке:

  1. Нужно выбрать контакт;
  2. Нажать на троеточие;
  3. Нажать на Sms.by.

2

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

На карточке контакта также будет отображаться виджет, где вы можете ввести и отправить текст сообщения:
3

Текст сообщения – окошко для ввода текста смс.
Во втором окошке список контактов телефонов. Для контактов – это телефоны контактов, для компаний – это телефоны компаний, для сделок – это телефоны присоединённых к сделке контактов и компаний. Здесь можно галочками выделить конкретные телефоны, по которым хотим осуществить рассылку. Нажимаем на кнопку «Отправить для старта рассылки».

4

Более подробно о настройках витжета вы можете посмотреть в нашем видео:


Еще нет акаунта в SMS.by? Зарегистрироваться тут.

 

Читать дальше