Начните с одного события: например, отправляйте SMS, когда заказ готов к выдаче. Для этого приложению нужен серверный модуль, который обращается к SMS-сервису через API и проверяет ответ. ИИ поможет написать такой модуль, но правила отправки и проверку ошибок нужно задать отдельно. Ниже — порядок работы для предпринимателя и разработчика: как описать задачу, проверить код после вайбкодинга и запустить уведомления без повторных сообщений при каждом нажатии кнопки.
Что подготовить до того, как просить ИИ написать код?
Опишите момент отправки обычными словами. «Подключить SMS к сайту» — слишком широкая задача. «После перехода заказа в статус “Готов к выдаче” отправить покупателю уведомление» уже задаёт понятную границу. Для первого запуска выберите одно событие и один шаблон сообщения.
Затем определите, откуда приложение узнаёт об этом событии. В интернет-магазине это смена статуса заказа, в сервисной мастерской — отметка сотрудника о готовности работы. Просмотр карточки или обновление страницы не должны запускать отправку.
Короткое техническое задание можно собрать в такой последовательности:
- Назовите событие: сотрудник переводит заказ в статус «Готов к выдаче».
- Укажите источник номера: поле телефона в конкретном заказе.
- Напишите шаблон: «Заказ {номер} готов к выдаче. Время работы: {часы}».
- Определите защиту от повторов: одно уведомление для этого перехода статуса.
- Опишите результат для сотрудника: запрос принят сервисом, отклонён или требует проверки.
Такое описание пригодится и для самостоятельной работы с ИИ, и для передачи задачи разработчику. В нём уже видны границы доработки: серверная функция, связь со статусом заказа и экран с результатом отправки. Обсуждать объём работы проще по этому списку, чем по обещанию «добавить рассылку».
Как дать ИИ документацию и не получить выдуманный API?
Передайте ИИ актуальное описание метода отправки. Попросите использовать только параметры из документации и отдельно перечислить вопросы, на которые она не отвечает. Модель умеет дописывать правдоподобные названия методов, поэтому красивый код ещё не подтверждает, что сервис примет запрос.
Технические детали для интеграции можно сверить в статье на rocketsms.by. Перед разработкой проверьте способ авторизации, формат тела запроса и значение ответа. Не поручайте ИИ восстанавливать эти детали по памяти.
В исходном описании интеграции есть существенная деталь: тело запроса передают как поля формы, хотя ответ приходит в JSON. Разработчику нужно проверить оба формата отдельно. Если автоматически отправить JSON только потому, что сервис возвращает JSON, запрос может не соответствовать документации.
Для первого задания подойдёт такой текст:
«Напиши серверный модуль отправки SMS по приложенной документации. Реквизиты доступа получай из переменных окружения. Добавь ограничение времени ожидания, проверку HTTP-ответа и разбор ответа сервиса. Предусмотри тестовый режим без реальной отправки. Не добавляй автоматические повторы, пока мы не определим, как исключать дубли. Сначала покажи план и список файлов, которые изменишь».
Попросите ИИ вынести обращение к сервису в отдельную функцию. Тогда смена шаблона сообщения не потребует переписывать сетевой запрос, а тесты смогут подменять ответ сервиса. Для небольшой доработки это понятная граница: бизнес-правило решает, когда отправлять, отдельный модуль отвечает за сам запрос.
Как проверить безопасность и результат отправки?
Запускайте запрос к SMS-сервису на сервере. Браузер передаёт вашему приложению команду, а сервер проверяет право пользователя на действие и обращается к провайдеру. Реквизиты доступа не должны попадать в код страницы, публичный репозиторий или переписку с ИИ.
Используйте переменные окружения или механизм секретов, который поддерживает ваша среда запуска. В примере конфигурации оставьте только названия переменных без значений. Отдельно попросите ИИ проверить, не выводит ли отладочный код пароль вместе с телом запроса.
Разделяйте технический ответ и результат бизнес-действия. Успешный HTTP-ответ ещё не доказывает, что сервис принял сообщение: внутри ответа может находиться ошибка. Идентификатор сообщения тоже не стоит показывать сотруднику как подтверждение доставки. Подтверждение доставки требует отдельной проверки, если сервис её поддерживает.
На экране достаточно понятных состояний: «Запрос принят сервисом», «Сервис отклонил запрос», «Результат неизвестен». Последнее состояние нужно для случая, когда приложение не дождалось ответа. Причина может быть в соединении, хотя сервис уже получил запрос.
Вот почему автоматический повтор после тайм-аута требует отдельного решения. Сначала проверьте, какие средства поиска сообщения и защиты от дублей предоставляет API. Если однозначной проверки нет, покажите сотруднику неопределённый результат и предложите проверить отправку перед повтором.
Как протестировать SMS-интеграцию после вайбкодинга?
Начните с тестового режима: приложение формирует запрос, но вместо реальной отправки получает заранее заданный ответ. Так можно проверить поведение интерфейса и бизнес-правила, не отправляя SMS при каждом исправлении кода. Реальный запрос оставьте для отдельной проверки на своём тестовом номере.
Попросите ИИ написать тесты по следующим сценариям:
- Сервис принимает запрос: приложение сохраняет идентификатор и показывает корректный статус.
- Сервис возвращает ошибку: сотрудник видит отказ, а заказ не получает отметку об успешном уведомлении.
- Ответ не приходит вовремя: приложение показывает неопределённый результат и не запускает бесконечные повторы.
- Сотрудник повторно нажимает кнопку: приложение блокирует повтор для того же события.
- Сервис возвращает неожиданный формат: приложение обрабатывает сбой без остановки всей страницы.
Проверьте защиту от дублей на сервере. Отключение кнопки в браузере помогает при повторном клике, но не закрывает одновременные запросы из разных вкладок. В задании разработчику свяжите уведомление с конкретным заказом и конкретным событием, затем попросите проверить одновременный запуск.
После тестов выполните одну реальную отправку на свой номер. Сравните текст, статус в приложении и сведения в кабинете сервиса. Уже работающая интеграция должна показывать понятный результат, а повторное выполнение того же действия — соблюдать выбранное правило защиты от дублей.
Если доработку принимает другой разработчик, передайте ему сценарии проверки вместе с кодом. Такой набор помогает оценить результат вайбкодинга предметно: какие действия запускают запрос, как приложение переживает сбой и где сотрудник видит причину ошибки.
Типичные ошибки при подключении SMS через ИИ
- Просить «сразу готовое решение» без документации. ИИ заполняет пробелы предположениями. Приложите описание API и потребуйте отметить всё, что ещё нужно уточнить.
- Отправлять SMS при открытии карточки заказа. Обновление страницы запускает действие повторно. Привяжите уведомление к явному событию или отдельной команде.
- Считать любой ответ сервера успехом. Проверяйте и HTTP-статус, и содержимое ответа SMS-сервиса.
- Повторять запрос после каждого сетевого сбоя. Сначала выясните результат предыдущей попытки и определите правило для неопределённого статуса.
- Принимать работу только по одному доставленному сообщению. Добавьте проверку отказа сервиса, тайм-аута и повторного нажатия.
Для первого запуска достаточно одного сценария с понятным результатом и проверкой ошибок. Расширять уведомления проще после того, как этот путь проходит тесты. Сейчас потратьте две минуты: запишите одной фразой, какое событие в вашем приложении должно запускать первое SMS, и добавьте к ней текст сообщения.



