# Передача меток из Telegram с использованием Deep Linking

## Описание задачи

Есть несколько источников трафика, и необходимо определить, какой из них эффективнее.

**Решение:** использовать ссылки на Telegram бота с использованием механизма **Deep Linking**.

В параметр `start` можно передать дополнительные значения, например:

```
https://t.me/YourBot?start=from_vk
```

или

```
https://t.me/YourBot?start=from_landing
```

## Пошаговая настройка

1. К ИИ-Агенту подключен Telegram бот по [инструкции](https://doc.nextbot.ru/functional/integrations/telegram/podklyuchenie)
2. Предположим, что есть два источника трафика:
   * Telegram-канал
   * лендинг
3. Для каждого источника создайте отдельную ссылку на бота с параметром Deep Linking:

   * Для Telegram-канала:

     ```
     https://t.me/YourBot?start=from_tg
     ```
   * Для лэндинга:

     ```
     https://t.me/YourBot?start=from_landing
     ```

   *(Замените `YourBot` на **имя пользователя** вашего бота в Telegram.)*<br>
4. В функции для отправки результатов (например, в мессенджер или в CRM) выберите следующие параметры:
   * **Имя переменной (Поле сделки)** — желаемое название или поле сделки
   * **Действия** = Данные пользователя
   * **Передаваемое значение** = Переменные из запроса `telegram /start`

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FJnC4Y5FphqdSO3SZyYR5%2Fimage.png?alt=media&#x26;token=7a583d87-6e16-417b-902d-6c86e8892eac" alt=""><figcaption><p>Пример для отправки Админу в мессенджер</p></figcaption></figure>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F0gWBewCfduXxKJLwJvGB%2Fimage.png?alt=media&#x26;token=eae6fcdb-13ba-4022-8ea8-5fc74b6d6440" alt=""><figcaption><p>Пример для CRM</p></figcaption></figure>

5. Проверим, как это работает.

   Перейдём по ссылке и согласимся открыть Telegram.\
   \&#xNAN;*(В текущем примере настроена отправка отчёта в Telegram-группу.)*<br>

   <div align="left"><figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FvZIJJl4s6fRkyGLtq2s6%2FScreenshot%202025-08-11%20100914.png?alt=media&#x26;token=5c079f07-c4bd-461d-8c64-837d12787017" alt=""><figcaption></figcaption></figure></div>
6. Проведём диалог и добьёмся выполнения функции.
7. После этого проверим присланный отчёт и увидим, что передался параметр **from\_tg**.\
   ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FmMNQyPlOQ6UVagVpgDsv%2FScreenshot%202025-08-11%20101116.png?alt=media\&token=3b1b6ef9-5b43-4f99-bff0-4b6f92049eb6)

## Дополнительная информация по deep link

* Максимальная длина параметра — **64 байта** (не символов).
* Не используйте специальные символы, требующие URL-кодирования (пробелы, кириллицу, спецсимволы).
* Для передачи нескольких параметров объединяйте их в одну строку с разделителем (`_` или `-`).

\
Пример:

```
https://t.me/YourBot?start=param1_param2_param3
```