Как связать сайт, SEO-аналитику и Telegram-бота без потери атрибуции: гайд с кодом

LightsOn Agency — Thu, 29 Oct 2026 20:09:35 +0000

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

Перевод трафика с сайта напрямую в 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, мы используем легковесную серверную прослойку:

Frontend: При входе пользователя микро-скрипт фиксирует точку входа (SEO-страницу), referrer и UTM-параметры, отправляя их асинхронным запросом на наш бэкенд.
Backend (Redis / БД): Сохраняет полный слепок сессии и возвращает короткий уникальный токен (например, s_8f92a1).
DOM-гидратация: Скрипт на сайте автоматически дописывает ?start=s_8f92a1 ко всем кнопкам перехода в Telegram.
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 клик запустить бота и ответить на пару вопросов кнопками, чем заполнять длинные формы и ждать звонка.
Прозрачная окупаемость SEO и рекламы: Маркетолог видит в CRM точную посадочную страницу, которая привела клиента, даже если сама сделка закрылась внутри мессенджера спустя неделю прогрева.
100 баллов в Google PageSpeed: Отказ от тяжелых сторонних чатов и громоздких маркетинговых трекеров в пользу легкого серверного API позволяет удерживать идеальные показатели Core Web Vitals, что напрямую помогает сайту расти в поисковой выдаче.