Как подключить SMS к сайту и CRM через API?

Как подключить SMS к сайту и CRM через API?

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

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

Опишите один сценарий обычными словами: «Когда сотрудник меняет статус заказа на “Готов к выдаче”, клиент получает сообщение». Такая формулировка задаёт разработчику точное условие. Фраза «подключить рассылку к CRM» оставляет слишком много вопросов: кто запускает отправку, какие события учитывать и что делать после повторного изменения статуса.

Для первого сценария составьте короткое задание. Его можно оформить в рабочем документе без технических терминов.

  1. Назовите событие, после которого нужно сообщение: подтверждение записи, готовность заказа или изменение времени доставки.
  2. Укажите систему, которая первой узнаёт о событии: сайт, CRM или приложение сотрудника.
  3. Напишите текст SMS и отметьте переменные, например номер заказа или время визита.
  4. Определите, когда сообщение уже бесполезно и его нужно исключить из очереди.
  5. Назначьте сотрудника, который увидит ошибки и решит, нужен ли звонок клиенту.

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

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

Как устроить отправку и проверить ответ сервиса?

Запрос к SMS-сервису отправляет серверная часть сайта или отдельное приложение. Браузеру посетителя эту работу поручать не следует: реквизиты доступа окажутся доступны пользователю. Разработчик размещает настройки на сервере и исключает их из открытого кода и журналов ошибок.

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

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

В исходном описании интерфейса успешный ответ содержит поле id, а ответ с ошибкой — поле error. Это полезная деталь для проверки интеграции. Наличие идентификатора означает, что сервис принял запрос на отправку; само по себе оно ещё не подтверждает доставку на телефон. Способ получения статуса доставки нужно отдельно уточнить в документации.

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

Как связаны SMS, облачный сервер и интернет в офисе?

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

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

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

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

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

Что проверить перед запуском и как оценить расходы?

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

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

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

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

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

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

Типичные ошибки при интеграции SMS

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

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