API 1MSG: новая основа для интеграций с WhatsApp

Если вы уже интегрированы с 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, улучшенные инструменты для разработчиков и бэкенд, который мы можем развивать с уверенностью.