Как подключить SMS к бизнес-приложению с помощью ИИ?

Как подключить SMS к бизнес-приложению с помощью ИИ?

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

Что подготовить до того, как просить ИИ написать код?

Опишите момент отправки обычными словами. «Подключить SMS к сайту» — слишком широкая задача. «После перехода заказа в статус “Готов к выдаче” отправить покупателю уведомление» уже задаёт понятную границу. Для первого запуска выберите одно событие и один шаблон сообщения.

Затем определите, откуда приложение узнаёт об этом событии. В интернет-магазине это смена статуса заказа, в сервисной мастерской — отметка сотрудника о готовности работы. Просмотр карточки или обновление страницы не должны запускать отправку.

Короткое техническое задание можно собрать в такой последовательности:

  1. Назовите событие: сотрудник переводит заказ в статус «Готов к выдаче».
  2. Укажите источник номера: поле телефона в конкретном заказе.
  3. Напишите шаблон: «Заказ {номер} готов к выдаче. Время работы: {часы}».
  4. Определите защиту от повторов: одно уведомление для этого перехода статуса.
  5. Опишите результат для сотрудника: запрос принят сервисом, отклонён или требует проверки.

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

Как дать ИИ документацию и не получить выдуманный API?

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

Технические детали для интеграции можно сверить в статье на rocketsms.by. Перед разработкой проверьте способ авторизации, формат тела запроса и значение ответа. Не поручайте ИИ восстанавливать эти детали по памяти.

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

Для первого задания подойдёт такой текст:

«Напиши серверный модуль отправки SMS по приложенной документации. Реквизиты доступа получай из переменных окружения. Добавь ограничение времени ожидания, проверку HTTP-ответа и разбор ответа сервиса. Предусмотри тестовый режим без реальной отправки. Не добавляй автоматические повторы, пока мы не определим, как исключать дубли. Сначала покажи план и список файлов, которые изменишь».

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

Как проверить безопасность и результат отправки?

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

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

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

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

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

Как протестировать SMS-интеграцию после вайбкодинга?

Начните с тестового режима: приложение формирует запрос, но вместо реальной отправки получает заранее заданный ответ. Так можно проверить поведение интерфейса и бизнес-правила, не отправляя SMS при каждом исправлении кода. Реальный запрос оставьте для отдельной проверки на своём тестовом номере.

Попросите ИИ написать тесты по следующим сценариям:

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

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

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

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

Типичные ошибки при подключении SMS через ИИ

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

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