---
title: "Шаблонные переменные воронок: справочник | tuk-tuk.online"
nav_title: "Шаблонные переменные"
url: https://docs.tuk-tuk.online/funnels/templates
markdown: https://docs.tuk-tuk.online/funnels/templates.md
section: "Воронки историй"
description: "Все переменные воронок tuk-tuk.online: результаты AI и генерации, данные клиента, история диалогов {{dialogs_...}} с фильтрами по периоду, типу и тегам, лимиты и формат вывода."
keywords: ["шаблонные переменные", "template variables", "шаблоны диалогов", "фильтр по тегам", "dialogs template", "переменные воронки", "персонализация рассылки"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Справочник переменных воронок tuk-tuk.online: контекстные {{aiResult}}, {{imageResult}}, {{storyResult}} (с суффиксом _N), персональные {{name}}, {{phone}}, {{email}} и шаблоны истории диалогов {{dialogs_<период>}} с фильтрами по типу, тегам и лимиту.
>
> - Синтаксис шаблона диалогов: {{dialogs_<число><d|h>[_private|_groups|_channels|_tag:<теги>][:<лимит>]}}.
> - Лимит диалогов по умолчанию 50, максимум 200; сообщений на диалог 100.
> - Несколько тегов через запятую: логика AND.
> - Персональные переменные подставляются для каждого получателя только в блоке «Отправка сообщений».
> - Шаблоны диалогов работают в подписи Story, рассылке, промптах AI и генерации; в профиле и условии не работают.
> - Формат вывода: заголовок «Все диалоги за 7 дн. (N из макс. 50)», секция на диалог, строки «[MM-DD HH:MM] Роль: текст».
>
> Связанные страницы: https://docs.tuk-tuk.online/funnels, https://docs.tuk-tuk.online/funnels/tg-funnels, https://docs.tuk-tuk.online/funnels/vk-funnels, https://docs.tuk-tuk.online/funnels/ig-funnels, https://docs.tuk-tuk.online/dialogs/search-and-filters

# Шаблонные переменные воронок

В текстовых полях любого блока воронки работают переменные в двойных фигурных скобках: `{{переменная}}`. При выполнении они заменяются на реальные значения: результат AI, URL картинки, имя клиента или историю переписок за период.

## Контекстные переменные

Результаты предыдущих блоков, доступные в последующих.

| Переменная | Значение |
|---|---|
| `{{aiResult}}` | Текстовый результат последнего блока AI-обработки |
| `{{aiResult_N}}` | Результат AI-блока номер N |
| `{{imageResult}}` | URL последнего сгенерированного изображения |
| `{{imageResult_N}}` | URL изображения от блока номер N |
| `{{storyResult}}` | ID последней опубликованной Story |
| `{{storyResult_N}}` | ID Story от блока номер N |

> [!NOTE] N: порядковый номер блока на холсте, начиная с 1.

## Персональные переменные

Работают в блоке «Отправка сообщений» и подставляются для каждого получателя отдельно.

| Переменная | Значение |
|---|---|
| `{{name}}` | Имя клиента из диалога |
| `{{phone}}` | Телефон клиента |
| `{{email}}` | Email клиента |

## Шаблоны диалогов

Подставляют историю переписок из базы за указанный период. Основной инструмент для AI-промптов и аналитики.

### Базовый синтаксис

```text
{{dialogs_<период><единица>}}
```

| Часть | Значение | Примеры |
|---|---|---|
| `период` | Число | `1`, `7`, `24`, `30` |
| `единица` | `d` дни, `h` часы | `7d` = 7 дней, `24h` = 24 часа |

### Фильтр по типу диалога

```text
{{dialogs_<период><единица>_<тип>}}
```

| Тип | Что берётся |
|---|---|
| `private` | Только личные диалоги |
| `groups` | Только групповые чаты |
| `channels` | Только каналы |

### Фильтр по тегам

```text
{{dialogs_<период><единица>_tag:<теги>}}
```

| Синтаксис | Что берётся |
|---|---|
| `tag:VIP` | Диалоги с тегом «VIP» |
| `tag:лид` | Диалоги с тегом «лид» |
| `tag:VIP,горячий` | Диалоги, у которых есть и «VIP», и «горячий» |

> [!NOTE] Несколько тегов через запятую работают по логике AND: диалог должен содержать все перечисленные теги.

### Лимит количества

```text
{{dialogs_<период><единица>:<лимит>}}
{{dialogs_<период><единица>_<фильтр>:<лимит>}}
```

| Параметр | По умолчанию | Максимум |
|---|---|---|
| Диалогов | 50 | 200 |
| Сообщений на диалог | 100 | 100 |

## Таблица примеров

| Шаблон | Что подставится |
|---|---|
| `{{dialogs_7d}}` | Все диалоги за 7 дней, лимит 50 |
| `{{dialogs_24h}}` | Все диалоги за 24 часа |
| `{{dialogs_30d}}` | За 30 дней |
| `{{dialogs_1h}}` | За последний час |
| `{{dialogs_7d_private}}` | Только личные за 7 дней |
| `{{dialogs_7d_groups}}` | Только групповые за 7 дней |
| `{{dialogs_7d_channels}}` | Только каналы за 7 дней |
| `{{dialogs_7d:100}}` | За 7 дней, лимит 100 диалогов |
| `{{dialogs_7d_private:200}}` | Личные за 7 дней, лимит 200 |
| `{{dialogs_7d_tag:VIP}}` | Диалоги с тегом VIP за 7 дней |
| `{{dialogs_30d_tag:лид:50}}` | Тег «лид» за 30 дней, лимит 50 |
| `{{dialogs_7d_tag:VIP,горячий}}` | Теги VIP и горячий (AND) за 7 дней |
| `{{dialogs_24h_tag:важный:10}}` | Тег «важный» за 24 часа, лимит 10 |

## Формат вывода

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

```text
═══ Все диалоги за 7 дн. (2 из макс. 50) ═══

── Иван Петров (79001234567) ──
  [03-01 14:30] Иван Петров: Здравствуйте, хочу узнать цену
  [03-01 14:31] Вы: Добрый день! Цена от 5000 руб.
  [03-01 14:32] Иван Петров: Подходит, как оплатить?

── Мария Сидорова (79007654321) ──
  [03-02 10:15] Мария Сидорова: Когда доставка?
  [03-02 10:20] Вы: Доставка 2–3 дня.
```

Роль в строке сообщения: имя собеседника (или «Собеседник»), имя AI-ассистента (или «Вы» для исходящих), «Заметка», «Система». Если у сообщения есть медиа, в конце строки добавляется его тип в квадратных скобках.

С фильтром по типу или тегу заголовок меняется: «Личные диалоги за 7 дн. (...)», «Тег [VIP] диалоги за 7 дн. (...)». Если за период ничего не найдено, подставляется `[Диалоги за 7 дн.: не найдено]`.

## Где какие переменные работают

| Блок | Контекстные | Персональные | Шаблоны диалогов |
|---|---|---|---|
| Story (подпись) | Да | Нет | Да |
| Обновление профиля | Да | Нет | Нет |
| Отправка сообщений | Да | Да | Да |
| AI-обработка (промпт) | Да | Нет | Да |
| Генерация изображения (промпт) | Да | Нет | Да |
| Условие | Да | Нет | Нет |

## Примеры с AI

### Аналитика VIP-клиентов

```text
AI-промпт:
«Проанализируй переписки с VIP-клиентами за неделю:
{{dialogs_7d_tag:VIP}}

Определи основные темы обращений и общий sentiment.»
```

### Еженедельный отчёт

```text
AI-промпт:
«Вот все диалоги за последние 7 дней:
{{dialogs_7d:200}}

Составь краткий отчёт: сколько обращений, основные вопросы,
незакрытые запросы.»
```

### Персональная рассылка

```text
Отправка сообщений:
«Привет, {{name}}! Мы подготовили специальное предложение
для вас на основе вашего последнего запроса. Подробности
по ссылке: ...»
```