Классические лид-формы на сайтах («Оставьте телефон, и мы перезвоним») стремительно теряют конверсию. Пользователи устали от спам-звонков и предпочитают асинхронное общение в мессенджерах.

Перевод трафика с сайта напрямую в Telegram-бота (для квиза, расчета стоимости проекта или получения лид-магнита) решает проблему конверсии, но создает слепую зону на стыке разработки и маркетинга: в момент перехода по ссылке t.me/... обрывается веб-аналитика. Бизнес перестает видеть, какая именно SEO-страница или рекламная кампания привела платежеспособного клиента.

В нашем digital-агентстве lightson.by мы проектируем сайты, чат-ботов и поисковый маркетинг как единую воронку. В этом материале разберем с примерами кода, как бесшовно передавать поисковую аналитику и UTM-метки с сайта внутрь Telegram-бота и CRM, не нагружая фронтенд тяжелыми сторонними скриптами.

1. Ограничения Telegram API и архитектура решения

В Telegram Bot API есть встроенный механизм Deep Linking: боту можно передать стартовый параметр через ссылку вида https://t.me/your_bot?start=PAYLOAD.

Главная техническая проблема — жесткий лимит на длину PAYLOAD: максимум 64 символа (допустимы только латинские буквы, цифры, дефис и нижнее подчеркивание). Зашить туда напрямую URL посадочной страницы, ClientID метрики и набор UTM-меток физически невозможно.

Чтобы обойти это ограничение и сохранить высокие показатели Core Web Vitals (LCP, INP) для SEO, мы используем легковесную серверную прослойку:

  1. Frontend: При входе пользователя микро-скрипт фиксирует точку входа (SEO-страницу), referrer и UTM-параметры, отправляя их асинхронным запросом на наш бэкенд.
  2. Backend (Redis / БД): Сохраняет полный слепок сессии и возвращает короткий уникальный токен (например, s_8f92a1).
  3. DOM-гидратация: Скрипт на сайте автоматически дописывает ?start=s_8f92a1 ко всем кнопкам перехода в Telegram.
  4. Telegram-бот: Перехватывает команду /start s_8f92a1, забирает полную аналитику по токену и отправляет обогащенный лид в CRM.

2. Реализация на фронтенде: сбор сессии и защита SEO-веса

На стороне сайта важно решить две задачи: динамически обновить ссылки для реальных пользователей и не позволить поисковым роботам (Googlebot, YandexBot) тратить краулинговый бюджет на индексацию динамических параметров.

В HTML-шаблоне ссылки на бота изначально размечаются с атрибутом rel="nofollow noopener":

<a href="[https://t.me/your_agency_bot](https://t.me/your_agency_bot)" class="js-tg-bot-link" rel="nofollow noopener" target="_blank"> Рассчитать стоимость в Telegram </a>

Клиентский скрипт на чистом JavaScript (без внешних библиотек, чтобы не блокировать основной поток рендеринга):

document.addEventListener('DOMContentLoaded', async () => { const urlParams = new URLSearchParams(window.location.search); const sessionPayload = { landing_page: window.location.pathname, referrer: document.referrer || 'direct', utm_source: urlParams.get('utm_source') || 'organic_search', utm_medium: urlParams.get('utm_medium') || 'seo', utm_campaign: urlParams.get('utm_campaign') || 'none', timestamp: Date.now() }; try { const response = await fetch('/api/v1/session-track', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(sessionPayload) }); if (!response.ok) return; const { sessionId } = await response.json(); // Например: "s_8f92a1" // Модифицируем все ссылки на бота на текущей странице document.querySelectorAll('.js-tg-bot-link').forEach((link) => { const botUrl = new URL(link.href); botUrl.searchParams.set('start', sessionId); link.href = botUrl.toString(); }); } catch (err) { console.error('Attribution tracking skipped:', err); } });

Важно для технического SEO: обязательно закройте эндпоинт /api/v1/session-track от индексации в файле robots.txt (Disallow: /api/), чтобы поисковые краулеры не генерировали пустые сессии при обходе страниц.

3. Серверный эндпоинт сохранения сессии (Node.js)

Для хранения временных сессий лучше всего подходит Redis с автоматическим временем жизни ключа (TTL — например, 24 часа).

import { createClient } from 'redis'; import crypto from 'crypto'; const redis = createClient({ url: process.env.REDIS_URL }); await redis.connect(); export async function POST(request) { try { const data = await request.json(); const sessionId = `s_${crypto.randomBytes(4).toString('hex')}`; // Сохраняем данные маркетинговой атрибуции на 24 часа (86400 секунд) await redis.setEx(sessionId, 86400, JSON.stringify(data)); return Response.json({ sessionId }, { status: 200 }); } catch (error) { return Response.json({ error: 'Failed to store session' }, { status: 500 }); } }

4. Прием данных в Telegram-боте и отправка в CRM (Python / aiogram 3.x)

Когда пользователь переходит с сайта в Telegram и нажимает кнопку «Запустить», бот получает команду /start s_8f92a1. Нам остается расшифровать токен и передать полную карточку клиента в отдел продаж.

from aiogram import Router from aiogram.filters import CommandStart, CommandObject from aiogram.types import Message import httpx router = Router() @router.message(CommandStart(deep_link=True)) async def start_with_attribution(message: Message, command: CommandObject): session_id = command.args # Получаем 's_8f92a1'  # Запрашиваем сохраненную веб-сессию с нашего бэкенда  async with httpx.AsyncClient() as client: resp = await client.get(f"[https://yourdomain.com/api/v1/session/](https://yourdomain.com/api/v1/session/){session_id}") web_session = resp.json() if resp.status_code == 200 else {} # Формируем обогащенный лид для CRM и уведомления менеджеров  crm_lead = { "telegram_id": message.from_user.id, "username": message.from_user.username, "first_name": message.from_user.first_name, "seo_landing_page": web_session.get("landing_page", "Прямой вход в бота"), "traffic_source": web_session.get("utm_source", "Telegram Direct"), "utm_medium": web_session.get("utm_medium", "none"), "referrer": web_session.get("referrer", "none") } # Отправляем вебхук в CRM (Bitrix24 / AmoCRM / кастомный бэкенд)  await push_lead_to_crm(crm_lead) await message.answer( f"Привет, {message.from_user.first_name}! 👋\n" "Давайте рассчитаем предварительную смету вашего проекта за 3 шага. " "Какая задача перед вами стоит?" )

Что дает такая связка бизнесу

Когда разработка сайтов, Telegram-ботов и SEO-продвижение строятся по единому техническому заданию, а не собираются разрозненными подрядчиками, проект выигрывает сразу по трем метрикам:

  1. Увеличение конверсии в лид: Пользователю проще в 1 клик запустить бота и ответить на пару вопросов кнопками, чем заполнять длинные формы и ждать звонка.
  2. Прозрачная окупаемость SEO и рекламы: Маркетолог видит в CRM точную посадочную страницу, которая привела клиента, даже если сама сделка закрылась внутри мессенджера спустя неделю прогрева.
  3. 100 баллов в Google PageSpeed: Отказ от тяжелых сторонних чатов и громоздких маркетинговых трекеров в пользу легкого серверного API позволяет удерживать идеальные показатели Core Web Vitals, что напрямую помогает сайту расти в поисковой выдаче.

А как вы решаете задачу сквозной аналитики при уводе пользователей с сайта в мессенджеры? Используете кастомные решения через Redis/API или сторонние коннекторы? Делитесь опытом в комментариях!