Как подключить Битрикс24 к SMS-шлюзу через API

Подключение Битрикс24 к SMS-шлюзу через API позволяет автоматически сообщать клиенту о новой заявке, смене этапа сделки и готовности заказа. В статье разберём рабочую схему для интернет-магазина: какие данные подготовить, где поставить триггеры, как передавать номер и текст сообщения, что проверить до запуска. После настройки менеджеру не придётся вручную копировать телефон из CRM и отправлять каждое уведомление отдельно.

Какие уведомления стоит автоматизировать в Битрикс24?

Начните с событий, которые клиенту действительно полезно получить сразу. Для интернет-магазина это обычно подтверждение заявки, сообщение о передаче заказа в обработку, уведомление об отправке и напоминание о готовности к выдаче. Если заказ отменили или по нему потребовалось уточнение, CRM тоже может передать это событие в SMS-сценарий.

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

Сценарий лучше описать на бумаге до технической настройки: какое событие запускает отправку, кому уходит SMS, какой шаблон используется и что происходит при ошибке. Для общего понимания возможностей CRM пригодится инструкция по настройке транзакционных SMS из Битрикс24.

Что подготовить до подключения SMS API?

Сначала зарегистрируйте доступ к SMS-шлюзу и получите параметры API. Обычно это ключ или логин с паролем, адрес метода отправки, имя отправителя и правила формирования запроса. Точные названия полей зависят от провайдера, поэтому их берут из документации конкретного сервиса.

Для теста подготовьте один номер сотрудника и несколько шаблонов. Не начинайте с большой базы клиентов: сначала нужно проверить, как CRM передаёт номер, как кодируются русские буквы и какой ответ возвращает шлюз. В кабинете также должна быть доступна история отправок, чтобы сопоставить заявку в Битрикс24 с результатом доставки.

• Опишите этапы сделки, которые должны запускать SMS.
• Проверьте, где в карточке сделки хранится мобильный номер клиента.
• Составьте короткие тексты для каждого события.
• Получите API-ключ и данные для авторизации.
• Определите, кто будет смотреть ошибки и отчёты.

Ключ API нельзя помещать в открытый текст сделки, комментарий или шаблон сообщения. Его хранят в настройках интеграции либо на сервере, который выполняет запрос к шлюзу. Если подключение делает подрядчик, доступ к ключу передают через защищённый канал, а после тестового периода проверяют, где он сохранён.

Как проходит подключение Битрикс24 к SMS-шлюзу?

Интеграция строится по цепочке: событие в Битрикс24 запускает обработчик, обработчик собирает данные клиента, затем отправляет запрос в SMS-шлюз и записывает результат. API здесь выступает связующим звеном между CRM и сервисом сообщений.

1. Выберите событие. Например, сделка перешла на этап «Заказ подтверждён». Для каждого этапа задайте собственное условие, чтобы одно и то же SMS не отправлялось при каждом изменении карточки.
2. Получите данные сделки. Интеграции понадобятся номер телефона, имя клиента, номер заказа и название нового статуса. Если поле пустое, запрос лучше остановить и записать причину в журнал.
3. Соберите текст. В шаблон подставляются значения из CRM: имя, номер заказа, дата или ссылка. Сначала отправьте тестовый текст без сложной персонализации, затем добавляйте динамические поля по одному.
4. Сформируйте API-запрос. Передайте ключ доступа, номер получателя, текст и имя отправителя в формате, который указан в документации шлюза. Ошибка в названии параметра приведёт к отказу даже при правильном ключе.
5. Разберите ответ. Интеграция должна различать успешную постановку сообщения в очередь, ошибку авторизации, неверный номер и временную проблему сервиса. Один общий статус «ошибка» затрудняет поиск причины.
6. Запишите результат. В карточке сделки или журнале сохраните дату отправки, событие и идентификатор сообщения. Так менеджер увидит, было ли уведомление инициировано системой.

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

Если магазин работает на WooCommerce, CRM может получать данные о заказе из отдельной интеграции, а SMS отправляется уже после изменения статуса в Битрикс24. Для сравнения логики статусов полезно посмотреть материал о SMS-уведомлениях о статусе заказа в WooCommerce: принцип событий и шаблонов там похож, хотя техническое подключение отличается.

Как проверить автоматические SMS до запуска?

Тестирование проводите по одному сценарию. Создайте тестовую сделку, заполните номер сотрудника и переведите её на нужный этап. Затем проверьте четыре результата: изменился ли статус сделки, сформировался ли правильный текст, пришло ли сообщение и появилась ли запись в журнале.

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

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

• Сравните номер в карточке Битрикс24 с номером, который получил шлюз.
• Проверьте подстановку имени и номера заказа.
• Убедитесь, что кириллица отображается без повреждений.
• Посмотрите, не отправляется ли одно событие дважды.
• Сверьте журнал CRM с отчётом SMS-сервиса.

После теста задайте небольшой период наблюдения. Проверяйте не только факт отправки, но и соответствие статуса в CRM результату у SMS-провайдера. Если уведомление о доставке посылки нужно связать с отдельным сервисом, поможет инструкция по настройке SMS о статусе доставки.

Какие ошибки чаще всего мешают интеграции?

• Триггер поставили на любое изменение сделки. Менеджер меняет комментарий или сумму, и система повторно отправляет клиенту старый статус. Условие нужно привязать к конкретному этапу.
• Телефон хранится в разных полях. В одной карточке заполнен мобильный номер, в другой контактный телефон. Интеграция должна использовать одно согласованное поле или понятное правило выбора.
• Шаблон получился слишком длинным. До запуска проверьте длину текста и отображение кириллицы. Разделение сообщения на несколько частей меняет подсчёт отправок и восприятие уведомления.
• Нет журнала действий. Без даты, события и ответа шлюза трудно понять, на каком этапе возникла проблема. Минимальный лог экономит время при разборе каждого сбоя.
• Ключ API разместили в коде без защиты. Доступ к шлюзу нельзя оставлять в публичном репозитории или передавать через комментарии CRM.
• Не предусмотрена временная ошибка. Если шлюз кратко недоступен, обработчик должен зафиксировать сбой и применить согласованный сценарий повторной попытки.

Для малого интернет-магазина обычно достаточно начать с двух событий: подтверждения заказа и изменения статуса доставки. После проверки можно добавить уведомления о готовности к выдаче, отмене и других этапах. Такой порядок снижает число переменных и помогает быстро найти ошибку в связке Битрикс24 и SMS API.