Интеграции со сторонними сервисами

Зачем интеграции

Сам по себе проект мало что делает. Сила — в связях: отправить сообщение в Telegram, сохранить заявку в Google Sheets, принять оплату через Stripe, получить данные из погодного сервиса. Всё это — интеграции через API.

Что такое API

API — это «меню» команд, которые сервис разрешает вызывать программно. Ты отправляешь запрос (HTTP) — получаешь ответ (обычно JSON). Например, запрос к API погоды вернёт температуру в твоём городе.

# Пример запроса к публичному API
curl "https://api.github.com/users/torvalds"
# Вернёт JSON с данными пользователя

API-ключи и безопасность

Большинство сервисов требуют API-ключ — секретный пароль, который доказывает, что запрос от тебя. Ключи нельзя светить в коде и git!

# .env (этот файл НЕ коммитим)
TELEGRAM_TOKEN=123456:ABC-DEF...
OPENWEATHER_KEY=abcdef123

# Использование в коде (Node.js)
# process.env.TELEGRAM_TOKEN

Вебхуки

Вебхук — обратная связь: вместо того чтобы ты опрашивал сервис, он сам присылает тебе HTTP-запрос, когда что-то случилось (пришла оплата, новое сообщение). Для вебхуков нужен публичный адрес — твой сервер из урока 2 идеально подходит.

Интеграции через MCP

Многие сервисы уже имеют готовые MCP-серверы (GitHub, Slack, Notion, базы данных). Подключаешь сервер — и агент сам работает с сервисом, без написания кода интеграции вручную. Это самый быстрый путь.

Практический пример: Telegram-бот

1. Создай бота через @BotFather в Telegram, получи токен.
2. Сохрани токен в .env.
3. Попроси агента: «напиши скрипт, который шлёт сообщение мне в Telegram через Bot API, токен бери из переменной окружения».
4. Запусти и проверь, что сообщение пришло.

# Отправка сообщения ботом одной командой
curl -X POST \
  "https://api.telegram.org/bot$TELEGRAM_TOKEN/sendMessage" \
  -d "chat_id=ТВОЙ_ID&text=Привет из вайбкодинга!"