[{"data":1,"prerenderedAt":14},["ShallowReactive",2],{"$fFjhFRwKXNOPIEJ5l4IDeg2Zg2GpYQjMNdCPSTOv4bTI":3},{"slug":4,"title":5,"published":6,"publishedAt":7,"section":8,"preview":9,"heroImage":10,"previewImage":11,"bodyMd":12,"bodyHtml":13},"sms-konnektor-bitrix24-za-4-chasa","Как мы сделали SMS-коннектор для Битрикс24 за 4 часа, когда стандартный сломался",true,"22.06.2026 12:02:01","Статьи","Утро понедельника, клиент в панике — стандартная SMS-интеграция в Битрикс24 перестала работать. Через 3 часа 52 минуты мы написали и запустили свой коннектор...",null,"\u002Fmedia\u002Farticles\u002F0b92193d2565.png","\n# Как мы сделали SMS-коннектор для Битрикс24 за 4 часа, когда стандартный сломался\n\nУтро понедельника. Клиент пишет: «Глеб, добрый день! Критически важно. Можем настроить смс отправки в Битрикс?» Это была команда Джобазавра — компании, которая задаёт стандарты в hr-маркетинге и не привыкла ждать, когда что-то ломается. Стандартная интеграция через Маркет перестала работать. Провайдер сказал: «Только если интегратор вам напрямую настроит». SMS-рассылки нужны здесь и сейчас.\n\nЧерез 3 часа 52 минуты приложение было готово, установлено и отправляло тестовые сообщения. Ещё через 40 минут клиент написал: «Работает!» с десятком эмодзи-впечатлений.\n\nЯ хочу рассказать, что именно сломалось, как мы собрали замену за одно утро и почему прямой коннектор через API часто выигрывает у готовых приложений из Маркета.\n\n## Что случилось со стандартной интеграцией\n\nКлиент работал с SMS Aero — типовой российский SMS-провайдер. В Маркете Битрикс24 стояло готовое приложение для интеграции. В какой-то момент оно перестало отправлять сообщения. Провайдер посоветовал другое приложение из Маркета — то же самое, не работает.\n\nПочему так вышло: готовые коннекторы в Маркете обычно используют авторизацию через API-ключ по схеме, которую разработчик зашил на старте. Провайдер меняет метод аутентификации или обновляет формат запросов — приложение отваливается. Разработчик может не успеть выпустить обновление. А клиенту SMS нужны прямо сейчас.\n\nПри этом у SMS Aero открытый API с нормальной документацией. Методы рабочие, эндпоинты живые. Просто готовый коннектор отстал.\n\n## Как работает самописный коннектор\n\nМы не чинили чужое приложение. Написали своё. Прямое подключение к API SMS Aero плюс нативная регистрация SMS-провайдера в Битрикс24.\n\n![Главная страница приложения SmsAero в Битрикс24](\u002Fmedia\u002Farticles\u002F0b92193d2565.png)\n\nСхема такая:\n\n- Приложение устанавливается на портал через Маркет\n- Администратор вводит email, API-ключ и подпись отправителя\n- Приложение регистрирует в Битрикс24 провайдера с кодом `smsAero`\n- Все SMS из CRM — роботы, бизнес-процессы, ручные отправки — идут через этого провайдера\n- Статусы доставки возвращаются через callback на URL приложения\n\nНикаких промежуточных серверов. Приложение — просто прослойка между API Битрикс24 и API провайдера. Битрикс24 считает, что отправляет SMS стандартным способом. На деле каждое сообщение уходит напрямую в SMS Aero.\n\n## Где приложение появляется в CRM\n\nПосле установки SMS-провайдер регистрируется на уровне портала. Все инструменты, которые умеют слать SMS, подхватывают его автоматически. Донастраивать ничего не надо.\n\nКонкретные точки входа:\n\n- Карточка сделки, лида и контакта — кнопка отправки SMS прямо из карточки\n- Роботы и бизнес-процессы — автоотправка при смене стадии, назначении ответственного, по таймеру\n- Список контактов — массовая рассылка с фильтрацией\n- Центр продаж — отправка SMS из интерфейса работы с клиентом\n\n![Панель настроек SMS-провайдера](\u002Fmedia\u002Farticles\u002Fff35818bca6a.png)\n\n## Хронология: от сообщения до работающих SMS\n\nВот как это выглядело по минутам:\n\n| Время | Событие |\n|---|---|\n| 9:49 | Клиент: «стандартная интеграция сломалась» |\n| 9:51 | Выяснили провайдера — SMS Aero, API открытый |\n| 10:39 | Решили: делаем своё приложение |\n| 10:44 | Получили документацию API |\n| 10:46 | Клиент прислал API-ключ |\n| 13:02 | Приложение опубликовано, клиент устанавливает |\n| 13:15 | Настройки заполнены |\n| 13:18 | Поймали ошибку авторизации, сразу поправили |\n| 13:27 | Тестовое SMS ушло и доставлено |\n| 13:41 | Клиент подтвердил: всё работает |\n\n![Статус интеграции — провайдер установлен](\u002Fmedia\u002Farticles\u002F5128d37a973a.png)\n\n3 часа 52 минуты от первого сообщения до боевой отправки. С перерывом на обед и одной ошибкой, которую поймали и поправили за 3 минуты.\n\n## Что ломается чаще всего\n\nКогда делаешь не первый SMS-коннектор, уже знаешь, где будут грабли. Вот что вылезает почти каждый раз:\n\n**1. Авторизация не совпадает.** Провайдер ждёт Basic Auth (логин:пароль прямо в URL), а коннектор шлёт ключ в заголовке. Или наоборот. Результат — 400 Bad Request без внятного объяснения. Лечится сравнением документации с фактическим форматом запроса.\n\n**2. Кривой callback URL.** Битрикс24 ждёт статусы доставки на свой эндпоинт. Если URL обработчика указан с ошибкой или приложение висит на сервере, который не виден из интернета — статусы не доходят. Все SMS висят в статусе «отправлено», подтверждения нет. Проверять доступность URL обработчика снаружи — первое, что надо сделать при отладке.\n\n**3. Email не подтверждён у провайдера.** Некоторые провайдеры требуют не только API-ключ, но и подтверждённый email в личном кабинете. Ключ валидный, а API отвечает ошибкой. Выглядит как магия, лечится звонком в поддержку.\n\n**4. Тестовый режим на боевом портале.** Классика. Приложение шлёт SMS, провайдер принимает, деньги списываются — но абоненту ничего не приходит. Потому что тестовый режим. Всегда проверяйте этот переключатель перед переводом в бой.\n\n**5. Не зарегистрирована подпись отправителя.** Провайдер блокирует сообщения без зарегистрированного имени. Ваше SMS уходит с «SMS Aero» вместо названия компании — или не уходит вообще.\n\n## Сравнение с альтернативами\n\n| Подход | Скорость запуска | Надёжность | Гибкость |\n|---|---|---|---|\n| Готовое приложение из Маркета | Минуты | Зависит от разработчика | Ограничена настройками |\n| Самописный коннектор | Часы | Вы контролируете код | Полная — любые методы API |\n| Ручная отправка через ЛК | Мгновенно | Человеческий фактор | Никакой автоматизации |\n| Внешний сервис + вебхуки | Дни | Зависит от двух интеграций | Средняя |\n\nГотовое приложение выигрывает по скорости установки — это правда. Но когда оно ломается, вы сидите и ждёте, пока разработчик выпустит обновление. С самописным коннектором вы зависите только от себя. Провайдер поменял API — поправили код, задеплоили, работаем дальше.\n\nРучная отправка через личный кабинет — крайний случай на один день. Разовые сообщения отправить можно. Но роботы не работают, массовые рассылки превращаются в ад. Для бизнеса, где SMS встроены в процессы, это не вариант.\n\n## Когда свой коннектор оправдан\n\nНе каждый случай требует разработки. Мы пишем коннектор только если совпало несколько условий:\n\n- Готовое приложение не работает или не закрывает нужные сценарии\n- У провайдера открытый и документированный API\n- SMS критичны для бизнеса — простой в пару дней неприемлем\n- Нужна нестандартная логика: выбор провайдера по номеру, роутинг, приоритеты\n\nЕсли всё четыре условия выполняются — пишем свой коннектор. Если нет — ставим готовый и не усложняем.\n\nВ этом конкретном случае совпало всё: приложение из Маркета не работало, API открытый, клиенту нужно было вчера, стандартная схема не подходила. Поэтому уложились в 4 часа.\n\n## Заключение\n\nСтандартные интеграции ломаются. Это не редкость, это норма. Провайдеры меняют API, разработчики не успевают обновлять приложения. Бизнес остаётся без SMS именно тогда, когда они нужны.\n\nПрямой коннектор через API решает проблему кардинально. Да, это несколько часов работы. Но вы получаете инструмент, который не сломается при следующем апдейте провайдера. И который можно допилить под любые сценарии — от триггерных уведомлений до массовых рассылок по сегментам.\n\nЕсли ваша SMS-интеграция перестала работать или вы только планируете её — не ждите. За 4 часа можно написать свой коннектор. Работает надёжно, не зависит от чужого кода, не ломается при обновлениях на стороне провайдера.\n","\u003Ch1>Как мы сделали SMS-коннектор для Битрикс24 за 4 часа, когда стандартный сломался\u003C\u002Fh1>\n\u003Cp>Утро понедельника. Клиент пишет: «Глеб, добрый день! Критически важно. Можем настроить смс отправки в Битрикс?» Это была команда Джобазавра — компании, которая задаёт стандарты в hr-маркетинге и не привыкла ждать, когда что-то ломается. Стандартная интеграция через Маркет перестала работать. Провайдер сказал: «Только если интегратор вам напрямую настроит». SMS-рассылки нужны здесь и сейчас.\u003C\u002Fp>\n\u003Cp>Через 3 часа 52 минуты приложение было готово, установлено и отправляло тестовые сообщения. Ещё через 40 минут клиент написал: «Работает!» с десятком эмодзи-впечатлений.\u003C\u002Fp>\n\u003Cp>Я хочу рассказать, что именно сломалось, как мы собрали замену за одно утро и почему прямой коннектор через API часто выигрывает у готовых приложений из Маркета.\u003C\u002Fp>\n\u003Ch2>Что случилось со стандартной интеграцией\u003C\u002Fh2>\n\u003Cp>Клиент работал с SMS Aero — типовой российский SMS-провайдер. В Маркете Битрикс24 стояло готовое приложение для интеграции. В какой-то момент оно перестало отправлять сообщения. Провайдер посоветовал другое приложение из Маркета — то же самое, не работает.\u003C\u002Fp>\n\u003Cp>Почему так вышло: готовые коннекторы в Маркете обычно используют авторизацию через API-ключ по схеме, которую разработчик зашил на старте. Провайдер меняет метод аутентификации или обновляет формат запросов — приложение отваливается. Разработчик может не успеть выпустить обновление. А клиенту SMS нужны прямо сейчас.\u003C\u002Fp>\n\u003Cp>При этом у SMS Aero открытый API с нормальной документацией. Методы рабочие, эндпоинты живые. Просто готовый коннектор отстал.\u003C\u002Fp>\n\u003Ch2>Как работает самописный коннектор\u003C\u002Fh2>\n\u003Cp>Мы не чинили чужое приложение. Написали своё. Прямое подключение к API SMS Aero плюс нативная регистрация SMS-провайдера в Битрикс24.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"\u002Fmedia\u002Farticles\u002F0b92193d2565.png\" alt=\"Главная страница приложения SmsAero в Битрикс24\">\u003C\u002Fp>\n\u003Cp>Схема такая:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Приложение устанавливается на портал через Маркет\u003C\u002Fli>\n\u003Cli>Администратор вводит email, API-ключ и подпись отправителя\u003C\u002Fli>\n\u003Cli>Приложение регистрирует в Битрикс24 провайдера с кодом \u003Ccode>smsAero\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Все SMS из CRM — роботы, бизнес-процессы, ручные отправки — идут через этого провайдера\u003C\u002Fli>\n\u003Cli>Статусы доставки возвращаются через callback на URL приложения\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Никаких промежуточных серверов. Приложение — просто прослойка между API Битрикс24 и API провайдера. Битрикс24 считает, что отправляет SMS стандартным способом. На деле каждое сообщение уходит напрямую в SMS Aero.\u003C\u002Fp>\n\u003Ch2>Где приложение появляется в CRM\u003C\u002Fh2>\n\u003Cp>После установки SMS-провайдер регистрируется на уровне портала. Все инструменты, которые умеют слать SMS, подхватывают его автоматически. Донастраивать ничего не надо.\u003C\u002Fp>\n\u003Cp>Конкретные точки входа:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Карточка сделки, лида и контакта — кнопка отправки SMS прямо из карточки\u003C\u002Fli>\n\u003Cli>Роботы и бизнес-процессы — автоотправка при смене стадии, назначении ответственного, по таймеру\u003C\u002Fli>\n\u003Cli>Список контактов — массовая рассылка с фильтрацией\u003C\u002Fli>\n\u003Cli>Центр продаж — отправка SMS из интерфейса работы с клиентом\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Cimg src=\"\u002Fmedia\u002Farticles\u002Fff35818bca6a.png\" alt=\"Панель настроек SMS-провайдера\">\u003C\u002Fp>\n\u003Ch2>Хронология: от сообщения до работающих SMS\u003C\u002Fh2>\n\u003Cp>Вот как это выглядело по минутам:\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Время\u003C\u002Fth>\n\u003Cth>Событие\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>9:49\u003C\u002Ftd>\n\u003Ctd>Клиент: «стандартная интеграция сломалась»\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>9:51\u003C\u002Ftd>\n\u003Ctd>Выяснили провайдера — SMS Aero, API открытый\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>10:39\u003C\u002Ftd>\n\u003Ctd>Решили: делаем своё приложение\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>10:44\u003C\u002Ftd>\n\u003Ctd>Получили документацию API\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>10:46\u003C\u002Ftd>\n\u003Ctd>Клиент прислал API-ключ\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>13:02\u003C\u002Ftd>\n\u003Ctd>Приложение опубликовано, клиент устанавливает\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>13:15\u003C\u002Ftd>\n\u003Ctd>Настройки заполнены\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>13:18\u003C\u002Ftd>\n\u003Ctd>Поймали ошибку авторизации, сразу поправили\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>13:27\u003C\u002Ftd>\n\u003Ctd>Тестовое SMS ушло и доставлено\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>13:41\u003C\u002Ftd>\n\u003Ctd>Клиент подтвердил: всё работает\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Cimg src=\"\u002Fmedia\u002Farticles\u002F5128d37a973a.png\" alt=\"Статус интеграции — провайдер установлен\">\u003C\u002Fp>\n\u003Cp>3 часа 52 минуты от первого сообщения до боевой отправки. С перерывом на обед и одной ошибкой, которую поймали и поправили за 3 минуты.\u003C\u002Fp>\n\u003Ch2>Что ломается чаще всего\u003C\u002Fh2>\n\u003Cp>Когда делаешь не первый SMS-коннектор, уже знаешь, где будут грабли. Вот что вылезает почти каждый раз:\u003C\u002Fp>\n\u003Cp>\u003Cstrong>1. Авторизация не совпадает.\u003C\u002Fstrong> Провайдер ждёт Basic Auth (логин:пароль прямо в URL), а коннектор шлёт ключ в заголовке. Или наоборот. Результат — 400 Bad Request без внятного объяснения. Лечится сравнением документации с фактическим форматом запроса.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>2. Кривой callback URL.\u003C\u002Fstrong> Битрикс24 ждёт статусы доставки на свой эндпоинт. Если URL обработчика указан с ошибкой или приложение висит на сервере, который не виден из интернета — статусы не доходят. Все SMS висят в статусе «отправлено», подтверждения нет. Проверять доступность URL обработчика снаружи — первое, что надо сделать при отладке.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>3. Email не подтверждён у провайдера.\u003C\u002Fstrong> Некоторые провайдеры требуют не только API-ключ, но и подтверждённый email в личном кабинете. Ключ валидный, а API отвечает ошибкой. Выглядит как магия, лечится звонком в поддержку.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>4. Тестовый режим на боевом портале.\u003C\u002Fstrong> Классика. Приложение шлёт SMS, провайдер принимает, деньги списываются — но абоненту ничего не приходит. Потому что тестовый режим. Всегда проверяйте этот переключатель перед переводом в бой.\u003C\u002Fp>\n\u003Cp>\u003Cstrong>5. Не зарегистрирована подпись отправителя.\u003C\u002Fstrong> Провайдер блокирует сообщения без зарегистрированного имени. Ваше SMS уходит с «SMS Aero» вместо названия компании — или не уходит вообще.\u003C\u002Fp>\n\u003Ch2>Сравнение с альтернативами\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Подход\u003C\u002Fth>\n\u003Cth>Скорость запуска\u003C\u002Fth>\n\u003Cth>Надёжность\u003C\u002Fth>\n\u003Cth>Гибкость\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>Готовое приложение из Маркета\u003C\u002Ftd>\n\u003Ctd>Минуты\u003C\u002Ftd>\n\u003Ctd>Зависит от разработчика\u003C\u002Ftd>\n\u003Ctd>Ограничена настройками\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Самописный коннектор\u003C\u002Ftd>\n\u003Ctd>Часы\u003C\u002Ftd>\n\u003Ctd>Вы контролируете код\u003C\u002Ftd>\n\u003Ctd>Полная — любые методы API\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ручная отправка через ЛК\u003C\u002Ftd>\n\u003Ctd>Мгновенно\u003C\u002Ftd>\n\u003Ctd>Человеческий фактор\u003C\u002Ftd>\n\u003Ctd>Никакой автоматизации\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Внешний сервис + вебхуки\u003C\u002Ftd>\n\u003Ctd>Дни\u003C\u002Ftd>\n\u003Ctd>Зависит от двух интеграций\u003C\u002Ftd>\n\u003Ctd>Средняя\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Готовое приложение выигрывает по скорости установки — это правда. Но когда оно ломается, вы сидите и ждёте, пока разработчик выпустит обновление. С самописным коннектором вы зависите только от себя. Провайдер поменял API — поправили код, задеплоили, работаем дальше.\u003C\u002Fp>\n\u003Cp>Ручная отправка через личный кабинет — крайний случай на один день. Разовые сообщения отправить можно. Но роботы не работают, массовые рассылки превращаются в ад. Для бизнеса, где SMS встроены в процессы, это не вариант.\u003C\u002Fp>\n\u003Ch2>Когда свой коннектор оправдан\u003C\u002Fh2>\n\u003Cp>Не каждый случай требует разработки. Мы пишем коннектор только если совпало несколько условий:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Готовое приложение не работает или не закрывает нужные сценарии\u003C\u002Fli>\n\u003Cli>У провайдера открытый и документированный API\u003C\u002Fli>\n\u003Cli>SMS критичны для бизнеса — простой в пару дней неприемлем\u003C\u002Fli>\n\u003Cli>Нужна нестандартная логика: выбор провайдера по номеру, роутинг, приоритеты\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Если всё четыре условия выполняются — пишем свой коннектор. Если нет — ставим готовый и не усложняем.\u003C\u002Fp>\n\u003Cp>В этом конкретном случае совпало всё: приложение из Маркета не работало, API открытый, клиенту нужно было вчера, стандартная схема не подходила. Поэтому уложились в 4 часа.\u003C\u002Fp>\n\u003Ch2>Заключение\u003C\u002Fh2>\n\u003Cp>Стандартные интеграции ломаются. Это не редкость, это норма. Провайдеры меняют API, разработчики не успевают обновлять приложения. Бизнес остаётся без SMS именно тогда, когда они нужны.\u003C\u002Fp>\n\u003Cp>Прямой коннектор через API решает проблему кардинально. Да, это несколько часов работы. Но вы получаете инструмент, который не сломается при следующем апдейте провайдера. И который можно допилить под любые сценарии — от триггерных уведомлений до массовых рассылок по сегментам.\u003C\u002Fp>\n\u003Cp>Если ваша SMS-интеграция перестала работать или вы только планируете её — не ждите. За 4 часа можно написать свой коннектор. Работает надёжно, не зависит от чужого кода, не ломается при обновлениях на стороне провайдера.\u003C\u002Fp>\n",1782217598374]