01
Создайте бота
Напишите @BotFather → /newbot → задайте имя и username. Сохраните выданный TOKEN.
TelegramДокументация интеграции
Telegram
Бот, который превращает входящие сообщения в лиды
Создаёте бота у @BotFather, ставите webhook на наш endpoint - каждое текстовое сообщение становится лидом с источником TELEGRAM, username и chat_id уезжают в source_detail.
Webhook endpoint
POST
https://closeflow.ru/api/v1/webhooks/leads/telegramАутентификация: заголовок X-Api-Key или query-параметр ?api_key=. Получить ключ - в Настройках.
Шаги настройки
02
Получите API-ключ workspace
В CloseFlow откройте /dashboard/integrations и скопируйте API key для приёма лидов (или создайте новый).
03
Установите webhook у бота
Выполните setWebhook у Telegram, чтобы сообщения шли к нам:
curl -sS "https://api.telegram.org/bot<TOKEN>/setWebhook" \ -d "url=https://your-app.com/api/v1/webhooks/leads/telegram?api_key=cf_live_..."
04
Проверьте - напишите боту /start
Сообщение должно появиться как новый лид в /dashboard/leads с source=Telegram.
05
Альтернатива: mini-app / форма
Если используете Telegram Mini App или сторонний форвардер - отправьте POST с полями name / phone / message / telegram_username. Адаптер распознаёт оба формата.
{ "name": "Игорь", "phone": "+79161234567", "message": "Нужна консультация", "telegram_username": "igor_dev" }Документация провайдера
Другие интеграции