> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Интеграция Telegram: уведомления о лидах через бота

> Подключите Telegram-бота в LanderLab и получайте мгновенные уведомления о каждом новом лиде в личный чат, группу или канал в реальном времени.

Подключите Telegram к лендингам в LanderLab, чтобы мгновенно получать уведомление о каждом новом лиде. Вместо того чтобы проверять панель управления, ваша команда видит каждый лид в момент отправки прямо в чате, группе или канале Telegram.

## Что такое интеграция с Telegram?

Интеграция использует Telegram-бота, который отправляет сообщение в выбранный чат каждый раз, когда на лендинге собран лид. В сообщение автоматически включаются все поля лида, поэтому вы получаете заявку целиком без дополнительных настроек — достаточно подключить интеграцию.

Она отлично подходит для оперативных оповещений: уведомляйте отдел продаж в общей группе, отправляйте лиды в приватный канал или получайте личное сообщение о каждой новой заявке.

## Перед началом

Для подключения Telegram нужны две вещи:

1. **Токен бота** (bot token), созданный в BotFather.
2. **Chat ID** — идентификатор чата, который указывает боту, куда отправлять уведомления (личный чат, группа или канал).

Бота нужно создать только один раз. Далее тот же бот можно использовать для уведомлений со скольких угодно лендингов.

## Шаг 1. Создайте Telegram-бота и получите токен

Бот — это аккаунт, который доставляет уведомления. Вы создаёте его через BotFather — официального бота Telegram для управления ботами.

<Steps>
  <Step title="Откройте BotFather в Telegram">
    В строке поиска Telegram введите `BotFather` и откройте верифицированный аккаунт (с синей галочкой и именем `@BotFather`).

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botfather.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=ea65bfd31940bb7d2833927589e1eb7d" alt="Верифицированный аккаунт BotFather в результатах поиска Telegram с синей галочкой" width="1456" height="829" data-path="images/botfather.png" />
    </Frame>
  </Step>

  <Step title="Запустите создание нового бота">
    Нажмите **Start**, затем отправьте команду `/newbot`.
  </Step>

  <Step title="Дайте боту имя">
    BotFather запросит **name** (отображаемое имя, любое), а затем **username**. Username должен быть уникальным и заканчиваться на `bot` (например, `LanderLabdoc_Bot`).
  </Step>

  <Step title="Скопируйте токен бота">
    Когда username принят, BotFather ответит сообщением с подтверждением, где указан токен вашего бота. Он выглядит так: `123456789:AAExampleTokenReplaceWithYourOwn000`. Скопируйте его и сохраните в надёжном месте.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botapi.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=40bea8773dd6af8e9fd6411bdae12929" alt="Сообщение BotFather с подтверждением и API-токеном нового бота" width="1456" height="829" data-path="images/botapi.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Относитесь к токену бота как к паролю. Любой, у кого он есть, может управлять вашим ботом. Никогда не публикуйте его открыто и не передавайте людям, которым не доверяете.
</Warning>

## Шаг 2. Получите Chat ID

Chat ID точно указывает боту, куда отправлять уведомления. Как его найти, зависит от того, куда вы хотите получать лиды. Выберите вариант, который подходит под вашу схему.

<AccordionGroup>
  <Accordion title="Групповой чат (рекомендуется для команд)">
    Самый простой способ получить Chat ID группы — в настольном приложении Telegram.

    <Steps>
      <Step title="Создайте группу и добавьте бота">
        Создайте группу в Telegram (или откройте существующую) и добавьте в неё своего бота как участника.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/botgroup.png?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=d6b8b1e180f8daae0f1d1e1e8a77b80e" alt="Группа Telegram, в которую бот добавлен как участник" width="1456" height="820" data-path="images/botgroup.png" />
        </Frame>
      </Step>

      <Step title="Отправьте сообщение и скопируйте ссылку на него">
        Отправьте любое сообщение в группу. Затем кликните по нему правой кнопкой мыши (на мобильном — долго нажмите) и выберите **Copy Message Link**.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/copylink.webp?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=1a45ce1fd9ad6c51951db3239fccbfa7" alt="Контекстное меню Telegram на сообщении в группе с выделенным пунктом Copy Message Link" width="1568" height="768" data-path="images/copylink.webp" />
        </Frame>
      </Step>

      <Step title="Возьмите Chat ID из ссылки">
        Скопированная ссылка выглядит так: `https://t.me/c/4302014071/2`. Число сразу после `/c/` — это ID вашей группы. В этом примере Chat ID равен `4302014071`.

        <Frame>
          <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/groupid.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=194aa213dd4d7d3ee65dfe5bb5f6ca9b" alt="Скопированная ссылка на сообщение Telegram с выделенным ID группы после сегмента /c/" width="1568" height="277" data-path="images/groupid.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Если уведомления не приходят с обычным числом, добавьте к ID группы префикс `-100`. Например, `4302014071` превращается в `-1004302014071`. Именно такой формат использует Telegram Bot API для групп и каналов.
    </Note>
  </Accordion>

  <Accordion title="Личный чат (только вы)">
    Используйте этот вариант, если хотите получать личные уведомления прямо в своём Telegram.

    <Steps>
      <Step title="Запустите бота">
        Откройте своего нового бота и нажмите **Start** или отправьте ему любое сообщение.
      </Step>

      <Step title="Откройте URL getUpdates">
        В браузере откройте URL ниже, заменив `<YOUR_BOT_TOKEN>` на ваш токен. Слово `bot` должно стоять сразу перед токеном.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Найдите Chat ID">
        Страница вернёт блок JSON. Найдите объект `chat` и скопируйте значение `id`. Это число и есть ваш Chat ID.

        ```json theme={null}
        "chat": {
          "id": 21xxxxx38,
          "type": "private"
        }
        ```
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Канал">
    Используйте этот вариант, чтобы отправлять лиды в Telegram-канал.

    <Steps>
      <Step title="Добавьте бота в канал как администратора">
        Добавьте бота в канал и дайте ему права администратора, затем опубликуйте в канале любое сообщение.
      </Step>

      <Step title="Откройте URL getUpdates">
        В браузере откройте URL ниже, заменив `<YOUR_BOT_TOKEN>` на ваш токен.

        ```text theme={null}
        https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
        ```
      </Step>

      <Step title="Найдите Chat ID">
        Найдите объект `chat` внутри `channel_post` и скопируйте значение `id`. ID каналов начинаются с `-100`.

        ```json theme={null}
        "chat": {
          "id": -1001xxxxxx062,
          "type": "channel"
        }
        ```
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Tip>
  Результат по URL `getUpdates` пустой? Сначала отправьте хотя бы одно сообщение боту, в группу или канал. Telegram возвращает только недавнюю активность.
</Tip>

## Шаг 3. Подключите Telegram в LanderLab

Когда токен бота и Chat ID готовы, можно подключать интеграцию.

### Добавьте интеграцию

<Steps>
  <Step title="Откройте свой лендинг">
    Перейдите в **Landing Pages** и нажмите на **название лендинга**, для которого хотите получать уведомления о лидах.
  </Step>

  <Step title="Откройте вкладку Integrations">
    Нажмите **Add Integration**, чтобы открыть панель интеграций, затем найдите **Telegram** и выберите его.
  </Step>

  <Step title="Введите название и токен бота">
    Дайте интеграции название в поле **Name**, затем вставьте **Bot Token** из шага 1. Нажмите **Add Telegram**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/bot-token.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=f8eddbe2a0c4d7c7c4b23e535679460e" alt="Форма интеграции Telegram в LanderLab с полями Name и Bot Token" width="551" height="317" data-path="images/bot-token.webp" />
    </Frame>
  </Step>
</Steps>

### Настройте уведомление

После добавления бота откроется короткий мастер, где вы выбираете, куда приходят уведомления и как они выглядят.

<Steps>
  <Step title="Введите Chat ID">
    Вставьте **Chat ID**, который вы нашли на шаге 2 (например, `-1004309994071`). Нажмите **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/9-VOMykPx0hrcjP5/images/chatid.webp?fit=max&auto=format&n=9-VOMykPx0hrcjP5&q=85&s=632546f1d1b7169a066b71284e43f1c2" alt="Шаг ввода Chat ID в мастере настройки Telegram в LanderLab" width="696" height="331" data-path="images/chatid.webp" />
    </Frame>
  </Step>

  <Step title="Выберите формат сообщения">
    Выберите, как будет написано каждое уведомление:

    | Формат | Что делает |
    | :- | :- |
    | **List** | LanderLab автоматически форматирует каждое поле лида. Вы добавляете только **Intro text** — текст в начале сообщения. |
    | **Custom** | Вы пишете свой шаблон сообщения и полностью контролируете, что будет в каждом уведомлении. |

    В большинстве случаев быстрее всего выбрать **List**. Добавьте вступление, например `New lead from Pre-Sell Warm-Up Landing Page`, и нажмите **Continue**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/6dsdE__B-csyS6Jn/images/image-27.png?fit=max&auto=format&n=6dsdE__B-csyS6Jn&q=85&s=b6df23cb4f87f08a4771194b23d91fc2" alt="Шаг выбора формата сообщения в мастере Telegram: форматы List и Custom и поле Intro text" width="912" height="502" data-path="images/image-27.png" />
    </Frame>
  </Step>

  <Step title="Проверьте и подключите">
    На последнем шаге показан предпросмотр: куда отправляется сообщение, его формат и вступление. Все поля лида включаются автоматически. Если всё верно, нажмите **Connect Telegram**.
  </Step>
</Steps>

<Note>
  Если у лендинга несколько вариантов A/B-теста, перед добавлением интеграции вам предложат выбрать, к какому или каким вариантам она относится.
</Note>

## Проверьте интеграцию

Отправьте тестовый лид через форму или квиз на лендинге и посмотрите в ваш чат Telegram. Бот должен прислать сообщение с данными лида в течение нескольких секунд.

## Устранение неполадок

<AccordionGroup>
  <Accordion title="Уведомления не приходят">
    Проверьте три вещи: токен бота указан верно, бот является участником (или администратором) группы или канала, Chat ID введён правильно. Для групп и каналов попробуйте добавить к ID префикс `-100`.
  </Accordion>

  <Accordion title="Уведомления приходят не в тот чат">
    Ещё раз проверьте Chat ID. Группу, канал и личный чат легко путать. Повторите шаг 2 для того чата, куда вы хотите получать лиды.
  </Accordion>

  <Accordion title="Бот не отвечает">
    Убедитесь, что вы нажали **Start** в чате с ботом или отправили хотя бы одно сообщение в группу или канал. Пока нет активности, Telegram не вернёт никаких данных о чате.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.