Бот «Кодиума» работает круглые сутки, заявки из Telegram падают в файл на Яндекс Диске. Через неделю владелец школы пишет: «А с сайта люди тоже записываются, там у нас Яндекс Форма. Эти заявки я смотрю отдельно, и пару раз мы про них просто забыли. Можно, чтобы всё было в одном месте?» Так начинается второй продукт трека: интеграция.
Чему научишься в этом уроке:
• находить у заказчика места, где заявки теряются между сервисами;
• объяснить своими словами, что такое интеграция и вебхук;
• отличать, где нужен API, а где MCP;
• нарисовать поток «было → стало» для своего заказчика.
Где теряются заявки
У маленького бизнеса заявки приходят из нескольких мест: из бота, с формы на сайте, из личных сообщений. Каждое место живёт своей жизнью. Бот кладёт заявку в файл, форма копит ответы в своём кабинете, а человек, который должен перезвонить, смотрит туда, куда привык. Заявка, которую не увидели вовремя, остывает: человек уже нашёл другую школу.
У «Кодиума» после П1 картина такая:
- Бот. Заявка сразу приходит владельцу в Telegram и строкой в zayavki.xlsx на Диске. Здесь порядок.
- Форма на сайте. Ответы лежат в кабинете Яндекс Форм. Владелец заходит туда, когда вспомнит, и переносит заявки в файл руками.
- Отчёт. Сколько заявок пришло вчера и откуда, никто не знает без ручного подсчёта.
Было → стало
Задача интеграции: убрать из этой картины ручной перенос. Заявка с формы должна вести себя так же, как заявка из бота.
- Человек заполняет форму на сайте и ставит галочку согласия.
- Владелец сразу получает уведомление в Telegram с пометкой «Источник: сайт».
- Заявка ложится строкой в тот же zayavki.xlsx на Диске, в колонку «Источник» пишется «сайт» или «бот».
- Каждый день в 9:00 по Москве владельцу приходит отчёт: сколько заявок за вчера, из каких источников, на какие курсы.
Что такое интеграция
Представь курьера между двумя офисами. В одном офисе бумаги появляются, в другом их ждут. Курьер забирает пакет, проверяет, что он не пустой, и относит по адресу. Интеграция (связка сервисов) делает то же самое с данными: забирает заявку из одного сервиса, проверяет и кладёт в другой, а заодно предупреждает владельца.
Сервисы разговаривают друг с другом через API (программный вход в сервис, ты знаешь его по уроку 1.8). Бот «Кодиума» уже ходит через API в Telegram и в Яндекс Диск. Теперь к ним добавится третий участник: форма.
Вебхук: звонок в дверь
Есть два способа узнать, что пришла посылка. Можно каждые пять минут выходить к почтовому ящику и проверять. А можно повесить звонок: курьер сам позвонит, когда принесёт.
Твой бот работает первым способом. Это опрос (long polling) из урока 2.5: бот сам раз за разом спрашивает Telegram «есть новое?». Яндекс Форма работает вторым способом. Когда человек нажал «Отправить», форма сама шлёт заявку на твой адрес в интернете. Такой адрес и такой запрос называются вебхуком (дословно «веб-крючок»: на него сервис «вешает» событие).
Из-за звонка в дверь меняется главное. В П1 к серверу никто не стучался снаружи: бот ходил наружу сам. Для вебхука у тебя должна быть дверь: публичный адрес, на который форма сможет отправить заявку. Имя и телефон поедут по этому адресу, поэтому в курсе правило: адрес только с HTTPS (защищённое соединение, замок в адресной строке браузера). Для HTTPS нужен домен: сертификат выдают на имя, а не на голый адрес сервера. Справка Яндекс Форм этого не требует, но без HTTPS данные заявки идут открытым текстом.
API или MCP
В уроке 1.9 ты подключал MCP: переходник, через который Claude сам заглядывает в сервис. Легко решить, что интеграцию тоже можно собрать на MCP. Нельзя. MCP работает, пока ты сидишь в Claude Code и задаёшь вопросы: «сколько заявок на Диске?». Служба на сервере работает круглые сутки без тебя и без Claude, поэтому она ходит в API напрямую.
Простое правило: MCP для тебя во время работы, API для сервиса, который работает без тебя. Официального MCP для Яндекс Диска на 09.10.2026 не нашлось, есть только сторонние. Если захочешь им пользоваться для отчётов руками, сначала проверь репозиторий, как в уроке 1.9.
Два пути: код и n8n
Собрать интеграцию можно двумя способами, и в курсе пройдены оба.
- Код. Claude Code пишет маленький сервис приёма заявок на том же сервере, где живёт бот. Ничего не стоит сверх сервера, всё под твоим контролем, но поддерживать его будешь ты.
- n8n. Конструктор сценариев: шаги собираются из готовых блоков мышкой, как схема. Заказчик может сам поменять текст уведомления, но за облако n8n он платит каждый месяц.
Что выбрать заказчику, разберём в следующем уроке. Сравнение похожих инструментов есть в уроке трека 2 «Выбор инструмента».
Кейс: источник, который не восстановить
В прогоне курса первые две заявки с сайта попали в файл раньше, чем в нём появилась колонка «Источник». Когда колонку добавили, старым строкам проставили «бот», потому что откуда они пришли, нигде не записано. Восстановить это задним числом нельзя. Вывод для проектирования: решай, какие поля нужны для отчёта, до первой живой заявки.
Сколько это стоит заказчику
Ориентир из раздела курса «Клиенты и деньги»: настройка интеграции 20–60 тысяч ₽ и поддержка 3–5 тысяч ₽ в месяц. Это ориентир рынка, а не обещание дохода. Чек выше, чем у бота, потому что ты экономишь заказчику время каждый день, а не только принимаешь заявки. Как посчитать эту экономию, разберём в уроке 3.6.
Контрольный вопрос. Владелец «Кодиума» спрашивает: «Почему для формы нужен домен с HTTPS, если боту он был не нужен?» Какой ответ верный?
Подсказка: Сравни, кто кого спрашивает: бот у Telegram и форма у сервера.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. Ты собрал интеграцию, служба работает на сервере. Владелец хочет по утрам сам спрашивать у Claude: «сколько заявок пришло с сайта за неделю?». Что здесь уместно?
Подсказка: Кто работает круглые сутки без человека, а кто только во время разговора?
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. В файле заявок у двух строк в колонке «Источник» стоит «бот», хотя ты точно знаешь, что они пришли с сайта. Как не повторить это у своего заказчика?
Подсказка: Подумай, когда информация об источнике ещё есть, а когда её уже нет.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Задание. МИССИЯ «Карта потерь». 1. Возьми своего заказчика из П1 или знакомый бизнес (школа, салон, мастерская). 2. Выпиши все места, откуда приходят заявки: бот, форма на сайте, сообщения, звонки. 3. Для каждого места ответь: куда заявка попадает, кто её видит и что человек делает руками. 4. Нарисуй две схемы, «было» и «стало», как у «Кодиума». В «стало» отметь, какие поля попадут в отчёт (например, «Источник»). 5. Одной фразой: что в твоём потоке будет работать через API, а где тебе пригодится MCP. Сделай в среде: Замерь ручной перенос: отправь своему боту из П1 тестовую заявку и перенеси её руками в таблицу, засекая время секундомером. Принято, если: приложен снимок или файл с двумя схемами; в «было» отмечен хотя бы один ручной перенос; в «стало» указаны вход (откуда заявка), выходы (уведомление, файл) и поля отчёта; одна фраза, сколько времени этот перенос отнимает у заказчика по его словам; фраза про API и MCP; приложен снимок секундомера или записанное время и строка заявки в таблице; это время стоит в схеме «было».
Подсказка: Если не знаешь, сколько времени уходит на перенос, спроси у заказчика. Это первый вопрос будущего созвона из урока 3.7.
✅ Готово, если: программа запускается без ошибок и выводит то, что просят в задании.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Что дальше
Ты знаешь, что такое вебхук и зачем «Кодиуму» одна точка для всех заявок. Следующий шаг: спроектировать поток по шагам и выбрать, собирать его кодом или в n8n.
Итог:
• интеграция связывает сервисы, чтобы заявки не переносили руками;
• вебхук это звонок в дверь: форма сама присылает заявку на публичный адрес с HTTPS;
• служба ходит в API, MCP нужен тебе во время работы с Claude;
• поля для отчёта решают до первой живой заявки.
