IT-КУБиК-Сервис • Форум 1С
Абстрактный тёмно-синий фон с мягкими геометрическими линиями и оранжевыми акцентами, создающий технологичную атмосферу

Агрегатор публикаций с Инфостарта по 1С:Предприятие — обработки, расширения, конфигурации, интеграции и администрирование. Сообщество специалистов 1С.

Интеграция 1С с SMS-рассылками через API

Интеграция 1С с сервисом SMS-рассылок, например SMSClub, превращает шаблон уведомления в рабочий сценарий: данные берутся из учетной системы, сообщение формируется по правилам компании и отправляется через API.

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

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

Как устроен обмен с SMS-провайдером

Рабочий процесс удобно разделить на четыре шага: выбор получателя, подстановка шаблона, отправка HTTP-запроса и запись результата. Для 1С:Enterprise это может быть фоновое задание, регламентное задание или обработка, запускаемая из документа.

Критерий Ручная отправка Обмен через API Готовый модуль
Обработка данных Оператор вручную Платформа 1С Сторонний сервис
Запуск По отдельной команде По событию или расписанию По настройке модуля
Контроль результата В переписке В журнале системы В интерфейсе поставщика
Масштабирование Ограничено числом операторов Зависит от очереди заданий Зависит от тарифа сервиса

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

Подготовка учетной системы и провайдера

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

В конфигурации 1С предусмотрите справочник получателей, шаблоны сообщений и регистр журнала отправок. Токен авторизации следует хранить отдельно от открытого кода, ограничить доступ к нему и исключить из текстовых выгрузок. Название метода API, схема JSON и правила подписи сверяются с документацией SMSClub перед написанием запроса.

Отправка сообщения через HTTP-запрос

Для защищенного соединения в 1С используются объекты HTTPСоединение и HTTPЗапрос. В настройках необходимо оставить включенной проверку сертификатов сервера, задать адрес API-метода, метод POST и заголовок с типом содержимого application/json.

Перед вызовом API платформа получает данные документа, проверяет согласие получателя, нормализует телефон и подставляет текст в шаблон. В JSON включаются только предусмотренные провайдером поля: номер, текст, имя отправителя и дополнительные параметры. Ошибочные данные лучше отклонять до отправки, чтобы не расходовать лимит на недоставленные сообщения.

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

Обработка ответов и ошибок

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

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

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

Автоматизация процессов и контроль коммуникаций

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

Для иллюстрации разделения внешних данных и прикладного решения подойдет материал о веб-аналитике, хотя формат запросов SMSClub и обработка ответа требуют собственной реализации.

Если проект шире отправки уведомлений, стоит рассмотреть KUBiK — продукт компании для автоматизации учетных и бизнес-процессов. Совместно с интеграционным контуром 1С его можно использовать для связки заявки, согласований, клиентской базы и последующих коммуникаций.

Безопасность и эксплуатационные ограничения

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

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

При расчете бюджета учитываются цена сообщения, платный номер отправителя, повторные попытки и доля недоставленных уведомлений. Сервисный лимит требует очередности и пауз между пачками запросов. Резервный сценарий полезен при недоступности SMS-провайдера, особенно для сообщений о срочных платежах или изменениях в заказе.

Практические рекомендации для пилотного запуска

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

Запустите пилот на тестовых номерах, зафиксируйте результаты и опубликуйте схему обмена на форуме. Описанный подход к проверке, ошибкам и журналированию поможет участникам быстрее адаптировать собственную интеграцию 1С к SMSClub или другому API-сервису.