Какие данные передавать из Битрикс24 в сервисное SMS?

Какие данные передавать из Битрикс24 в сервисное SMS?

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

Какое событие в Битрикс24 должно запускать SMS?

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

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

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

Условия запуска настройте через доступный механизм автоматизации или интеграционный модуль. Возможности зависят от вашей версии Битрикс24 и выбранного подключения, поэтому сначала проверьте, умеет ли оно реагировать на нужное событие. Общая последовательность подключения описана в статье на mpb.by; для передачи данных дополнительно понадобится согласовать поля карточки с полями запроса.

Какие поля нужны для отправки сервисного SMS?

Разделите данные на две группы: что нужно клиенту в тексте и что нужно интеграции для контроля. Клиенту достаточно понять, что произошло и куда обращаться. Технические идентификаторы оставьте в журнале отправок.

Для работы SMS из Битрикс24 в Беларуси нужны сама CRM, зарегистрированное буквенное имя отправителя у белорусских операторов и интеграционный модуль SMS-провайдера (источник: smsinfo.by, «Как настроить SMS-уведомления из Битрикс24 в Беларуси?»). При прямой интеграции по API отдельно уточните у провайдера способ подключения и формат запроса.

  • Событие: причина отправки, например готовность заказа или перенос визита. Оно определяет сценарий и шаблон.
  • Номер клиента: мобильный телефон конкретного получателя. Заранее определите поле, из которого интеграция его берёт.
  • Шаблон и переменные: текст сообщения и значения, которые система подставит вместо обозначений в фигурных скобках.
  • Идентификатор события: значение для проверки повторов. Повторная попытка отправить то же уведомление должна сохранять связь с исходным событием.
  • Связь с CRM: идентификатор сделки или заказа, по которому менеджер найдёт результат отправки.

Названия этих полей здесь условные. Один сервис принимает готовый текст, другой работает с шаблоном и отдельными переменными. Перед настройкой попросите интегратора показать соответствие: поле Битрикс24 → поле запроса → значение в SMS. Например, «адрес выдачи» должен браться из точки получения заказа, а не из адреса клиента.

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

Как связать номер клиента с переменными шаблона?

Сначала определите получателя. В карточке могут быть телефоны покупателя, представителя организации и человека, который заберёт заказ. Правило «взять первый доступный номер» здесь ненадёжно: SMS о выдаче получит человек, который не планировал приезжать.

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

Для шаблона о выдаче можно взять такой текст: «Заказ {номер_заказа} готов. Забрать: {адрес_выдачи}. Часы работы: {часы_работы}». Фигурные скобки обозначают места подстановки, а не обязательный синтаксис API. Реальный формат задаёт документация интеграции.

У каждой переменной должен быть конкретный источник. Номер заказа берите из поля заказа, адрес и часы работы — из выбранной точки выдачи. Если сотрудник каждый раз вводит адрес вручную, опечатка из карточки попадёт и в SMS.

Перед отправкой проверьте итоговый текст целиком. Пустое значение не должно превращать уведомление в «Забрать: .». Для обязательных полей задайте остановку отправки с понятной причиной, а для необязательных подготовьте отдельный вариант текста. Если имя клиента не заполнено, сообщение без обращения останется понятным.

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

Как проверить отправку и увидеть результат в CRM?

Проверьте всю цепочку на собственном тестовом номере: событие в CRM, запрос в сервис, текст на телефоне и результат в карточке. Ответ «запрос принят» ещё не подтверждает доставку. Уточните, как провайдер возвращает статусы: через отдельный запрос или уведомление интеграции.

В отчёте должны быть видны номер заказа, время события, шаблон, результат доставки и причина ошибки, если сообщение не дошло (источник: smsinfo.by, «Как настроить сервисные SMS для пункта выдачи»). Дополнительно свяжите запись отчёта с идентификатором сообщения у провайдера: по нему проще разбирать конкретную отправку.

  1. Создайте тестовый заказ с собственным мобильным номером и заполните обязательные поля.
  2. Запустите выбранное событие и сравните SMS с данными карточки.
  3. Повторите обработку того же события и проверьте защиту от дублирования.
  4. Уберите обязательную переменную и убедитесь, что менеджер видит причину остановки.
  5. Проверьте возврат статуса и переход из записи об отправке к нужному заказу.

Защиту от повторов согласуйте отдельно. Если ответ сервиса потерялся, интеграция не должна сразу создавать новое сообщение, не проверив судьбу предыдущего. Для этого используют идентификатор события и доступные у провайдера способы проверки запроса.

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

Типичные ошибки: что проверить перед запуском?

  • Слишком широкий триггер. SMS уходит после любого изменения карточки. Ограничьте запуск конкретным событием и проверяйте актуальный статус заказа перед отправкой.
  • Неоднозначный получатель. Интеграция выбирает случайный телефон из нескольких контактов. Закрепите источник номера в правиле сценария.
  • Пустые или устаревшие переменные. В сообщении нет адреса либо осталось прежнее время визита. Проверяйте обязательные поля и обновляйте отложенные уведомления после переноса.
  • Повторная отправка без контроля. Один заказ вызывает одинаковые SMS после повторной обработки. Свяжите попытки с идентификатором события и задайте правило обработки повторов.
  • Нет результата в CRM. Менеджер видит запуск автоматизации, но не знает судьбу сообщения. Верните статус доставки и причину ошибки в карточку или связанный журнал.

Задание на интеграцию по API удобно проверять по конкретным результатам: откуда система берёт номер, какие поля подставляет в текст и где показывает доставку. Это же помогает очертить работу SMS-сервиса: принять событие, отправить уведомление и вернуть статус. До запуска уточните, какие из этих действий выполняет готовый модуль, а какие нужно настроить отдельно.

Следующий шаг на две минуты: откройте одну карточку заказа в Битрикс24 и выпишите названия полей с телефоном получателя, номером заказа и адресом выдачи. Эти поля станут основой первого шаблона.