API
API 1MSG: новая основа для интеграций с WhatsApp
Мы завершили одно из крупнейших изменений бэкенда в истории 1MSG. Теперь 1MSG API работает на всей нашей производственной инфраструктуре — современном типизированном сервисе на базе NestJS и TypeScript.
Nikita L ·
Если вы уже интегрированы с 1MSG, ничего не нарушится. Ваши точки взаимодействия, URL, токены и форматы ответов работают как прежде. Изменения коснулись почти исключительно внутренних механизмов — и в этом вся суть.
Почему мы перестроили бэкенд
Наш API прекрасно служил клиентам, но технологии, на которых он был построен, устарели: JavaScript, слабая связь контракта и реализации, растущая сложность с добавлением каждого нового типа сообщения и крайние случаи в эксплуатационной среде.
1MSG API — это не запуск нового продукта. Это выпуск платформы: тот же публичный API, на который вы полагаетесь сегодня, но перестроенный на основе, разработанной для масштабирования, развития и безопасной работы.
Какие изменения были «под капотом»
1. Полная замена ядра производства
Мы не стали исправлять старый сервис — мы заменили его.
Весь флот серверов каналов теперь работает на версиях контейнерных образов, которые разворачиваются в нашем CI/CD-пайплайне через управляемые и воспроизводимые развертывания.
Это полное изменение в работе и развертывании, а не косметический рефакторинг.
2. Архитектура, основанная на контрактах: OpenAPI как основной источник данных
The new stack is built OpenAPI-first. The API specification is no longer documentation that chases the code — it is the code generator.
Из одного контракта мы создаем:
- Серверные контроллеры
- Типизированный TypeScript SDK
- Сервер MCP для интеграции с агентом и IDE
Сгенерированный транспортный слой (маршрутизация, валидация, типы) четко отделен от бизнес-логики. Один процесс генерации поддерживает сервер, SDK и инструменты в актуальном состоянии при изменении API.
3. Плавный перенос без нарушения существующих интеграций
Самое сложное в переписывании бэкенда — не написание нового кода, а сохранение поведения, сложившегося за много лет.
Мы перенесли и проверили все, что нужно нашим нынешним клиентам:
- Потоки сообщений: текст, медиа, шаблоны, кнопки, списки, контакты, местоположение, реакции, карусель, продукты и Flows WhatsApp
- Входящие вебхуки, обновления статуса, подтверждения и переадресация вебхуков клиентам
- Groups API, поведение прокси WABA и многое другое
- Разрешение токенов из параметров запроса, тела и заголовков авторизации
- Оригинальный вид URL:
https://api.1msg.io/{instanceId}/...?token=... - Паритет HTTP-ответов: коды состояний, тела ошибок, псевдонимы эндпоинтов и поведение при блокировке подписки
- Обработка предварительного запроса CORS перед аутентификацией
До первого развертывания для пользователей в рабочей среде (19 июня 2026 года) мы проводили канареечные развертывания, smoke-тесты и проверки на соответствие. Полное развертывание завершилось 2 июля 2026 года.
Итог
Мы создали новую платформу, перевели на нее все наши рабочие системы и сохранили полную обратную совместимость с существующими интеграциями.
API 1MSG — это основа всего, что будет дальше: более безопасные изменения API, улучшенные инструменты для разработчиков и бэкенд, который мы можем развивать с уверенностью.