Меню

Отправка СМС из 1С-Битрикс

Содержание:

1.Важно

21 июня 2021 года произошло обновление нашего приложения для отправки СМС из 1С-Битрикс: в нем исправлены небольшие ошибки старых версий. Для корректной работы обновленного приложения рекомендуем Вам обновить наше приложение через систему обновление 1С-Битрикс (там покажет, что есть доступное обновление) или установив обновленный архив с приложением.

2.Описание

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

3.Видеоинструкция

4.Функционал

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

5.Установка, активация и настройка приложения "TargetSMS: СМС-рассылки и уведомления" в 1С-Битрикс

  1. Пройдите регистрацию в нашем сервисе СМС-рассылок. После регистрации Вы получите логин, пароль, тестовое имя отправителя и тестовый баланс для проверки работы сервиса СМС-рассылок;

Установите приложение "TargetSMS: СМС-рассылки и уведомления" с помощью стандартной процедуры в панели администрирования "1С-Битрикс":

  1. Вручную (например, если закончились активные обновления):
    1. скачать архив с модулем UTF-8 версия, Windows-1251 версия
    2. разархивировать архив и загрузить папку targetsms.sms в /bitrix/modules/
    3. открыть администраторскую панель 1С-Битрикс и перейти на вкладку «Маркетплейс» – «Установленные решения» и установить модуль "TargetSMS: СМС-рассылки и уведомления", следуя указаниям системы
  2. Установка приложения "TargetSMS: СМС-рассылки и уведомления" из маркетплейса 1С-Битрикс:
    1. зайдите на страницу нашего приложения и нажмите кнопку «Установить» 1C-Битрикс. Установка
    2. в всплывающем окне введите адрес Вашего сайта или портала (см. пункт 1), после этого нажмите «Установить». 1C-Битрикс. Установка - 2

6.Настройка приложения "TargetSMS: СМС-рассылки и уведомления"

  1. После установки приложения "TargetSMS: СМС-рассылки и уведомления" Вы будете автоматически перенаправлены на страницу настроек модуля ("Настройки" – "Настройки продукта" - "Настройки модулей" - "TargetSMS: СМС-рассылки и уведомления").
  2. На этой странице нужно ввести имя хоста sms.targetsms.ru, логин и пароль от Вашего личного кабинета СМС-рассылок (логин и пароль нужно запросить у нас), а также согласованное с нами имя отправителя СМС по умолчанию (регистр важен!) и нажать кнопку "Применить". ВАЖНО: указывайте только согласованную подпись отправителя (несогласованные подписи отправителей работать НЕ БУДУТ).
  3. После нажатия кнопки "Применить" произойдет проверка доступа к сервису СМС-рассылок, и Вы увидите соответствующее сообщение и Ваш доступный баланс.

Настройка модуля

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

  1. Перейдите на вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Шаблоны смс"
  2. Нажмите кнопку "Добавить шаблон", выберите код события и заполните форму настроек.

Шаблоны СМС

7.1.Пример 1. СМС-уведомление администратору интернет-магазина о поступлении нового заказа

  1. Перейдите на вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Шаблоны смс"
  2. Нажмите на кнопку "Добавить шаблон"
  3. Выберите код события Новый заказ [ISMS_NEWORDER]
  4. Заполните форму шаблона, указав в качестве получателя номер мобильного телефона администратора магазина в международном формате (+79001234567). ВАЖНО: оставьте поле "Отправитель" пустым, если хотите, чтобы использовалась подпись по умолчанию, указанная в настройках, либо впишите другое согласованное с нами имя отправителя (регистр важен!)
  5. Нажмите кнопку "Сохранить"

Новый заказ

Если все сделано верно, то после оформления заказа администратор интернет-магазина получит СМС-уведомление заданного вида.

Все отправленные СМС-сообщения можно увидеть в вкладке "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "История сообщений"

История сообщений

7.2.Пример 2. СМС-уведомление администратору интернет-магазина о поступлении нового заказа с помощью стандартных почтовых событий

  1. Выбираем код события – Отправка письма [ISMS_BXEVENT]
  2. Указываем получателя СМС (номер мобильного телефона администратора магазина) в международном формате (+79001234567)
  3. Выбираем событие "Новый заказ [SALE_NEW_ORDER]"
  4. Указываем идентификатор почтового шаблона (если не заполнить, то будут обработаны все шаблоны данного типа события). Список почтовых шаблонов - /bitrix/admin/message_admin.php?lang=ru
  5. Можно отменить отправку письма, если отправлено сообщение соответствующей опцией
  6. Нажимаем "Применить" и заполняем шаблон, например: "Поступил заказ №#ORDER_ID#. Сумма заказа - #PRICE#."

Новый заказ-2

7.3.Пример 3. СМС-уведомление покупателям интернет-магазина о поступлении нового заказа

  1. Перейдите на вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Шаблоны смс"
  2. Нажмите на кнопку "Добавить шаблон"1С-Битрикс. Шаблон СМС покупателю
  3. Выберите код события "ISMS_NEWORDER" и заполните соответствующие поля открывшейся формы:
    1. Название шаблона (указывается любой произвольный текст - эти данные только для Вас)
    2. Активность (если шаблон должен быть активным - то нужно поставить галочку)
    3. ID сайта (выбрать нужный интернет-магазин, для которого предназначен шаблон)
    4. Отправитель (введите согласованное имя отправителя или тестовое имя target (регистр важен!)
    5. Шаблон (введите текст СМС с параметрами персонификации, если необходимо)
    6. Получатель СМС (вставьте параметр #PROPERTY_PHONE# (поле в зависимости настроек интернет-магазина может отличаться))
  4. Нажмите кнопку "Сохранить"1С-Битрикс. Шаблон СМС покупателю-2

В этом случае СМС будет отправляться на номер телефона покупателя/клиента интернет-магазина.

7.4.Пример 4. СМС-уведомление покупателям интернет-магазина об изменении статуса заказа

  1. Перейдите на вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Шаблоны смс"
  2. Нажмите на кнопку "Добавить шаблон"
  3. Выберите код события Обновление статуса [ISMS_STATUSUPDATE]
  4. Заполните форму шаблона, указав в качестве получателя параметр #PROPERTY_PHONE# (поле в зависимости настроек интернет-магазина может отличаться). Можно также ограничить срабатывание события только выбранными статусами, для этого настройте поля "Начальный статус" и "Текущий статус" необходимым Вам образом.
  5. Нажмите кнопку "Сохранить"

7.5.Пример 5. СМС-уведомление администраторам интернет-магазина об изменении статуса заказа

  1. Перейдите на вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Шаблоны смс"
  2. Нажмите на кнопку "Добавить шаблон"
  3. Выберите код события Обновление статуса [ISMS_STATUSUPDATE]
  4. Заполните форму шаблона, указав в качестве получателя мобильный номер телефона администратора интернет-магазина в формате +79001234567. Можно также ограничить срабатывание события только выбранными статусами, для этого настройте поля "Начальный статус" и "Текущий статус" необходимым Вам образом.
  5. Нажмите кнопку "Сохранить"

7.6.Пример со звездочкой. Макросы и PHP

В шаблоне текста СМС можно использовать макросы и php код. Для отмены отправки смс с помощью php можно вернуть пустой шаблон.
Например, отменим отправку СМС администратору, если в примечании есть слово тестовый. 
if(strpos(toLower("#USER_DESCRIPTION#"),"тестовый") !== false){
}
else{
?>
Поступил заказ №#ACCOUNT_NUMBER# от #PROPERTY_FIO#. сумма к оплате #PRICE_FORMAT#.
}
?>

8.Поддерживаемые макросы (параметры персонификации текста СМС)

#ID# - ID заказа
#LID# - ID сайта
#ACCOUNT_NUMBER# - номер заказа
#TRACKING_NUMBER# - трекинг код
#PAY_SYSTEM_ID# - ID платежной системы
#DELIVERY_ID# - ID службы доставки
#PERSON_TYPE_ID# - ID типа плательщика
#USER_ID# - ID пользователя
#PAYED# - оплата заказа
#STATUS_ID# - код статуса
#PRICE_DELIVERY# - стоимость доставки
#PRICE_DELIVERY_FORMAT# - стоимость доставки (форматированная)
#ALLOW_DELIVERY# - доставка разрешена
#PRICE# - сумма заказа
#PRICE_FORMAT# - сумма заказа (форматированная)
#CURRENCY# - код валюты
#DISCOUNT_VALUE# - сумма скидки
#DISCOUNT_VALUE_FORMAT# - сумма скидки (форматированная)
#TAX_VALUE# - наценка
#TAX_VALUE_FORMAT# - наценка (форматированная)
#SUM_PAID# - уже оплачено
#SUM_PAID_FORMAT# - уже оплачено (форматированная)
#USER_DESCRIPTION# - комментарий пользователя
#STATUS_NAME# - название статуса
#USER_EMAIL# - email пользователя
#USER_NAME# - имя пользователя
#USER_PERSONAL_PHONE# - телефон пользователя
#USER_PERSONAL_MOBILE# - мобильный телефон пользователя
#USER_PERSONAL_CITY# - город пользователя
#USER_WORK_PHONE# - рабочий телефон пользователя
#USER_PERSONAL_GENDER# - пол пользователя
#PROPERTY_FIO# - Ф.И.О. (Физическое лицо)
#PROPERTY_EMAIL# - E-Mail (Физическое лицо)
#PROPERTY_PHONE# - Телефон (Физическое лицо)
#PROPERTY_ZIP# - Индекс (Физическое лицо)
#PROPERTY_CITY# - Город (Физическое лицо)
#PROPERTY_LOCATION# - Город/Регион (Физическое лицо)
#PROPERTY_ADDRESS# - Адрес доставки (Физическое лицо)
#ORDER_SUM# - сумма заказа без доставки
#ORDER_SUM_FORMAT# - сумма заказа без доставки (форматированная)
#DELIVERY_NAME# - название службы доставки
#PAYMENT_NAME# - название платежной системы
#DATE_INSERT_FORMAT# - дата заказа со временем
#DATE_INSERT# - дата заказа

9.Отправка произвольных СМС

  1. Для отправки одиночного СМС-сообщения пройдите в вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Отправить смс"1С-Битрикс. Отправка произвольного СМС
  2. В открывшейся форме выберите нужное имя отправителя, введите номер мобильного телефона получателя в международном формате +79001234567, текст сообщения, задайте дату и время отправки СМС, если нужно, переведите в транслит
  3. Нажмите кнопку "Отправить СМС"

Отправить СМС

Отправить произвольное СМС-сообщение и посмотреть историю отправок СМС по конкретному заказу можно в карте этого заказа.

1С-Битрикс. Отправка СМС из карточки заказа

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

Для проверки баланса пройдите в вкладку "Маркетинг" – "TargetSMS: СМС-рассылки и уведомления" – "Остаток на счету". При необходимости можно пополнить баланс, нажав на кнопку "Пополнить счет", или из личного кабинета СМС-рассылок sms.targetsms.ru.

Остаток на счету

11.Экспериментальная функция "Проверка номеров телефонов на актуальность

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

  1. Проверка осуществляется по базе, которая не обновляется примерно с 2014 года. Это может приводить к тому, что некоторые актуальные номера телефонов будут ошибочно определяться как несуществующие
  2. База не берется из внешних источников

Другими словами, эта функция не используется в работе модуля, не актуализируется и не заявляется в функционале модуля; при необходимости функцию можно использовать по принципу "как есть".

Также обращаем Ваше внимание на то, что в стандартном функционале API есть актуальная функция, с помощью которой можно бесплатно запросить информацию по любому российскому номеру телефона: https://targetsms.ru/images/XML.pdf (пункт "Запрос на получение информации по номеру телефона"). При необходимости можно использовать ее.

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

Начиная с версии 18.5.0 в 1С-Битрикс появился встроенный "Главный модуль", с помощью которого можно:

  1. Настроить отправку СМС для штатной авторизации, регистрации и восстановления пароля.
  2. Использовать наш СМС-шлюз для отправки СМС из любого стороннего модуля или приложения, которые поддерживают отправку системных СМС из 1С-Битрикс

Наше приложение по отправке СМС, разумеется, совместимо с описанным выше функционалом: наше приложение и СМС-шлюз совместимы с любым функционалом и модулем, работающим на стандартном модуле 1С-Битрикс.

Для использования нашего приложения для отправки системных СМС из 1С-Битрикс:

  1. Обновите 1С-Битрикс до версии 18.5.0 или выше
  2. Перейдите в настройки главного модуля ("Настройки" – "Настройки продукта" - "Настройки модулей" - "Главный модуль")
  3. Перейдите на вкладку "Почта и СМС" и найдите раздел "Отправка СМС"
  4. В селекторе "Служба отправки СМС по умолчанию:" выберите наш шлюз "targetsms.sms" (предварительно Вы должны авторизоваться в нашем приложении "TargetSMS: СМС-рассылки и уведомления" - см. пункт "Настройка приложения "TargetSMS: СМС-рассылки и уведомления" данной инструкции)
  5. В селекторе "Номер отправителя по умолчанию:" выберите нужное Вам заранее согласованное с нами имя отправителя (для согласования имени отправителя обратитесь к Вашему менеджеру - сотруднику нашей компании)
  6. Выберите наш СМС-шлюз targetsms.sms
  7. Нажмите кнопку "Применить"
    Настройка Главного модуля

Для настройки регистрации новых пользователей по телефону, СМС-авторизации, восстановления паролей по СМС перейдите на вкладку "Авторизация" Главного модуля.

ВАЖНО: операторы сотовой связи требуют, чтобы в тексте СМС-сообщения с кодами авторизации обязательно фигурировало название сайта или сервиса клиента. Чтобы избежать вопросов от операторов связи мы настоятельно рекомендуем обязательно добавлять в текст СМС с кодами авторизации название Вашего сервиса и/или сайта.

Соответственно, вместо текста "Ваш код авторизации: 1234" мы рекомендуем делать текст, скажем, "Ваш код авторизации на сайте targetsms.ru: 1234".

РЕКОМЕНДАЦИЯ: заносить номера телефонов в карточки клиентов исключительно в международном формате +79000000001

13.Типовые проблемы и сложности

Самые популярные проблемы и вопросы по работе с интеграцией описаны тут.

Начать рассылку

Тестовые сообщения бесплатно