Интеграции

Интеграции, Новости

Интеграция 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-дневный пробный период.

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

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

Отправка СМС на 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.by и Bitrix24

Приложение SMS.BY для Bitrix24.

При помощи приложения SMS.BY вы можете легко делать рассылки смс, как массовые, так и по отдельным клиентам.

Чтобы установить приложение SMS. B вам нужно войти в ваш портал 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.BY, а чуть ниже находится поле для ввода текста сообщения:

bitrix4

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

Видео с подробным описанием:

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

Интеграции

Интеграция с AmoCrm, Bitrix24, YClients

Нажмите на логотип системы, которая вас интересует, чтобы подробнее узнать про интеграцию с SMS.by:

smsby_amocrm

 

 

 

smsby_bitrix24

 

 

 

smsby_yclients_logo

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

Интеграции

Интеграция с YClients для отправки смс

Интеграция сервиса Sms и Viber рассылок SMS.BY + yClients.

В конце статьи Вы можете посмотреть видео с пошаговой настройкой смс-рассылки в yClients.

Что у вас должно быть для того, чтобы успешно произвести настройку:

  1. Вы должны быть зарегистрированы в Sms.by и yClients;
  2. Вам нужно скопировать токен для интеграции сервисов тут: https://app.sms.by/user-api/token в блокнот, он вам пригодится;
  3. Если у вас уже есть Альфа-имя, то оно вам тоже понадобиться, скопируйте его в блокнот. Альфа-имена находятся тут: https://app.sms.by/alphanames
  4. Если Альфа-имени у вас нет, то тогда вы сможете использовать SMS.BY.

Для перехода к настройкам приложения необходимо пройти по ссылкам Настройки -> Уведомления:

yclients-1

 

На появившейся странице выберите SMS-уведомления, в появившейся форме выберите SMS-агрегатора «SMS.by». Далее укажите API-key и альфа-имя и сохраните настройки:

smsby_yclients

Для отправки смс перейдите в раздел Клиенты ->  Клиентская база:

yclients-1

В появившемся окне можно отправить смс как одному клиенту, выбрав его из списка, так и всем клиентам сразу:

yclients-3

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

yclients-3

Пример полученного смс:
yclients-3

 Видео по настройке смс-рассылки в yClients:


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