# Документация tuk-tuk.online (полная версия) Все страницы документации в порядке меню. Источник: https://docs.tuk-tuk.online. Отдельная страница: тот же URL + `.md`. --- title: "Документация tuk-tuk.online: каналы, AI-ассистенты, автоматизация, API" nav_title: "Обзор платформы" url: https://docs.tuk-tuk.online/ markdown: https://docs.tuk-tuk.online/index.md description: "Документация платформы tuk-tuk.online: подключение Telegram, SMS, Email и чат-виджета, настройка AI-ассистентов и цепочек, интеграции с amoCRM, YClients и Битрикс24, REST API и вебхуки." keywords: ["tuk-tuk.online", "документация", "омниканальная платформа", "чат-бот конструктор", "AI ассистент для бизнеса", "автоматизация сообщений", "CRM интеграция", "виджет чата для сайта", "Telegram бот для бизнеса", "автоворонка продаж", "платформа коммуникаций"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Документация платформы tuk-tuk.online: подключение каналов (Telegram, SMS, Email, чат-виджет, amoCRM и другие), AI-ассистенты, цепочки автоматизации, интеграции с CRM, REST API и вебхуки. > > - Личный кабинет: https://lk.tuk-tuk.online. Документация: https://docs.tuk-tuk.online. > - Любая страница доступна как Markdown по тому же URL с суффиксом .md, главная: https://docs.tuk-tuk.online/index.md. > - Оглавление для агентов: https://docs.tuk-tuk.online/llms.txt. Все страницы одним файлом: https://docs.tuk-tuk.online/llms-full.txt. > - На каждой странице есть блок «Кратко» с фактами и связанными страницами. > - Поддержка: чат на tuk-tuk.online или support@tuk-tuk.online. > > Связанные страницы: https://docs.tuk-tuk.online/getting-started, https://docs.tuk-tuk.online/concept, https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/faq # Документация tuk-tuk.online tuk-tuk.online собирает Telegram, SMS, Email, чат-виджет, amoCRM и другие каналы в один центр диалогов, добавляет AI-ассистентов, цепочки автоматизации и интеграции с CRM. Здесь описано, как всё это подключить и настроить: по шагам, с названиями кнопок и лимитами. ## С чего начать 1. [Быстрый старт](https://docs.tuk-tuk.online/getting-started): от регистрации до первого ответа AI за 10 минут. 2. [Как это устроено](https://docs.tuk-tuk.online/concept): каналы, диалоги, ассистенты, цепочки. 3. [Каналы связи](https://docs.tuk-tuk.online/channels): подключение Telegram, SMS, Email, виджета и остальных. 4. [AI-ассистенты](https://docs.tuk-tuk.online/ai): провайдеры, инструкции, режимы поведения. ## Как читать документацию - Каждая страница начинается с блока «Кратко»: суть, факты и ссылки на связанные страницы. Его достаточно, чтобы понять, нужна ли вам страница целиком. - Оглавление справа ведёт по разделам страницы. На телефоне оно раскрывается над текстом. - Поиск по всей документации: ⌘K на Mac, Ctrl+K на Windows или клавиша «/». - Ссылки на lk.tuk-tuk.online ведут в личный кабинет, на docs.tuk-tuk.online в документацию. ## Для ИИ-агентов - Любая страница доступна как чистый Markdown по тому же адресу с суффиксом `.md`, например `https://docs.tuk-tuk.online/getting-started.md`. Главная: `https://docs.tuk-tuk.online/index.md`. - [https://docs.tuk-tuk.online/llms.txt](https://docs.tuk-tuk.online/llms.txt): оглавление документации в формате llmstxt.org, по одной строке сути на страницу. - [https://docs.tuk-tuk.online/llms-full.txt](https://docs.tuk-tuk.online/llms-full.txt): все страницы одним файлом. - На каждой странице есть кнопки «Скопировать как Markdown», «Открыть .md», «Спросить ChatGPT» и «Спросить Claude». ## Поддержка Чат на [tuk-tuk.online](https://tuk-tuk.online) или письмо на support@tuk-tuk.online. Ответы на частые вопросы собраны в [FAQ](https://docs.tuk-tuk.online/faq). --- --- title: "Как устроен tuk-tuk.online: каналы, диалоги, AI и цепочки" nav_title: "Как это устроено" url: https://docs.tuk-tuk.online/concept markdown: https://docs.tuk-tuk.online/concept.md description: "Архитектура tuk-tuk.online: каналы связи собирают сообщения в единый центр диалогов, AI-ассистенты и цепочки отвечают автоматически, интеграции передают данные в CRM." keywords: ["tuk-tuk.online концепция", "омниканальная платформа для бизнеса", "архитектура чат-платформы", "единый центр диалогов", "автоматизация коммуникаций", "мультиканальный чат", "объединить мессенджеры в одном окне", "платформа для общения с клиентами"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Обзор архитектуры tuk-tuk.online: каналы принимают сообщения, диалоги хранят переписку с клиентом, действия (AI-ассистенты, цепочки, интеграции) реагируют на сообщения автоматически. > > - Три уровня: каналы (Telegram Bot, Telegram-аккаунт, SMS-шлюз, Email, чат-виджет, amoCRM, Webhook), диалоги, действия. > - AI-провайдеры: OpenAI (GPT-4), Anthropic (Claude), Google Gemini, Mistral, DeepSeek. > - Блоки цепочек: отправка сообщения, ожидание ответа, AI-обработка, условие, задержка, вебхук, Python-код. > - Триггеры цепочек: каждое сообщение, один раз на клиента, ключевое слово, регулярное выражение. > - Интеграции: amoCRM, Битрикс24, RetailCRM, YClients, GetCourse, 1С:Предприятие, Notion, Яндекс.Метрика. > - Безопасность: HTTPS/WSS, JWT, guard на каждом запросе, bcrypt для паролей, роли пользователей. > > Связанные страницы: https://docs.tuk-tuk.online/getting-started, https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/chains # Как устроен tuk-tuk.online tuk-tuk.online: облачная платформа, которая принимает сообщения из мессенджеров, SMS, почты и чата на сайте в один центр диалогов. Поверх диалогов работают AI-ассистенты, цепочки автоматизации и интеграции с CRM. Эта страница объясняет три уровня платформы и модель данных. Практические шаги собраны в [быстром старте](https://docs.tuk-tuk.online/getting-started). ## Три уровня: каналы, диалоги, действия ![Рабочий стол кабинета](https://docs.tuk-tuk.online/assets/screens/home/dashboard.webp) 1. Меню разделов: дашборд, связки, интеграции, каналы, AI, диалоги, задачи, календарь. 2. Финансы: баланс, расход за 30 дней, прогноз и тариф. 3. График расходов на связь. 4. Сообщения по часам и дням. 5. Кнопка «Настроить»: состав блоков дашборда. 6. Баланс и тариф, переход к оплате. 7. Добавить ещё один проект. 8. Эфир: внутренний чат команды. 9. Профиль, смена проекта и выход. | Уровень | Что это | Примеры | |---|---|---| | Каналы | Точки подключения к мессенджерам и сервисам | Telegram Bot, Telegram-аккаунт, SMS-шлюз, Email, чат-виджет, amoCRM, Webhook | | Диалоги | Переписка с конкретным клиентом через канал | История сообщений, теги, кастомные поля, вложения | | Действия | Автоматические реакции на сообщения | Ответ AI-ассистента, запуск цепочки, передача данных в CRM | Клиент пишет в любой канал, сообщение попадает в диалог, к диалогу применяются действия. Оператор видит всю историю в одном окне: неважно, пришло сообщение из Telegram, с сайта или по SMS. ```text Клиент Каналы Платформа ┌─────┐ ┌────────────┐ ┌──────────────────┐ │ TG │────▶│ TG Bot │────┐ │ │ ├─────┤ │ TG Account │ │ │ Единый центр │ │ Web │────▶│ Chat Widget│────┼───▶│ диалогов │ ├─────┤ │ SMS Gateway│ │ │ │ │ SMS │────▶│ Email │────┘ │ ┌──────────┐ │ ├─────┤ │ AmoCRM │ │ │AI-ассист.│ │ │Email│────▶│ Webhook │ │ └──────────┘ │ └─────┘ └────────────┘ │ ┌──────────┐ │ │ │ Цепочки │ │ │ └──────────┘ │ │ ┌──────────┐ │ │ │Интеграции│ │ │ └──────────┘ │ └──────────────────┘ ``` ## AI как ядро ![Настройка блоков дашборда](https://docs.tuk-tuk.online/assets/screens/home/dashboard-configure.webp "Кнопка «Настроить» включает режим сборки: блоки переставляются, меняют ширину и скрываются.") - AI-ассистенты обрабатывают входящие сообщения без участия оператора. - Поведение задаётся инструкцией в конструкторе промптов, без программирования. - Поддерживаются 5 провайдеров: OpenAI (GPT-4), Anthropic (Claude), Google Gemini, Mistral, DeepSeek. Подробнее: [AI-ассистенты](https://docs.tuk-tuk.online/ai). ## Визуальная автоматизация Цепочка: сценарий из блоков в drag-and-drop редакторе. Блоки: отправка сообщения, ожидание ответа, AI-обработка, условие, задержка, вебхук, Python-код. Цепочка запускается по триггеру: на каждое сообщение, один раз на клиента, по ключевому слову или по регулярному выражению. Подробнее: [Цепочки](https://docs.tuk-tuk.online/chains). ## Интеграции | Класс систем | Что подключается | |---|---| | CRM | amoCRM, Битрикс24, RetailCRM | | Онлайн-запись | YClients | | LMS | GetCourse | | ERP | 1С:Предприятие | | Заметки и аналитика | Notion, Яндекс.Метрика | Подробнее: [Интеграции](https://docs.tuk-tuk.online/integrations). ## Модель данных ### Канал Подключённый источник сообщений. У канала есть тип, имя и конфигурация: токены, ключи, настройки. К каналу привязываются AI-ассистенты и цепочки. ### Диалог Переписка с одним клиентом через один канал. Содержит: - данные клиента: имя, телефон, email, идентификатор в мессенджере; - сообщения: текст, медиа, голосовые, документы, стикеры; - теги для сегментации клиентов; - кастомные поля в формате JSON; - статистику: непрочитанные сообщения, время последнего контакта. ### AI-ассистент Настраиваемый «сотрудник», который отвечает автоматически. Привязывается к каналам, имеет рабочие часы, приоритет и роль: продавец, модератор, аналитик и другие. ### Цепочка Визуальный сценарий из блоков. Запускается по триггеру и выполняет действия по порядку. ## Безопасность - Данные передаются по HTTPS и WSS. - Авторизация по JWT-токенам. - Каждый запрос к API проходит guard-проверку. - Пароли хранятся как bcrypt-хеши. - Доступ пользователей разграничен ролями, см. [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions). --- --- title: "Быстрый старт tuk-tuk.online: первый канал и ответ AI за 10 минут" nav_title: "Быстрый старт" url: https://docs.tuk-tuk.online/getting-started markdown: https://docs.tuk-tuk.online/getting-started.md description: "Регистрация, подключение Telegram-бота, первое сообщение в диалогах, настройка AI-ассистента и первый автоматический ответ. Каждый шаг с ожидаемым результатом." keywords: ["tuk-tuk.online начало работы", "быстрый старт чат-бот", "регистрация tuk-tuk", "подключить Telegram бот", "настройка чат-бота с нуля", "первые шаги омниканальная платформа", "подключить AI к мессенджеру", "автоматические ответы клиентам"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Пошаговый сценарий для нового аккаунта tuk-tuk.online: регистрация, Telegram-бот через BotFather, подключение канала, первое сообщение в диалогах, провайдер AI и ассистент, первый автоматический ответ. > > - Регистрация: https://lk.tuk-tuk.online/register, нужны email и пароль. > - Каналы подключаются в разделе «Каналы связи» (https://lk.tuk-tuk.online/channels), кнопка «Подключить». > - Входящие сообщения видны в разделе «Диалоги» (https://lk.tuk-tuk.online/dialogs). > - Провайдер AI и инструкции: раздел «AI-обработка» (https://lk.tuk-tuk.online/ai); ассистенты: https://lk.tuk-tuk.online/ai-assistants. > - Цепочки создаются в разделе «Связки» (https://lk.tuk-tuk.online/bindings). > - API-ключ провайдера AI свой; на тарифе Free доступны 2 канала, 1 ассистент, 1 инструкция, 1 цепочка. > > Связанные страницы: https://docs.tuk-tuk.online/channels/telegram-bot, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/billing # Быстрый старт Шесть шагов от пустого аккаунта до первого ответа AI-ассистента клиенту. На всё уходит около 10 минут. Понадобятся аккаунт в Telegram и API-ключ провайдера AI (OpenAI, Anthropic или другого). Шаги 5 и 6 можно отложить: после шага 4 сообщения клиентов уже приходят в диалоги, и на них можно отвечать вручную. ## Шаг 1. Зарегистрируйтесь 1. Откройте [lk.tuk-tuk.online/register](https://lk.tuk-tuk.online/register). 2. Введите email и придумайте пароль. 3. Нажмите «Зарегистрироваться» и войдите. > [!SUCCESS] Результат: открыт дашборд, главная панель кабинета. ![Форма регистрации](https://docs.tuk-tuk.online/assets/screens/auth/register.webp "Регистрация: имя, email, телефон и пароль. Телефон понадобится для входа.") ## Шаг 2. Создайте Telegram-бота Telegram Bot: самый быстрый канал, настройка занимает 2 минуты. 1. Откройте [@BotFather](https://t.me/BotFather) в Telegram. 2. Отправьте команду `/newbot` и ответьте на вопросы о названии и username бота. 3. Скопируйте токен из последнего сообщения BotFather. > [!SUCCESS] Результат: токен бота скопирован. ## Шаг 3. Подключите канал ![Раздел «Каналы связи»](https://docs.tuk-tuk.online/assets/screens/channels/overview.webp) 1. Пункт «Каналы связи» в левом меню. 2. Кнопка «Подключить» на карточке Telegram Bot. 3. Виджет чата создаётся отдельной кнопкой. 4. Счётчик подключённых каналов этого типа. ![Форма подключения Telegram-бота](https://docs.tuk-tuk.online/assets/screens/channels/telegram-bot-form.webp) 1. Название канала. 2. Токен от @BotFather. 3. Кнопка «Подключить». 1. Откройте раздел [Каналы связи](https://lk.tuk-tuk.online/channels) в кабинете. 2. Нажмите «Подключить» на карточке Telegram Bot. 3. Вставьте токен и сохраните. > [!SUCCESS] Результат: канал появился в списке каналов. Подробная инструкция: [Подключение Telegram Bot](https://docs.tuk-tuk.online/channels/telegram-bot). ### Другие каналы | Канал | Время настройки | Сложность | |---|---|---| | [Telegram Bot](https://docs.tuk-tuk.online/channels/telegram-bot) | 2 мин | Легко | | [Чат-виджет](https://docs.tuk-tuk.online/channels/chat-widget) | 3 мин | Легко | | [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms) | 5 мин | Средне | | [Telegram-аккаунт](https://docs.tuk-tuk.online/channels/telegram-account) | 5 мин | Средне | | [Email](https://docs.tuk-tuk.online/channels/email) | 5 мин | Средне | | [Webhook](https://docs.tuk-tuk.online/channels/webhook) | 5 мин | Средне | | [amoCRM](https://docs.tuk-tuk.online/channels/amocrm-chat) | 10 мин | Сложно | ## Шаг 4. Получите первое сообщение ![Первое сообщение в разделе «Диалоги»](https://docs.tuk-tuk.online/assets/screens/dialogs/list.webp "Сообщение клиента появляется в списке диалогов: имя, канал, текст и время.") 1. Напишите боту любое сообщение из своего Telegram. 2. Откройте раздел [Диалоги](https://lk.tuk-tuk.online/dialogs). > [!SUCCESS] Результат: в списке появился новый диалог с вашим сообщением. Для других каналов проверка такая же: для чат-виджета напишите с сайта, где он установлен, для SMS отправьте SMS на номер шлюза. ## Шаг 5. Подключите AI-ассистента ![Подключение провайдера нейросети](https://docs.tuk-tuk.online/assets/screens/ai/provider-form.webp) 1. Название подключения. 2. API-ключ провайдера. 3. Модель по умолчанию. 4. Кнопка «Подключить». ![Создание AI-ассистента](https://docs.tuk-tuk.online/assets/screens/ai/assistant-form.webp) 1. Название ассистента. 2. Режим поведения. 3. AI-инструкция. 4. Пауза после ответа оператора. 5. Начало рабочего окна. 6. Конец рабочего окна. 7. Приоритет. 8. Кнопка «Создать». 1. Откройте раздел [AI-обработка](https://lk.tuk-tuk.online/ai). 2. Добавьте провайдера (OpenAI, Anthropic, Gemini или другого) и введите его API-ключ. 3. Создайте инструкцию: опишите, кто ассистент, как отвечает и чего не делает. 4. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), создайте ассистента, выберите инструкцию и привяжите его к каналу Telegram Bot. > [!SUCCESS] Результат: ассистент в списке, у него указан канал. > [!NOTE] API-ключ провайдера ваш, расход токенов оплачивается провайдеру по его тарифам. На тарифе Free доступен 1 ассистент и 1 инструкция. Подробнее: [Провайдеры](https://docs.tuk-tuk.online/ai/providers). ## Шаг 6. Получите первый ответ AI 1. Напишите боту вопрос по теме инструкции. 2. Откройте этот диалог в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). > [!SUCCESS] Результат: в диалоге появился ответ ассистента, написанный по вашей инструкции. ## Что дальше - [Цепочки](https://docs.tuk-tuk.online/chains): сценарии из блоков в разделе [Связки](https://lk.tuk-tuk.online/bindings) кабинета. Первая цепочка: «Отправка сообщения» с приветствием, «Ожидание ответа», «AI-обработка». - [Интеграции](https://docs.tuk-tuk.online/integrations) с amoCRM, YClients и Google Calendar. - [Чат-виджет](https://docs.tuk-tuk.online/channels/chat-widget) на ваш сайт. - [API](https://docs.tuk-tuk.online/api) для собственных интеграций. - [Тарифы](https://docs.tuk-tuk.online/billing): лимиты Free и переход на Business. --- --- title: "Каналы связи: Telegram, VK, Instagram, SMS, Email, виджет и другие" nav_title: "Каналы связи" url: https://docs.tuk-tuk.online/channels markdown: https://docs.tuk-tuk.online/channels.md description: "Подключение 11 каналов к tuk-tuk.online: Telegram Bot и аккаунт, VK, Instagram DM, Авито, MAX Bot, SMS, Email, чат-виджет, amoCRM и Webhook. Все сообщения в одном разделе «Диалоги» с AI-ассистентом и цепочками." keywords: ["подключение мессенджеров", "каналы связи для бизнеса", "Telegram бот подключение", "чат-виджет для сайта", "SMS шлюз", "Email канал", "омниканальность", "все мессенджеры в одном месте", "мультиканальная поддержка клиентов", "объединить чаты", "Instagram DM", "Авито переписка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Раздел «Каналы связи» подключает к tuk-tuk.online 11 источников сообщений: Telegram Bot, Telegram-аккаунт, чат-виджет, SMS-шлюз, Email, VK-сообщество, Instagram DM, Авито, MAX Bot, Webhook и amoCRM. Все сообщения попадают в общий раздел «Диалоги», к каждому каналу подключаются AI-ассистент и цепочки. > > - Путь в кабинете: Каналы связи → Подключить → выбрать тип → заполнить поля → Сохранить. После этого канал получает статус «Активен». > - Бесплатный тариф: Telegram Bot и чат-виджет. Тарифы «Бизнес» и «Корпоративный»: все 11 каналов. > - Кнопки в сообщениях поддерживают только Telegram Bot, чат-виджет и MAX Bot. > - AI-ассистент и цепочки автоматизации работают со всеми 11 каналами. > - Время настройки: от 2 минут (Telegram Bot) до 10 минут (Instagram DM, MAX Bot, amoCRM). > - Канал amoCRM не добавляется вручную: он создаётся автоматически при подключении интеграции amoCRM. > > Связанные страницы: https://docs.tuk-tuk.online/getting-started, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/billing # Каналы связи Канал: связь между мессенджером (или другим источником сообщений) и tuk-tuk.online. После подключения все сообщения из этого источника приходят в общий раздел [Диалоги](https://lk.tuk-tuk.online/dialogs). Отвечать можно оттуда, не переключаясь между приложениями. К любому каналу подключаются AI-ассистент и цепочки автоматизации. Работает одинаково для всех 11 типов. ## Какие каналы можно подключить | Канал | Что это | Время настройки | Инструкция | |---|---|---|---| | Telegram Bot | Бот в Telegram. Клиенты пишут боту, вы получаете сообщения | 2 мин | [Telegram Bot](https://docs.tuk-tuk.online/channels/telegram-bot) | | Telegram-аккаунт | Личный аккаунт Telegram. Переписка от своего имени | 5 мин | [Telegram-аккаунт](https://docs.tuk-tuk.online/channels/telegram-account) | | Чат-виджет | Окно чата на вашем сайте. Посетители пишут, вы отвечаете | 3 мин | [Чат-виджет](https://docs.tuk-tuk.online/channels/chat-widget) | | SMS-шлюз | SMS через ваш Android-телефон с SIM-картой | 5 мин | [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms) | | Email | Почтовый ящик: Gmail, Yandex, Mail.ru, корпоративная почта | 5 мин | [Email](https://docs.tuk-tuk.online/channels/email) | | ВКонтакте | Личные сообщения вашего сообщества VK | 5 мин | [VK-сообщество](https://docs.tuk-tuk.online/channels/vk-community) | | Instagram DM | Direct-сообщения и комментарии бизнес-аккаунта Instagram | 10 мин | [Instagram DM](https://docs.tuk-tuk.online/channels/instagram) | | Авито | Переписка с покупателями и продавцами на Авито | 5 мин | [Авито](https://docs.tuk-tuk.online/channels/avito) | | MAX Bot | Бот в мессенджере MAX | 10 мин | [MAX Bot](https://docs.tuk-tuk.online/channels/max-bot) | | Webhook | Приём заявок от любых сервисов по HTTP | 5 мин | [Webhook](https://docs.tuk-tuk.online/channels/webhook) | | amoCRM | Чаты из amoCRM. Создаётся автоматически вместе с интеграцией | 10 мин | [amoCRM Chat](https://docs.tuk-tuk.online/channels/amocrm-chat) | ## Как добавить канал ![Раздел «Каналы связи» в кабинете tuk-tuk.online](https://docs.tuk-tuk.online/assets/screens/channels/overview.webp) 1. Пункт «Каналы связи» в левом меню. 2. Кнопка «Подключить» на карточке нужного канала. 3. Виджет чата подключается кнопкой «Создать виджет». 4. Счётчик показывает, сколько каналов этого типа уже работает. 1. Откройте раздел [Каналы связи](https://lk.tuk-tuk.online/channels) в кабинете. 2. Нажмите «Подключить»: откроется список типов. 3. Выберите тип канала. 4. Заполните поля: токен, ключ API или другие данные, которые просит форма. 5. Нажмите «Сохранить»: канал получит статус «Активен» и начнёт принимать сообщения. ![Список уже подключённых каналов со статусами](https://docs.tuk-tuk.online/assets/screens/channels/connected-list.webp "Подключённые каналы собраны внизу страницы: статус, статистика, пауза и удаление.") ## Что можно делать с каждым каналом ### AI-ассистент К любому каналу можно привязать AI-ассистента. Он отвечает клиентам сам, по вашим инструкциям. Как настроить: [Настройка ассистента](https://docs.tuk-tuk.online/ai/assistants). ### Цепочки автоматизации Цепочка: пошаговый сценарий. Например: «клиент написал, отправить приветствие, подождать ответ, передать AI». Собирается в визуальном конструкторе. Подробнее: [Цепочки](https://docs.tuk-tuk.online/chains). ### Статистика Для каждого канала доступны количество сообщений, число активных диалогов и время ответа. ## Доступность по тарифам | Тариф | Доступные каналы | |---|---| | Бесплатный | Telegram Bot, Чат-виджет | | Бизнес / Корпоративный | Все 11 каналов | Подробнее о тарифах: [Тарифы и оплата](https://docs.tuk-tuk.online/billing). ## Сравнение каналов | Возможность | TG Bot | TG-аккаунт | Виджет | SMS | Email | VK | Instagram | Авито | MAX | Webhook | amoCRM | |---|---|---|---|---|---|---|---|---|---|---|---| | Текст | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | | Фото | Да | Да | Да | Нет | Да | Да | Да | Да | Да | Да | Нет | | Видео | Да | Да | Нет | Нет | Нет | Да | Нет | Нет | Да | Нет | Нет | | Голосовые | Да | Да | Да | Нет | Нет | Да | Нет | Нет | Да | Нет | Нет | | Документы | Да | Да | Да | Нет | Да | Да | Нет | Нет | Да | Нет | Нет | | Кнопки | Да | Нет | Да | Нет | Нет | Нет | Нет | Нет | Да | Нет | Нет | | AI-ассистент | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | | Цепочки | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | Да | --- --- title: "Подключение Telegram Bot к tuk-tuk.online" nav_title: "Telegram Bot" url: https://docs.tuk-tuk.online/channels/telegram-bot markdown: https://docs.tuk-tuk.online/channels/telegram-bot.md section: "Каналы связи" description: "Как подключить Telegram-бота к tuk-tuk.online за 2 минуты: создание бота в @BotFather, токен, привязка канала, проверка. Что умеет канал, лимиты Bot API и частые ошибки." keywords: ["подключить Telegram бот", "BotFather создать бота", "Telegram бот для бизнеса", "tuk-tuk Telegram", "настройка Telegram бота", "чат-бот Telegram", "Telegram бот автоответчик", "бот для продаж Telegram", "Telegram рассылка", "Telegram бот конструктор"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал Telegram Bot принимает сообщения клиентов, написавших боту, в раздел «Диалоги» tuk-tuk.online и отвечает от имени бота. Подходит для поддержки, AI-автоответов и цепочек в Telegram. > > - Тариф: доступен на бесплатном тарифе. > - Путь в кабинете: Каналы связи → Подключить → Telegram Bot → название и токен → Сохранить. > - Предусловие: токен бота от @BotFather (команда /newbot, username оканчивается на bot). > - Лимиты Bot API: файл до 20 МБ, текст до 4096 символов (длиннее делится на части), пауза около 3 секунд между сообщениями. > - Бот не пишет первым: клиент должен нажать «Старт». > - Кнопки в исходящих сообщениях задаются через цепочки автоматизации. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/channels/telegram-account, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/dialogs # Подключение Telegram Bot Telegram Bot: аккаунт в Telegram, которым управляет программа, а не человек. Клиенты пишут боту, сообщения приходят в раздел [Диалоги](https://lk.tuk-tuk.online/dialogs) tuk-tuk.online, ответы уходят от имени бота. Самый быстрый канал для старта: настройка занимает около 2 минут. Канал доступен на бесплатном тарифе. ## Когда это нужно - Отвечать клиентам в Telegram из общего раздела «Диалоги». - Поставить AI-ассистента, который отвечает вместо вас. - Запускать цепочки: приветствие, квиз, воронку. ## Как подключить ### Создать бота в Telegram 1. Откройте в Telegram [@BotFather](https://t.me/BotFather), официального бота для создания ботов. 2. Отправьте команду `/newbot`: BotFather попросит имя. 3. Введите имя бота, которое увидят клиенты (например, «Поддержка магазина»). 4. Введите username: уникальный адрес бота, обязательно заканчивается на `bot` (например, `myshop_support_bot`). 5. Скопируйте токен из ответа BotFather. Он выглядит как `7123456789:AAF...xyz`. > [!WARNING] Токен даёт полный контроль над ботом. Не передавайте его никому и не публикуйте. ### Подключить канал в tuk-tuk.online 1. Войдите в [кабинет](https://lk.tuk-tuk.online) и откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Telegram Bot. 3. Введите название канала: для себя, чтобы отличать его от других. 4. Вставьте токен от BotFather. 5. Нажмите «Сохранить»: у канала появится зелёный статус «Активен». ![Форма подключения Telegram-бота](https://docs.tuk-tuk.online/assets/screens/channels/telegram-bot-form.webp) 1. Название канала: любое, чтобы отличать канал в списке. 2. Bot Token из @BotFather, копируется целиком, без пробелов. 3. Кнопка «Подключить»: имя бота подтянется автоматически. ## Проверить, что работает 1. Откройте бота в Telegram по его username. 2. Нажмите «Старт» или отправьте любое сообщение. 3. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится в списке новым диалогом. ## Что умеет ### Входящие сообщения от клиентов | Тип | Описание | |---|---| | Текст | Обычные текстовые сообщения | | Фото | Изображения | | Голосовые | Голосовые сообщения, можно расшифровать через AI | | Видео | Видеофайлы | | Видеосообщения | Круглые короткие видео («кружочки») | | Стикеры | Стикеры Telegram | | Документы | Любые файлы: PDF, Word, ZIP и другие | | Контакты | Номер телефона из карточки контакта | | Геолокация | Точка на карте | ### Исходящие сообщения | Тип | Описание | |---|---| | Текст | Markdown-разметка: жирный, курсив, ссылки | | Фото | С подписью до 1024 символов | | Голосовые | Голосовые сообщения | | Видео | Видеофайлы | | Видеосообщения | Круглые «кружочки» | | Стикеры | Стикеры | | Документы | Файлы любого формата | | Кнопки | Интерактивные кнопки, задаются в цепочках автоматизации | ### AI-ассистент К боту можно подключить AI-ассистента: он отвечает клиентам сам, круглосуточно. Как настроить: [Настройка ассистента](https://docs.tuk-tuk.online/ai/assistants). ### Оформление бота в BotFather Аватар, описание и меню команд настраиваются в самом Telegram, командами @BotFather: | Команда | Что делает | |---|---| | `/setuserpic` | Ставит аватар бота | | `/setdescription` | Описание, которое клиент видит при первом открытии | | `/setabouttext` | Текст «О боте» в профиле | | `/setcommands` | Меню команд внизу чата | ## Ограничения - Ботов можно подключить сколько угодно, каждый как отдельный канал. - Максимальный размер файла через Bot API: 20 МБ. - Лимит Telegram на одно сообщение: 4096 символов. Длинные тексты платформа разбивает на части автоматически. - Бот не может написать первым: клиент должен сам начать диалог, нажав «Старт». - Между сообщениями пауза около 3 секунд: защита от лимитов Telegram. ## Частые проблемы | Проблема | Что делать | |---|---| | Бот не отвечает | Проверьте статус канала: должен быть «Активен» | | Ошибка «Conflict: terminated by other getUpdates request» | Бот подключён к другому сервису. Отключите его там | | Сообщения не приходят | Проверьте, что токен скопирован целиком, без пробелов | | Бот отвечает с задержкой | Это норма: между сообщениями пауза около 3 секунд | --- --- title: "Подключение Telegram-аккаунта к tuk-tuk.online" nav_title: "Telegram-аккаунт" url: https://docs.tuk-tuk.online/channels/telegram-account markdown: https://docs.tuk-tuk.online/channels/telegram-account.md section: "Каналы связи" description: "Как подключить личный Telegram-аккаунт к tuk-tuk.online и переписываться от своего имени: API ID и API Hash с my.telegram.org, код подтверждения, двухфакторная защита, приём из групп и каналов." keywords: ["Telegram аккаунт подключить", "Telegram userbot", "MTProto", "подключить личный Telegram", "рассылка от личного аккаунта", "Telegram Account API", "автоответчик Telegram аккаунт", "Telegram переписка от своего имени"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал Telegram-аккаунт подключает личный аккаунт Telegram к tuk-tuk.online по MTProto: переписка идёт от вашего имени, можно писать первым и принимать сообщения из групп и каналов. > > - Тариф: «Бизнес» и выше. > - Путь в кабинете: Каналы связи → Подключить → Telegram Account → API ID, API Hash, номер телефона → код подтверждения → облачный пароль при включённой 2FA. > - Предусловия: API ID и API Hash с my.telegram.org (раздел API Development Tools) и доступ к номеру телефона аккаунта. > - По умолчанию принимаются только личные чаты; группы и каналы включаются отдельно в настройках канала. > - Пауза около 10 секунд между сообщениями (защита от FloodWait); один аккаунт нельзя подключить к двум сервисам одновременно. > - При подключении доступен импорт существующих диалогов с историей. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/channels/telegram-bot, https://docs.tuk-tuk.online/dialogs/import-export, https://docs.tuk-tuk.online/funnels/tg-funnels, https://docs.tuk-tuk.online/ai/assistants # Подключение Telegram-аккаунта Канал подключает личный аккаунт Telegram к tuk-tuk.online. Сообщения приходят и уходят от вашего имени: с вашим аватаром, а не от бота. Соединение идёт по MTProto, тому же протоколу, что и в обычном приложении Telegram. Канал доступен на тарифе «Бизнес» и выше. ## Когда это нужно - Писать клиентам от своего имени, а не от бота. - Написать первым тому, кто ещё не начинал диалог. - Автоматизировать ответы в уже существующих чатах. - Получать сообщения из групп и каналов Telegram. ## Как подключить ### Получить API ID и API Hash Telegram требует ключи приложения для подключения аккаунта. Это не токен бота, а отдельная пара значений. 1. Откройте [my.telegram.org](https://my.telegram.org) и войдите по номеру телефона аккаунта. 2. Откройте раздел «API Development Tools». 3. Создайте приложение: Telegram выдаст API ID (число) и API Hash (строка из букв и цифр). > [!NOTE] Ключи бесплатные и выдаются один раз. По ним Telegram понимает, что подключается разрешённое приложение. ### Добавить канал ![Форма подключения Telegram-аккаунта](https://docs.tuk-tuk.online/assets/screens/channels/telegram-account-form.webp) 1. Название канала. 2. Номер телефона аккаунта в международном формате. 3. Кнопка «Отправить код»: код придёт в Telegram, дальше шаги «Код» и «Готово». 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Telegram Account. 3. Введите API ID и API Hash. 4. Введите номер телефона аккаунта: Telegram пришлёт код подтверждения. 5. Введите код. Если включена двухфакторная аутентификация (облачный пароль), введите и его. 6. Дождитесь статуса «Активен»: платформа установила защищённое соединение по MTProto. ## Что умеет ### Откуда принимать сообщения | Настройка | Что это | |---|---| | Личные чаты | Переписки один на один | | Группы | Групповые чаты, в которых состоит аккаунт | | Каналы | Telegram-каналы, на которые подписан аккаунт | По умолчанию включены только личные чаты. Группы и каналы включаются отдельно в настройках канала. ### Импорт диалогов При подключении можно импортировать существующие диалоги: они появятся в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs) вместе с историей переписки. Подробнее: [Импорт и экспорт](https://docs.tuk-tuk.online/dialogs/import-export). ### Отличия от Telegram Bot | Критерий | Telegram Bot | Telegram-аккаунт | |---|---|---| | Кто отправитель | Бот | Вы: ваш аватар и имя | | Может писать первым | Нет, клиент должен нажать «Старт» | Да, любому пользователю | | Групповые чаты | Только если бота добавили в группу | Все группы аккаунта | | Медиа | Стандартный набор | Все типы, включая голосовые заметки | | Тариф | Бесплатный | «Бизнес» и выше | | Риски | Нет | Блокировка аккаунта при злоупотреблении | ## Ограничения - Не рассылайте спам. За массовые сообщения незнакомым людям Telegram блокирует аккаунт, временно или навсегда. - Подключайте только свой аккаунт или аккаунт сотрудника с его согласия. - Один аккаунт нельзя подключить к двум сервисам одновременно. - Между сообщениями пауза около 10 секунд: защита от FloodWait. - При обрыве связи соединение восстанавливается автоматически. ## Частые проблемы | Проблема | Что делать | |---|---| | Ошибка SESSION_REVOKED | Сессия сброшена. Переподключите аккаунт | | Ошибка PHONE_CODE_EXPIRED | Код подтверждения устарел. Запросите новый | | Сообщения не приходят | Проверьте настройки приёма: личные чаты, группы, каналы | | Ошибка FloodWait | Telegram временно ограничил аккаунт. Подождите указанное время | --- --- title: "Чат-виджет для сайта: установка, настройка, AI-ассистент" nav_title: "Чат-виджет для сайта" url: https://docs.tuk-tuk.online/channels/chat-widget markdown: https://docs.tuk-tuk.online/channels/chat-widget.md section: "Каналы связи" description: "Как поставить чат-виджет tuk-tuk.online на сайт за 3 минуты: код скрипта, внешний вид, кнопки быстрых ответов, popup, авто-действия, отслеживание посетителей. Доступен на бесплатном тарифе." keywords: ["чат-виджет для сайта", "live chat бесплатно", "онлайн-консультант для сайта", "виджет чата", "установить чат на сайт", "popup чат", "чат поддержки на сайте", "альтернатива JivoSite", "онлайн чат для сайта бесплатно", "виджет обратной связи", "чат-бот для сайта"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Чат-виджет ставится на сайт одним тегом script и передаёт сообщения посетителей в раздел «Диалоги» tuk-tuk.online. Отвечает оператор или AI-ассистент; есть кнопки быстрых ответов, popup, авто-действия и данные о посетителях. > > - Тариф: доступен на бесплатном тарифе. > - Путь в кабинете: Каналы связи → Подключить → Чат-виджет → название → Сохранить. Внешний вид, кнопки, popup и авто-действия: раздел «Настройки виджета». > - Установка: тег ``` > [!TIP] Не знаете, куда вставить код: передайте его разработчику или веб-мастеру сайта. Обычно это занимает минуту. ## Проверить, что работает 1. Откройте сайт: в углу экрана появится кнопка-пузырь. 2. Нажмите на неё и отправьте сообщение. 3. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится как новый диалог. ## Что умеет ### Внешний вид ![Настройки чат-виджета: вкладка «Основные»](https://docs.tuk-tuk.online/assets/screens/channels/widget-settings.webp) 1. Вкладки настроек: Основные, Дизайн, Кнопки, Автодействия, Интерактивные, Всплывашки, Домены, Установка. 2. Заголовок и подзаголовок окна чата. 3. Приветственный текст, который видит посетитель. 4. Кнопка «Сохранить»: изменения появятся на сайте после сохранения. ![Вкладка «Дизайн»: цвета и размеры окна](https://docs.tuk-tuk.online/assets/screens/channels/widget-design.webp "Вкладка «Дизайн»: основной цвет, цвет сообщений клиента и кнопок, размеры окна, позиция.") Настраивается в разделе [Настройки виджета](https://lk.tuk-tuk.online/chat-widget). Основные настройки: | Параметр | Что это | |---|---| | Цвет акцента | Главный цвет кнопки и заголовка виджета | | Положение | Левый или правый нижний угол экрана | | Отступы | Расстояние от края экрана в пикселях | | Имя оператора | Как зовут оператора в окне чата | | Аватар | Иконка оператора | | Приветствие | Текст, который посетитель видит при открытии чата | Кнопка-пузырь: | Параметр | Что это | |---|---| | Стиль | Круглая кнопка, баннер с текстом или своя иконка | | Размер | Маленькая, средняя или большая | | Цвет | Цвет кнопки, может отличаться от цвета акцента | | Текст баннера | Надпись на кнопке в стиле «баннер» | Размеры окна: | Параметр | Что это | |---|---| | Ширина | Ширина окна чата | | Высота | Высота окна чата | | Размер шрифта | Размер текста в сообщениях | ### Кнопки быстрых ответов ![Вкладка «Кнопки»: быстрые ответы в виджете](https://docs.tuk-tuk.online/assets/screens/channels/widget-buttons.webp "Кнопки показываются под приветствием и подставляют готовый текст за клиента.") Кнопки показываются в чате. Посетитель нажимает кнопку, её текст уходит как сообщение. Примеры: «Узнать цены», «Заказать звонок», «Задать вопрос». Кнопки располагаются горизонтально или вертикально. Есть режим, в котором они исчезают после первого сообщения. ### Popup-окно ![Вкладка «Всплывашки»](https://docs.tuk-tuk.online/assets/screens/channels/widget-popups.webp "Всплывающее окно показывается по времени, скроллу или уходу со страницы.") Всплывающее окно, которое привлекает внимание посетителя и предлагает начать диалог. | Параметр | Что это | |---|---| | Шаблон | 6 готовых дизайнов | | Заголовок и текст | Сообщение, которое видит посетитель | | Задержка | Через сколько секунд показать popup | | Частота | Как часто показывать повторным посетителям | ### Авто-действия ![Вкладка «Автодействия»](https://docs.tuk-tuk.online/assets/screens/channels/widget-auto.webp "Автодействия отправляют сообщение сами: через N секунд, при возврате, по странице.") Правила вида «условие: действие», которые срабатывают без участия оператора. Примеры: - Посетитель на странице дольше 30 секунд: отправить приветствие. - Посетитель на странице цен: показать popup с предложением. - Нерабочее время: показать форму «Оставьте email, мы ответим». - Определённая UTM-метка: отправить персональное сообщение. Каждое авто-действие состоит из условий (когда срабатывает) и действия (что делает). ### Отслеживание посетителей ![Страница «Посетители»: кто сейчас на сайте](https://docs.tuk-tuk.online/assets/screens/channels/widget-visitors.webp "Посетители обновляются каждые 5 секунд: город, страница, время на сайте, просмотры, UTM.") | Данные | Описание | |---|---| | Город и страна | Определяются по IP-адресу | | Текущая страница | На какой странице находится посетитель | | Браузер и ОС | Chrome, Firefox, Windows, macOS и другие | | Источник | Прямой заход, поиск, реклама | | UTM-метки | utm_source, utm_medium, utm_campaign | Данные видны в разделе [Посетители](https://lk.tuk-tuk.online/visitors). ### Мобильная и десктопная версия Виджет можно показывать или скрывать отдельно для мобильных и десктопных устройств. Например, на телефоне показывать только кнопку звонка, а на компьютере полноценный чат. ### Звуковые уведомления При новом сообщении от посетителя звучит сигнал. Громкость настраивается. ### Типы сообщений Посетитель отправляет: - текст; - файлы и документы. Оператор отправляет: - текст; - изображения; - документы; - голосовые сообщения; - интерактивные сообщения (кнопки, ссылки, карусели) через [цепочки автоматизации](https://docs.tuk-tuk.online/chains). ### Домены ![Вкладка «Домены»](https://docs.tuk-tuk.online/assets/screens/channels/widget-domains.webp "Ограничьте домены, на которых работает виджет.") По умолчанию виджет работает на любом сайте. Для безопасности можно задать список разрешённых доменов: виджет будет работать только на них. ## Частые проблемы | Проблема | Что делать | |---|---| | Виджет не появляется | Проверьте, что скрипт вставлен перед `` | | Виджет появляется с задержкой | Это норма: скрипт загружается после основной страницы | | Нет уведомлений | Проверьте настройку звука в параметрах виджета | --- --- title: "SMS-шлюз: отправка и приём SMS через Android-телефон" nav_title: "SMS-шлюз" url: https://docs.tuk-tuk.online/channels/sms markdown: https://docs.tuk-tuk.online/channels/sms.md section: "Каналы связи" description: "Как превратить Android-телефон с SIM-картой в SMS-шлюз tuk-tuk.online: приложение, привязка по QR-коду, SMS-канал, статусы доставки, лимиты. Без платного SMS-провайдера, оплата по тарифу оператора." keywords: ["SMS шлюз бесплатно", "отправить SMS с Android", "Android SMS gateway", "SMS через телефон", "бесплатная отправка SMS", "SMS рассылка бесплатно", "SMS канал", "SMS уведомления клиентам"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > SMS-шлюз отправляет и принимает SMS через Android-телефон с SIM-картой и приложением tuk-tuk. SMS-провайдер не нужен, оплата по тарифу оператора; статусы доставки видны в диалогах. > > - Путь в кабинете: Каналы связи → Подключить → SMS → выбрать привязанное устройство → Сохранить. > - Предусловия: Android-телефон с SIM-картой, приложение tuk-tuk (APK из раздела «SMS» кабинета) с разрешениями на SMS и уведомления, привязка по QR-коду. > - QR-код привязки действует 10 минут и одноразовый. > - Статусы SMS: Pending, Sent, Delivered, Failed, Received. > - Лимиты в настройках устройства: в день, в месяц, разрешённые страны, заблокированные номера, максимальная длина. > - Оплата SMS по тарифу оператора; операторы обычно ограничивают 100–200 SMS в день. Телефон должен быть постоянно в сети. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/sms-gateway/setup, https://docs.tuk-tuk.online/sms-gateway/features, https://docs.tuk-tuk.online/sms-gateway/reliability, https://docs.tuk-tuk.online/sms-gateway/monitoring # SMS-шлюз SMS-шлюз отправляет и принимает SMS через обычный Android-телефон с SIM-картой. Платный SMS-провайдер не нужен: вы платите только оператору по своему тарифу. Телефон с приложением tuk-tuk лежит на столе и отправляет SMS, когда оператор, цепочка или AI нажимает «Отправить» в кабинете. ## Когда это нужно - Отправлять клиентам SMS-уведомления без SMS-провайдера. - Принимать входящие SMS и обрабатывать их в общем разделе «Диалоги». - Автоматизировать SMS-рассылки через цепочки. ## Как это работает ```text Вы нажимаете Клиент «Отправить» получает в tuk-tuk.online SMS │ ▲ ▼ │ ┌────────┐ push-уведомление ┌──────────┐ │ │ Сервер │ ───────────────────→ │ Android │ ───┘ │ │ ← отчёт о доставке ── │ телефон │ └────────┘ └──────────┘ ``` 1. Оператор или цепочка отправляет SMS из tuk-tuk.online. 2. Сервер шлёт push-уведомление на Android-телефон. 3. Телефон отправляет SMS через SIM-карту, как обычное сообщение. 4. Телефон возвращает серверу отчёт: «Доставлено» или «Ошибка». Входящие SMS идут тем же путём в обратную сторону. ## Как подключить ### Установить приложение 1. Откройте раздел [SMS](https://lk.tuk-tuk.online/sms) в кабинете. 2. Скачайте Android-приложение tuk-tuk (APK-файл). 3. Установите его на телефон. 4. Разрешите приложению отправлять SMS и получать уведомления. ### Привязать телефон 1. На экране [SMS](https://lk.tuk-tuk.online/sms) в кабинете найдите QR-код. 2. Откройте приложение на телефоне и нажмите «Сканировать QR-код». 3. Наведите камеру на QR-код на экране компьютера: телефон появится в списке устройств кабинета. > [!NOTE] QR-код действует 10 минут и срабатывает один раз. Если не успели, обновите страницу. ### Создать SMS-канал ![Создание SMS-канала и привязка телефона](https://docs.tuk-tuk.online/assets/screens/channels/sms-form.webp) 1. Название канала. 2. Кнопка «Подключить»: после создания у канала появится QR-код для приложения Тук-Тук на Android. 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке SMS. 3. Выберите привязанное устройство из списка. 4. Нажмите «Сохранить»: канал появится в списке со статусом «Активен». ## Что умеет ### Статусы SMS Статус каждого сообщения обновляется в реальном времени. | Статус | Что это значит | |---|---| | В очереди (Pending) | Сообщение ждёт отправки | | Отправлено (Sent) | Телефон отправил SMS | | Доставлено (Delivered) | Оператор связи подтвердил доставку | | Ошибка (Failed) | Отправить не удалось | | Получено (Received) | Входящее SMS | ### Лимиты и защита от случайных рассылок Задаются в настройках устройства. | Параметр | Что это | |---|---| | Лимит в день | Максимум SMS в сутки (например, 100) | | Лимит в месяц | Максимум SMS в месяц | | Разрешённые страны | Отправка только в выбранные страны | | Заблокированные номера | На эти номера SMS не уходят никогда | | Максимальная длина сообщения | Ограничение длины текста SMS | ### Информация об устройстве В кабинете видно состояние телефона: - модель и производитель; - уровень заряда батареи; - тип подключения: Wi-Fi или мобильный интернет; - данные SIM-карты; - время последнего «пульса» (heartbeat); - счётчики отправленных и полученных SMS. Подробнее о приложении: [SMS Gateway (Android)](https://docs.tuk-tuk.online/sms-gateway). ## Ограничения - Телефон должен быть постоянно в сети: Wi-Fi или мобильный интернет. - SMS оплачиваются по тарифу вашего оператора. - Операторы ограничивают число SMS в день, обычно 100–200. - Если телефон уснул или потерял связь, сервер попробует его разбудить. ## Частые проблемы | Проблема | Что делать | |---|---| | Телефон офлайн | Проверьте интернет на телефоне и что приложение tuk-tuk открыто | | SMS не отправляется | Проверьте баланс SIM-карты и лимиты оператора | | Входящие SMS не приходят | Убедитесь, что приложению разрешён доступ к SMS | | QR-код не сканируется | Обновите страницу: QR-код мог истечь (10 минут) | --- --- title: "Подключение Email (SMTP/IMAP): Gmail, Yandex, Mail.ru" nav_title: "Email (SMTP/IMAP)" url: https://docs.tuk-tuk.online/channels/email markdown: https://docs.tuk-tuk.online/channels/email.md section: "Каналы связи" description: "Как подключить почтовый ящик Gmail, Yandex, Mail.ru или корпоративную почту к tuk-tuk.online: IMAP, SMTP, пароль приложения, серверы и порты. Письма как диалоги, AI-ответы, защита от спама, ссылка отписки." keywords: ["подключить email к CRM", "SMTP настройка Gmail", "IMAP почта Yandex", "email канал для бизнеса", "Gmail подключение", "Yandex почта интеграция", "Mail.ru SMTP", "email автоответчик", "email рассылка", "обработка email AI"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Email-канал подключает почтовый ящик к tuk-tuk.online по IMAP (приём) и SMTP (отправка): письма становятся диалогами, на них отвечает оператор, AI-ассистент или цепочка. Поддерживаются Gmail, Yandex, Mail.ru и корпоративная почта. > > - Путь в кабинете: Каналы связи → Подключить → Email → SMTP- и IMAP-серверы, порты, логин, пароль приложения, имя отправителя → Сохранить. > - Предусловия: включённый IMAP в ящике и пароль приложения (Gmail, Yandex, Mail.ru); основной пароль аккаунта не подходит. > - Серверы: Gmail smtp.gmail.com и imap.gmail.com, Yandex smtp.yandex.ru и imap.yandex.ru, Mail.ru smtp.mail.ru и imap.mail.ru. Порты: SMTP 587, IMAP 993. > - Лимит отправки по умолчанию: 100 писем в час, настраивается в канале. > - Входящие принимаются в реальном времени по IMAP IDLE; к каждому исходящему письму добавляются ссылка отписки и заголовок List-Unsubscribe. > - Защита от спама: SPF, DKIM и DMARC в DNS домена; DKIM-селектор и Reply-To задаются в настройках канала. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains/blocks/send-message # Подключение Email Email-канал подключает почтовый ящик (Gmail, Yandex, Mail.ru или корпоративную почту) к tuk-tuk.online. Входящие письма становятся диалогами: на них отвечает оператор или AI-ассистент, а цепочки отправляют письма автоматически. Приём идёт по IMAP, отправка по SMTP. ## Когда это нужно - Заявки приходят на почту, и их нужно обрабатывать вместе с мессенджерами. - Нужен AI-помощник, который сам отвечает на типовые письма. - Нужны email-рассылки через цепочки автоматизации. ## Как подключить Сначала включите IMAP в ящике и создайте пароль приложения, затем добавьте канал в кабинете. ### Подготовить ящик: Gmail 1. Откройте «Настройки → Все настройки → Пересылка и POP/IMAP». 2. Включите «Доступ по IMAP». 3. Откройте [Пароли приложений Google](https://myaccount.google.com/apppasswords). 4. Создайте пароль приложения для «Почта» и сохраните его: он нужен при подключении вместо основного пароля. ### Подготовить ящик: Yandex 1. Откройте «Настройки → Почтовые программы». 2. Включите «С сервера imap.yandex.ru по протоколу IMAP». 3. Если включена двухфакторная аутентификация, создайте пароль приложения. ### Подготовить ящик: Mail.ru 1. Откройте «Настройки → Безопасность → Пароли для внешних приложений». 2. Создайте пароль приложения. IMAP включится автоматически. ### Добавить канал ![Форма подключения почтового ящика по SMTP и IMAP](https://docs.tuk-tuk.online/assets/screens/channels/email-form.webp) 1. Название канала. 2. SMTP-хост вашего провайдера. 3. SMTP-порт: обычно 465 для SSL. 4. Логин: полный адрес ящика. 5. Пароль приложения, не пароль от аккаунта. 6. IMAP-хост для приёма писем. 7. IMAP-порт: обычно 993. 8. Адрес в поле From. 9. Имя отправителя, которое видит клиент. 10. Reply-To, если ответы должны идти на другой адрес. 11. Ссылка отписки для массовых рассылок. 12. Кнопка «Подключить». 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Email. 3. Введите SMTP- и IMAP-серверы и порты из таблицы ниже. 4. Укажите логин (ваш email-адрес), пароль приложения и имя отправителя (например, «Поддержка магазина»). 5. Нажмите «Сохранить»: канал появится в списке. | Сервис | SMTP-сервер | IMAP-сервер | Порт SMTP | Порт IMAP | |---|---|---|---|---| | Gmail | smtp.gmail.com | imap.gmail.com | 587 | 993 | | Yandex | smtp.yandex.ru | imap.yandex.ru | 587 | 993 | | Mail.ru | smtp.mail.ru | imap.mail.ru | 587 | 993 | > [!WARNING] В поле «Пароль» вводите пароль приложения, а не основной пароль аккаунта. ## Проверить, что работает 1. Отправьте письмо на подключённый адрес с другого ящика. 2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): письмо появится как новый диалог. 3. Ответьте из диалога: ответ придёт получателю обычным письмом. ## Что умеет ### Входящие - Текстовые письма: plain text и HTML. - Вложения: документы, изображения и другие файлы. - Обработка в реальном времени по IMAP IDLE. ### Исходящие - HTML-письма с разметкой. - Текстовые письма. - Ссылка для отписки добавляется к каждому письму автоматически. ### Защита от попадания в спам | Механизм | Что это | |---|---| | SPF | DNS-запись, которая подтверждает право отправлять письма от вашего домена | | DKIM | Цифровая подпись: доказывает, что письмо не изменено по пути | | DMARC | Политика: что делать с письмами, не прошедшими проверку | | List-Unsubscribe | Заголовок, по которому почтовый сервис показывает кнопку «Отписаться» | | Ограничение скорости | По умолчанию не больше 100 писем в час | > [!NOTE] SPF, DKIM и DMARC настраиваются в DNS вашего домена. Для корпоративной почты попросите об этом администратора. ### Отписка от рассылок Если получатель нажмёт «Отписаться», платформа запомнит это и больше не отправит ему писем. Ссылка отписки защищена цифровой подписью, подделать её нельзя. ### Дополнительные настройки | Параметр | Что это | |---|---| | Reply-To | Адрес для ответов, если отличается от основного | | Максимум писем в час | Защита от случайных массовых рассылок, по умолчанию 100 | | DKIM-селектор | Селектор из DNS, если используете DKIM | ## Частые проблемы | Проблема | Что делать | |---|---| | Письма не приходят | Проверьте IMAP-настройки и пароль приложения | | Ошибка «Authentication failed» | Используйте пароль приложения, а не основной пароль аккаунта | | Письма попадают в спам | Настройте SPF, DKIM и DMARC для вашего домена | | Отправка не работает | Проверьте SMTP-настройки: хост, порт, тип шифрования | Подробнее о цепочках, которые отправляют письма: [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message). --- --- title: "Подключение VK-сообщества к tuk-tuk.online" nav_title: "VK-сообщество" url: https://docs.tuk-tuk.online/channels/vk-community markdown: https://docs.tuk-tuk.online/channels/vk-community.md section: "Каналы связи" description: "Как подключить сообщения сообщества ВКонтакте к tuk-tuk.online: авторизация через VK ID, токен сообщества, Long Poll. Ответы подписчикам из общего раздела «Диалоги», AI-ассистент и цепочки." keywords: ["VK канал", "VK Community", "ВКонтакте подключить", "VK сообщество чат", "VK Long Poll", "сообщения ВКонтакте", "чат ВК для бизнеса", "VK автоответчик", "VK бот для группы"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал VK Community принимает личные сообщения сообщества ВКонтакте в раздел «Диалоги» tuk-tuk.online и отвечает от имени сообщества. События приходят через Long Poll, ответы подписчикам даёт оператор или AI-ассистент. > > - Путь в кабинете: Каналы связи → Подключить → VK Community → авторизация VK ID → выбор сообщества → токен сообщества → Сохранить. > - Предусловия: права администратора сообщества, Group Access Token с правами на сообщения, включённые «Сообщения сообщества» в настройках группы. > - Приём событий через Long Poll с задержкой меньше секунды; VK API версии 5.199. > - Входящие: текст, фото, голосовые, видео, документы. Исходящие: текст и фото. > - Ответы, отправленные напрямую из VK, попадают в диалог по событию message_reply. > - Пауза около 3 секунд между ответами. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/funnels/vk-funnels, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants # Подключение VK-сообщества Канал VK Community подключает личные сообщения сообщества ВКонтакте к tuk-tuk.online. Подписчик пишет в сообщения группы, сообщение приходит в раздел [Диалоги](https://lk.tuk-tuk.online/dialogs), ответ уходит от имени сообщества. Новые события платформа получает через Long Poll с задержкой меньше секунды. ## Когда это нужно - Клиенты пишут в личные сообщения вашего сообщества VK. - Отвечать в VK из одного окна вместе с Telegram, email и другими каналами. - Поставить AI-ассистента, который отвечает подписчикам автоматически. ## Как подключить ### Авторизоваться через VK ID ![Форма подключения сообщества ВКонтакте](https://docs.tuk-tuk.online/assets/screens/channels/vk-form.webp) 1. Название канала. 2. Кнопка «Авторизоваться через ВКонтакте»: дальше выбираете сообщество из списка, где вы администратор. 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке VK Community. 3. Нажмите кнопку авторизации VK ID: откроется окно входа ВКонтакте. 4. Войдите в аккаунт администратора нужного сообщества: в форме появится список ваших сообществ. > [!NOTE] Если VK ID недоступен, используйте альтернативную авторизацию (legacy OAuth). ### Выбрать сообщество 1. Выберите сообщество из списка. 2. Укажите токен сообщества (Group Access Token) с правами на сообщения. 3. Нажмите «Сохранить»: платформа подключит Long Poll, канал получит статус «Активен». ## Проверить, что работает 1. Откройте сообщество ВКонтакте с другого аккаунта. 2. Напишите в личные сообщения группы. 3. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится в списке. ## Что умеет ### Входящие сообщения от подписчиков | Тип | Описание | |---|---| | Текст | Обычные сообщения | | Фото | Изображения | | Голосовые | Голосовые сообщения | | Видео | Видеозаписи | | Документы | Файлы любых форматов | ### Исходящие сообщения | Тип | Описание | |---|---| | Текст | Сообщения от имени сообщества | | Фото | Изображения, загружаются через VK Upload | ### Синхронизация ответов из VK Если оператор ответил напрямую из VK, минуя tuk-tuk.online, ответ тоже попадёт в историю диалога: платформа отслеживает событие `message_reply`. Автопостинг историй в сообщество настраивается отдельно: [Воронки историй VK](https://docs.tuk-tuk.online/funnels/vk-funnels). ## Ограничения - Нужны права администратора сообщества. - Токен сообщества должен иметь права на сообщения. - Между ответами пауза около 3 секунд: защита от лимитов VK API. - Используется VK API версии 5.199. ## Частые проблемы | Проблема | Что делать | |---|---| | Канал не получает сообщения | Включите «Сообщения сообщества» в настройках группы | | Ошибка 403 | Проверьте, что у токена есть права на отправку и получение сообщений | | Исходящие не отображаются | Включите событие `message_reply` в настройках Long Poll сообщества | | Ошибка авторизации | Попробуйте альтернативную (legacy) авторизацию | --- --- title: "Подключение Instagram DM к tuk-tuk.online: Direct и комментарии" nav_title: "Instagram DM" url: https://docs.tuk-tuk.online/channels/instagram markdown: https://docs.tuk-tuk.online/channels/instagram.md section: "Каналы связи" description: "Как подключить бизнес-аккаунт Instagram к tuk-tuk.online через Facebook Graph API: авторизация, Direct-сообщения и комментарии в диалогах, публикация постов и каруселей, AI-ответы, лимиты API." keywords: ["Instagram канал", "Instagram DM", "Instagram Direct", "Instagram бизнес", "Instagram чат-бот", "Instagram комментарии", "Instagram автоответчик", "Instagram посты", "подключить Instagram к CRM"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал Instagram DM подключает бизнес-аккаунт Instagram к tuk-tuk.online через Facebook Graph API: Direct-сообщения и комментарии приходят в «Диалоги», ответы уходят в Instagram, из платформы публикуются посты и карусели. > > - Путь в кабинете: Каналы связи → Подключить → Instagram DM → «Авторизоваться через Facebook» → Сохранить. > - Предусловия: бизнес-аккаунт или аккаунт автора Instagram, привязанная Facebook-страница, права администратора этой страницы. > - Интеграция через Facebook Graph API; long-lived токены на 60 дней обновляются автоматически. > - Входящие: Direct (текст, изображения, видео) и комментарии к постам. Исходящие: текст и изображения в Direct, ответы на комментарии, посты и карусели. > - Первым писать в Direct нельзя; пауза около 10 секунд между ответами; комментарии опрашиваются polling каждые несколько секунд. > - Публикация постов только с изображениями, видео через API не загружается. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/funnels/ig-funnels, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants # Подключение Instagram DM Канал Instagram DM подключает бизнес-аккаунт Instagram к tuk-tuk.online через Facebook Graph API. Личные сообщения (Direct) и комментарии к постам приходят в раздел [Диалоги](https://lk.tuk-tuk.online/dialogs), ответы уходят обратно в Instagram. Из платформы также можно публиковать посты и карусели. ## Когда это нужно - Все Direct-сообщения от клиентов в одном окне с другими каналами. - Комментарии к постам как входящие сообщения. - Публикация постов и каруселей прямо из платформы. - AI-ответы на Direct и комментарии. - Цепочки для обработки обращений. ## Как подключить ### Что нужно заранее 1. Бизнес-аккаунт или аккаунт автора в Instagram. Личный аккаунт не подойдёт. 2. Facebook-страница, привязанная к этому Instagram-аккаунту. 3. Права администратора этой Facebook-страницы. > [!TIP] Переключить аккаунт на бизнес можно бесплатно: Настройки → Аккаунт → Тип аккаунта → Переключиться на бизнес. ### Авторизоваться через Facebook ![Форма подключения Instagram Direct](https://docs.tuk-tuk.online/assets/screens/channels/instagram-form.webp) 1. Название канала. 2. Кнопка авторизации через Facebook: выбираете страницу, связанную с профессиональным аккаунтом Instagram. 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Instagram DM. 3. Нажмите «Авторизоваться через Facebook»: откроется окно входа. 4. Войдите в аккаунт Facebook, который управляет нужной страницей. 5. Разрешите доступ к Instagram и странице: окно закроется, поля канала заполнятся автоматически. ### Сохранить канал После авторизации платформа сама получает три значения: Access Token (отправка сообщений), Page Access Token (работа с Facebook-страницей) и Instagram User ID. Нажмите «Сохранить»: канал появится в списке. ## Проверить, что работает 1. Отправьте Direct-сообщение на подключённый аккаунт со второго аккаунта. 2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится в списке. 3. Ответьте из диалога: ответ придёт в Instagram Direct. ## Что умеет ### Входящие | Тип | Описание | |---|---| | Direct-сообщения | Текст из Direct | | Медиа в Direct | Изображения и видео из Direct | | Комментарии | Комментарии к вашим постам | ### Исходящие | Тип | Описание | |---|---| | Текст в Direct | Текстовые ответы | | Изображения в Direct | Картинки в ответ | | Ответы на комментарии | Ответы под постами | | Публикация постов | Новые посты в ленте | | Карусели | Посты с несколькими фото | ### Публикация постов и каруселей Обычный пост: отправьте в канал сообщение с изображением и текстом, пост появится в ленте Instagram. Карусель: отправьте несколько изображений одним сообщением, они опубликуются как галерея со свайпом. > [!NOTE] Публикация идёт через Facebook Graph API: Instagram API не принимает контент напрямую. Изображения сначала загружаются как контейнеры, затем публикуются. Автопостинг историй настраивается отдельно: [Воронки историй Instagram](https://docs.tuk-tuk.online/funnels/ig-funnels). ### Токены - Используются long-lived токены со сроком жизни 60 дней. Платформа обновляет их заранее. - Если токен всё же истёк, канал покажет ошибку и попросит переподключиться. ## Ограничения - Пауза около 10 секунд между ответами: требование Instagram API. - Публикация постов только с изображениями. Видео через API не загружается. - Instagram API не позволяет писать в Direct первым, только отвечать на входящие. - Комментарии обрабатываются через polling: проверка каждые несколько секунд. ## Частые проблемы | Проблема | Что делать | |---|---| | Канал не получает Direct | Убедитесь, что аккаунт бизнес или автора, а не личный | | Нет комментариев в диалогах | Проверьте, что Facebook-страница привязана к Instagram | | Ошибка 190 (Invalid token) | Токен истёк. Переподключите канал | | Посты не публикуются | Выдайте все запрошенные права при авторизации Facebook | | Ошибка «Scoped user ID» | Это норма: Instagram использует IGSID вместо обычного ID | --- --- title: "Канал amoCRM Chat: синхронизация чатов amoCRM с tuk-tuk.online" nav_title: "amoCRM (Amojo)" url: https://docs.tuk-tuk.online/channels/amocrm-chat markdown: https://docs.tuk-tuk.online/channels/amocrm-chat.md section: "Каналы связи" description: "Канал amoCRM Chat создаётся автоматически при подключении интеграции amoCRM и синхронизирует текстовые сообщения между чатом сделки в amoCRM и диалогом tuk-tuk.online через Amojo Chat API." keywords: ["AmoCRM канал", "AmoCRM чат", "Amojo", "AmoCRM интеграция", "AmoCRM мессенджер", "AmoCRM подключить", "AmoCRM webhook", "AmoCRM автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал amoCRM Chat синхронизирует текстовые сообщения между чатом сделки в amoCRM и диалогом tuk-tuk.online через Amojo Chat API. Создаётся автоматически вместе с интеграцией amoCRM, вручную не добавляется. > > - Создаётся автоматически при подключении интеграции amoCRM (кабинет: Интеграции → amoCRM); в каталоге «Подключить» не показывается. > - Обмен через Amojo Chat API; все запросы подписаны HMAC-SHA1. > - Только текстовые сообщения в обе стороны, медиафайлы не поддерживаются. > - При удалении интеграции amoCRM канал перестаёт работать. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/integrations/amocrm, https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/dialogs # Канал amoCRM Chat Канал amoCRM Chat создаётся автоматически при подключении [интеграции amoCRM](https://docs.tuk-tuk.online/integrations/amocrm) и синхронизирует сообщения между чатом сделки в amoCRM и диалогом в tuk-tuk.online в обе стороны. Обмен идёт через Amojo Chat API. Вручную канал не создаётся: в каталоге «Подключить» его нет. ## Как это работает 1. При подключении интеграции в amoCRM появляется новый канал чата (через Amojo Chat API). 2. В tuk-tuk.online появляется канал amoCRM Chat. 3. Сообщения из чата amoCRM поступают в диалог tuk-tuk.online. 4. Ответы оператора или AI из tuk-tuk.online уходят обратно в чат amoCRM. ```text amoCRM (чат в сделке) ↕ Amojo Chat API tuk-tuk.online (диалог) ↕ AI / оператор ``` ## Как подключить 1. Откройте [Интеграции](https://lk.tuk-tuk.online/integrations). 2. Подключите amoCRM по инструкции [Интеграция amoCRM](https://docs.tuk-tuk.online/integrations/amocrm). 3. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels): канал amoCRM Chat появится в списке. ## Что умеет | Направление | Тип | Описание | |---|---|---| | Входящие | Текст | Сообщения из чата amoCRM | | Исходящие | Текст | Ответы, уходят в чат amoCRM | ### Безопасность Все запросы к Amojo Chat API подписываются HMAC-SHA1: получатель проверяет, что данные не изменены при передаче. ## Ограничения - Канала нет в каталоге «Подключить»: он создаётся только вместе с интеграцией amoCRM. - При удалении интеграции канал перестаёт работать. - Только текст: медиафайлы не поддерживаются. ## Частые проблемы | Проблема | Что делать | |---|---| | Канал не появился | Проверьте, что интеграция amoCRM подключена и работает | | Сообщения из amoCRM не приходят | Проверьте, что в amoCRM выбран правильный канал чата | | Ответы не уходят в amoCRM | Проверьте статус интеграции: токен мог истечь | | Дубли сообщений | Напишите в поддержку | --- --- title: "Подключение MAX Bot к tuk-tuk.online" nav_title: "MAX Bot" url: https://docs.tuk-tuk.online/channels/max-bot markdown: https://docs.tuk-tuk.online/channels/max-bot.md section: "Каналы связи" description: "Как подключить бота мессенджера MAX (бывший TamTam) к tuk-tuk.online: токен от @PrimeBot, Long Polling, типы сообщений, inline-кнопки, AI-ответы и лимиты API." keywords: ["MAX Bot", "MAX канал", "MAX мессенджер", "TamTam бот", "MAX подключить", "MAX API", "MAX автоответчик", "MAX бизнес", "MAX чат-бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал MAX Bot подключает бота мессенджера MAX (бывший TamTam) к tuk-tuk.online: сообщения пользователей приходят в «Диалоги», ответы уходят от имени бота, поддерживаются медиа и inline-кнопки. > > - Путь в кабинете: Каналы связи → Подключить → MAX Bot → токен → Сохранить. > - Предусловие: токен бота от @PrimeBot в MAX (команда /create). > - Приём через Long Polling, публичный IP и домен не нужны; API: platform-api.max.ru; медиа через MAX Upload API. > - Inline-кнопки: callback, link, request_contact, request_geo_location, open_app. > - Входящие: текст, фото, видео, аудио, файлы, локация, контакт, нажатие кнопки. Исходящие: текст, фото, видео, файлы, inline-кнопки. > - Пауза около 3 секунд между сообщениями. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/channels/telegram-bot, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains # Подключение MAX Bot Канал MAX Bot подключает бота в мессенджере MAX (мессенджер от VK, бывший TamTam) к tuk-tuk.online. Пользователь пишет боту, сообщение приходит в раздел [Диалоги](https://lk.tuk-tuk.online/dialogs), ответ уходит от имени бота. Сообщения принимаются через Long Polling, поэтому свой IP-адрес или домен не нужны. ## Когда это нужно - Ваши клиенты пользуются мессенджером MAX. - Обрабатывать сообщения из MAX вместе с другими каналами. - Поставить AI-ассистента, который отвечает пользователям MAX автоматически. ## Как подключить ### Создать бота в MAX 1. Откройте мессенджер MAX и найдите бота @PrimeBot, официального бота для создания ботов. 2. Отправьте команду `/create`: PrimeBot создаст нового бота. 3. Скопируйте токен бота из ответа. > [!WARNING] Токен даёт полный доступ к боту. Не передавайте его посторонним. ### Добавить канал ![Форма подключения MAX Bot](https://docs.tuk-tuk.online/assets/screens/channels/max-bot-form.webp) 1. Название канала. 2. Bot Token из MAX BotFather. 3. Кнопка «Подключить». 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке MAX Bot. 3. Вставьте токен бота. 4. Нажмите «Сохранить»: платформа подключит Long Polling, канал получит статус «Активен». ## Проверить, что работает 1. Найдите бота в MAX и напишите ему. 2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится в списке. ## Что умеет ### Входящие | Тип | Описание | |---|---| | Текст | Текстовые сообщения | | Фото | Изображения | | Видео | Видеозаписи | | Аудио | Голосовые сообщения | | Файлы | Документы любых форматов | | Локация | Геолокация пользователя | | Контакт | Карточка контакта | | Нажатие кнопки | Callback от inline-кнопок | ### Исходящие | Тип | Описание | |---|---| | Текст | Текстовые сообщения | | Фото | Изображения, загружаются через MAX Upload API | | Видео | Видеозаписи | | Файлы | Документы | | Inline-кнопки | Интерактивные кнопки под сообщением | ### Inline-кнопки | Тип | Что делает | |---|---| | callback | Отправляет callback-данные боту | | link | Открывает ссылку в браузере | | request_contact | Запрашивает контакт пользователя | | request_geo_location | Запрашивает геолокацию | | open_app | Открывает мини-приложение | Кнопки размещаются горизонтально или вертикально, в несколько рядов. Примеры: «Записаться», «Задать вопрос», «Посмотреть цены». Кнопки задаются в [цепочках автоматизации](https://docs.tuk-tuk.online/chains). ### Индикатор набора текста Пока AI формирует ответ, бот показывает пользователю индикатор «печатает…». ## Ограничения - Между сообщениями пауза около 3 секунд: защита от лимитов API. - Приём через Long Polling: работает без публичного IP и домена. - Медиафайлы загружаются через MAX Upload API. - Адрес MAX API: platform-api.max.ru. ## Частые проблемы | Проблема | Что делать | |---|---| | Канал не получает сообщения | Проверьте, что токен бота актуален | | Бот не отвечает | Убедитесь, что канал активен: зелёная точка в списке каналов | | Изображения не отправляются | Проверьте размер файла: у MAX есть лимит | | Кнопки не работают | Проверьте тип кнопки | --- --- title: "Подключение Авито к tuk-tuk.online: сообщения по объявлениям" nav_title: "Авито" url: https://docs.tuk-tuk.online/channels/avito markdown: https://docs.tuk-tuk.online/channels/avito.md section: "Каналы связи" description: "Как подключить мессенджер Авито к tuk-tuk.online: Client ID и Client Secret из кабинета Авито для бизнеса, OAuth2, polling каждые 5 секунд. Ответы покупателям из общего раздела «Диалоги», AI-ассистент." keywords: ["Avito канал", "Avito чат", "Avito подключить", "Avito мессенджер", "Avito API", "Avito автоответчик", "Avito CRM", "Avito бизнес", "сообщения Avito"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канал Авито принимает сообщения покупателей по объявлениям в раздел «Диалоги» tuk-tuk.online и отправляет ответы обратно в чат Авито. Работает через REST API Авито с OAuth2 и polling каждые 5 секунд. > > - Путь в кабинете: Каналы связи → Подключить → Avito → Client ID и Client Secret → Сохранить. > - Предусловия: профессиональный аккаунт Авито с доступом к API и приложение в кабинете Авито для бизнеса (Client ID, Client Secret). > - Авторизация OAuth2 client_credentials; токен получается и обновляется автоматически. > - Polling каждые 5 секунд; пауза около 5 секунд между ответами. > - Входящие и исходящие: текст и изображения. > - Одно подключение: один аккаунт Авито. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains # Подключение Авито Канал Авито подключает мессенджер Авито к tuk-tuk.online. Покупатель пишет по объявлению, сообщение приходит в раздел [Диалоги](https://lk.tuk-tuk.online/dialogs), ответ уходит обратно в чат Авито. Платформа работает через REST API Авито и опрашивает новые сообщения каждые 5 секунд. ## Когда это нужно - Вы продаёте на Авито и получаете много сообщений. - Отвечать покупателям из одного окна вместе с Telegram, email и VK. - Поставить AI-ассистента, который отвечает на типовые вопросы. ## Как подключить ### Получить ключи API Нужен профессиональный аккаунт Авито с доступом к API. 1. Войдите в [кабинет Авито для бизнеса](https://www.avito.ru/professionals). 2. Откройте раздел «API» (или «Настройки → Профиль для бизнеса»). 3. Создайте приложение, если его ещё нет. 4. Скопируйте Client ID и Client Secret. ### Добавить канал ![Форма подключения Авито](https://docs.tuk-tuk.online/assets/screens/channels/avito-form.webp) 1. Название канала. 2. Client ID из настроек профиля Авито. 3. Client Secret оттуда же. 4. Кнопка «Подключить»: нужны права messenger:read и messenger:write. 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Avito. 3. Введите Client ID и Client Secret. 4. Нажмите «Сохранить»: платформа получит OAuth2-токен, канал начнёт принимать сообщения. ## Проверить, что работает 1. Попросите кого-нибудь написать вам по одному из объявлений. 2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): сообщение появится в списке. 3. Ответьте из диалога: ответ придёт покупателю в Авито. ## Что умеет ### Входящие | Тип | Описание | |---|---| | Текст | Сообщения от покупателей | | Изображения | Фото товаров и другие картинки | ### Исходящие | Тип | Описание | |---|---| | Текст | Ответы покупателям | | Изображения | Фото в ответных сообщениях | ### Как это работает ```text Авито <---- опрос каждые 5 сек ---- tuk-tuk.online ↕ ↕ Покупатель Оператор / AI ``` - Авторизация: OAuth2 (client_credentials). Токен получается и обновляется автоматически. - Защита от дублей: платформа помнит ID последнего обработанного сообщения. ## Ограничения - Между ответами пауза около 5 секунд: защита от лимитов API. - Новые сообщения приходят с задержкой до 5 секунд из-за polling. - Нужен профессиональный аккаунт Авито с доступом к API. - Одно подключение: один аккаунт Авито. ## Частые проблемы | Проблема | Что делать | |---|---| | Канал не получает сообщения | Проверьте Client ID и Client Secret | | Ошибка авторизации | Убедитесь, что приложение Авито активно и ключи верные | | Ответы не доходят | Проверьте, что у приложения есть права на отправку сообщений | | Сообщения дублируются | Напишите в поддержку: возможен сбой синхронизации | Как настроить автоответы: [Настройка ассистента](https://docs.tuk-tuk.online/ai/assistants). --- --- title: "Webhook-канал: приём заявок с сайтов и форм в tuk-tuk.online" nav_title: "Webhook-канал" url: https://docs.tuk-tuk.online/channels/webhook markdown: https://docs.tuk-tuk.online/channels/webhook.md section: "Каналы связи" description: "Как принимать заявки с форм, Tilda, WordPress и любых сервисов в tuk-tuk.online через Webhook-канал: URL вебхука, GET и POST, автоматическое распознавание имени, телефона и email, запуск цепочек." keywords: ["Webhook канал", "Webhook подключить", "приём заявок", "форма обратной связи", "Tilda webhook", "WordPress webhook", "заявки с сайта", "интеграция форм", "лидогенерация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Webhook-канал принимает заявки по HTTP от форм, конструкторов сайтов и любых сервисов: каждая заявка становится диалогом с карточкой клиента и запускает назначенную цепочку. Канал односторонний, ответить через него нельзя. > > - Путь в кабинете: Каналы связи → Подключить → Webhook → Сохранить. URL вебхука показан в карточке канала. > - Эндпоинт: https://api.tuk-tuk.online/webhooks/incoming/; методы GET (параметры в URL) и POST (JSON в теле). > - Распознаваемые поля: name, first_name, firstName, client_name, Имя; phone, telephone, tel, mobile, Телефон; email, e-mail, mail, Email. Остальное сохраняется в customFields. > - Диалог создаётся или находится по телефону и email; назначенная каналу цепочка запускается автоматически. > - Флаг "_skipChains": true в теле запроса отключает запуск цепочек. > - Канал односторонний: ответить клиенту через Webhook нельзя, URL вебхука секретный. > > Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/blocks/webhook # Подключение Webhook-канала Webhook-канал принимает заявки и данные от любых внешних источников: форм на сайте, конструкторов (Tilda, WordPress), CRM и любых сервисов, которые умеют отправлять HTTP-запросы. Каждая заявка становится диалогом с карточкой клиента, а назначенная каналу цепочка запускается автоматически. Канал односторонний: данные приходят в tuk-tuk.online, ответить клиенту через Webhook нельзя. ## Когда это нужно - На сайте есть форма обратной связи: имя, телефон, email. - Сайт собран на конструкторе (Tilda, WordPress, Bitrix), и заявки нужно отправлять в tuk-tuk.online. - Создавать диалоги автоматически при каждой заявке. - Запускать цепочку автоматизации по входящей заявке. ## Как подключить ### Создать канал ![Форма создания Webhook-канала](https://docs.tuk-tuk.online/assets/screens/channels/webhook-form.webp) 1. Название канала: по нему потом видно источник заявок. 2. Адрес источника, если он нужен для справки. 3. Кнопка «Подключить»: после создания канал получит собственный URL для приёма заявок. 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке Webhook. 3. Нажмите «Сохранить»: в карточке канала появится уникальный URL вебхука. ### URL вебхука ```text https://api.tuk-tuk.online/webhooks/incoming/ ``` URL принимает запросы двумя способами: | Метод | Формат данных | |---|---| | GET | Параметры в URL: `?name=Иван&phone=+79001234567` | | POST | JSON в теле запроса: `{"name": "Иван", "phone": "+79001234567"}` | Большинство конструкторов сайтов (Tilda, WordPress) отправляют данные методом POST в JSON. > [!DANGER] URL вебхука секретный. Не публикуйте его в открытом доступе. ### Настроить отправку данных Пример для Tilda: 1. Откройте настройки формы в Tilda. 2. В разделе «Приём данных» выберите Webhook. 3. Вставьте URL вебхука. 4. Сохраните и опубликуйте страницу: заявки с формы начнут приходить в tuk-tuk.online. Пример запроса из своего кода: отправьте POST на URL вебхука с заголовком `Content-Type: application/json` и телом: ```json { "name": "Иван Петров", "phone": "+79001234567", "email": "ivan@example.com", "message": "Хочу записаться на консультацию" } ``` ## Проверить, что работает 1. Отправьте тестовую заявку через форму или запрос. 2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): появится новый диалог с данными заявки во входящем сообщении. 3. Откройте карточку клиента: имя, телефон и email заполнены. ## Что умеет ### Автоматическое распознавание полей Маппинг настраивать не нужно: платформа ищет знакомые имена полей. | Что ищем | Какие имена полей распознаются | |---|---| | Имя | name, first_name, firstName, client_name, Имя | | Телефон | phone, telephone, tel, mobile, Телефон | | Email | email, e-mail, mail, Email | Остальные поля сохраняются в customFields диалога. > [!TIP] Если форма называет поле нестандартно (например, `kontaktniy_telefon`), данные не пропадут: они попадут в пользовательские поля диалога. ### Что происходит при получении заявки 1. Платформа создаёт новый диалог или находит существующий по телефону или email. 2. Данные заявки показываются как входящее сообщение. 3. Имя, телефон и email сохраняются в карточке клиента. 4. Остальные поля попадают в customFields. 5. Если каналу назначена цепочка, она запускается автоматически. ### Флаг `_skipChains` | Флаг | Описание | |---|---| | `_skipChains` | Передайте `"_skipChains": true`, и цепочки не запустятся. Удобно, когда нужно только сохранить данные | ## Ограничения - Каждый запрос создаёт один диалог или обновляет существующий. - Канал односторонний: ответить клиенту через Webhook нельзя. Для ответа используйте другие каналы: Email, SMS, Telegram. Исходящие уведомления о событиях платформы описаны отдельно: [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). ## Частые проблемы | Проблема | Что делать | |---|---| | Заявки не приходят | Сверьте URL вебхука: он должен совпадать символ в символ | | Данные пустые | Убедитесь, что форма отправляет JSON | | Имя или телефон не распознались | Они сохранены в customFields: проверьте карточку диалога | | Цепочка не запускается | Проверьте, что цепочка назначена каналу и в запросе нет флага `_skipChains` | --- --- title: "Диалоги: единый центр входящих сообщений | tuk-tuk.online" nav_title: "Диалоги" url: https://docs.tuk-tuk.online/dialogs markdown: https://docs.tuk-tuk.online/dialogs.md description: "Раздел «Диалоги» в tuk-tuk.online собирает переписки из всех подключённых каналов в один список: Telegram, VK, Email, виджет и другие. Теги, статусы, приоритеты, AI-ассистенты, заметки, импорт и экспорт." keywords: ["единый центр диалогов", "входящие сообщения из мессенджеров", "чат с клиентами", "единый почтовый ящик", "теги клиентов CRM", "голосовые сообщения в чате", "медиа диалоги", "приоритеты обращений", "омниканальный inbox", "мультиканальная поддержка", "управление обращениями клиентов", "чат-центр для бизнеса"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Раздел «Диалоги» объединяет переписки из всех подключённых каналов в один список с чатом и карточкой клиента. Это точка входа к статусам, фильтрам, шаблонам, заметкам, приоритетам, импорту и экспорту. > > - Где: кабинет, раздел «Диалоги» (lk.tuk-tuk.online/dialogs). > - Экран: список диалогов слева, переписка по центру, панель клиента справа. > - Диалог создаётся при первом сообщении клиента из любого подключённого канала. > - Подразделы: интерфейс, панель клиента, статусы, поиск и фильтры, быстрые ответы, заметки, импорт и экспорт, уведомления, приоритеты, типы сообщений, события, дубли. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/statuses, https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/ai/assistants # Диалоги Раздел [Диалоги](https://lk.tuk-tuk.online/dialogs) собирает переписки с клиентами из всех подключённых [каналов](https://docs.tuk-tuk.online/channels) в один список. Менеджер отвечает из одного окна, а рядом видит карточку клиента: контакты, теги, статус, приоритет, активные цепочки и AI-ассистента. Экран состоит из трёх областей: список диалогов слева, переписка по центру, панель клиента справа. Подробно каждая часть описана на страницах раздела. ## Страницы раздела ![Раздел «Диалоги»](https://docs.tuk-tuk.online/assets/screens/dialogs/list.webp "Все обращения из всех каналов приходят в один список.") | Страница | О чём | |---|---| | [Интерфейс](https://docs.tuk-tuk.online/dialogs/interface) | Три области экрана: список диалогов, чат, панель клиента | | [Панель клиента](https://docs.tuk-tuk.online/dialogs/info-panel) | 17 настраиваемых блоков: контакты, идентификаторы, теги, ассистент, риск потери | | [Статусы и канбан](https://docs.tuk-tuk.online/dialogs/statuses) | 4 статуса, канбан с перетаскиванием, автозакрытие | | [Поиск и фильтры](https://docs.tuk-tuk.online/dialogs/search-and-filters) | Поиск по имени, телефону, email и тексту; 12 фильтров | | [Быстрые ответы](https://docs.tuk-tuk.online/dialogs/templates) | Шаблоны с переменными {{name}}, {{phone}} | | [Заметки](https://docs.tuk-tuk.online/dialogs/notes) | Внутренние записи, невидимые клиенту, с автоудалением по сроку | | [Импорт и экспорт](https://docs.tuk-tuk.online/dialogs/import-export) | Импорт клиентов из CSV, экспорт истории, удаление тестовых диалогов | | [Уведомления](https://docs.tuk-tuk.online/dialogs/notifications) | Push, email, звук, счётчики непрочитанных, индикатор присутствия | | [Приоритеты](https://docs.tuk-tuk.online/dialogs/priorities) | Правила автоматической классификации клиентов | | [Типы сообщений](https://docs.tuk-tuk.online/dialogs/messages) | Входящие, исходящие, системные, заметки, медиа, статусы доставки | | [События и комментарии](https://docs.tuk-tuk.online/dialogs/calendar-events) | События календаря из диалога и комментарии к ним | | [Дубли и идентификаторы](https://docs.tuk-tuk.online/dialogs/duplicates) | Идентификаторы каналов, кросс-канальная маршрутизация, объединение диалогов | --- --- title: "Интерфейс диалогов: список, чат, панель клиента | tuk-tuk.online" nav_title: "Интерфейс" url: https://docs.tuk-tuk.online/dialogs/interface markdown: https://docs.tuk-tuk.online/dialogs/interface.md section: "Диалоги" description: "Как устроен экран диалогов tuk-tuk.online: левая панель со списком и фильтрами, центральная область чата, правая панель клиента с настраиваемыми блоками." keywords: ["интерфейс диалогов", "список диалогов", "панель чата", "фильтры диалогов", "поиск клиентов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Экран диалогов состоит из трёх областей: список диалогов с поиском и фильтрами слева, переписка с панелью ввода по центру, панель клиента с настраиваемыми блоками справа. > > - Где: кабинет, раздел «Диалоги» (lk.tuk-tuk.online/dialogs). > - Левая панель: поиск, фильтры по каналу и тегам, сортировка по времени последнего сообщения, счётчик непрочитанных. > - Карточка диалога: имя, иконка канала, превью и время последнего сообщения, бейдж непрочитанных. > - Чат: входящие слева, исходящие справа, разделители по дате, медиа, голосовые с расшифровкой, выбор канала отправки в панели ввода. > - Правая панель: блоки клиента, которые можно переставлять и скрывать. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/messages, https://docs.tuk-tuk.online/dialogs/statuses # Интерфейс диалогов Экран раздела [Диалоги](https://lk.tuk-tuk.online/dialogs) делится на три области: слева список диалогов с поиском и фильтрами, по центру переписка с выбранным клиентом, справа панель клиента с настраиваемыми блоками. ## Левая панель: список диалогов ![Список диалогов с панелью инструментов](https://docs.tuk-tuk.online/assets/screens/dialogs/list.webp) 1. Пункт «Диалоги» в меню, цифра справа: непрочитанные. 2. Панель инструментов: поиск, фильтр, архив, новый диалог, канбан, массовые действия, настройки. 3. Карточка диалога: имя, значок канала, последнее сообщение, теги, время. 4. Счётчик показанных диалогов. ![Кнопки панели инструментов над списком диалогов](https://docs.tuk-tuk.online/assets/screens/dialogs/toolbar.webp) 1. Только непрочитанные. 2. Поиск по имени, телефону, email и тексту сообщений. 3. Архив. 4. Создать диалог вручную. 5. Канбан по статусам. 6. Массовые действия над выбранными диалогами. 7. Настройки списка: звук, автозакрытие, реактивация, приветствие, экспорт. Что есть в панели: - Строка поиска: по имени клиента или тексту сообщения. - Фильтр по каналу: показать диалоги только из выбранного канала. - Фильтр по тегам: только диалоги с нужными тегами. - Сортировка: по времени последнего сообщения. - Счётчик непрочитанных: бейдж с общим числом. Полный список фильтров и правила поиска: [Поиск и фильтры](https://docs.tuk-tuk.online/dialogs/search-and-filters). Карточка диалога в списке показывает имя клиента, иконку канала (Telegram, Email, SMS и другие), превью и время последнего сообщения, бейдж непрочитанных. ## Центральная область: чат ![Открытый диалог: переписка, заметка и панель ответа](https://docs.tuk-tuk.online/assets/screens/dialogs/open.webp) 1. Шапка: имя клиента, идентификатор, канал и действия с диалогом. 2. Панель ответа: текст, шаблоны, эмодзи, голосовое, задача, файл. 3. Заметка менеджера: видна только команде, клиенту не уходит. 4. Кнопка показа и скрытия панели клиента. ![Панель ответа крупным планом](https://docs.tuk-tuk.online/assets/screens/dialogs/composer.webp) 1. Поле ответа: Ctrl+Enter отправляет, {{name}} подставляет имя клиента. 2. Быстрые ответы (шаблоны). 3. Эмодзи. 4. Запись голосового сообщения. 5. Создание задачи по клиенту. 6. Сниппеты для AI. 7. Орфография и перефразирование через AI. ![Действия с диалогом в шапке](https://docs.tuk-tuk.online/assets/screens/dialogs/header-actions.webp) 1. Эфир с клиентом. 2. Закрепить диалог вверху списка. 3. В архив. 4. Выключить звук уведомлений по диалогу. 5. Показать или скрыть панель клиента. Здесь идёт переписка с клиентом. - История сообщений с разделителями по дате. - Входящие слева, исходящие справа. - Медиа-вложения: фото, видео, документы. - Голосовые сообщения с расшифровкой. - Панель ввода сообщения с выбором канала отправки. Типы сообщений и вложений: [Типы сообщений](https://docs.tuk-tuk.online/dialogs/messages). ## Правая панель: клиент Карточка клиента из настраиваемых блоков: контакты, идентификаторы каналов, теги, приоритет, ассистент, риск потери, связки, кастомные поля. Блоки можно переставлять и скрывать. Подробно: [Панель клиента](https://docs.tuk-tuk.online/dialogs/info-panel). --- --- title: "Панель клиента в диалоге: настраиваемые блоки | tuk-tuk.online" nav_title: "Панель клиента" url: https://docs.tuk-tuk.online/dialogs/info-panel markdown: https://docs.tuk-tuk.online/dialogs/info-panel.md section: "Диалоги" description: "Правая панель клиента в диалогах tuk-tuk.online: телефон, email, источник, идентификаторы каналов, приоритет, AI-ассистент, риск потери, теги, связки, кастомные поля. Порядок и видимость блоков настраиваются." keywords: ["информационная панель", "карточка клиента", "теги клиента", "кастомные поля", "AI ассистент", "риск потери клиента"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Правая панель диалога показывает данные клиента в 17 блоках: телефон, email, источник, идентификаторы каналов, приоритет, AI-ассистент, риск потери, AI-анализ, теги, связки, запрет запуска связок, кастомные поля. Порядок и видимость блоков настраиваются и хранятся в localStorage. > > - Где: раздел «Диалоги», правая панель; режим настройки по кнопке «НАСТРОИТЬ», выход по «ГОТОВО». > - Телефон и email редактируются inline: клик, ввод, Enter. Источник только для чтения. > - Идентификаторы каналов: Telegram ID, VK ID, Avito ID, MAX Bot ID, AmoCRM ID; используются для кросс-канального поиска, дублей и объединения. > - Риск потери: probability = min(95, minutes / maxMinutes * 95); по умолчанию 240 мин до 95%, пороги 30% (жёлтый) и 60% (красный). > - Ассистент: режим Автоответ / Заметка, кнопки «Сбросить историю» и «Пауза». > - Флажок «Запрет запуска связок» останавливает текущие цепочки клиента и блокирует новые. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/priorities, https://docs.tuk-tuk.online/dialogs/duplicates, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/chains # Панель клиента Правая панель в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs) показывает всё о клиенте выбранного диалога: контакты, идентификаторы каналов, теги, приоритет, ассистента, риск потери, цепочки и кастомные поля. Панель состоит из 17 блоков, каждый можно переставить или скрыть. ![Панель клиента справа от переписки](https://docs.tuk-tuk.online/assets/screens/dialogs/info-panel.webp) 1. Контакты: телефон, email, источник. 2. Приоритет клиента: автоправила и ручной выбор. 3. AI-ассистент диалога, пауза и сброс истории. 4. Риск потери клиента. 5. Поиск дублей по телефону и email. 6. AI-анализ переписки по кнопке. 7. Теги клиента. 8. Ручной запуск связки для клиента. 9. Кнопка «Настроить»: какие блоки показывать. ![Нижняя часть панели клиента](https://docs.tuk-tuk.online/assets/screens/dialogs/info-panel-bottom.webp) 1. Кастомные поля клиента. 2. События календаря клиента. 3. Задачи по клиенту. ## Блоки панели ### Номер телефона Телефон клиента. Нажмите на номер, введите новый и нажмите Enter или кнопку подтверждения: номер сохранится. ### Email Почта клиента. Редактируется так же, как телефон: клик, ввод, Enter. ### Источник Откуда пришёл клиент: UTM-метка, название сайта. Поле только для чтения, заполняется автоматически через виджет или API. ### Идентификаторы каналов ![Блок «Дубли»: поиск одинаковых клиентов](https://docs.tuk-tuk.online/assets/screens/dialogs/block-duplicates.webp "Блок «Дубли» ищет диалоги того же клиента по телефону и email.") Для каждого клиента сохраняются идентификаторы из каналов связи. | Канал | Поле | Что хранится | |---|---|---| | Telegram Bot / Account | Telegram ID | Chat ID пользователя в Telegram | | VK | VK ID | Peer ID пользователя ВКонтакте | | Avito | Avito ID | ID чата на Avito | | MAX Bot | MAX Bot ID | Chat ID в MAX (бывший ICQ) | | AmoCRM | AmoCRM ID | Contact ID из AmoCRM | Поля заполняются при первом обращении клиента и нужны для трёх задач: - Кросс-канальный поиск: если клиент пишет из нового канала, система сопоставит его с существующим диалогом по Telegram ID, телефону или email. - Поиск дублей: искать дубликаты можно по любому идентификатору канала. - Объединение диалогов: при слиянии дублей идентификаторы сохраняются. Подробно: [Дубли и идентификаторы](https://docs.tuk-tuk.online/dialogs/duplicates). ### Приоритет ![Блок «Приоритет»](https://docs.tuk-tuk.online/assets/screens/dialogs/block-priority.webp) Бейдж текущего приоритета клиента: например, VIP, Горячий, Без ответа, Холодный. Рядом две кнопки: подсказка с объяснением, как определяется приоритет, и шестерёнка, которая открывает окно «Настройка приоритетов». Правила описаны на странице [Приоритеты](https://docs.tuk-tuk.online/dialogs/priorities). ### Ассистент ![Блок AI-анализа диалога](https://docs.tuk-tuk.online/assets/screens/dialogs/block-ai-analysis-open.webp) Карточка AI-ассистента, активного на этом диалоге. - Имя ассистента, режим работы (Автоответ / Заметка), расписание, приоритет. - Индикатор состояния: активен или на паузе. - «Сбросить историю»: обнуляет контекст AI для этого диалога, ассистент забывает предыдущие сообщения. - «Пауза»: временно отключает ассистента, с обратным отсчётом. Настройка ассистентов: [Настройка ассистента](https://docs.tuk-tuk.online/ai/assistants). ![Блок «Ассистент» в панели клиента](https://docs.tuk-tuk.online/assets/screens/dialogs/block-assistant.webp "Блок «Ассистент»: кто отвечает, расписание, приоритет, сброс истории и пауза.") ### Риск потери ![Блок «Риск потери»](https://docs.tuk-tuk.online/assets/screens/dialogs/block-risk.webp) Оценка вероятности потерять клиента по времени ожидания ответа. - Есть непрочитанные входящие: блок показывает прогресс-бар и число в процентах. - Непрочитанных нет: блок показывает текст «Нет риска потери». Расчёт по умолчанию: 0 минут дают 0%, 63 минуты дают 25%, 240 минут дают 95% (потолок). ```text probability = min(95, minutes / maxMinutes * 95) ``` Настройки блока (шестерёнка): | Параметр | Что делает | По умолчанию | |---|---|---| | Время до 95% риска | Через сколько минут без ответа вероятность достигнет 95% | 240 мин | | Жёлтый порог (%) | С какой вероятности полоса становится жёлтой | 30% | | Красный порог (%) | С какой вероятности полоса становится красной | 60% | ### AI-анализ ![Блок «AI-анализ»](https://docs.tuk-tuk.online/assets/screens/dialogs/block-ai-analysis.webp) Сворачиваемая панель для анализа диалога с помощью AI. 1. Выберите инструкцию из списка ваших AI-инструкций. 2. При необходимости добавьте дополнительный промпт. 3. Нажмите «Анализировать»: результат появится в чате как AI-заметка. ### Теги ![Блок тегов клиента](https://docs.tuk-tuk.online/assets/screens/dialogs/block-tags.webp) Теги сегментируют клиентов. - Текущие теги показаны цветными бейджами. - Кнопка удаления на теге снимает его. - Поле ввода и кнопка «+» добавляют новый тег. - Теги могут добавляться автоматически через цепочки. Примеры: `VIP`, `заинтересован`, `оплатил`, `новый_клиент`. ### Пройденные связки Список цепочек автоматизации, которые уже выполнились для этого клиента. ### Запустить связку ![Блок ручного запуска связки](https://docs.tuk-tuk.online/assets/screens/dialogs/block-run-chain.webp) Ручной запуск цепочки. 1. Выберите цепочку из выпадающего списка. 2. Нажмите «Запуск»: цепочка стартует для этого клиента. ### Активные связки Счётчик работающих цепочек с пульсирующим индикатором. Кнопка «Остановить связки» останавливает все текущие цепочки клиента. ### Запрет запуска связок Флажок «Запрет запуска связок» блокирует автоматический запуск цепочек для клиента. - Включение останавливает все текущие связки клиента и не даёт запуститься новым, в том числе возобновиться связкам, которые ждут ответа. - Выключение снимает блокировку, цепочки снова запускаются по триггерам. > [!TIP] Включайте запрет, когда клиента нужно полностью вывести из автоматических сценариев: ручная обработка сложного запроса, VIP-обслуживание. ### Кастомные поля ![Блок «События»: записи клиента в календаре](https://docs.tuk-tuk.online/assets/screens/dialogs/block-events.webp "Блок «События»: ближайшие записи клиента и кнопка «+ Запись».") ![Блок «Задачи» по клиенту](https://docs.tuk-tuk.online/assets/screens/dialogs/block-tasks.webp "Блок «Задачи»: активные задачи по этому клиенту.") ![Кастомные поля клиента](https://docs.tuk-tuk.online/assets/screens/dialogs/block-custom-fields.webp) Произвольные данные клиента в формате «ключ: значение». Кнопка «+» добавляет поле, кнопки на поле редактируют значение и удаляют поле. Кастомные поля доступны в [цепочках](https://docs.tuk-tuk.online/chains) и [шаблонах сообщений](https://docs.tuk-tuk.online/dialogs/templates). ## Как настроить порядок и видимость блоков ![Режим настройки блоков панели](https://docs.tuk-tuk.online/assets/screens/dialogs/panel-configure.webp "Режим настройки: блоки перетаскиваются за ручку слева, глаз скрывает блок, «Готово» сохраняет порядок.") 1. Нажмите «НАСТРОИТЬ» в правом верхнем углу панели: у блоков появятся ручки перетаскивания и кнопки скрытия. 2. Зажмите ручку слева от блока и перетащите его: зона вставки подсвечивается. 3. Нажмите иконку глаза справа от блока, чтобы скрыть его. 4. Нажмите «ГОТОВО»: порядок и видимость сохранятся. > [!NOTE] Настройки панели хранятся в браузере (localStorage). В другом браузере или на другом устройстве порядок блоков будет свой. --- --- title: "Статусы диалогов и канбан-доска | tuk-tuk.online" nav_title: "Статусы и канбан" url: https://docs.tuk-tuk.online/dialogs/statuses markdown: https://docs.tuk-tuk.online/dialogs/statuses.md section: "Диалоги" description: "Четыре статуса диалога в tuk-tuk.online: Новый, В работе, Ожидание клиента, Закрыт. Канбан с перетаскиванием, автоматические переходы и автозакрытие по таймеру." keywords: ["статусы диалогов", "канбан-доска", "управление обращениями", "закрытие диалога", "автозакрытие чата", "жизненный цикл диалога", "CRM статусы", "воронка обращений"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Диалог проходит четыре статуса: «Новый», «В работе», «Ожидание клиента», «Закрыт». Статус меняется в шапке чата, перетаскиванием на канбан-доске или автоматически, включая автозакрытие по таймеру. > > - Где: раздел «Диалоги», статус в шапке чата; канбан-доска с 4 колонками и перетаскиванием. > - Новый диалог получает статус «Новый»; входящее в закрытый диалог снова делает его «Новым». > - Автозакрытие: «Настройки», блок «Автозакрытие диалогов»: часов без активности, сообщение клиенту, исключения по каналам. > - Отсчёт таймера автозакрытия сбрасывается при новом сообщении клиента. > - Закрытые диалоги скрыты из списка, показываются фильтром «Показать закрытые». > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/priorities, https://docs.tuk-tuk.online/tasks/kanban, https://docs.tuk-tuk.online/chains/triggers # Статусы и канбан У каждого диалога есть один из четырёх статусов: от первого сообщения клиента до закрытия. Статус показывает, на каком этапе разговор, а канбан-доска раскладывает диалоги по этим этапам в колонки. ## Какие статусы бывают | Статус | Цвет | Значение | |---|---|---| | Новый | Синий | Клиент написал, диалог ещё никто не взял | | В работе | Янтарный | Менеджер работает с клиентом | | Ожидание клиента | Фиолетовый | Вы ответили и ждёте реакции клиента | | Закрыт | Серый | Вопрос решён, диалог завершён | Первое сообщение клиента создаёт диалог со статусом «Новый». Дальше статус меняется вручную или автоматически. ## Жизненный цикл ```text Клиент пишет -> Новый Менеджер отвечает -> В работе Ждём ответа клиента -> Ожидание клиента Вопрос решён -> Закрыт Клиент пишет снова -> Новый ``` ### Автоматические переходы - Новое входящее сообщение в закрытый диалог открывает его заново и ставит статус «Новый». - При закрытии фиксируется дата закрытия, диалог уходит из основного списка. ## Как менять статус вручную 1. Откройте диалог в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. Нажмите на текущий статус в шапке чата: раскроется список. 3. Выберите новый статус: бейдж в шапке обновится. На канбан-доске статус меняется перетаскиванием карточки в другую колонку. ## Канбан-доска ![Канбан-доска диалогов по статусам](https://docs.tuk-tuk.online/assets/screens/dialogs/kanban.webp) 1. Колонки статусов: Новые, В работе, Ожидает клиента, Закрыто. 2. Кнопка «Список»: вернуться к обычному списку. 3. Ссылка «Открыть диалог» на карточке. Канбан: режим отображения, где каждый статус занимает отдельную колонку, а все диалоги видны разом. - 4 колонки, по одной на статус. - Перетаскивание: зажмите карточку диалога и перенесите в нужную колонку. Статус обновится сам. - Сортировка внутри колонки: по дате последнего сообщения, имени клиента или числу непрочитанных. > [!TIP] Канбан удобен, когда диалогов много и нужно быстро увидеть, что требует внимания. ## Автозакрытие Диалоги, в которых долго нет активности, система может закрывать сама. Так в рабочем списке остаются только живые разговоры. Настройка живёт в [Настройках](https://lk.tuk-tuk.online/settings), блок «Автозакрытие диалогов». | Параметр | Что делает | |---|---| | Включено / выключено | Активирует автозакрытие | | Часов без активности | Через сколько часов без новых сообщений диалог закроется | | Сообщение | Текст, который уйдёт клиенту перед закрытием (необязательно) | | Исключения по каналам | Свой таймер для отдельных каналов, например Email 48 ч, Telegram 24 ч | > [!NOTE] Проверка идёт периодически. Если клиент напишет до срабатывания таймера, отсчёт начнётся заново. ## Закрыть и открыть заново ![Архив диалогов](https://docs.tuk-tuk.online/assets/screens/dialogs/archive.webp "Архив прячет диалог из списка и выключает уведомления, переписка сохраняется.") - Закрыть: кнопка «Закрыть диалог» или перевод в статус «Закрыт». Дата закрытия сохраняется. - Открыть заново: кнопка «Открыть» на закрытом диалоге. Любое новое сообщение клиента тоже откроет диалог. > [!NOTE] Закрытые диалоги скрыты из основного списка. Чтобы их увидеть, включите фильтр «Показать закрытые». --- --- title: "Поиск и фильтры диалогов | tuk-tuk.online" nav_title: "Поиск и фильтры" url: https://docs.tuk-tuk.online/dialogs/search-and-filters markdown: https://docs.tuk-tuk.online/dialogs/search-and-filters.md section: "Диалоги" description: "Поиск диалогов по имени, телефону, email и тексту сообщения. 12 фильтров: канал, теги, статус, кастомные поля, дата. Сортировка, URL-параметры, счётчик непрочитанных." keywords: ["поиск клиентов", "фильтр диалогов", "поиск по сообщениям", "фильтрация по тегам", "фильтр по каналу", "сортировка диалогов", "CRM фильтры", "поиск контактов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Поиск в левой панели раздела «Диалоги» ищет по имени, идентификатору, телефону, email и тексту последнего сообщения. 12 фильтров под строкой поиска сочетаются по логике «И». > > - Где: раздел «Диалоги», верх левой панели: строка поиска, под ней фильтры. > - Поиск без учёта регистра, по вхождению, запрос уходит через 0,7 секунды после ввода. > - Поиск доступен через URL-параметр `?search=...`. > - Фильтры: канал, теги, статус, источник, есть телефон, есть email, непрочитанные, кастомное поле, дата сообщения, пройденные цепочки, показать закрытые, тип канала. > - Сортировка по дате последнего сообщения, свежие сверху. > - Сброс непрочитанных: ответ клиенту, кнопка «Прочитать», кнопка «Прочитать все». > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/statuses, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/notifications, https://docs.tuk-tuk.online/dialogs/duplicates # Поиск и фильтры Строка поиска и фильтры находятся в верхней части левой панели раздела [Диалоги](https://lk.tuk-tuk.online/dialogs). Поиск сужает список по тексту, фильтры по параметрам диалога. Их можно сочетать. ## Поиск ![Поиск по списку диалогов](https://docs.tuk-tuk.online/assets/screens/dialogs/search.webp "Поиск идёт по имени, телефону, email и тексту сообщений, список фильтруется на лету.") Начните вводить текст, и список диалогов отфильтруется сам. ### Где ищет система | Поле | Пример | |---|---| | Имя клиента | Иван Петров | | Идентификатор | tg_123456789 | | Номер телефона | +7 999 123-45-67 | | Email | ivan@mail.ru | | Текст последнего сообщения | «Хочу записаться на приём» | > [!NOTE] Регистр не важен. Достаточно части слова: поиск идёт по вхождению. ### Как это работает 1. Введите текст в строку поиска. 2. Подождите 0,7 секунды: запрос уходит на сервер с задержкой, чтобы не отправляться на каждое нажатие. 3. Список обновится и покажет только совпадения. Поиск дублируется в адресной строке: `?search=иван`. Такой ссылкой можно поделиться с коллегой. ## Фильтры Фильтры расположены под строкой поиска. | Фильтр | Что делает | Пример | |---|---|---| | Канал | Только диалоги из выбранного канала | Только Telegram | | Теги | Диалоги с указанными тегами | Только с тегом «VIP» | | Статус | По статусу на канбан-доске | Только «В работе» | | Источник | Откуда пришёл клиент | Только «Сайт» | | Есть телефон | Только с заполненным номером | Да / Нет | | Есть email | Только с заполненным email | Да / Нет | | Непрочитанные | Только диалоги с непрочитанными сообщениями | Да | | Кастомное поле | По значению конкретного кастомного поля | Город = Москва | | Дата сообщения | Диалоги с сообщениями в указанном периоде | С 1 по 15 марта | | Пройденные цепочки | Клиенты, завершившие указанную автоматизацию | Прошёл «Онбординг» | | Показать закрытые | Включить закрытые диалоги в выдачу | По умолчанию скрыты | | Тип канала | По типу канала, а не по конкретному каналу | Все Telegram-каналы | ### Сочетание фильтров Фильтры работают одновременно, по логике «И». Пример: Канал = Telegram, Тег = VIP, Непрочитанные = Да. В списке останутся только непрочитанные диалоги VIP-клиентов из Telegram. ## Сортировка По умолчанию диалоги отсортированы по дате последнего сообщения, свежие сверху. Диалоги, в которых что-то происходит, всегда на виду. ## Счётчик непрочитанных В заголовке левой панели виден общий счётчик непрочитанных по всем диалогам. Он обновляется в реальном времени. На каждой карточке диалога есть свой бейдж с числом непрочитанных. ### Как сбросить непрочитанные - Автоматически: когда вы отправляете ответ клиенту, счётчик этого диалога обнуляется. - Вручную: кнопка «Прочитать» на конкретном диалоге. - Все сразу: кнопка «Прочитать все» обнуляет счётчики по всем диалогам. --- --- title: "Шаблоны быстрых ответов с переменными | tuk-tuk.online" nav_title: "Быстрые ответы" url: https://docs.tuk-tuk.online/dialogs/templates markdown: https://docs.tuk-tuk.online/dialogs/templates.md section: "Диалоги" description: "Шаблоны сообщений с переменными {{name}}, {{phone}}, {{email}} и {{custom_field_XXX}} в tuk-tuk.online. Создание, вставка, счётчик использования, хранение в браузере." keywords: ["шаблоны сообщений", "быстрые ответы", "переменные в сообщениях", "шаблоны с подстановкой", "готовые ответы клиентам", "сниппеты", "автоподстановка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Шаблоны быстрых ответов: заготовленные тексты с переменными {{name}}, {{phone}}, {{email}}, {{custom_field_XXX}}, которые вставляются в поле ввода из панели сообщения. Хранятся в localStorage браузера, не синхронизируются между устройствами. > > - Где: диалог, панель ввода сообщения, кнопка шаблонов, затем «+ Добавить шаблон» и «Сохранить». > - Переменные: `{{name}}`, `{{phone}}`, `{{email}}`, `{{custom_field_<имя поля>}}`. > - Пустая переменная (нет данных у клиента) удаляется из текста. > - Вставка: кнопка шаблонов или поиск по названию с автоподсказкой. > - У каждого шаблона есть счётчик использования. > - Хранение в localStorage: шаблоны привязаны к браузеру и теряются при очистке данных. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/notes, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/funnels/templates # Шаблоны быстрых ответов Шаблон: заготовленный текст с названием, который вставляется в поле ввода одним нажатием. Переменные внутри текста заменяются данными клиента: именем, телефоном, email, кастомными полями. ## Когда это нужно Менеджер десятки раз в день набирает одно и то же: приветствие, адрес, реквизиты, подтверждение записи. Шаблон пишется один раз и дальше вставляется за секунду. ## Как это работает 1. Создайте шаблон с названием и текстом. 2. При ответе клиенту откройте список шаблонов. 3. Выберите нужный: текст появится в поле ввода. 4. Переменные подставятся автоматически. 5. Отправьте сообщение. ## Переменные | Переменная | Что подставит | Пример | |---|---|---| | `{{name}}` | Имя клиента | Иван Петров | | `{{phone}}` | Номер телефона | +7 999 123-45-67 | | `{{email}}` | Email | ivan@mail.ru | | `{{custom_field_ГОРОД}}` | Кастомное поле «ГОРОД» | Москва | | `{{custom_field_ЗАКАЗ}}` | Кастомное поле «ЗАКАЗ» | #12345 | > [!NOTE] Если данных у клиента нет (например, не заполнен email), переменная удаляется из текста. ### Пример Название: Приветствие. Текст: ```text Здравствуйте, {{name}}! Спасибо за обращение. Чем могу помочь? ``` Если клиента зовут Анна, в поле ввода окажется: ```text Здравствуйте, Анна! Спасибо за обращение. Чем могу помочь? ``` ## Как создать шаблон 1. Откройте диалог и нажмите кнопку шаблонов в панели ввода сообщения: откроется менеджер шаблонов. 2. Нажмите «+ Добавить шаблон». 3. Введите название (короткое, для поиска: «Приветствие», «Адрес», «Реквизиты») и текст с переменными. 4. Нажмите «Сохранить»: шаблон появится в списке. ### Редактирование и удаление Наведите на шаблон в списке: появятся кнопки редактирования и удаления. ### Счётчик использования У каждого шаблона видно, сколько раз его вставляли. По счётчику понятно, какие шаблоны нужны, а какие можно убрать. ## Как вставить шаблон ![Список шаблонов в окне диалога](https://docs.tuk-tuk.online/assets/screens/dialogs/templates.webp "Шаблоны открываются кнопкой в панели ответа и подставляются в поле одним кликом.") - Кнопка шаблонов в панели ввода открывает полный список. - Поиск: начните вводить название, появится автоподсказка. ## Где хранятся шаблоны Шаблоны хранятся в браузере (localStorage), а не на сервере. - Открываются мгновенно, без запроса к серверу. - В другом браузере или на другом устройстве будет свой набор шаблонов. - При очистке данных браузера шаблоны пропадут. > [!TIP] Если работаете с нескольких устройств, продублируйте нужные шаблоны на каждом. ## Примеры шаблонов | Название | Текст | |---|---| | Приветствие | Здравствуйте, {{name}}! Чем могу помочь? | | Уточнение телефона | Подскажите, пожалуйста, ваш номер телефона для связи | | Подтверждение записи | {{name}}, подтверждаю вашу запись. Ждём вас! | | Реквизиты | Наши реквизиты для оплаты: ... | | Благодарность | Спасибо за обращение, {{name}}! Если появятся вопросы, пишите | --- --- title: "Заметки менеджеров к диалогам | tuk-tuk.online" nav_title: "Заметки" url: https://docs.tuk-tuk.online/dialogs/notes markdown: https://docs.tuk-tuk.online/dialogs/notes.md section: "Диалоги" description: "Внутренние заметки к диалогу в tuk-tuk.online: создание, редактирование, временные заметки с автоудалением. Клиент их не видит, видит только команда." keywords: ["заметки к диалогам", "внутренние записи", "заметки менеджеров", "комментарии к клиенту", "временные заметки", "примечания к диалогу"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Заметки: внутренние записи в ленте диалога, видимые только команде и не отправляемые клиенту. Можно задать срок действия, после которого заметка удаляется сама. > > - Где: раздел «Диалоги», панель ввода сообщения, кнопка «Заметка», затем «Добавить». > - Срок действия необязателен; без него заметка хранится до ручного удаления. > - Заметка не поднимает диалог в списке и не запускает цепочки. > - Нужно разрешение «Заметки» у пользователя. > - В ленте заметка помечена «Заметка» и оформлена отдельным стилем. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/messages, https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/calendar-events, https://docs.tuk-tuk.online/chains/blocks/tags-and-notes, https://docs.tuk-tuk.online/users/roles-permissions # Заметки менеджеров Заметка: внутренняя запись в ленте диалога, которую видит только ваша команда. Клиенту она не отправляется. Так контекст по клиенту хранится там же, где переписка, а не в стороннем документе. ## Когда это нужно - Передать контекст коллеге: «Клиент хочет скидку 10%, обсудить с руководителем». - Зафиксировать договорённость: «Перезвонить в понедельник после 14:00». - Оставить напоминание себе: «Проверить оплату завтра утром». - Отметить особенность клиента: «Общается только в мессенджере, не звонить». ## Как добавить заметку 1. Откройте диалог в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. В панели ввода сообщения нажмите «Заметка»: поле ввода переключится в режим заметки. 3. Введите текст. 4. При необходимости задайте срок действия: дату и время, когда заметка удалится автоматически. 5. Нажмите «Добавить»: заметка появится в ленте с пометкой «Заметка». ## Временные заметки Часть заметок актуальна до конкретного момента: «Клиент ждёт звонка до 18:00». Для таких случаев есть срок действия. - Укажите дату и время при создании. - Когда срок истечёт, заметка удалится из ленты сама. - Если срок не задан, заметка остаётся, пока её не удалят вручную. ## Как отличить заметку от сообщения Заметки лежат в общей ленте, но оформлены отдельным стилем: пометка «Заметка» и своя иконка. Визуально они отличаются от входящих и исходящих, и клиенту не уходят. ## Редактирование и удаление - Редактировать: нажмите на заметку, измените текст, сохраните. - Удалить: нажмите кнопку удаления на заметке. ## Что важно знать | Свойство | Значение | |---|---| | Видна клиенту | Нет | | Влияет на сортировку диалогов | Нет, заметка не поднимает диалог в списке | | Запускает автоматизацию | Нет, цепочки на заметки не реагируют | | Требует права доступа | Да, нужно разрешение «Заметки» | --- --- title: "Импорт клиентов из CSV и экспорт диалогов | tuk-tuk.online" nav_title: "Импорт и экспорт" url: https://docs.tuk-tuk.online/dialogs/import-export markdown: https://docs.tuk-tuk.online/dialogs/import-export.md section: "Диалоги" description: "Массовый импорт контактов из CSV-файла, фоновый экспорт истории диалогов с фильтрами и удаление тестовых диалогов в tuk-tuk.online." keywords: ["импорт клиентов CSV", "экспорт диалогов", "массовый импорт контактов", "выгрузка базы клиентов", "CSV экспорт чатов", "массовые операции", "загрузка контактов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Импорт создаёт диалоги из CSV-файла со списком клиентов, экспорт выгружает историю переписок в CSV по фильтрам и выполняется в фоне. Отдельная кнопка удаляет диалоги с пометкой «Тестовый». > > - Где: раздел «Диалоги», кнопки «Импорт», «Экспорт», «Удалить тестовые». > - Поля импорта: имя (обязательно), телефон, email, Telegram Chat ID, кастомные поля в JSON. > - Параметры импорта: общие теги, обновление существующих (по телефону, email или Telegram ID), пропуск первой строки с заголовками. > - Фильтры экспорта: канал, теги, статус, дата сообщений, наличие телефона или email. > - Статусы экспорта: «В очереди», «Обработка», «Готово», «Ошибка». Файл хранится 7 дней, предупреждение за 3 часа до удаления. > - Удаление тестовых затрагивает только диалоги с пометкой «Тестовый». > > Связанные страницы: https://docs.tuk-tuk.online/dialogs, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/duplicates, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/api/rest # Импорт и экспорт Импорт создаёт диалоги по списку клиентов из CSV-файла. Экспорт выгружает историю переписок в CSV по выбранным фильтрам и выполняется в фоне. Обе операции запускаются кнопками в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). ## Когда это нужно - Переезд с другой платформы: база клиентов из 1С, Excel или CRM уже есть, её нужно загрузить одним файлом. - Отчёт или архив: выгрузить переписки за период, по каналу или по тегу. - Чистка после настройки: удалить пробные диалоги, которые появились во время тестов. ## Импорт контактов из CSV ![Создание диалога вручную и импорт из файла](https://docs.tuk-tuk.online/assets/screens/dialogs/create-manual.webp) 1. Имя клиента. 2. Канал для первого сообщения. 3. ID или логин получателя в этом канале. 4. Текст первого сообщения. 5. Источник обращения. 6. Телефон. 7. Email. 8. Telegram Chat ID. 9. Telegram @username. 10. Теги. 11. Ключ переменной клиента. 12. Значение переменной. 13. Кнопка «Создать и отправить»; слева «Импорт из файла» для загрузки CSV. ### Поля контакта | Поле | Обязательное | Пример | |---|---|---| | Имя клиента | Да | Иван Петров | | Телефон | Нет | +79991234567 | | Email | Нет | ivan@mail.ru | | Telegram Chat ID | Нет | 123456789 | | Кастомные поля (JSON) | Нет | {"город": "Москва"} | ### Параметры импорта | Параметр | Что делает | |---|---| | Общие теги | Присваиваются всем импортированным контактам | | Обновлять существующие | Если клиент уже есть в базе, его данные обновятся. Совпадение ищется по телефону, email или Telegram ID | | Первая строка: заголовки | Первая строка файла пропускается, если в ней названия столбцов | ### Как импортировать 1. Откройте раздел [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. Нажмите «Импорт»: откроется окно загрузки файла. 3. Загрузите CSV-файл. 4. Сопоставьте столбцы файла с полями контакта и задайте параметры импорта. 5. Нажмите «Импортировать»: по окончании появится отчёт. ### Отчёт после импорта | Показатель | Значение | |---|---| | Создано | Новых диалогов | | Обновлено | Обновлённых диалогов (если включён параметр «Обновлять существующие») | | Пропущено | Пустых или дублирующих строк | | Всего | Обработанных строк | ## Экспорт диалогов ![Массовые действия над выбранными диалогами](https://docs.tuk-tuk.online/assets/screens/dialogs/bulk.webp "Режим выбора: отметьте диалоги, чтобы сменить статус, поставить теги или отправить в архив.") ### Как экспортировать 1. Откройте раздел [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. Нажмите «Экспорт»: откроется окно с фильтрами. 3. Задайте, какие диалоги выгружать: по каналу, тегам и статусу, по дате сообщений, по наличию телефона или email. 4. Нажмите «Запросить экспорт»: запрос появится в списке экспортов со статусом «В очереди». ### Как идёт экспорт Экспорт выполняется в фоне, ждать на странице не нужно. Когда файл готов, приходит уведомление. | Этап | Что происходит | |---|---| | В очереди | Запрос принят и ждёт обработки | | Обработка | Система собирает данные | | Готово | Файл можно скачать | | Ошибка | Экспорт не удался, причина в описании | ### Срок хранения файла > [!WARNING] Готовый файл хранится 7 дней. За 3 часа до удаления приходит предупреждение. После удаления файл восстановить нельзя. ### История экспортов Все запрошенные экспорты видны в списке. По каждому: дата запроса, кто запросил, количество записей, статус и ссылка на скачивание. ## Удаление тестовых диалогов Во время настройки платформы часто появляются пробные диалоги: сообщения самому себе, проверка цепочек. Их можно удалить одной кнопкой. 1. Нажмите «Удалить тестовые». 2. Подтвердите действие: диалоги с пометкой «Тестовый» исчезнут из списка. > [!NOTE] Удаляются только диалоги с пометкой «Тестовый». Рабочие диалоги не затрагиваются. --- --- title: "Уведомления о сообщениях: push, email, звук | tuk-tuk.online" nav_title: "Уведомления" url: https://docs.tuk-tuk.online/dialogs/notifications markdown: https://docs.tuk-tuk.online/dialogs/notifications.md section: "Диалоги" description: "Push-уведомления в браузере и на телефоне, email-оповещения и звуковой сигнал о новых сообщениях в tuk-tuk.online. Типы уведомлений, настройка, счётчики непрочитанных." keywords: ["push уведомления", "уведомления о сообщениях", "звуковые уведомления", "email уведомления", "оповещения чат-бота", "настройка уведомлений", "пропущенные сообщения"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Уведомления о новых, пропущенных и системных событиях приходят через push (Web Push), email и звук во вкладке. Каждый тип включается отдельно в настройках, а непрочитанные считаются в заголовке вкладки, левой панели и на карточке диалога. > > - Где: «Настройки», блок «Уведомления», кнопка «Подключить push» и переключатели по типам. > - Типы: новое сообщение, пропущенное (более 5 минут без ответа), системные. По умолчанию все включены. > - Статусы push-подписки: «Подписан», «Отписан», «Заблокировано», «Не поддерживается» (нужен Chrome, Firefox, Edge или Safari). > - Звук работает только при открытой вкладке. > - Счётчик сбрасывается при ответе клиенту, кнопкой «Прочитать» или «Прочитать все». > - В шапке чата видны аватары менеджеров, которые сейчас открыли диалог. > > Связанные страницы: https://docs.tuk-tuk.online/pwa/push, https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/priorities, https://docs.tuk-tuk.online/users/team # Уведомления Платформа сообщает о новых и пропущенных сообщениях тремя способами: push в браузере или на телефоне, письмо на email и звук во вкладке. Каждый тип уведомления включается и выключается отдельно в настройках. ## Типы уведомлений | Тип | Когда приходит | По умолчанию | |---|---|---| | Новое сообщение | Клиент написал вам | Включено | | Пропущенное сообщение | Прошло больше 5 минут, а никто не ответил | Включено | | Системные | Низкий баланс, ошибки интеграций, важные события | Включено | ## Как подключить push ![Настройки проекта: уведомления](https://docs.tuk-tuk.online/assets/screens/settings/general.webp) 1. Пункт «Настройки проекта» в меню. 2. Вкладки: Общие, Вебхуки API, API, Проект. 3. Блок «Уведомления»: включение push в браузере. Push приходят в браузер или на телефон, даже если вкладка с платформой закрыта. 1. Откройте [Настройки](https://lk.tuk-tuk.online/settings). 2. В блоке «Уведомления» нажмите «Подключить push»: браузер запросит разрешение. 3. Разрешите уведомления: статус подписки сменится на «Подписан». > [!NOTE] Push работают через Web Push. Устанавливать приложение не нужно. ### Статусы подписки | Статус | Значение | |---|---| | Подписан | Push-уведомления работают | | Отписан | Вы отключили push | | Заблокировано | Браузер запретил уведомления для сайта, разрешение нужно вернуть в настройках браузера | | Не поддерживается | Браузер не умеет Web Push. Подойдут Chrome, Firefox, Edge или Safari | ## Email и звук - Email: дублирует оповещения на почту. Полезно, когда вы не за компьютером. - Звук: при новом сообщении платформа проигрывает короткий двухтональный сигнал. Помогает, когда вы работаете в другой вкладке. > [!WARNING] Звук воспроизводится только при открытой вкладке с платформой. ## Настройка ![Меню настроек списка диалогов](https://docs.tuk-tuk.online/assets/screens/dialogs/settings-menu.webp "Меню «Настройки» над списком: звук, архив, прочитать всё, автозакрытие, реактивация, приветствие, транскрибация, экспорт.") Все уведомления живут в [Настройки](https://lk.tuk-tuk.online/settings), блок «Уведомления». Для каждого типа (новое сообщение, пропущенное, системные) есть свой переключатель. ## Счётчики непрочитанных ![Раздел «История»: журнал действий](https://docs.tuk-tuk.online/assets/screens/history/audit.webp) 1. Переключение: вся история или только сообщения. 2. Период. 3. Поиск по описанию, имени, идентификатору. 4. Категория событий. ![История сообщений](https://docs.tuk-tuk.online/assets/screens/history/messages.webp "Вкладка «Сообщения»: дата, канал, получатель, текст и статус доставки.") Кроме уведомлений, число непрочитанных сообщений видно в трёх местах. | Место | Что показывает | |---|---| | Заголовок вкладки | Число непрочитанных в title страницы | | Левая панель | Общий счётчик по всем диалогам | | Карточка диалога | Бейдж с числом непрочитанных в этом диалоге | ### Когда сбрасывается счётчик - При отправке ответа клиенту: непрочитанные этого диалога обнуляются. - По кнопке «Прочитать»: вручную для одного диалога. - По кнопке «Прочитать все»: для всех диалогов сразу. ## Индикатор присутствия Когда несколько менеджеров работают одновременно, в шапке чата видны аватары тех, кто сейчас открыл этот диалог. Так два человека не ответят одному клиенту разом. Присутствие отслеживается в реальном времени: открыли диалог, и коллеги вас видят; переключились на другой, и аватар пропадает. --- --- title: "Приоритеты клиентов: правила автоклассификации | tuk-tuk.online" nav_title: "Приоритеты" url: https://docs.tuk-tuk.online/dialogs/priorities markdown: https://docs.tuk-tuk.online/dialogs/priorities.md section: "Диалоги" description: "Автоматическая классификация клиентов в tuk-tuk.online по правилам с весом и условием: VIP, Горячий, Без ответа, Холодный. Настройка названий, цветов, условий и порядка проверки." keywords: ["приоритеты клиентов", "классификация обращений", "VIP клиенты", "горячие лиды", "автоматическая сортировка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Приоритет клиента вычисляется автоматически по правилам «условие + вес»: правила проверяются от большего веса к меньшему, первое сработавшее задаёт бейдж. По умолчанию четыре правила: VIP, Горячий, Без ответа, Холодный. > > - Где: раздел «Диалоги», панель клиента, блок «Приоритет», шестерёнка открывает окно «Настройка приоритетов». > - Правила по умолчанию: VIP (тег vip, вес 4), Горячий (входящее меньше 30 мин, вес 3), Без ответа (непрочитанные и входящее больше 10 мин, вес 2), Холодный (запасное, вес 1). > - Параметры правила: название до 15 символов, вес 1–10, одна из 20 иконок, один из 10 цветов, условие. > - 12 условий: тег vip, входящее недавно, не отвечено, нет активности, кастомный тег, число непрочитанных, тип канала, новый клиент, есть контакт, ключевое слово, источник, прошёл цепочку. > - Кнопка «Сбросить» возвращает правила по умолчанию. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/statuses, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/dialogs/notifications, https://docs.tuk-tuk.online/chains/blocks/tags-and-notes # Приоритеты Приоритет: бейдж на диалоге, который система ставит сама по набору правил. Правило состоит из условия и веса. Бейдж показывает, кто из клиентов важнее или срочнее, без ручной разметки. ## Как это работает 1. Настройте правила: у каждого условие и вес от 1 до 10. 2. Система проверяет правила для каждого диалога, начиная с наибольшего веса. 3. Первое сработавшее правило задаёт приоритет: его название, иконка и цвет показываются в бейдже [панели клиента](https://docs.tuk-tuk.online/dialogs/info-panel). ### Правила по умолчанию | Приоритет | Цвет | Вес | Условие | |---|---|---|---| | VIP | Янтарный | 4 | У клиента есть тег `vip` | | Горячий | Красный | 3 | Последнее входящее меньше 30 минут назад | | Без ответа | Оранжевый | 2 | Есть непрочитанные, последнее входящее больше 10 минут назад | | Холодный | Серый | 1 | Нет активности (запасное правило) | ## Как настроить правила 1. Откройте диалог в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. Нажмите шестерёнку рядом с бейджем приоритета: откроется окно «Настройка приоритетов». 3. Измените правила и закройте окно: бейджи в диалогах пересчитаются. ### Параметры правила | Параметр | Что задаёт | |---|---| | Название | Текст бейджа, до 15 символов | | Вес (1–10) | Чем выше вес, тем раньше проверяется правило | | Иконка | Одна из 20 доступных иконок | | Цвет | Цвет бейджа, 10 предустановленных цветов | | Условие | Логика срабатывания | ### Доступные условия | Условие | Когда срабатывает | Параметр | |---|---|---| | Тег «vip» | У клиента есть тег `vip` | Нет | | Входящее недавно | Последнее входящее меньше N минут назад | Минуты | | Не отвечено | Есть непрочитанные, последнее входящее больше N минут назад | Минуты | | Нет активности | Клиент без активности (запасное правило) | Нет | | Кастомный тег | У клиента есть указанный тег | Название тега | | Кол-во непрочитанных не меньше N | Непрочитанных сообщений N или больше | Порог | | Тип канала | Клиент пришёл из канала этого типа | Тип канала | | Новый клиент | Клиент создан меньше N минут назад | Минуты | | Есть контакт | У клиента заполнен телефон или email | Нет | | Ключевое слово | В последнем сообщении есть указанное слово | Слово | | Источник | Источник клиента совпадает с текстом | Текст | | Прошёл цепочку | Клиент завершил хотя бы одну цепочку | Нет | ### Управление правилами - «+ Добавить правило» создаёт новое правило. - Кнопка удаления убирает пользовательское правило. - «Сбросить» возвращает правила по умолчанию. --- --- title: "Типы сообщений в диалогах: входящие, исходящие, медиа | tuk-tuk.online" nav_title: "Типы сообщений" url: https://docs.tuk-tuk.online/dialogs/messages markdown: https://docs.tuk-tuk.online/dialogs/messages.md section: "Диалоги" description: "Типы сообщений в диалогах tuk-tuk.online: входящие, исходящие, системные, заметки. Вложения: фото, документы, голосовые, видео, стикеры. Статусы доставки и лимит 20 МБ для Telegram Bot API." keywords: ["типы сообщений", "входящие сообщения", "исходящие сообщения", "голосовые сообщения", "медиа вложения", "статусы доставки"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Сообщения в диалоге делятся на входящие (INBOUND), исходящие (OUTBOUND), системные (SYSTEM) и заметки (NOTE). Поддерживаются фото, документы, голосовые с AI-расшифровкой, видео и стикеры Telegram; у исходящих три статуса доставки. > > - Где: раздел «Диалоги», лента сообщений выбранного диалога. > - Системные сообщения помечены жёлтым бейджем и не запускают автоматизацию. > - Заметки невидимы клиенту и могут быть временными. > - Лимит Telegram Bot API на скачивание файла: 20 МБ. > - Файл можно отправить перетаскиванием в окно диалога. > - Статусы доставки: Sent, Delivered, Read. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/interface, https://docs.tuk-tuk.online/dialogs/notes, https://docs.tuk-tuk.online/ai/transcription, https://docs.tuk-tuk.online/files, https://docs.tuk-tuk.online/channels/telegram-bot # Типы сообщений В ленте диалога четыре типа сообщений по направлению и несколько видов вложений. Тип определяет, как сообщение выглядит в чате и запускает ли оно автоматизацию. ## По направлению | Тип | Код | Что это | |---|---|---| | Входящие | INBOUND | Сообщения от клиента | | Исходящие | OUTBOUND | Ваши ответы и автоматические сообщения | | Системные | SYSTEM | Технические уведомления платформы, помечены жёлтым бейджем. Не запускают автоматизацию | | Заметки | NOTE | Внутренние записи, клиент их не видит. Могут быть временными | Подробно о заметках: [Заметки](https://docs.tuk-tuk.online/dialogs/notes). ## Вложения | Вид | Как показывается | |---|---| | Фотографии | С превью в чате | | Документы | Файлы любого типа | | Голосовые сообщения | С возможностью расшифровки через AI | | Видео | Видеосообщения и видеозаметки | | Стикеры | Из Telegram | > [!WARNING] Telegram Bot API отдаёт файлы до 20 МБ. Файлы больше этого размера не загрузятся. Расшифровка голосовых: [Транскрибация](https://docs.tuk-tuk.online/ai/transcription). Хранение вложений: [Файлы и медиа](https://docs.tuk-tuk.online/files). ### Отправка перетаскиванием Перетащите файл из файлового менеджера в окно диалога в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs): файл прикрепится к сообщению. ## Статусы доставки | Статус | Значение | |---|---| | Sent | Отправлено | | Delivered | Доставлено получателю | | Read | Прочитано | --- --- title: "События календаря и комментарии в диалоге | tuk-tuk.online" nav_title: "События и комментарии" url: https://docs.tuk-tuk.online/dialogs/calendar-events markdown: https://docs.tuk-tuk.online/dialogs/calendar-events.md section: "Диалоги" description: "Создание и редактирование событий календаря прямо из диалога tuk-tuk.online, внутренние комментарии к встречам, переход в Google Calendar и связь с цепочками." keywords: ["события календаря", "комментарии к событию", "Google Calendar из чата", "запись клиента", "встреча из диалога"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок календаря в карточке диалога создаёт и редактирует события, добавляет к ним внутренние комментарии для команды и ведёт к связанному событию в Google Calendar. > > - Где: раздел «Диалоги», карточка диалога, блок календаря. > - Редактируются дата, время, название, описание и внутренний комментарий события. > - Комментарий не виден клиенту, создаётся при планировании и редактируется в том же блоке. > - Переход к событию в интеграции Google Calendar из блока. > - События используются в цепочках: напоминания за N часов, сообщения после события, запись данных в кастомные поля. > > Связанные страницы: https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/integrations/google-calendar, https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/chains # События и комментарии Блок календаря в карточке диалога создаёт и редактирует события, не выходя из переписки. К событию можно добавить внутренний комментарий: его видит команда, а клиент нет. ## Что умеет блок календаря - Создать событие прямо из диалога в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). - Изменить дату, время, название и описание. - Добавить внутренний комментарий к событию. - Перейти к связанному событию в интеграции [Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar). Общие настройки календаря, услуг и расписания: [Календарь и запись](https://docs.tuk-tuk.online/calendar). ## Комментарии к событиям Комментарий хранит контекст, который не должен попасть клиенту: - детали договорённости по встрече; - риски и возражения клиента; - напоминания для менеджера. Комментарий создаётся при планировании события и редактируется позже в том же блоке. ## Как вести комментарии 1. Сразу после согласования времени запишите цель встречи одной строкой. 2. Перед звонком обновите комментарий, если запрос клиента изменился. 3. Держите единый формат для всей команды, например `цель / подготовка / следующий шаг`. ## Связь с автоматизацией События календаря доступны в [цепочках](https://docs.tuk-tuk.online/chains) и AI-сценариях: - напоминание за N часов до события; - сообщение после события; - сбор данных после встречи в кастомные поля диалога. --- --- title: "Дубли диалогов и идентификаторы каналов | tuk-tuk.online" nav_title: "Дубли и идентификаторы" url: https://docs.tuk-tuk.online/dialogs/duplicates markdown: https://docs.tuk-tuk.online/dialogs/duplicates.md section: "Диалоги" description: "Как tuk-tuk.online хранит идентификаторы клиента из каждого канала, находит существующий диалог при входящем сообщении, ищет дубли по телефону, email, Telegram ID, VK ID, Avito ID и объединяет диалоги." keywords: ["поиск дублей", "объединение диалогов", "merge диалогов", "Telegram ID", "идентификаторы каналов", "кросс-канальный поиск"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Платформа хранит идентификатор клиента из каждого канала (Telegram Chat ID, VK Peer ID, Avito Chat ID, MAX Chat ID, AmoCRM Contact ID, email, телефон, Visitor ID) и по ним кладёт входящее в существующий диалог. Блок «Дубли» в панели клиента находит повторные диалоги и объединяет их с переносом всей истории. > > - Где: раздел «Диалоги», панель клиента, блок «Дубли», шестерёнка для настройки полей и режима. > - Маршрутизация входящего: сначала по `clientIdentifier`, затем кросс-канально по `telegramChatId`, `vkPeerId`, `email`, `phoneNumber`. > - Поля поиска дублей по умолчанию: телефон, email, имя, Telegram ID, VK ID, Avito ID, MAX Bot ID, AmoCRM ID; можно добавить кастомные поля. > - Режимы: точное совпадение или частичное (LIKE). Настройки хранятся в браузере. > - Объединение: выбор данных из каждого диалога, кнопка «Объединить», сообщения переносятся полностью. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/dialogs/import-export, https://docs.tuk-tuk.online/dialogs/search-and-filters, https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/integrations/amocrm # Дубли и идентификаторы каналов При первом обращении клиента платформа сохраняет его идентификатор из канала: Telegram Chat ID, VK Peer ID, телефон, email. По этим идентификаторам входящее сообщение попадает в существующий диалог, даже если клиент сменил канал, а блок «Дубли» находит повторные карточки и объединяет их. ## Идентификаторы каналов | Канал | Идентификатор | Пример | |---|---|---| | Telegram Bot | Telegram Chat ID | `123456789` | | Telegram Account | Telegram Chat ID | `123456789` | | VK Group | VK Peer ID | `87654321` | | Avito | Avito Chat ID | `u2i-xxx-yyy` | | MAX Bot | MAX Chat ID | `chat_456` | | AmoCRM | AmoCRM Contact ID | `amo:12345` | | Email | Email-адрес | `client@mail.ru` | | SMS | Номер телефона | `+79991234567` | | Чат-виджет | Visitor ID | `vis_abc123` | | Webhook | Телефон / Email / Hash | Зависит от данных | Идентификаторы видны в [панели клиента](https://docs.tuk-tuk.online/dialogs/info-panel) и доступны для поиска дублей. ## Как входящее находит свой диалог 1. Основной поиск: по `clientIdentifier`, уникальному ключу канала. 2. Кросс-канальный поиск, если основной ничего не нашёл: - Telegram: по `telegramChatId`; - VK: по `vkPeerId`; - Email: по `email`; - SMS: по `phoneNumber`; - остальные каналы: по своему идентификатору. Если клиент раньше писал в Telegram, а теперь написал по email, и этот email уже записан в его диалоге, сообщение прикрепится к тому же диалогу. > [!TIP] Клиент впервые написал в Telegram Bot, его `telegramChatId = 123456789`. Позже администратор добавил ему телефон `+79991234567`. Когда с этого номера придёт SMS, система найдёт клиента по телефону и положит SMS в тот же диалог. ## Поиск дублей Блок «Дубли» в панели клиента ищет другие диалоги с совпадающими данными. ### По каким полям По умолчанию: телефон, email, имя клиента, Telegram ID, VK ID, Avito ID, MAX Bot ID, AmoCRM ID. Дополнительно можно включить любые кастомные поля, например `ИНН` или `номер заказа`. ### Режимы поиска - Точное совпадение: значения совпадают полностью. - Частичное совпадение: поиск по вхождению подстроки (LIKE). ### Как настроить 1. Откройте диалог в разделе [Диалоги](https://lk.tuk-tuk.online/dialogs). 2. Нажмите шестерёнку рядом с блоком «Дубли»: откроются настройки. 3. Отметьте поля для проверки и выберите режим (точный или частичный): список дублей пересчитается. > [!NOTE] Настройки поиска дублей хранятся в браузере. ## Как объединить диалоги 1. Нажмите на карточку дубликата в блоке «Дубли»: откроется окно объединения. 2. Выберите, какие данные из какого диалога оставить: имя, телефон, email, источник; Telegram ID, VK ID, Avito ID, MAX Bot ID, AmoCRM ID; кастомные поля. 3. Нажмите «Объединить»: останется один диалог. Все сообщения из удалённого диалога переносятся в оставшийся, история переписки сохраняется целиком. --- --- title: "Задачи: канбан, дедлайны и автосоздание | tuk-tuk.online" nav_title: "Задачи" url: https://docs.tuk-tuk.online/tasks markdown: https://docs.tuk-tuk.online/tasks.md description: "Встроенный менеджер задач tuk-tuk.online: канбан с 5 статусами, 4 приоритета, назначение на сотрудника, привязка к диалогу, дедлайны с уведомлениями, автосоздание через цепочки и AI." keywords: ["задачи CRM", "канбан задач", "управление задачами", "задачи для команды", "приоритеты задач", "дедлайны задач", "менеджер задач", "task manager", "задачи из диалога"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Встроенный менеджер задач tuk-tuk.online: канбан с 5 статусами и 4 приоритетами, назначение на сотрудника, привязка к диалогу, дедлайны с автоматическими действиями, создание задач цепочками и AI. > > - Раздел «Задачи» в меню кабинета https://lk.tuk-tuk.online; рядом счётчик задач не в статусе «Готово». > - Статусы: Бэклог, К выполнению (по умолчанию), В работе, На проверке, Готово. > - Приоритеты: Низкий, Средний (по умолчанию), Высокий, Срочный. > - Задача привязывается к диалогу и видна в блоке «Задачи» панели клиента. > - Дедлайны проверяются каждую минуту; при наступлении: пост в Эфир, запись в диалог, push, авто-сообщение клиенту, запуск цепочки. Каждое действие выполняется один раз. > - Автосоздание: блоки CREATE_TASK и AI_TASK в редакторе цепочек. > > Связанные страницы: https://docs.tuk-tuk.online/tasks/kanban, https://docs.tuk-tuk.online/tasks/deadlines, https://docs.tuk-tuk.online/tasks/automation, https://docs.tuk-tuk.online/dialogs/info-panel, https://docs.tuk-tuk.online/chains/blocks/tasks # Задачи Задачи: встроенный менеджер дел внутри платформы. Задача создаётся в два клика из любого диалога, попадает на канбан-доску, назначается сотруднику и получает дедлайн. По наступлении дедлайна платформа сама уведомляет команду, пишет клиенту или запускает цепочку. Отдельный Trello, Notion или Asana не нужен: задачи живут рядом с перепиской, из которой возникли. ## Когда это нужно - Не забыть перезвонить: задача с дедлайном прямо из диалога. - Распределить работу: задача назначается конкретному сотруднику. - Видеть этапы: канбан показывает, что в работе, что на проверке, что закрыто. - Автоматизировать: цепочки и AI создают задачи без участия менеджера. ## Разделы | Раздел | Что внутри | |---|---| | [Канбан и статусы](https://docs.tuk-tuk.online/tasks/kanban) | 5 колонок, перетаскивание, форма задачи, привязка к диалогу, цветные метки | | [Дедлайны и напоминания](https://docs.tuk-tuk.online/tasks/deadlines) | Пост в Эфир, запись в диалог, push, авто-сообщение клиенту, запуск цепочки, делегирование | | [Автосоздание задач](https://docs.tuk-tuk.online/tasks/automation) | Блоки CREATE_TASK и AI_TASK в цепочках, создание из панели клиента | ## Статусы и приоритеты ![Вид «Дни»: задачи по дедлайнам](https://docs.tuk-tuk.online/assets/screens/tasks/days.webp "Вид «Дни» раскладывает задачи по датам дедлайна на неделю вперёд.") ![Вид «Список»: все задачи одной таблицей](https://docs.tuk-tuk.online/assets/screens/tasks/list.webp "Вид «Список» удобен для быстрого просмотра и поиска.") ### 5 статусов | Статус | Значение | |---|---| | Бэклог | Записана, но пока не в приоритете | | К выполнению | Готова к работе. Статус по умолчанию | | В работе | Кто-то уже занимается | | На проверке | Сделана, нужна проверка | | Готово | Завершена | ### 4 приоритета | Приоритет | Цвет | Когда ставить | |---|---|---| | Низкий | Зелёный | Когда-нибудь потом | | Средний | Жёлтый | В плановом порядке. Приоритет по умолчанию | | Высокий | Оранжевый | Важно, сделать скоро | | Срочный | Красный | Нужно прямо сейчас | > [!TIP] Рядом с пунктом «Задачи» в меню кабинета стоит счётчик задач не в статусе «Готово». Загрузку команды видно, не открывая доску. --- --- title: "Канбан-доска задач: статусы и перетаскивание | tuk-tuk.online" nav_title: "Канбан и статусы" url: https://docs.tuk-tuk.online/tasks/kanban markdown: https://docs.tuk-tuk.online/tasks/kanban.md section: "Задачи" description: "Канбан-доска задач в tuk-tuk.online: 5 колонок-статусов, перетаскивание, приоритеты, назначение на сотрудника, цветные метки, привязка к диалогу, делегирование по дедлайну." keywords: ["канбан задач", "доска задач", "drag and drop задачи", "назначение задач", "приоритеты задач", "фильтрация задач", "статусы задач"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Канбан-доска задач tuk-tuk.online: пять колонок по статусам, перетаскивание карточек, форма задачи с приоритетом, исполнителем, дедлайном, цветом и привязкой к диалогу. > > - Раздел «Задачи» в меню кабинета https://lk.tuk-tuk.online; кнопка «+ Новая задача». > - Колонки: Бэклог, К выполнению, В работе, На проверке, Готово. Перетаскивание меняет статус или порядок. > - Обязательные поля: Название, Статус (по умолчанию «К выполнению»), Приоритет (по умолчанию «Средний»). > - Необязательные: Описание, Исполнитель, Дедлайн, Цвет, Привязка к диалогу. > - Делегирование по дедлайну: конкретный сотрудник, роль или все. > - Привязанная к диалогу задача видна в блоке «Задачи» панели клиента. > > Связанные страницы: https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/tasks/deadlines, https://docs.tuk-tuk.online/tasks/automation, https://docs.tuk-tuk.online/dialogs/info-panel # Канбан-доска задач Канбан: доска из пяти колонок, по одной на статус. Все задачи команды видны разом, карточки перетаскиваются между колонками, статус меняется без открытия формы. ## Как выглядит доска ![Доска задач](https://docs.tuk-tuk.online/assets/screens/tasks/board.webp) 1. Пункт «Задачи» в меню. 2. Новая задача. 3. Вид: Доска, Дни, Список. 4. Поиск и фильтры по исполнителю, приоритету, статусу. 5. Карточка задачи, перетаскивается между колонками. ```text Бэклог │ К выполнению │ В работе │ На проверке │ Готово ────────────┼────────────────┼─────────────┼───────────────┼─────────── Задача 1 │ Задача 3 │ Задача 5 │ Задача 7 │ Задача 9 Задача 2 │ Задача 4 │ Задача 6 │ │ Задача 10 ``` На карточке видно: - название задачи; - приоритет: цветная метка (зелёная, жёлтая, оранжевая, красная); - исполнитель; - дедлайн, если задан; - цвет карточки; - имя клиента, если задача создана из диалога. ## Перетаскивание ![Быстрое редактирование задачи](https://docs.tuk-tuk.online/assets/screens/tasks/task-open.webp "Клик по карточке открывает быстрые правки: название, статус, приоритет и полные настройки.") 1. Зажмите карточку и перетащите в другую колонку: статус сменится сразу. 2. Перетащите карточку вверх или вниз внутри колонки: изменится порядок. Изменения видны остальным участникам в реальном времени. ## Как создать задачу ![Форма новой задачи](https://docs.tuk-tuk.online/assets/screens/tasks/new-task.webp) 1. Название задачи. 2. Описание. 3. Исполнитель. 4. Дедлайн. 5. Клиент: привязка к диалогу. 6. Кнопка «Создать»; выше выбираются статус, приоритет и цвет карточки. 1. Нажмите «+ Новая задача»: откроется форма. 2. Заполните поля и сохраните: карточка появится в колонке выбранного статуса. | Поле | Обязательное | Что указать | |---|---|---| | Название | Да | Что нужно сделать | | Описание | Нет | Подробности, контекст, ссылки | | Статус | Да | По умолчанию «К выполнению» | | Приоритет | Да | По умолчанию «Средний» | | Исполнитель | Нет | Кому назначить | | Дедлайн | Нет | К какой дате и времени выполнить | | Цвет | Нет | Визуальная метка карточки | | Привязка к диалогу | Нет | Связать с конкретным клиентом | ## Назначение на сотрудника Назначенный сотрудник видит задачу на своей доске и получает уведомления по ней. ### Делегирование по дедлайну Для задач с дедлайном есть второй механизм: при наступлении дедлайна задача передаётся автоматически. | Режим | Что происходит | |---|---| | Конкретный сотрудник | Задача переходит к выбранному человеку | | Роль | Задача переходит к сотруднику с указанной ролью | | Все | Задача становится видна всем сотрудникам | Подробнее в разделе [Дедлайны и напоминания](https://docs.tuk-tuk.online/tasks/deadlines). ## Привязка к диалогу Задачу можно связать с клиентом (диалогом). Удобно, когда задача родилась в переписке: «Подготовить коммерческое предложение для Ивана». Привязанная задача: - показывается в блоке «Задачи» [панели клиента](https://docs.tuk-tuk.online/dialogs/info-panel) в диалоге; - выводит имя клиента на карточке; - может отправить клиенту сообщение при наступлении дедлайна. ## Цветные метки У каждой задачи можно выбрать цвет карточки. Это группировка по проекту, типу или отделу без фильтров: достаточно взгляда на доску. ## Счётчик задач Рядом с пунктом «Задачи» в меню кабинета стоит счётчик незавершённых задач: всех, что не в статусе «Готово». --- --- title: "Дедлайны задач: напоминания и автодействия | tuk-tuk.online" nav_title: "Дедлайны и напоминания" url: https://docs.tuk-tuk.online/tasks/deadlines markdown: https://docs.tuk-tuk.online/tasks/deadlines.md section: "Задачи" description: "Что происходит при наступлении дедлайна задачи в tuk-tuk.online: пост в Эфир, запись в диалог, push, авто-сообщение клиенту, запуск цепочки, делегирование. Защита от повторов." keywords: ["дедлайны задач", "напоминания о задачах", "автоуведомления", "автосообщение клиенту", "запуск цепочки по дедлайну", "делегирование задач"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > При наступлении дедлайна задачи tuk-tuk.online автоматически публикует пост в Эфир, оставляет заметку в диалоге, шлёт push исполнителю, отправляет клиенту заданный текст и запускает выбранную цепочку. Каждое действие выполняется один раз. > > - Планировщик проверяет дедлайны каждую минуту. > - Порядок действий: Эфир, заметка в диалоге, push, авто-сообщение клиенту, запуск цепочки. > - Настройки в форме задачи: Дедлайн, Уведомить в Эфир, Авто-сообщение, Цепочка, Делегирование. > - Авто-сообщение и заметка в диалоге требуют привязки задачи к диалогу. > - Делегирование: конкретный сотрудник, по роли или все. > - Защита от повторов: уведомление, авто-сообщение и запуск цепочки помечаются как выполненные. > > Связанные страницы: https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/tasks/kanban, https://docs.tuk-tuk.online/tasks/automation, https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/dialogs/notifications # Дедлайны и напоминания Дедлайн: дата и время, к которым задачу нужно закрыть. При наступлении дедлайна платформа не просто подсвечивает карточку, а выполняет серию действий: уведомляет команду, пишет клиенту, запускает цепочку, передаёт задачу другому. ## Что происходит при наступлении дедлайна Планировщик проверяет задачи каждую минуту. Для задачи с наступившим дедлайном действия выполняются по порядку. | Шаг | Действие | Условие | |---|---|---| | 1 | Пост в [Эфир](https://docs.tuk-tuk.online/dialogs/notifications): команда видит, что дедлайн наступил | Включён переключатель «Уведомить в Эфир» | | 2 | Системная заметка в диалоге клиента | Задача привязана к диалогу | | 3 | Push-уведомление исполнителю (или создателю, если исполнитель не назначен) | Всегда | | 4 | Авто-сообщение клиенту с заданным текстом | Заполнено поле «Авто-сообщение» и есть привязка к диалогу | | 5 | Запуск цепочки для клиента | В задаче выбрана цепочка | Запуск цепочки: самый сильный вариант. По наступлении дедлайна стартует целый сценарий: серия сообщений, AI-обработка, интеграции. ## Как настроить 1. Откройте задачу на создание или редактирование: появится форма. 2. Заполните блок дедлайна и сохраните: действия сработают в указанное время. | Настройка | Что указать | |---|---| | Дедлайн | Дата и время | | Уведомить в Эфир | Включить или выключить пост в Эфир | | Авто-сообщение | Текст, который уйдёт клиенту | | Цепочка | Цепочка, которая запустится при дедлайне | | Делегирование | Кому передать задачу при наступлении дедлайна | ## Делегирование по дедлайну | Режим | Что происходит | |---|---| | Конкретный сотрудник | Задача переназначается выбранному человеку | | По роли | Задача переходит к сотруднику с указанной ролью | | Все | Задача становится видна всей команде | Так задача эскалируется сама, если основной ответственный не успел. ## Защита от повторного срабатывания > [!NOTE] Каждое действие выполняется ровно один раз. Платформа отмечает: уведомление отправлено, авто-сообщение ушло, цепочка запущена. Повторных отправок не будет, даже если задача остаётся с просроченным дедлайном. ## Пример: напоминание о записи 1. Клиент записался на приём 15 марта в 10:00. 2. Создайте задачу «Напомнить Иванову о приёме» с дедлайном 14 марта, 18:00 и авто-сообщением «Иван, напоминаем: завтра в 10:00 вас ждёт приём». 3. Дождитесь 14 марта, 18:00: менеджер получит push, клиенту уйдёт сообщение, в диалоге появится системная заметка. --- --- title: "Автосоздание задач через цепочки и AI | tuk-tuk.online" nav_title: "Автосоздание задач" url: https://docs.tuk-tuk.online/tasks/automation markdown: https://docs.tuk-tuk.online/tasks/automation.md section: "Задачи" description: "Как tuk-tuk.online создаёт задачи без участия менеджера: блок CREATE_TASK с фиксированными параметрами, блок AI_TASK по контексту переписки, кнопка в панели клиента." keywords: ["автосоздание задач", "задачи из цепочки", "AI создание задач", "автоматизация задач", "задачи из диалога", "умные задачи"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Задачи в tuk-tuk.online создаются автоматически блоком CREATE_TASK (фиксированные параметры) или AI_TASK (AI подбирает название, приоритет, дедлайн и исполнителя по переписке), а также вручную из блока «Задачи» в панели клиента. > > - CREATE_TASK: Название обязательно; Статус по умолчанию «К выполнению», Приоритет MEDIUM, Исполнитель по умолчанию создатель. > - Приоритеты в блоке: LOW, MEDIUM, HIGH, URGENT. > - AI_TASK: AI генерирует JSON с названием, описанием, приоритетом, дедлайном и тегами. > - Режимы назначения AI_TASK: автор цепочки, по роли, конкретный сотрудник. > - Ручное создание: диалог, правая панель, блок «Задачи», кнопка «+ Создать задачу»; диалог привязывается автоматически. > - Задача, созданная цепочкой, привязывается к клиенту, для которого шла цепочка. > > Связанные страницы: https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/tasks/deadlines, https://docs.tuk-tuk.online/chains/blocks/tasks, https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/dialogs/info-panel # Автосоздание задач Задачу не обязательно заводить руками. [Цепочка](https://docs.tuk-tuk.online/chains) создаёт её блоком «Создать задачу» с заданными параметрами или блоком «AI-задача», где параметры подбирает AI по переписке. Третий путь: кнопка в панели клиента внутри диалога. ## Блок «Создать задачу» (CREATE_TASK) Когда цепочка доходит до этого блока, задача создаётся с указанными параметрами и привязкой к клиенту, для которого идёт цепочка. | Параметр | Что задаёт | По умолчанию | |---|---|---| | Название | Заголовок задачи | Обязательно | | Описание | Подробности | Пусто | | Статус | Начальный статус | К выполнению | | Приоритет | LOW, MEDIUM, HIGH, URGENT | MEDIUM | | Исполнитель | На кого назначить | Создатель | | Цвет | Цвет карточки | Пусто | | Дедлайн | Дата и время | Пусто | | Делегирование | Кому передать при дедлайне | Пусто | Пример сценария: ```text Клиент пишет «Хочу оформить заказ» ↓ Условие: тег = «VIP» ↓ Да Создать задачу: Название: «Обработать VIP-заказ» Приоритет: Срочный Исполнитель: Менеджер по VIP Дедлайн: через 1 час ``` Описание блока в редакторе: [Блок «Задачи»](https://docs.tuk-tuk.online/chains/blocks/tasks). ## Блок «AI-задача» (AI_TASK) Вместо фиксированных параметров AI читает диалог и сам решает, какую задачу создать. ### Как работает 1. AI читает контекст переписки. 2. Определяет, нужна ли задача, какой у неё приоритет и кому её отдать. 3. Генерирует JSON с параметрами задачи. 4. Платформа создаёт задачу по этим данным: карточка появляется на доске. ### Что AI определяет | Параметр | Пример | |---|---| | Название | «Подготовить КП для Иванова» | | Описание | «Клиент интересуется тарифом Premium, нужна цена на 50 рабочих мест» | | Приоритет | HIGH (клиент торопит) | | Дедлайн | Завтра 12:00 | | Теги | продажа, КП | ### Режимы назначения | Режим | Кому уходит задача | |---|---| | Автор цепочки | Владельцу аккаунта | | По роли | Сотруднику с подходящей ролью | | Конкретный сотрудник | Выбранному человеку | ## Из панели клиента в диалоге ![Создание задачи прямо из диалога](https://docs.tuk-tuk.online/assets/screens/dialogs/task-from-dialog.webp) 1. Название задачи. 2. Описание. 3. Исполнитель. 4. Дедлайн. 5. Клиент: диалог подставляется автоматически. 6. Кнопка «Создать». 1. Откройте нужный диалог. 2. В правой панели найдите блок «Задачи». 3. Нажмите «+ Создать задачу»: откроется форма. 4. Заполните форму и сохраните: диалог привяжется автоматически. Все задачи, привязанные к клиенту, видны в том же блоке. ## Задачи в Эфире О создании задачи, ручном или автоматическом, можно узнать в Эфире, внутреннем канале команды. При наступлении дедлайна уведомление придёт всем. Подробнее: [Дедлайны и напоминания](https://docs.tuk-tuk.online/tasks/deadlines). --- --- title: "Календарь и онлайн-запись клиентов | tuk-tuk.online" nav_title: "Календарь и запись" url: https://docs.tuk-tuk.online/calendar markdown: https://docs.tuk-tuk.online/calendar.md description: "Встроенный календарь tuk-tuk.online: запись клиентов на услуги, каталог услуг, сотрудники с расписанием, таймлайн загрузки, синхронизация с Google Calendar и Яндекс Календарём." keywords: ["календарь CRM", "онлайн-запись клиентов", "расписание сотрудников", "запись на услуги", "календарь событий", "Google Calendar интеграция", "booking", "запись на приём"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Встроенный календарь tuk-tuk.online для записи клиентов: каталог услуг, сотрудники с расписанием, события с 4 статусами, три вида отображения, синхронизация с Google Calendar (OAuth 2.0) и Яндекс Календарём (CalDAV), AI-запись из диалога. > > - Раздел «Календарь» в меню кабинета https://lk.tuk-tuk.online; вкладки «Услуги», «Сотрудники», «Теги». > - Источники событий: локальные, Google Calendar (OAuth 2.0, ссылки Google Meet), Яндекс Календарь (CalDAV). > - Статусы события: Ожидание, Подтверждено, Состоялось, Неявка. > - Виды: Сетка (месяц, неделя, день), Список, Таймлайн по сотрудникам. > - AI-ассистент в режиме «Запись в календарь» создаёт события из переписки. > - Права: просмотр, создание, редактирование, удаление событий, синхронизация (категория «Календарь»). > > Связанные страницы: https://docs.tuk-tuk.online/calendar/services, https://docs.tuk-tuk.online/calendar/staff, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/integrations/google-calendar # Календарь и запись Календарь: встроенная запись клиентов и управление событиями. Услуга, сотрудник, время и контакты клиента собраны в одной карточке события, а загрузка каждого сотрудника видна на таймлайне. Календарь синхронизируется с Google Calendar и Яндекс Календарём, а AI-ассистент в режиме [«Запись в календарь»](https://docs.tuk-tuk.online/ai/calendar-booking) записывает клиентов прямо из переписки. ## Когда это нужно - Записать клиента на приём с указанием услуги, сотрудника и времени. - Видеть загрузку команды: таймлайн показывает расписание каждого сотрудника. - Держать один календарь: события из Google Calendar или Яндекс Календаря приходят в платформу и обратно. - Автоматизировать запись: AI-ассистент подбирает слот и создаёт событие сам. ## Разделы ![Календарь: вид «Таймлайн»](https://docs.tuk-tuk.online/assets/screens/calendar/timeline.webp) 1. Пункт «Календарь» в меню. 2. Вид: Таймлайн, Список, Сетка. 3. Каталог услуг и товаров. 4. Сотрудники и их расписание. 5. Создать запись вручную. 6. Навигация по дням. 7. Фильтр по сотруднику. | Раздел | Что внутри | |---|---| | [Каталог услуг](https://docs.tuk-tuk.online/calendar/services) | Услуги и продукты, длительность, цена, привязка к сотрудникам | | [Сотрудники и расписание](https://docs.tuk-tuk.online/calendar/staff) | Профили сотрудников, 5 режимов графика, часы работы, таймлайн | | [События и запись](https://docs.tuk-tuk.online/calendar/events) | Создание, 4 статуса, синхронизация, комментарии, история изменений | ## Источники, статусы и виды ### 3 источника событий | Источник | Как попадает в календарь | |---|---| | Локальные | Создаются вручную в платформе | | Google Calendar | Синхронизация через OAuth 2.0, автоматические ссылки Google Meet | | Яндекс Календарь | Синхронизация по протоколу CalDAV | ### 4 статуса события | Статус | Значение | |---|---| | Ожидание | Запись создана, но ещё не подтверждена | | Подтверждено | Клиент подтвердил визит | | Состоялось | Клиент пришёл | | Неявка | Клиент не пришёл | ### 3 вида отображения | Вид | Что показывает | |---|---| | Сетка | Классический календарь: месяц, неделя, день | | Список | Все события одним списком с фильтрами | | Таймлайн | Колонки по сотрудникам: кто когда занят | --- --- title: "Каталог услуг для записи клиентов | tuk-tuk.online" nav_title: "Каталог услуг" url: https://docs.tuk-tuk.online/calendar/services markdown: https://docs.tuk-tuk.online/calendar/services.md section: "Календарь и запись" description: "Каталог услуг в календаре tuk-tuk.online: название, длительность, цена, категория (услуга или продукт), цвет, привязка к сотрудникам. Как услуги подставляются при записи." keywords: ["каталог услуг", "услуги для записи", "длительность услуги", "цена услуги", "услуги и продукты", "управление услугами", "сервис каталог"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Каталог услуг календаря tuk-tuk.online: карточки услуг и продуктов с длительностью, ценой, цветом и списком сотрудников. При записи услуга подставляет длительность, цену и доступных специалистов. > > - Путь в кабинете: Календарь → Услуги (https://lk.tuk-tuk.online); кнопка «+ Новая услуга». > - Параметры: Название (обязательно), Длительность (по умолчанию 60 мин), Цена, Категория (Услуга по умолчанию), Цвет, Сотрудники, Активна (по умолчанию да). > - Категории: Услуга (занимает слот по времени) и Продукт (без привязки ко времени, слот не занимает). > - Услуга привязывается к одному или нескольким сотрудникам; при записи предлагаются только они. > - В событии можно выбрать несколько услуг: длительность суммируется. > - Неактивная услуга скрыта из каталога, история записей сохраняется. > > Связанные страницы: https://docs.tuk-tuk.online/calendar, https://docs.tuk-tuk.online/calendar/staff, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/ai/calendar-booking # Каталог услуг Каталог услуг: список того, на что записывают клиента. Здесь хранятся услуги (стрижка, консультация, массаж) и продукты (курс, абонемент). При создании события услуга подставляет длительность, цену и список сотрудников, которые её оказывают. ## Параметры услуги | Параметр | Что задаёт | По умолчанию | |---|---|---| | Название | Как называется услуга | Обязательно | | Длительность | Сколько минут занимает | 60 мин | | Цена | Стоимость для клиента | Пусто | | Категория | Услуга или продукт | Услуга | | Цвет | Цвет для выделения в календаре | Пусто | | Сотрудники | Кто может оказывать услугу | Пусто | | Активна | Видна ли в каталоге | Да | ## Услуга или продукт | Категория | Когда выбирать | Примеры | |---|---|---| | Услуга | Работа с клиентом по времени | Консультация, стрижка, диагностика | | Продукт | Продажа без привязки ко времени | Курс, абонемент, подписка | Продукты не занимают слот в расписании. Разделение помогает и в отчётах, и при записи. ## Привязка к сотрудникам Услугу можно привязать к одному или нескольким сотрудникам. Тогда: - при записи клиенту предлагаются только специалисты, которые оказывают выбранную услугу; - в таймлайне видно, кто из них свободен под конкретную услугу. Пример: «Стрижку» делают Мария и Анна, «Окрашивание» только Мария. При записи на окрашивание платформа покажет только Марию. ## Как добавить услугу ![Каталог услуг и товаров](https://docs.tuk-tuk.online/assets/screens/calendar/services.webp) 1. Кнопка «Добавить». 2. Карточка услуги: название, длительность, цена, исполнители. ![Форма новой услуги](https://docs.tuk-tuk.online/assets/screens/calendar/service-form.webp) 1. Название услуги. 2. Длительность в минутах. 3. Цена. 4. Кнопка «Создать»; ниже тип, цвет и исполнители. 1. Откройте Календарь → Услуги: появится список каталога. 2. Нажмите «+ Новая услуга»: откроется форма. 3. Заполните параметры и нажмите «Сохранить»: услуга появится в каталоге и станет доступна при записи. Из каталога можно редактировать параметры, переключать статус «активна / неактивна» и удалять неиспользуемые услуги. > [!TIP] Если услугу временно не оказываете, не удаляйте её, а выключите. История записей сохранится. ## Как услуги работают при записи Когда менеджер или AI-ассистент создаёт событие, можно выбрать одну или несколько услуг. Платформа сама: - подставит длительность (сумму длительностей выбранных услуг); - покажет цену; - предложит только тех сотрудников, которые оказывают эти услуги. --- --- title: "Сотрудники и расписание в календаре | tuk-tuk.online" nav_title: "Сотрудники и расписание" url: https://docs.tuk-tuk.online/calendar/staff markdown: https://docs.tuk-tuk.online/calendar/staff.md section: "Календарь и запись" description: "Сотрудники календаря tuk-tuk.online: профиль, 5 режимов расписания (свой, будни, 2 через 2, 3 через 1, все дни), часы работы по дням, таймлайн загрузки." keywords: ["расписание сотрудников", "график работы", "сменный график", "режим 2 через 2", "расписание сотрудника", "управление персоналом", "таймлайн сотрудников"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Сотрудники календаря tuk-tuk.online: отдельный справочник специалистов с цветом, признаком активности и расписанием. Пять режимов графика, часы по дням, сменные циклы от даты старта, таймлайн загрузки. > > - Путь в кабинете: Календарь → Сотрудники (https://lk.tuk-tuk.online); кнопка «+ Новый сотрудник». > - Сотрудники календаря не связаны с пользователями платформы (аккаунтами с доступом в кабинет). > - Режимы расписания: custom (свой), weekdays (будни), 2_2 (2 через 2), 3_1 (3 через 1), all (все дни). > - Режимы 2_2 и 3_1 считаются от даты старта цикла. > - Часы работы задаются на каждый рабочий день. > - Неактивный сотрудник сохраняет записи, новые на него не создаются. > > Связанные страницы: https://docs.tuk-tuk.online/calendar, https://docs.tuk-tuk.online/calendar/services, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/users/team # Сотрудники и расписание Для записи клиентов нужны сотрудники с настроенным графиком. Платформа знает, кто в какие дни и часы работает, и не даст записать клиента на время, когда специалист недоступен. > [!NOTE] Сотрудники в модуле «Календарь» и пользователи платформы: разные справочники. Здесь хранятся специалисты, к которым записываются клиенты, а не аккаунты с доступом в кабинет. ## Профиль сотрудника | Параметр | Что задаёт | |---|---| | Имя | Имя сотрудника или специалиста | | Цвет | Цвет колонки в таймлайне | | Активен | Работает ли сейчас | | Режим расписания | По какому правилу строится график | | Расписание | Конкретные часы работы | ## 5 режимов расписания | Режим | Код | Как работает | Пример | |---|---|---|---| | Свой | `custom` | Рабочие дни и часы задаются вручную | Пн 9:00–18:00, Ср 10:00–14:00 | | Будни | `weekdays` | Понедельник, вторник, среда, четверг, пятница | Стандартная 5-дневная неделя | | 2 через 2 | `2_2` | Два дня работает, два отдыхает | Сменный график | | 3 через 1 | `3_1` | Три дня работает, день отдыхает | Сменный график | | Все дни | `all` | Работает каждый день | Без выходных | ### Сменные графики Для режимов 2 через 2 и 3 через 1 нужна дата старта: день, с которого начался цикл. Дальше график считается автоматически на любую дату вперёд. Пример для режима 2 через 2 со стартом 1 января: - 1–2 января: рабочие дни; - 3–4 января: выходные; - 5–6 января: рабочие дни; - и так далее. ## Часы работы Для каждого рабочего дня задаются часы: ```text Мария (парикмахер): Пн, Ср, Пт: 09:00–18:00 Вт, Чт: 12:00–20:00 Сб, Вс: выходной Анна (косметолог): Режим: 2 через 2 Старт: 1 января Часы: 10:00–19:00 ``` ## Таймлайн В виде «Таймлайн» у каждого сотрудника своя колонка, по строкам идёт время: ```text Мария Анна Игорь 09:00 ████████ 10:00 ████████ ████████ 11:00 ████████ ████████ ████████ 12:00 ████████ ████████ ████████ 13:00 ████████ ████████ ████████ 14:00 ████████ ████████ ████████ 15:00 ████████ ████████ 16:00 ████████ ``` Закрашено рабочее время, пусто: выходной или нерабочие часы. Наведите на свободный слот, чтобы сразу создать запись. ## Как добавить сотрудника ![Список сотрудников с графиками](https://docs.tuk-tuk.online/assets/screens/calendar/staff.webp) 1. Кнопка «Добавить». 2. Карточка сотрудника: цвет, рабочие часы и график. ![Форма нового сотрудника](https://docs.tuk-tuk.online/assets/screens/calendar/staff-form.webp) 1. Имя сотрудника. 2. Начало рабочего дня. 3. Конец рабочего дня. 4. График работы: будни, 2/2, 3/1 или свой. 5. Кнопка «Создать». 1. Откройте Календарь → Сотрудники: появится список. 2. Нажмите «+ Новый сотрудник»: откроется форма. 3. Введите имя, выберите цвет и режим расписания. 4. Настройте часы работы. 5. Нажмите «Сохранить»: сотрудник появится в списке и в таймлайне. > [!TIP] Если сотрудник ушёл в отпуск, не удаляйте его, а выключите тумблер «Активен». Существующие записи сохранятся, новые на него создать не получится. --- --- title: "События календаря: запись, статусы, синхронизация | tuk-tuk.online" nav_title: "События и запись" url: https://docs.tuk-tuk.online/calendar/events markdown: https://docs.tuk-tuk.online/calendar/events.md section: "Календарь и запись" description: "События календаря tuk-tuk.online: поля записи, 4 статуса, синхронизация с Google Calendar и Яндекс Календарём, комментарии, история изменений, теги, три вида отображения, AI-запись из диалога." keywords: ["запись клиента", "события календаря", "онлайн-запись", "Google Calendar синхронизация", "статусы записи", "история изменений", "комментарии к записи", "таймлайн календаря"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Событие календаря tuk-tuk.online: запись клиента с датой, сотрудником, услугами, контактами и статусом. Поддерживает синхронизацию с Google Calendar и Яндекс Календарём, комментарии, историю изменений, теги и создание через AI-ассистента. > > - Поля события: название, начало, окончание, сотрудник, услуги, имя клиента, телефон, email, местоположение, цвет (по умолчанию индиго), теги, заметки. > - Статусы: Ожидание, Подтверждено, Состоялось, Неявка. > - Google Calendar: OAuth 2.0 в разделе «Интеграции», кнопка «Синхронизировать», автоссылки Google Meet. Яндекс Календарь: CalDAV, двусторонняя синхронизация. > - История фиксирует: создание, изменение полей, смену статуса, перенос, удаление, комментарии. > - Виды: Сетка (месяц, неделя, день), Список, Таймлайн по сотрудникам. > - Теги создаются в разделе Календарь → Теги. > > Связанные страницы: https://docs.tuk-tuk.online/calendar, https://docs.tuk-tuk.online/calendar/services, https://docs.tuk-tuk.online/calendar/staff, https://docs.tuk-tuk.online/integrations/google-calendar, https://docs.tuk-tuk.online/ai/calendar-booking # События и запись Событие: запись клиента на конкретное время. Это центральная сущность календаря: в нём собраны дата, время, услуга, сотрудник, клиент и его контакты. Событие можно привязать к диалогу, тогда менеджер видит запись прямо в переписке. ## Как создать событие ![Форма новой записи в календарь](https://docs.tuk-tuk.online/assets/screens/calendar/new-event.webp) 1. Описание события. 2. Дата. 3. Время начала. 4. Время окончания. 5. Имя клиента. 6. Телефон клиента. 7. Email клиента. 8. Сотрудник. 9. Место: офис, Zoom или адрес. 10. Кнопка «Создать»; сверху статус записи, ниже теги и услуги. 1. Откройте Календарь и выберите свободный слот в таймлайне: откроется форма события. 2. Заполните поля и сохраните: событие появится в сетке, списке и таймлайне. | Поле | Что указать | |---|---| | Название | Описание записи | | Дата и время начала | Когда начинается | | Дата и время окончания | Когда заканчивается | | Сотрудник | К кому записан клиент | | Услуги | Одна или несколько услуг из [каталога](https://docs.tuk-tuk.online/calendar/services) | | Имя клиента | Кто записан | | Телефон | Контактный номер | | Email | Электронная почта | | Местоположение | Адрес или кабинет | | Цвет | Визуальная метка, по умолчанию индиго | | Теги | Метки для фильтрации | | Заметки | Дополнительная информация | ## 4 статуса записи | Статус | Значение | |---|---| | Ожидание | Запись создана, ждём подтверждения | | Подтверждено | Клиент подтвердил, что придёт | | Состоялось | Клиент пришёл, услуга оказана | | Неявка | Клиент не пришёл | Статус меняется вручную в карточке события или автоматически при синхронизации с внешним календарём. ## Синхронизация с внешними календарями ### Google Calendar 1. Подключите Google-аккаунт через OAuth 2.0 в разделе «Интеграции»: интеграция появится в списке подключённых. 2. Нажмите «Синхронизировать» в календаре: события из Google Calendar появятся в платформе, а события платформы уйдут в Google. При создании события через Google Calendar автоматически генерируется ссылка на Google Meet. Подробнее: [интеграция Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar). ### Яндекс Календарь 1. Подключите Яндекс-аккаунт через CalDAV в разделе «Интеграции». 2. Синхронизация идёт в обе стороны. ## Комментарии к событию К событию можно добавлять комментарии: заметки менеджеров о записи. Например: «Клиент просил перезвонить за час», «Перенесла с 15:00 на 17:00 по просьбе клиента». Комментарии видны всем сотрудникам, которые работают с событием, и редактируются. ## История изменений Все действия с событием записываются автоматически. | Действие | Что фиксируется | |---|---| | Создано | Кто создал, когда | | Изменено | Какие поля изменены: было и стало | | Статус изменён | Старый и новый статус | | Перенесено | Старое и новое время | | Удалено | Кто удалил, когда | | Комментарий | Текст добавленного комментария | История показывает, кто и когда менял запись. Полезно при разборе спорных ситуаций. ## Три вида календаря ### Сетка ![Календарь: вид «Сетка»](https://docs.tuk-tuk.online/assets/screens/calendar/grid.webp "Месячная сетка: все записи по дням.") ![Календарь: вид «Список»](https://docs.tuk-tuk.online/assets/screens/calendar/list.webp "Список: дата, время, услуга, сотрудник, клиент и статус записи.") Классический вид, как в Google Calendar: сетка по дням с ячейками времени. Масштаб: месяц, неделя, день. ### Список Все события в виде таблицы с фильтрами. Удобно, когда нужно быстро найти конкретную запись. ### Таймлайн Колонки по сотрудникам, строки по времени. Видно, кто когда занят и где есть свободные слоты. Лучший вид для планирования расписания. ```text Мария Анна Игорь 09:00 ┌──────────┐ │ Стрижка │ 10:00 │ Иванова │ ┌──────────┐ └──────────┘ │ Маникюр │ 11:00 │ Петрова │ ┌──────────┐ └──────────┘ │ Массаж │ 12:00 │ Сидорова │ └──────────┘ ``` ## Теги Тег: метка с названием и цветом для группировки и фильтрации событий. Примеры: «VIP» для важных клиентов, «Первичный» для первого визита, «Перенос» для перенесённых записей. Теги создаются в разделе Календарь → Теги и доступны при создании любого события. ## AI-запись через диалог AI-ассистент в режиме [«Запись в календарь»](https://docs.tuk-tuk.online/ai/calendar-booking) записывает клиентов из переписки: 1. Клиент пишет: «Хочу записаться на стрижку». 2. AI предлагает доступные даты и сотрудников. 3. Клиент выбирает время. 4. AI создаёт событие в календаре: запись появляется в сетке и в диалоге. --- --- title: "Цепочки автоматизации: конструктор чат-ботов без кода | tuk-tuk.online" nav_title: "Цепочки" url: https://docs.tuk-tuk.online/chains markdown: https://docs.tuk-tuk.online/chains.md description: "Визуальный конструктор сценариев: сообщения, ожидание ответа, условия, AI-обработка, HTTP-запросы, Python. 21 шаблон, импорт из JSON, массовый запуск, каскадные каналы." keywords: ["цепочки автоматизации", "автоматизация сообщений", "визуальный конструктор ботов", "конструктор чат-ботов без кода", "автоворонка продаж", "чат-бот конструктор", "no-code чат-бот", "автоматические сценарии", "конструктор рассылок", "триггерные сообщения", "drip кампании", "автоматизация Telegram"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Цепочки: визуальный конструктор сценариев автоматизации в tuk-tuk.online; цепочка запускается по триггеру и выполняет блоки (сообщения, ожидание, условия, AI, webhook, Python, CRM) без участия оператора. > > - Где: раздел «Связки» в кабинете, кнопка «+ Новая связка» > - 21 готовый шаблон и 17 типов блоков > - Триггеры: любое сообщение, ключевое слово, точное совпадение, regex; режимы запуска: каждое сообщение, один раз на клиента > - Импорт цепочки из JSON: поля name, blocks[], runMode, triggerCondition > - Массовый запуск по тегу, кастомному полю или периоду > - Лимиты: 200 блоков за запуск, минимальный баланс 1 ₽, webhook 15 с, Python 10 с > > Связанные страницы: https://docs.tuk-tuk.online/chains/templates, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/dialogs # Цепочки автоматизации Цепочка: сценарий, который запускается по триггеру (входящее сообщение, ключевое слово, расписание) и выполняет последовательность блоков без участия оператора. Цепочки собираются в визуальном редакторе в разделе [Связки](https://lk.tuk-tuk.online/bindings): блоки добавляются на холст и соединяются стрелками. Из блоков собираются автоответчики, воронки продаж, анкеты, AI-ассистенты, напоминания и интеграции с CRM. ## Как создать цепочку ![Список связок в кабинете](https://docs.tuk-tuk.online/assets/screens/chains/list.webp) 1. Пункт «Связки» в меню. 2. Маркетплейс готовых сценариев по нишам. 3. Массовый запуск связки по базе клиентов. 4. Создать пустую связку. 5. Статус связки и число блоков. 6. Журнал выполнений. 7. Статистика по связке. 8. Копировать, поставить на паузу, удалить. 1. Откройте раздел [Связки](https://lk.tuk-tuk.online/bindings) и нажмите «+ Новая связка»: откроется выбор шаблона или пустой цепочки. 2. Добавьте блоки на холст: сообщения, ожидание ответа, условия, AI-обработка. 3. Настройте триггер: когда цепочка должна запускаться. 4. Активируйте цепочку: она начнёт срабатывать на входящие события. ## Шаблоны ![Сборка связки по описанию через ИИ](https://docs.tuk-tuk.online/assets/screens/chains/ask-ai.webp "«Спросить ИИ»: опишите сценарий словами, ИИ соберёт блоки. Можно улучшить текущую связку или сгенерировать новую схему.") 21 готовый шаблон, чтобы не собирать сценарий с нуля: | Категория | Примеры | |---|---| | Базовые | Приветствие, автоответчик, follow-up, авто-тегирование | | AI | AI-ассистент, AI-квалификация, AI с эскалацией, маршрутизация | | Формы | Сбор заявки, запись на услугу, NPS-опрос, сбор отзывов | | Воронки | Воронка продаж, капельная рассылка, реактивация, онбординг | | Условные | Ответ по ключевому слову, нерабочее время | | API | Статус заказа через webhook | Каталог с описанием каждого шаблона: [Шаблоны связок](https://docs.tuk-tuk.online/chains/templates). ## Блоки ![Визуальный редактор связки](https://docs.tuk-tuk.online/assets/screens/chains/editor.webp) 1. Кнопка «Триггер»: когда связка запускается. 2. Режим запуска: один раз на клиента или каждый раз. 3. Тестовый прогон связки. 4. «Спросить ИИ»: собрать сценарий по описанию. 5. Добавить блок. 6. Сохранить. 7. Стартовый узел, от него идёт первая связь. 8. Блок: клик открывает параметры, точки сверху и снизу соединяют блоки. 9. Шаблонные переменные, клик копирует. 10. Палитра типов блоков и статистика. 11. Масштаб, «показать всё», полный экран и миникарта. В редакторе 17 типов блоков: | Блок | Что делает | |---|---| | [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message) | Текст или медиа через канал, с каскадом резервных каналов | | [Ожидание ответа](https://docs.tuk-tuk.online/chains/blocks/wait-response) | Пауза до ответа клиента, с таймаутом | | [Задержка](https://docs.tuk-tuk.online/chains/blocks/delay) | Пауза на N секунд | | [AI-обработка](https://docs.tuk-tuk.online/chains/blocks/ai-process) | Обработка текста нейросетью (GPT, Claude, Gemini) | | [Условие](https://docs.tuk-tuk.online/chains/blocks/condition) | Ветвление по значению: if/else, regex | | [Рандомайзер](https://docs.tuk-tuk.online/chains/blocks/randomizer) | Случайное распределение по веткам, A/B-тест | | [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook) | HTTP-запрос к внешнему API | | [Вызов цепочки](https://docs.tuk-tuk.online/chains/blocks/call-chain) | Запуск вложенной цепочки | | [Python-код](https://docs.tuk-tuk.online/chains/blocks/python-code) | Скрипт в песочнице: 10 секунд, 256 КБ | | [Теги](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) | Добавить или удалить тег клиента | | [Примечание](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) | Внутренняя заметка, клиент не видит | | [Переменная](https://docs.tuk-tuk.online/chains/blocks/set-variable) | Сохранить значение для следующих блоков | | [Генерация изображений](https://docs.tuk-tuk.online/chains/blocks/generate-image) | AI-картинка через Kandinsky или KIE.AI | | [Задача](https://docs.tuk-tuk.online/chains/blocks/tasks) | Создать задачу: статус, приоритет, исполнитель | | [ИИ-задача](https://docs.tuk-tuk.online/chains/blocks/tasks) | AI читает диалог и создаёт задачу | | [Интеграция](https://docs.tuk-tuk.online/chains/blocks/integration) | Действия в AmoCRM и YClients | Сводная таблица и лимиты выполнения: [Типы блоков](https://docs.tuk-tuk.online/chains/blocks). ## Триггеры Цепочка запускается по триггеру: любое сообщение, ключевое слово, точное совпадение, regex. Дополнительно настраиваются режим запуска (каждое сообщение, один раз на клиента), рабочие часы, лимиты и автоостановка. Подробнее: [Триггеры и условия](https://docs.tuk-tuk.online/chains/triggers). ## Импорт из JSON 1. На странице «Связки» нажмите «+ Новая связка» и выберите «Импорт из файла»: откроется загрузка файла. 2. Загрузите JSON с описанием блоков: система проверит структуру. 3. Укажите каналы и AI-инструкции, которые предложит система: цепочка готова. Формат JSON включает поля `name`, `blocks[]`, `runMode`, `triggerCondition`. ## Массовый запуск ![Массовый запуск связки по базе клиентов](https://docs.tuk-tuk.online/assets/screens/chains/mass-launch.webp) 1. Выбор связки и канала отправки. 2. Условие отбора клиентов: по тегу, полю, статусу. 3. Значение для поиска, дальше «Найти клиентов». 1. Откройте цепочку и нажмите «Массовый запуск»: откроется выбор клиентов. 2. Выберите критерий: по тегу, по кастомному полю или за период (диапазон дат). 3. Просмотрите список найденных клиентов. 4. Подтвердите запуск: цепочка выполнится для каждого клиента из списка. ## Каскадные каналы Блок «Отправка сообщения» поддерживает резервные каналы: если основной недоступен, сообщение уходит через следующий, например Telegram, затем SMS, затем Email. Подробнее: [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message). ## Мониторинг ![Журнал выполнений связки](https://docs.tuk-tuk.online/assets/screens/chains/runs.webp "Журнал показывает клиента, статус и дату каждого запуска.") ![Статистика связки](https://docs.tuk-tuk.online/assets/screens/chains/stats.webp "Статистика: запуски, завершения, ошибки, активные, уникальные клиенты, отправленные сообщения.") В сайдбаре кабинета есть индикатор активных запусков: сколько цепочек выполняется прямо сейчас. --- --- title: "Шаблоны связок: 21 готовый сценарий автоматизации | tuk-tuk.online" nav_title: "Шаблоны связок" url: https://docs.tuk-tuk.online/chains/templates markdown: https://docs.tuk-tuk.online/chains/templates.md section: "Цепочки" description: "Каталог из 21 шаблона связок: приветствие, автоответчик, AI-ассистент, сбор заявки, NPS-опрос, воронка продаж, капельная рассылка, статус заказа через webhook." keywords: ["шаблоны связок", "готовые сценарии бота", "шаблон воронки продаж", "шаблон автоответчика", "шаблон AI бота", "готовый чат-бот", "шаблон приветствия", "NPS опрос бот", "drip кампания шаблон", "онбординг бот шаблон"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Каталог из 21 готового шаблона связок tuk-tuk.online: приветствие, автоответчик, AI-ассистент, формы сбора данных, воронки и webhook-сценарий; создаются в разделе «Связки» через «+ Новая связка». > > - Где: раздел «Связки», кнопка «+ Новая связка», выбор шаблона или «Пустая цепочка» > - Категории: базовые (4), AI (4), формы (4), условные (2), воронки (5), API (1) > - AI-шаблоны требуют подключённого AI-провайдера и инструкции > - При создании задаются канал отправки, AI-инструкция, триггерный канал, режим запуска и триггерное условие > - Режимы запуска шаблонов: каждое сообщение, один раз на клиента, по ключевому слову («запись», «отзыв», «заказ», «прайс») > > Связанные страницы: https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/providers # Шаблоны связок Шаблон: готовая цепочка с блоками и триггером. Вы выбираете его из каталога, указываете канал и AI-инструкцию, и цепочка готова к запуску. В каталоге 21 шаблон в шести категориях: базовые, AI, формы, условные, воронки, API. ## Как создать цепочку из шаблона ![Маркетплейс шаблонов: выбор ниши](https://docs.tuk-tuk.online/assets/screens/chains/marketplace-step1.webp) 1. Шаги мастера: Ниша, Цель, Параметры, Шаблон, Настройка. 2. Выбор ниши бизнеса. 3. Кнопка «Далее». ![Шаг «Параметры»: тип клиентов и уровень AI](https://docs.tuk-tuk.online/assets/screens/chains/marketplace-step3.webp "Шаг «Параметры»: кого ведём и сколько думает бот. От уровня AI зависит, нужна ли AI-инструкция.") ![Шаг «Шаблон»: подобранные сценарии](https://docs.tuk-tuk.online/assets/screens/chains/marketplace-step4.webp "Сценарии отсортированы по совпадению с нишей и целью, лучший помечен как «Лучший выбор».") 1. Откройте раздел [Связки](https://lk.tuk-tuk.online/bindings) и нажмите «+ Новая связка»: откроется каталог. 2. Выберите шаблон из каталога. 3. Укажите канал отправки и, если шаблон использует AI, инструкцию. 4. Нажмите «Создать»: цепочка готова к работе. ## Каталог ![Шаг «Цель»: что связка должна делать](https://docs.tuk-tuk.online/assets/screens/chains/marketplace-step2.webp "Шаг «Цель»: лидогенерация, запись и заявки, реактивация или поддержка.") Базовые: | Шаблон | Что делает | Режим запуска | |---|---|---| | Приветствие | Приветствует нового клиента | Один раз на клиента | | Автоответчик | Быстрый ответ на каждое сообщение | Каждое сообщение | | Напоминание (follow-up) | Напоминает, если клиент не ответил в течение 1 часа | Один раз на клиента | | Авто-тегирование | Присваивает тег новому клиенту | Один раз на клиента | AI: | Шаблон | Что делает | Режим запуска | |---|---|---| | AI-ассистент | Нейросеть отвечает на каждое сообщение | Каждое сообщение | | AI-квалификация лида | Задаёт уточняющие вопросы и квалифицирует | Один раз на клиента | | AI с эскалацией | Отвечает сама, при низкой уверенности передаёт оператору | Каждое сообщение | | Маршрутизация | Классифицирует намерение и расставляет теги | Один раз на клиента | > [!WARNING] AI-шаблонам нужен подключённый [AI-провайдер](https://docs.tuk-tuk.online/ai/providers) и созданная [инструкция](https://docs.tuk-tuk.online/ai/instructions). Формы и сбор данных: | Шаблон | Что делает | Режим запуска | |---|---|---| | Сбор заявки | Последовательно собирает имя, телефон, вопрос | Один раз на клиента | | Запись на услугу | Диалог: услуга, дата, контакт, подтверждение | По ключевому слову «запись» | | Опрос NPS | Оценка от 1 до 10 и сбор обратной связи | По ключевому слову «отзыв» | | Сбор отзывов | Хороший отзыв: ссылка на публикацию, плохой: форма жалобы | Один раз на клиента | Условные: | Шаблон | Что делает | Режим запуска | |---|---|---| | Ответ по ключевому слову | Срабатывает на слово «прайс» (можно заменить) | Каждое сообщение | | Нерабочее время | Автоответ в нерабочие часы | Каждое сообщение | Воронки: | Шаблон | Что делает | Режим запуска | |---|---|---| | Воронка продаж | Приветствие, выявление потребности, предложение, follow-up | Один раз на клиента | | Двойное напоминание | Два напоминания: через 1 час и через 24 часа | Один раз на клиента | | Реактивация | 3 касания: через 1 день, 3 дня, 7 дней | Один раз на клиента | | Онбординг | Приветствие и 3 обучающих сообщения за 3 дня | Один раз на клиента | | Капельная рассылка | 5 сообщений: день 1, 3, 5, 7, 14 | Один раз на клиента | API: | Шаблон | Что делает | Режим запуска | |---|---|---| | Статус заказа | Запрашивает номер, отправляет webhook в CRM, возвращает статус | По ключевому слову «заказ» | ## Что настраивается при создании | Параметр | Когда нужен | |---|---| | Канал отправки | Шаблон отправляет сообщения | | AI-инструкция | Шаблон использует AI | | Триггерный канал | На каком канале слушать входящие сообщения | | Режим запуска | Каждое сообщение или один раз на клиента | | Триггерное условие | Любое сообщение, ключевое слово или regex | Подробнее о режимах и условиях: [Триггеры и условия](https://docs.tuk-tuk.online/chains/triggers). ## Пустая цепочка ![Окно создания новой связки](https://docs.tuk-tuk.online/assets/screens/chains/create.webp "Пустая связка, загрузка сценария из .json или готовый шаблон из списка.") 1. Нажмите «+ Новая связка» и выберите «Пустая цепочка»: откроется визуальный редактор. 2. Добавьте блоки и соедините их стрелками: цепочка готова к настройке триггера. Описание блоков: [Типы блоков](https://docs.tuk-tuk.online/chains/blocks). --- --- title: "Триггеры и условия запуска цепочек | tuk-tuk.online" nav_title: "Триггеры и условия" url: https://docs.tuk-tuk.online/chains/triggers markdown: https://docs.tuk-tuk.online/chains/triggers.md section: "Цепочки" description: "Режимы запуска цепочки, триггерные условия (любое сообщение, ключевое слово, точное совпадение, regex), расширенные условия (рабочие часы, cooldown, лимиты) и автоостановка." keywords: ["триггеры чат-бота", "условия запуска бота", "ключевое слово триггер", "regex триггер", "автозапуск цепочки", "расписание бота", "cron чат-бот", "триггер по сообщению", "фильтры бота", "событийный триггер"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Триггер задаёт, когда запускается цепочка tuk-tuk.online: режим запуска, условие по тексту сообщения, расширенные условия (рабочие часы, лимиты, cooldown) и правила автоостановки. > > - Где: настройки цепочки в разделе «Связки» > - Режимы запуска: каждое сообщение, один раз на клиента, после завершения > - Условия: любое сообщение, ключевое слово, точное совпадение, regex > - Расширенные условия: таймаут ожидания ответа, минимум сообщений, только новые клиенты, рабочие часы, максимум запусков на клиента, cooldown, запрет параллельных > - Автоостановка: по тегу или при ответе клиента > > Связанные страницы: https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/chains/templates, https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/delay, https://docs.tuk-tuk.online/chains/blocks/condition # Триггеры и условия запуска Триггер определяет, когда запускается цепочка. Настраивается в редакторе цепочки в разделе [Связки](https://lk.tuk-tuk.online/bindings): режим запуска, условие по тексту сообщения и расширенные условия (рабочие часы, лимиты, интервалы). Отдельно задаётся автоостановка: события, при которых уже запущенная цепочка прерывается. ## Режимы запуска | Режим | Поведение | |---|---| | Каждое сообщение | Цепочка запускается на каждое входящее сообщение | | Один раз на клиента | Цепочка выполняется один раз для каждого клиента | | После завершения | Цепочка перезапускается после того, как предыдущий запуск полностью выполнился | ## Триггерные условия ![Настройки триггера связки](https://docs.tuk-tuk.online/assets/screens/chains/trigger-settings.webp "Каналы срабатывания, условие на сообщение, ограничения запусков и сводка справа.") | Условие | Когда срабатывает | |---|---| | Любое сообщение | На любой входящий текст | | Ключевое слово | Текст содержит указанное слово | | Точное совпадение | Текст полностью совпадает с указанным | | Regex | Текст соответствует регулярному выражению | ## Расширенные условия | Условие | Что делает | |---|---| | Таймаут ожидания ответа | Запуск, если клиент не ответил за N секунд | | Минимум сообщений | Запуск только после N сообщений от клиента | | Только новые клиенты | Запуск для клиентов, написавших впервые | | Рабочие часы | Запуск только в указанное время | | Максимум запусков на клиента | Ограничение числа срабатываний для одного клиента | | Cooldown | Минимальный интервал между запусками | | Запрет параллельных | Не запускать, если для клиента уже работает другая цепочка | ## Автоостановка | Событие | Что происходит | |---|---| | По тегу | Цепочка останавливается, когда у клиента появился указанный тег | | При ответе клиента | Цепочка прерывается, как только клиент написал | Автоостановка прерывает и блок [Задержка](https://docs.tuk-tuk.online/chains/blocks/delay): ждать конца паузы не нужно. Тег ставится вручную в диалоге или блоком [Добавить тег](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes). ## Пример Приветствие только для новых клиентов в рабочее время: ```text Режим запуска: один раз на клиента Условие: любое сообщение Только новые клиенты: включено Рабочие часы: 10:00–19:00 ``` Прайс по ключевому слову без спама: ```text Режим запуска: каждое сообщение Условие: ключевое слово «прайс» Cooldown: 3600 секунд ``` Запустить цепочку вручную для группы клиентов, минуя триггер, можно через «Массовый запуск» на странице [Цепочки](https://docs.tuk-tuk.online/chains). --- --- title: "Блоки цепочек: все 17 типов конструктора | tuk-tuk.online" nav_title: "Блоки" url: https://docs.tuk-tuk.online/chains/blocks markdown: https://docs.tuk-tuk.online/chains/blocks.md section: "Цепочки" description: "Справочник 17 блоков конструктора цепочек: отправка, ожидание, задержка, AI, условие, рандомайзер, webhook, Python, теги, переменные, задачи, CRM, генерация изображений." keywords: ["блоки цепочек", "конструктор бота блоки", "все блоки автоматизации", "17 блоков", "типы блоков бот", "блоки конструктора"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Справочник 17 типов блоков конструктора цепочек tuk-tuk.online: что делает каждый блок и на какой странице описаны его настройки. > > - Блоки добавляются в визуальном редакторе цепочки: кнопка «+» на холсте, настройки в правой панели > - 17 типов: отправка сообщения, ожидание ответа, задержка, AI-обработка, условие, рандомайзер, webhook, вызов цепочки, Python-код, добавить тег, удалить тег, примечание, переменная, генерация изображений, добавить задачу, ИИ-задача, интеграция > - Лимит 200 блоков за один запуск, минимальный баланс 1 ₽ > - Таймаут Webhook 15 секунд, таймаут Python 10 секунд, зависший блок снимается через 5 минут > - Редактор находит циклы и недостижимые блоки > > Связанные страницы: https://docs.tuk-tuk.online/chains, https://docs.tuk-tuk.online/chains/templates, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/chains/blocks/condition # Типы блоков цепочек В конструкторе цепочек 17 типов блоков. Каждый блок делает одно действие: отправляет сообщение, ждёт ответ, обрабатывает текст нейросетью, проверяет условие. Блоки соединяются стрелками и образуют сценарий, который выполняется без участия оператора. Эта страница нужна, чтобы быстро выбрать нужный блок. Подробные настройки каждого блока описаны на его странице. ![Палитра блоков в редакторе связок](https://docs.tuk-tuk.online/assets/screens/chains/add-block.webp "Кнопка «+ Блок» открывает палитру: триггер, отправка, ожидание, задержка, AI, условие, рандомайзер, вызов цепочки, теги, Python, webhook, примечание, переменная, генерация изображения, задачи.") ![Параметры выбранного блока](https://docs.tuk-tuk.online/assets/screens/chains/block-settings.webp "Клик по блоку открывает его параметры прямо на холсте.") ## Все блоки | Блок | Что делает | Страница | |---|---|---| | Отправить сообщение | Отправляет текст или медиа через канал | [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message) | | Ожидание ответа | Ждёт сообщение клиента, с таймаутом и двумя выходами | [Ожидание ответа](https://docs.tuk-tuk.online/chains/blocks/wait-response) | | Задержка | Пауза на указанное число секунд | [Задержка](https://docs.tuk-tuk.online/chains/blocks/delay) | | AI-обработка | Обрабатывает текст через нейросеть | [AI-обработка](https://docs.tuk-tuk.online/chains/blocks/ai-process) | | Условие | Ветвление по значению (if/else, regex) | [Условие](https://docs.tuk-tuk.online/chains/blocks/condition) | | Рандомайзер | Случайное распределение по веткам в процентах, A/B-тест | [Рандомайзер](https://docs.tuk-tuk.online/chains/blocks/randomizer) | | Webhook | HTTP-запрос к внешнему API | [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook) | | Вызов цепочки | Запуск вложенной цепочки | [Вызов цепочки](https://docs.tuk-tuk.online/chains/blocks/call-chain) | | Python-код | Выполнение Python-скрипта в песочнице | [Python-код](https://docs.tuk-tuk.online/chains/blocks/python-code) | | Добавить тег | Присваивает тег клиенту | [Теги и примечания](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) | | Удалить тег | Убирает тег у клиента | [Теги и примечания](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) | | Примечание | Внутренняя заметка в диалоге, клиент её не видит | [Теги и примечания](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) | | Переменная | Сохраняет значение для следующих блоков | [Переменные](https://docs.tuk-tuk.online/chains/blocks/set-variable) | | Генерация изображений | Создаёт картинку через AI (Kandinsky, KIE.AI) | [Генерация изображений](https://docs.tuk-tuk.online/chains/blocks/generate-image) | | Добавить задачу | Создаёт задачу с полями: статус, приоритет, исполнитель | [Задачи](https://docs.tuk-tuk.online/chains/blocks/tasks) | | ИИ-задача | AI читает диалог и сам заполняет задачу | [Задачи](https://docs.tuk-tuk.online/chains/blocks/tasks) | | Интеграция | Действия в CRM (AmoCRM, YClients) | [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration) | ## Категории | Категория | Блоки | |---|---| | Коммуникация | Отправить сообщение, Ожидание ответа | | Обработка | AI-обработка, Python-код, Генерация изображений | | Логика | Условие, Рандомайзер, Задержка, Вызов цепочки | | Действия с данными | Добавить тег, Удалить тег, Примечание, Переменная, Добавить задачу, ИИ-задача | | Внешние системы | Webhook, Интеграция | ## Как добавить блок 1. Откройте цепочку в визуальном редакторе: на холсте видны блоки и стрелки между ними. 2. Нажмите «+» между блоками или на свободном месте холста: откроется каталог блоков. 3. Выберите блок: он появится на холсте. 4. Настройте параметры в правой панели: изменения сохраняются в блоке. 5. Соедините блок стрелками с соседями: цепочка знает, куда идти дальше. ## Ограничения выполнения | Параметр | Значение | |---|---| | Максимум шагов за один запуск | 200 блоков | | Минимальный баланс для запуска | 1 ₽ | | Таймаут блока Webhook | 15 секунд | | Таймаут блока Python-код | 10 секунд | | Зависший блок | 5 минут без ответа | ## Проверка цепочки Редактор проверяет цепочку автоматически: - Циклы: если блоки зацикливаются, редактор показывает предупреждение. - Недостижимые блоки: редактор предупреждает, если блок не связан с остальными. - Лимит шагов: если за один запуск выполнится больше 200 блоков, цепочка остановится. --- --- title: "Блок «Отправка сообщения» в цепочке | tuk-tuk.online" nav_title: "Отправка сообщения" url: https://docs.tuk-tuk.online/chains/blocks/send-message markdown: https://docs.tuk-tuk.online/chains/blocks/send-message.md section: "Блоки" description: "Блок SEND_MESSAGE: текст с переменными, одно медиа-вложение, каскадные каналы и стратегии отправки (каскад, случайный, по очереди)." keywords: ["блок отправки сообщения", "SEND_MESSAGE", "каскадные каналы", "медиа вложение бот", "шаблон сообщения", "автоматическая рассылка", "round robin каналы"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок SEND_MESSAGE отправляет клиенту текст или один медиа-файл через выбранный канал; поддерживает переменные, каскад резервных каналов и три стратегии выбора канала. > > - Добавляется в визуальном редакторе цепочки через «+» на холсте > - Переменные в тексте: {{name}}, {{phone}}, {{email}}, {{lastMessage}}, {{aiResult}}, {{aiResult_N}}, {{python_N}}, {{webhook_N}}, {{var_N}}, {{custom_field_ИМЯ}}, {{dialog}}, {{dialog_N}} > - Одно вложение: картинка (JPG, PNG, GIF, WebP), голосовое (OGG, MP3, WAV), кружок (MP4), видео (MP4, MOV) или документ > - Источник медиа: URL или переменная, например {{imageResult_N}} > - Стратегии отправки: каскад (по умолчанию), случайный, по очереди > - После отправки текст доступен как {{message_N}} > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/wait-response, https://docs.tuk-tuk.online/chains/blocks/set-variable, https://docs.tuk-tuk.online/chains/blocks/generate-image, https://docs.tuk-tuk.online/channels # Отправка сообщения Блок отправляет клиенту текст или файл через выбранный канал и передаёт управление следующему блоку. Это единственный блок, через который цепочка пишет клиенту. В тексте работают переменные контекста: имя клиента, последнее сообщение, результат AI. Если основной канал недоступен, сообщение уходит через резервный. ## Настройки | Поле | Описание | |---|---| | Текст сообщения | Что написать клиенту. Поддерживает переменные в двойных фигурных скобках | | Канал | Через какой канал отправить (Telegram, SMS, Email и другие подключённые) | | Каскадные каналы | Резервные каналы на случай, если основной недоступен | | Стратегия отправки | Как выбирать канал, если их несколько: каскад, случайный, по очереди | | Медиа-файл | Одно вложение: картинка, голосовое, кружок, видео или документ | ## Переменные в тексте | Переменная | Что подставится | |---|---| | `{{name}}` | Имя клиента | | `{{phone}}` | Телефон | | `{{email}}` | Email | | `{{lastMessage}}` | Последнее сообщение клиента | | `{{aiResult}}` | Результат последнего AI-блока | | `{{aiResult_N}}` | Результат AI-блока номер N | | `{{python_N}}` | Результат Python-блока номер N | | `{{webhook_N}}` | Ответ вебхука номер N | | `{{var_N}}` | Пользовательская переменная номер N | | `{{custom_field_ИМЯ}}` | Кастомное поле диалога | | `{{dialog}}` | Вся история переписки | | `{{dialog_N}}` | Последние N сообщений | Полный список переменных: [Переменные](https://docs.tuk-tuk.online/chains/blocks/set-variable). ## Медиа-вложения К сообщению прикрепляется один файл. | Тип | Форматы | Как выглядит у клиента | |---|---|---| | Картинка | JPG, PNG, GIF, WebP | Фото в чате | | Голосовое | OGG, MP3, WAV | Аудиосообщение | | Кружок | MP4 (круглое видео) | Видеосообщение | | Видео | MP4, MOV | Видеофайл | | Документ | Любой формат | Файл-вложение | Файл загружается перетаскиванием на блок или кнопкой выбора. Источник медиа задаётся одним из двух способов: - URL: ссылка на файл в интернете. - Переменная: медиа из результата другого блока, например `{{imageResult_3}}` после блока «Генерация изображений». ## Каскадные каналы и стратегии Если основной канал недоступен (клиент заблокировал бота, канал отключён), сообщение уходит через следующий канал в списке. Порядок и число резервных каналов задаёте вы. Пример каскада: Telegram, затем SMS, затем Email. Когда каналов несколько, порядок выбора определяет стратегия: | Стратегия | Как работает | |---|---| | Каскад (по умолчанию) | Пробует каналы по порядку, пока отправка не удастся | | Случайный | Отправляет через случайный канал из списка | | По очереди | Чередует каналы по кругу: 1, 2, 3, снова 1 | ## Пример ```text Отправка сообщения: «Привет, {{name}}! Мы получили ваш запрос: «{{lastMessage}}»» Канал: Telegram Каскад: SMS, Email Медиа: картинка (URL) ``` Клиенту в Telegram приходит текст с подставленным именем и картинкой. Если бот в Telegram заблокирован, тот же текст уходит по SMS. ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{message_N}}` | Текст отправленного сообщения, N: номер блока | ## Ограничения - Одно вложение на сообщение. - Каскад и стратегии работают только между каналами, добавленными в список блока. --- --- title: "Блок «Ожидание ответа» в цепочке | tuk-tuk.online" nav_title: "Ожидание ответа" url: https://docs.tuk-tuk.online/chains/blocks/wait-response markdown: https://docs.tuk-tuk.online/chains/blocks/wait-response.md section: "Блоки" description: "Блок WAIT_RESPONSE: пауза до ответа клиента, таймаут в секундах, два выхода (ответ получен, таймаут), переменная lastMessage, тестовый режим." keywords: ["ожидание ответа бот", "WAIT_RESPONSE", "таймаут бот", "ветвление ответ", "диалоговый бот", "интерактивный бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок WAIT_RESPONSE останавливает цепочку до ответа клиента; ответ попадает в {{lastMessage}}, а по истечении таймаута цепочка уходит по отдельной ветке. > > - Единственная настройка: таймаут в секундах, 0 означает ждать без ограничения > - Два выхода: «Ответ получен» (зелёная стрелка) и «Таймаут» (красная стрелка) > - Ответ клиента сохраняется в {{lastMessage}} > - В тестовом режиме таймаут всегда 5 секунд > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/chains/blocks/delay, https://docs.tuk-tuk.online/chains/blocks/condition # Ожидание ответа Блок ставит цепочку на паузу, пока клиент не напишет. Без него цепочка только отправляет сообщения и не слушает. С ним получается диалог: вопрос, ответ, следующий вопрос. У блока два выхода. Если клиент ответил в пределах таймаута, цепочка идёт по зелёной ветке. Если время вышло, по красной. ## Настройки | Поле | Описание | |---|---| | Таймаут (секунды) | Сколько ждать ответ. 0: ждать без ограничения по времени | ## Выходы | Выход | Когда срабатывает | Цвет стрелки | |---|---|---| | Ответ получен | Клиент написал в пределах таймаута | Зелёная | | Таймаут | Клиент не ответил вовремя | Красная | К каждому выходу подключается своя ветка блоков. ## Пример Анкета с напоминанием: ```text Отправка сообщения: «Как вас зовут?» Ожидание ответа (таймаут 3600 с) Ответ получен → Отправка: «Отлично, {{lastMessage}}! Ваш телефон?» Таймаут → Отправка: «Вы не ответили. Напишите, когда будете готовы.» ``` Follow-up через сутки молчания: ```text Отправка сообщения: «Вам подошло наше предложение?» Ожидание ответа (таймаут 86400 с, это 1 день) Ответ получен → AI-обработка: анализ ответа Таймаут → Отправка: «Напоминаем о нашем предложении» ``` ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{lastMessage}}` | Текст ответа клиента, доступен всем следующим блокам. Остальные переменные: [Переменные](https://docs.tuk-tuk.online/chains/blocks/set-variable) | ## Ограничения > [!NOTE] В тестовом режиме таймаут всегда 5 секунд, чтобы не ждать при отладке. --- --- title: "Блок «Задержка» в цепочке | tuk-tuk.online" nav_title: "Задержка" url: https://docs.tuk-tuk.online/chains/blocks/delay markdown: https://docs.tuk-tuk.online/chains/blocks/delay.md section: "Блоки" description: "Блок DELAY: пауза на заданное число секунд, досрочная отмена по ответу клиента или тегу, тестовый режим с паузой 5 секунд." keywords: ["задержка бот", "DELAY блок", "пауза цепочка", "таймер бот", "расписание сообщений", "drip кампания"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок DELAY ставит цепочку на паузу на заданное число секунд; используется для напоминаний и капельных рассылок, может быть прерван остановкой цепочки, ответом клиента или стоп-тегом. > > - Единственная настройка: длительность в секундах (1 час = 3600, 1 день = 86400) > - Пауза прерывается при ручной остановке запуска, при ответе клиента (если включено «Остановить при ответе клиента») и при получении стоп-тега > - В тестовом режиме все задержки равны 5 секундам > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/wait-response, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/templates # Задержка Блок останавливает цепочку на указанное время и затем передаёт управление следующему блоку. Нужен для напоминаний, капельных рассылок и любых сценариев, где сообщения должны приходить с интервалом. В отличие от блока [Ожидание ответа](https://docs.tuk-tuk.online/chains/blocks/wait-response) задержка не ждёт сообщений от клиента: она просто отсчитывает секунды. ## Настройки | Поле | Описание | |---|---| | Длительность (секунды) | Сколько ждать перед переходом к следующему блоку | Подсказка по переводу в секунды: | Время | Секунды | |---|---| | 1 минута | 60 | | 5 минут | 300 | | 30 минут | 1 800 | | 1 час | 3 600 | | 4 часа | 14 400 | | 1 день | 86 400 | | 3 дня | 259 200 | | 7 дней | 604 800 | ## Пример Напоминание через час: ```text Отправка сообщения: «Мы отправили вам коммерческое предложение» Задержка: 3600 с Отправка сообщения: «Удалось ли ознакомиться с предложением?» ``` Капельная рассылка на 5 дней: ```text Отправка: «Добро пожаловать!» (день 1) Задержка: 86400 с Отправка: «Вот полезный материал» (день 2) Задержка: 172800 с Отправка: «Как вам наш сервис?» (день 4) Задержка: 86400 с Отправка: «Специальное предложение для вас» (день 5) ``` ## Досрочная отмена Пауза прерывается раньше срока в трёх случаях: - Оператор остановил запуск цепочки вручную. - В настройках цепочки включён параметр «Остановить при ответе клиента», и клиент написал. - В настройках цепочки задан стоп-тег, и клиент его получил. Условия автоостановки описаны на странице [Триггеры и условия](https://docs.tuk-tuk.online/chains/triggers). ## Ограничения > [!NOTE] В тестовом режиме каждая задержка сокращается до 5 секунд, чтобы проверка цепочки не занимала часы. --- --- title: "Блок «AI-обработка» в цепочке | tuk-tuk.online" nav_title: "AI-обработка" url: https://docs.tuk-tuk.online/chains/blocks/ai-process markdown: https://docs.tuk-tuk.online/chains/blocks/ai-process.md section: "Блоки" description: "Блок AI_PROCESS: инструкция из библиотеки или свой промпт, источник данных (последнее сообщение, вся переписка, свой текст), результат в {{aiResult}}." keywords: ["AI обработка бот", "AI_PROCESS блок", "ChatGPT в цепочке", "нейросеть в автоматизации", "AI промпт бот", "LLM блок", "обработка сообщений AI"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок AI_PROCESS отправляет выбранный текст нейросети по инструкции или своему промпту и сохраняет ответ в {{aiResult}} для следующих блоков цепочки. > > - Режимы: «Инструкция» из библиотеки AI-инструкций или «Свой промпт» в блоке > - Источники данных: последнее сообщение, текущее сообщение, вся переписка, свой текст с переменными > - К запросу можно приложить изображения для моделей с поддержкой зрения > - Результат: {{aiResult}} и {{aiResult_N}}; {{lastMessage}} после блока равен {{aiResult}} > - Предусловие: хотя бы один подключённый AI-провайдер; провайдер и модель задаются в инструкции > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/chains/blocks/condition, https://docs.tuk-tuk.online/chains/blocks/send-message # AI-обработка Блок берёт текст (сообщение клиента, всю переписку или ваш текст с переменными), отправляет его нейросети вместе с инструкцией и сохраняет ответ в контекст цепочки. Дальше этот ответ можно отправить клиенту, проверить условием или передать в другой блок. Блок работает через ваши AI-инструкции, а инструкция привязана к провайдеру и модели (GPT-4o, Claude 3.5, Gemini и другие). Нужен хотя бы один подключённый [AI-провайдер](https://docs.tuk-tuk.online/ai/providers). ## Настройки | Поле | Описание | |---|---| | Режим инструкции | «Инструкция» (из библиотеки) или «Свой промпт» (текст прямо в блоке) | | Инструкция | Готовая инструкция из библиотеки AI-инструкций. Удобно, когда одна инструкция нужна в нескольких цепочках | | Свой промпт | Системный промпт, написанный в блоке. Подходит для одноразовых задач | | Источник данных | Откуда взять текст для обработки | | Изображения | Картинки для моделей с поддержкой зрения | Источники данных: | Источник | Что получит нейросеть | |---|---| | Последнее сообщение | Текст последнего входящего сообщения клиента | | Текущее сообщение | Сообщение, которое запустило цепочку | | Вся переписка | Полная история диалога | | Свой текст | Ваш текст с переменными, например `{{aiResult}}` или `{{lastMessage}}` | ## Пример Ответ клиенту через инструкцию: ```text Ожидание ответа AI-обработка: инструкция «Менеджер продаж», источник «Последнее сообщение» Отправка сообщения: «{{aiResult}}» ``` Классификация обращения с ветвлением: ```text AI-обработка: промпт «Определи тему: продажи / поддержка / жалоба», источник «Последнее сообщение» Условие: {{aiResult}} содержит «продажи»? Да → Добавить тег «продажи» Иначе → Добавить тег «поддержка» ``` Резюме переписки в примечание: ```text AI-обработка: промпт «Составь резюме диалога», источник «Вся переписка» Примечание: «{{aiResult}}» ``` ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{aiResult}}` | Результат последнего AI-блока | | `{{aiResult_N}}` | Результат AI-блока номер N | | `{{lastMessage}}` | После блока равен `{{aiResult}}`, чтобы следующие блоки работали с ответом нейросети | > [!NOTE] N: порядковый номер блока на холсте, счёт с 1. ## Ограничения - Без подключённого AI-провайдера блок не выполнится. - Модель и провайдер задаются в инструкции, а не в блоке. Как их настроить: [Инструкции и промпты](https://docs.tuk-tuk.online/ai/instructions). --- --- title: "Блок «Условие» в цепочке | tuk-tuk.online" nav_title: "Условие" url: https://docs.tuk-tuk.online/chains/blocks/condition markdown: https://docs.tuk-tuk.online/chains/blocks/condition.md section: "Блоки" description: "Блок CONDITION: 6 операторов сравнения без учёта регистра, проверка текста, тега, переменной и результата AI, несколько условий с ветками и ветка «Иначе»." keywords: ["условие бот", "CONDITION блок", "ветвление бот", "if else бот", "проверка условия", "regex бот", "логика автоматизации"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок CONDITION сравнивает выбранное поле (сообщение, имя, тип канала, результат AI, тег, переменная) с заданным значением и направляет цепочку по ветке первого совпавшего условия или по ветке «Иначе». > > - 6 операторов: содержит, не содержит, равно, начинается с, заканчивается на, regex > - Все сравнения без учёта регистра > - Несколько условий в одном блоке, каждое даёт отдельную ветку; проверка сверху вниз до первого совпадения > - Ветка «Иначе» срабатывает, если ни одно условие не совпало > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/ai-process, https://docs.tuk-tuk.online/chains/blocks/tags-and-notes, https://docs.tuk-tuk.online/chains/blocks/randomizer, https://docs.tuk-tuk.online/chains/triggers # Условие Блок проверяет значение (текст сообщения, тег, переменную, результат AI) и направляет цепочку по одной из веток. Каждое условие в блоке создаёт свой выход, плюс есть ветка «Иначе» для случая, когда ничего не совпало. Условия проверяются сверху вниз. Первое совпавшее определяет ветку, остальные не проверяются. ## Настройки Каждое условие состоит из трёх частей: | Поле | Описание | |---|---| | Поле | Что проверяем: сообщение, имя, канал, результат AI, тег или переменную | | Оператор | Как сравниваем: содержит, равно, regex и другие | | Значение | С чем сравниваем | Доступные поля: | Поле | Что проверяется | |---|---| | Последнее сообщение | Текст последнего сообщения клиента | | Имя клиента | Имя из профиля контакта | | Тип канала | Канал, из которого пришло сообщение, например `telegram` | | Результат AI | Ответ последнего AI-блока | | Тег | Есть ли у клиента указанный тег | | Переменная | Значение любой переменной контекста | Операторы, все без учёта регистра: | Оператор | Что проверяет | Пример | |---|---|---| | Содержит | Текст включает подстроку | «Привет мир» содержит «мир» | | Не содержит | Текст не включает подстроку | «Привет мир» не содержит «цена» | | Равно | Точное совпадение | «да» равно «Да» | | Начинается с | Текст начинается с подстроки | «Привет мир» начинается с «привет» | | Заканчивается на | Текст заканчивается подстрокой | «Привет мир» заканчивается на «мир» | | Regex | Регулярное выражение | `\d{10}` находит десятизначный номер | ## Несколько условий В одном блоке можно задать несколько условий, каждое даёт отдельную ветку: ```text Условие 1. Сообщение содержит «цена» → ветка «Прайс» 2. Сообщение содержит «доставка» → ветка «Логистика» 3. Тег равно «VIP» → ветка «Приоритет» Иначе → ветка по умолчанию ``` ## Пример Маршрутизация по теме после AI-обработки: ```text AI-обработка: «Определи тему: продажи / поддержка / жалоба» Условие (поле «Результат AI») Содержит «продажи» → Добавить тег «Продажи» → Отправка: «Соединяю с менеджером» Содержит «жалоба» → Добавить тег «Жалоба» → Отправка: «Передаю руководителю» Иначе → Отправка: «Чем могу помочь?» ``` Проверка тега: ```text Условие (поле «Тег») Равно «VIP» → Отправка: «Здравствуйте! Для VIP-клиентов специальные условия» Иначе → Отправка: «Добро пожаловать!» ``` Ветвление по каналу: ```text Условие (поле «Тип канала») Равно «telegram» → Отправка: «Напишите /start для начала» Иначе → Отправка: «Опишите ваш вопрос» ``` ## Ограничения - Сравнение всегда без учёта регистра, отдельной настройки нет. - Срабатывает только первое совпавшее условие, даже если подходят несколько. - Результат AI для проверки берётся из блока [AI-обработка](https://docs.tuk-tuk.online/chains/blocks/ai-process), который должен стоять раньше по цепочке. --- --- title: "Блок «Рандомайзер» для A/B-тестов в цепочке | tuk-tuk.online" nav_title: "Рандомайзер" url: https://docs.tuk-tuk.online/chains/blocks/randomizer markdown: https://docs.tuk-tuk.online/chains/blocks/randomizer.md section: "Блоки" description: "Блок RANDOMIZER: случайное распределение клиентов по веткам с весами в процентах. A/B-тест текстов и скидок, балансировка между менеджерами." keywords: ["A/B тестирование бот", "RANDOMIZER блок", "сплит-тест бот", "случайное ветвление", "A/B тест мессенджер", "рандомайзер автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок RANDOMIZER случайно направляет клиента по одной из веток пропорционально заданным весам; используется для A/B-тестов и распределения клиентов между менеджерами. > > - Настройка: список сценариев, у каждого название и процент > - Процент работает как вес: вероятность = вес ветки / сумма весов, сумма не обязана равняться 100 > - Типовые сценарии: A/B-тест текстов и скидок, распределение клиентов между менеджерами через теги > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/condition, https://docs.tuk-tuk.online/chains/blocks/tags-and-notes, https://docs.tuk-tuk.online/chains/blocks/send-message # Рандомайзер Блок случайно направляет клиента по одной из веток с учётом заданных весов. Например, 60% клиентов уходят по первой ветке, 40% по второй. Основное применение: A/B-тесты текстов и предложений, равномерное распределение клиентов между менеджерами. ## Настройки | Поле | Описание | |---|---| | Сценарии | Список веток. У каждой: название (например, «Вариант A», «Скидка 10%») и процент | Процент задаёт вес ветки, а не строгую долю. Система делит вес ветки на сумму всех весов, поэтому сумма не обязана равняться 100: | Сценарий | Процент | Реальная вероятность | |---|---|---| | Вариант A | 60 | 60 / 100 = 60% | | Вариант B | 40 | 40 / 100 = 40% | | Сценарий | Процент | Реальная вероятность | |---|---|---| | Вариант A | 3 | 3 / 5 = 60% | | Вариант B | 2 | 2 / 5 = 40% | ## Пример A/B-тест приветствия: ```text Рандомайзер 50% «Формальное» → Отправка: «Здравствуйте! Чем могу помочь?» 50% «Дружеское» → Отправка: «Привет! Рады видеть. Что подсказать?» ``` Тест размера скидки: ```text Рандомайзер 33% «Без скидки» → Отправка: «Стоимость: 5000 ₽» 33% «Скидка 10%» → Отправка: «Для вас: 4500 ₽ (скидка 10%)» 34% «Скидка 20%» → Отправка: «Специально для вас: 4000 ₽ (скидка 20%)» ``` Распределение между менеджерами: ```text Рандомайзер 50% → Добавить тег «Менеджер Алиса» 50% → Добавить тег «Менеджер Борис» ``` ## Когда использовать - Тест текстов: какое приветствие даёт больше ответов. - Тест предложений: какая скидка даёт больше конверсий. - Балансировка нагрузки: равномерно распределить клиентов между менеджерами. - Тест каналов: одним клиентам отвечать через один канал, другим через другой. Чтобы измерить результат теста, пометьте каждую ветку тегом через блок [Добавить тег](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes) и сравните группы в диалогах. --- --- title: "Блок «Webhook» в цепочке: HTTP-запрос к внешнему API | tuk-tuk.online" nav_title: "Webhook" url: https://docs.tuk-tuk.online/chains/blocks/webhook markdown: https://docs.tuk-tuk.online/chains/blocks/webhook.md section: "Блоки" description: "Блок WEBHOOK: GET или POST на любой URL, параметры с переменными, автоматическая передача данных клиента, цепочки и диалога, таймаут 15 секунд, ответ в {{webhook_N}}." keywords: ["webhook бот", "HTTP запрос бот", "API интеграция бот", "внешний сервис бот", "REST API автоматизация", "webhook цепочка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок WEBHOOK отправляет GET- или POST-запрос на внешний URL с параметрами из переменных цепочки и сохраняет ответ в {{webhookResult}} и {{webhook_N}}. > > - Методы: POST (по умолчанию) и GET; только HTTP/HTTPS > - Таймаут 15 секунд; при ошибке блок сохраняет { error } и цепочка продолжается > - includeUserData добавляет client_name, phone, email, client_identifier, tags > - includeChainData добавляет last_message, ai_result, channel_type, chain_id, python_result, integration_result > - includeDialog добавляет поле dialog с полной перепиской > - Ответ: {{webhookResult}} как { status, body } или { error }, {{webhook_N}} как строка тела > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/python-code, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/api/rest # Webhook Блок отправляет HTTP-запрос на указанный URL, ждёт ответ до 15 секунд и сохраняет его в контекст цепочки. Так цепочка обменивается данными с CRM, 1С, интернет-магазином или любым другим API. К запросу можно автоматически добавить данные клиента, данные цепочки и полную историю диалога, а свои параметры заполнить переменными. ## Настройки | Поле | Описание | |---|---| | URL | Адрес, на который уходит запрос | | Метод | GET или POST | | Параметры | Пары ключ-значение, значения поддерживают переменные | | Передать данные клиента | Добавить к запросу имя, телефон, email, идентификатор и теги клиента | | Передать данные цепочки | Добавить последнее сообщение, результат AI, тип канала и другие поля | | Передать историю диалога | Добавить поле `dialog` с полным текстом переписки | Когда какой метод: | Метод | Назначение | |---|---| | POST (по умолчанию) | Передать данные: создать запись, обновить, отправить информацию | | GET | Запросить данные: статус, наличие, справочник | ## Автоматические поля Данные клиента (`includeUserData`): | Поле | Значение | |---|---| | `client_name` | Имя клиента | | `phone` | Телефон | | `email` | Email | | `client_identifier` | Уникальный идентификатор клиента | | `tags` | Теги клиента | Данные цепочки (`includeChainData`): | Поле | Значение | |---|---| | `last_message` | Последнее сообщение | | `ai_result` | Результат AI | | `channel_type` | Тип канала | | `chain_id` | Идентификатор цепочки | | `python_result` | Результат Python | | `integration_result` | Результат интеграции | История диалога (`includeDialog`): поле `dialog` с полной перепиской. Свои параметры добавляются парами ключ-значение, в значениях работают переменные: | Ключ | Значение | |---|---| | `order_id` | `{{lastMessage}}` | | `client` | `{{name}}` | | `ai_summary` | `{{aiResult}}` | ## Пример Статус заказа из CRM: ```text Отправка сообщения: «Напишите номер заказа» Ожидание ответа Webhook: POST https://api.myshop.com/orders/status Параметр: order_id = {{lastMessage}} Отправка сообщения: «Статус вашего заказа: {{webhook_3}}» ``` Запись в Google Sheets через Apps Script: ```text AI-обработка: «Извлеки имя и телефон» Webhook: POST https://script.google.com/... Передать данные клиента: включено Параметр: ai_result = {{aiResult}} ``` ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{webhookResult}}` | Полный ответ: объект `{ status, body }` или `{ error }` | | `{{webhook_N}}` | Тело ответа строкой, N: номер блока | Разобрать JSON из ответа удобно в блоке [Python-код](https://docs.tuk-tuk.online/chains/blocks/python-code). ## Ограничения - Таймаут 15 секунд. Если сервер не ответил, блок сохраняет ошибку в `{{webhookResult}}` и цепочка продолжается. - Только HTTP и HTTPS, другие протоколы не поддерживаются. > [!TIP] Чтобы принимать события от tuk-tuk.online в обратную сторону (новое сообщение, смена статуса), используйте [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). --- --- title: "Блок «Вызов цепочки»: вложенные сценарии | tuk-tuk.online" nav_title: "Вызов цепочки" url: https://docs.tuk-tuk.online/chains/blocks/call-chain markdown: https://docs.tuk-tuk.online/chains/blocks/call-chain.md section: "Блоки" description: "Блок CALL_CHAIN: запуск другой цепочки из текущей, передача и возврат переменных, защита от циклических вызовов." keywords: ["вызов цепочки", "CALL_CHAIN блок", "вложенная цепочка", "модульный бот", "подцепочка", "рекурсия бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок CALL_CHAIN запускает другую цепочку из текущей, передаёт ей переменные и возвращает выбранные переменные обратно; позволяет переиспользовать сценарии как модули. > > - Настройки: выбор цепочки, список передаваемых переменных, список возвращаемых переменных (через запятую) > - Пустой список означает «все переменные» и для передачи, и для возврата > - Возвращённые переменные перезаписывают значения в контексте текущей цепочки > - Циклические вызовы (A вызывает B, B вызывает A) не выполняются, ошибка пишется в лог > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/set-variable, https://docs.tuk-tuk.online/chains/blocks/ai-process, https://docs.tuk-tuk.online/chains # Вызов цепочки Блок запускает другую цепочку из текущей, ждёт её завершения и продолжает выполнение с полученными результатами. Так один сценарий (например, сбор контактов) собирается один раз и вызывается из любых цепочек как модуль, без копирования блоков. Вложенной цепочке передаются переменные контекста, а после её завершения выбранные переменные возвращаются обратно. ## Настройки | Поле | Описание | |---|---| | Цепочка | Какую цепочку вызвать, выбор из списка | | Передаваемые переменные | Имена переменных через запятую, которые получит вложенная цепочка. Пусто: передаются все | | Возвращаемые переменные | Имена переменных через запятую, которые вернутся в текущую цепочку. Пусто: возвращаются все | Пример заполнения: ```text Передать: aiResult, lastMessage, name, phone Вернуть: aiResult, var_1 ``` Возвращённые значения перезаписывают одноимённые переменные в контексте текущей цепочки. ## Как выполняется 1. Текущая цепочка доходит до блока: запускается выбранная вложенная цепочка. 2. Вложенная цепочка получает указанные переменные и выполняется до конца. 3. Возвращаемые переменные записываются в контекст текущей цепочки. 4. Текущая цепочка продолжается со следующего блока. ## Пример Модуль «Сбор контактов» как отдельная цепочка: ```text Отправка: «Как вас зовут?» → Ожидание ответа → Переменная var_1 = {{lastMessage}} Отправка: «Ваш телефон?» → Ожидание ответа → Переменная var_2 = {{lastMessage}} ``` Основная цепочка вызывает модуль: ```text Отправка: «Давайте оформим заявку» Вызов цепочки: «Сбор контактов», вернуть var_1, var_2 Отправка: «Спасибо, {{var_1}}! Мы перезвоним на {{var_2}}» ``` Переиспользование AI-квалификации: ```text Вызов цепочки: «AI-квалификация», передать lastMessage, вернуть aiResult Условие: {{aiResult}} содержит «горячий»? Да → Отправка: «Менеджер свяжется через 5 минут» Иначе → Отправка: «Отправляю каталог» ``` ## Ограничения - Циклические вызовы блокируются: если цепочка A вызывает B, а B вызывает A, вложенная цепочка не запустится, в лог запишется ошибка. - Общие лимиты выполнения (200 блоков за запуск и другие) описаны на странице [Типы блоков](https://docs.tuk-tuk.online/chains/blocks). --- --- title: "Блок «Python-код» в цепочке: скрипты в песочнице | tuk-tuk.online" nav_title: "Python-код" url: https://docs.tuk-tuk.online/chains/blocks/python-code markdown: https://docs.tuk-tuk.online/chains/blocks/python-code.md section: "Блоки" description: "Блок PYTHON_CODE: скрипт с доступом к переменным цепочки, результат через переменную result, разрешённые и запрещённые модули, таймаут 10 секунд, вывод до 256 КБ." keywords: ["Python бот", "PYTHON_CODE блок", "скрипт в боте", "песочница Python", "код автоматизация", "Python цепочка", "программирование бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок PYTHON_CODE выполняет Python-скрипт в песочнице с доступом к переменным цепочки; результат возвращается через переменную result и попадает в {{pythonResult}} и {{python_N}}. > > - Таймаут до 10 секунд, размер вывода до 256 КБ > - Переменные в скрипте: last_message, ai_result, name, phone, email, client_identifier, channel_type, custom_field_ИМЯ, aiResult_N, python_N, webhook_N, var_N > - Разрешённые модули: json, re, math, datetime, string, random, hashlib > - Запрещены файловая система, сеть, базы данных, subprocess/threading, eval/exec, pickle > - После блока {{lastMessage}} равен {{pythonResult}} > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/chains/blocks/set-variable, https://docs.tuk-tuk.online/chains/blocks/ai-process # Python-код Блок выполняет Python-скрипт внутри цепочки. Скрипт читает переменные контекста (сообщение клиента, результат AI, ответ вебхука), обрабатывает их и возвращает результат через переменную `result`. Нужен, когда стандартных блоков не хватает: вычисления, форматирование, разбор JSON. Скрипт запускается в изолированной песочнице без доступа к файлам, сети и системным вызовам. ## Настройки | Поле | Описание | |---|---| | Код | Python-скрипт. Результат записывается в переменную `result` | | Таймаут | Максимальное время выполнения, до 10 секунд | ## Доступные переменные Внутри скрипта доступны переменные цепочки: | Переменная | Что содержит | |---|---| | `last_message` (или `lastMessage`) | Последнее сообщение клиента | | `ai_result` (или `aiResult`) | Результат AI-обработки | | `name` / `clientName` | Имя клиента | | `phone` | Телефон | | `email` | Email | | `client_identifier` | Уникальный идентификатор клиента | | `channel_type` | Тип канала | | `custom_field_ИМЯ` | Кастомные поля диалога | | `aiResult_N` | Результат AI-блока номер N | | `python_N` | Результат Python-блока номер N | | `webhook_N` | Ответ вебхука номер N | | `var_N` | Пользовательская переменная номер N | ## Как вернуть результат Присвойте значение переменной `result`: ```python result = "Привет, " + name + "!" ``` ```python price = 5000 discount = 0.1 result = str(price * (1 - discount)) # "4500.0" ``` ```python import json data = json.loads(ai_result) result = data.get("summary", "Нет данных") ``` ## Пример Извлечение email из текста: ```python import re match = re.search(r'[\w.-]+@[\w.-]+', last_message) result = match.group(0) if match else "не найден" ``` Форматирование суммы: ```python price = int(last_message) result = f"{price:,}".replace(",", " ") + " ₽" # 5000 -> "5 000 ₽" ``` Разбор JSON из ответа вебхука: ```python import json data = json.loads(webhook_1 or '{}') status = data.get("status", "неизвестно") result = f"Статус заказа: {status}" ``` Дата на завтра: ```python from datetime import datetime, timedelta tomorrow = datetime.now() + timedelta(days=1) result = tomorrow.strftime("%d.%m.%Y") ``` ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{pythonResult}}` | Результат последнего Python-блока | | `{{python_N}}` | Результат Python-блока номер N | | `{{lastMessage}}` | После блока равен `{{pythonResult}}` | ## Ограничения | Параметр | Значение | |---|---| | Таймаут | До 10 секунд | | Размер вывода | До 256 КБ | | Импорты | Только безопасные модули стандартной библиотеки | Разрешённые модули: `json`, `re`, `math`, `datetime`, `string`, `random`, `hashlib`, плюс базовый Python (циклы, условия, списки, словари). Запрещено: | Категория | Что нельзя | |---|---| | Файловая система | `os`, `sys`, `pathlib`, `glob`, `tempfile`, `open()` | | Сеть | `socket`, `http`, `urllib`, `requests`, `ftplib`, `smtplib` | | Базы данных | `sqlite3`, `mysql`, `psycopg2`, `pymongo`, `redis` | | Системные вызовы | `subprocess`, `ctypes`, `multiprocessing`, `threading` | | Опасные функции | `eval()`, `exec()`, `compile()`, `getattr()`, `__import__()` | | Сериализация | `pickle`, `shelve`, `marshal` | > [!TIP] Для HTTP-запросов используйте блок [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook), а его ответ разбирайте в Python через `webhook_N`. --- --- title: "Блоки «Добавить тег», «Удалить тег», «Примечание» | tuk-tuk.online" nav_title: "Теги и примечания" url: https://docs.tuk-tuk.online/chains/blocks/tags-and-notes markdown: https://docs.tuk-tuk.online/chains/blocks/tags-and-notes.md section: "Блоки" description: "Блоки ADD_TAG, REMOVE_TAG и ADD_NOTE в цепочке: присвоение и снятие тегов клиента, внутренние заметки в диалоге с переменными." keywords: ["тег бот", "ADD_TAG блок", "REMOVE_TAG", "ADD_NOTE", "теги автоматизация", "заметки бот", "примечание диалог"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блоки ADD_TAG, REMOVE_TAG и ADD_NOTE присваивают или снимают тег клиента и добавляют внутреннюю заметку в диалог; ничего не отправляют клиенту и выполняются мгновенно. > > - ADD_TAG и REMOVE_TAG: одно поле «Тег» с названием > - ADD_NOTE: поле «Текст» с поддержкой переменных {{name}}, {{aiResult}}, {{lastMessage}}, {{python_N}} и других > - Теги используются в фильтрах диалогов, блоке «Условие», автоостановке цепочки, массовом запуске и передаются в AmoCRM > - У всех трёх блоков один выход, цепочка всегда идёт дальше > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/condition, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/dialogs/notes, https://docs.tuk-tuk.online/dialogs/search-and-filters # Теги и примечания Три блока для пометок внутри диалога: «Добавить тег», «Удалить тег» и «Примечание». Они ничего не отправляют клиенту, выполняются мгновенно и имеют один выход: цепочка всегда идёт дальше. Теги нужны для фильтрации диалогов, условий в цепочках, автоостановки, массового запуска и передачи в CRM. Примечание записывает служебный текст в диалог, который видит только команда. ## Настройки Добавить тег (ADD_TAG): | Поле | Описание | |---|---| | Тег | Название тега, которое получит клиент | Удалить тег (REMOVE_TAG): | Поле | Описание | |---|---| | Тег | Название тега, который нужно снять с клиента | Примечание (ADD_NOTE): | Поле | Описание | |---|---| | Текст | Содержимое заметки. Поддерживает те же переменные, что и блок «Отправка сообщения»: `{{name}}`, `{{aiResult}}`, `{{lastMessage}}`, `{{python_N}}` и остальные | ## Для чего нужны теги - Фильтрация: найти всех клиентов с тегом «VIP» в списке диалогов. - Условия: блок [Условие](https://docs.tuk-tuk.online/chains/blocks/condition) проверяет наличие тега. - Автоостановка: цепочка останавливается, когда у клиента появился стоп-тег, см. [Триггеры и условия](https://docs.tuk-tuk.online/chains/triggers). - Массовый запуск: запустить цепочку на всех клиентах с тегом. - CRM: теги передаются в AmoCRM. ## Пример Тег по результату классификации: ```text AI-обработка: «Определи тему обращения» Условие: {{aiResult}} содержит «покупка»? Да → Добавить тег «Горячий лид» Иначе → Добавить тег «Консультация» ``` Смена статуса обращения: ```text Отправка: «Проблема решена? Оцените от 1 до 5» Ожидание ответа Удалить тег «Ждёт ответа» Добавить тег «Обращение закрыто» ``` Резюме диалога в примечание: ```text AI-обработка: «Составь краткое резюме разговора» Примечание: «Резюме: {{aiResult}}» ``` Ответ CRM в примечание: ```text Webhook: запрос в CRM Примечание: «Ответ CRM: {{webhook_2}}» ``` ## Ограничения - Клиент не видит ни тегов, ни примечаний: это внутренние данные проекта. - Блоки не отправляют сообщений и не ветвят цепочку: для ветвления по тегу нужен блок «Условие». --- --- title: "Блок «Переменная» и справочник переменных цепочки | tuk-tuk.online" nav_title: "Переменные" url: https://docs.tuk-tuk.online/chains/blocks/set-variable markdown: https://docs.tuk-tuk.online/chains/blocks/set-variable.md section: "Блоки" description: "Блок SET_VARIABLE сохраняет значение в {{var_N}}. Справочник всех переменных цепочки: данные клиента, результаты AI, Python, вебхуков, история диалогов и выборки за период." keywords: ["переменная бот", "SET_VARIABLE блок", "шаблон переменная", "template variable", "контекст цепочки", "данные бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок SET_VARIABLE сохраняет текст в {{var_N}} для следующих блоков; страница также содержит справочник всех переменных цепочки tuk-tuk.online. > > - Единственное поле блока: «Значение», результат в {{var_N}}, где N: номер блока на холсте (с 1) > - Данные клиента: {{name}}, {{phone}}, {{email}}, {{client_identifier}}, {{custom_field_ИМЯ}} > - Результаты блоков: {{aiResult}}, {{aiResult_N}}, {{imageResult}}, {{imageResult_N}}, {{pythonResult}}, {{python_N}}, {{webhookResult}}, {{webhook_N}}, {{message_N}}, {{var_N}} > - Переписка: {{lastMessage}}, {{dialog}}, {{dialog_N}} > - Выборки за период: {{dialogs_7d}}, {{dialogs_24h}}, суффиксы _private/_groups/_channels, _tag:ИМЯ, лимит через двоеточие (по умолчанию 50) > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/chains/blocks/call-chain, https://docs.tuk-tuk.online/chains/blocks/python-code, https://docs.tuk-tuk.online/funnels/templates # Переменные Блок «Переменная» сохраняет текст (можно с подстановками) в переменную `{{var_N}}`, где N: порядковый номер блока на холсте. Любой следующий блок может использовать это значение. На этой же странице собран справочник всех переменных, которые работают в текстах сообщений, примечаниях, промптах, параметрах вебхука и Python-коде. ## Настройки | Поле | Описание | |---|---| | Значение | Текст для сохранения. Поддерживает переменные, например `{{lastMessage}}` или `{{aiResult}}` | Результат записывается в `{{var_N}}`. ## Пример Собрать ответы из нескольких шагов: ```text Отправка: «Как вас зовут?» → Ожидание ответа → Переменная: var_1 = {{lastMessage}} Отправка: «Ваш телефон?» → Ожидание ответа → Переменная: var_2 = {{lastMessage}} Отправка: «Ваш email?» → Ожидание ответа → Переменная: var_3 = {{lastMessage}} Отправка: «Итого: {{var_1}}, {{var_2}}, {{var_3}}» ``` Сохранить промежуточный результат AI перед следующим AI-блоком: ```text AI-обработка: «Извлеки имя клиента из сообщения» Переменная: var_4 = {{aiResult}} AI-обработка: «Извлеки телефон» Отправка: «Клиент: {{var_4}}, телефон: {{aiResult}}» ``` ## Справочник переменных Данные клиента: | Переменная | Значение | |---|---| | `{{name}}` | Имя клиента | | `{{phone}}` | Телефон | | `{{email}}` | Email | | `{{client_identifier}}` | Уникальный идентификатор клиента | | `{{custom_field_ИМЯ}}` | Кастомное поле диалога | Результаты блоков: | Переменная | Откуда | |---|---| | `{{aiResult}}` | Последний AI-блок | | `{{aiResult_N}}` | AI-блок номер N | | `{{imageResult}}` | Последняя сгенерированная картинка | | `{{imageResult_N}}` | Картинка из блока номер N | | `{{pythonResult}}` | Последний Python-блок | | `{{python_N}}` | Python-блок номер N | | `{{webhookResult}}` | Последний вебхук, объект `{status, body}` | | `{{webhook_N}}` | Ответ вебхука номер N | | `{{message_N}}` | Текст, отправленный блоком номер N | | `{{var_N}}` | Блок «Переменная» номер N | Сообщения и переписка: | Переменная | Значение | |---|---| | `{{lastMessage}}` | Последнее входящее сообщение клиента | | `{{dialog}}` | Полная история переписки | | `{{dialog_N}}` | Последние N сообщений | Выборки диалогов за период (для аналитики и отчётов): | Переменная | Значение | |---|---| | `{{dialogs_7d}}` | Все диалоги за 7 дней, лимит 50 | | `{{dialogs_24h}}` | За 24 часа | | `{{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 и горячий) | Период меняется в имени переменной: `24h` (сутки), `3d` (3 дня), `7d` (неделя), `30d` (месяц). ## Нумерация блоков N: порядковый номер блока на холсте, счёт с 1. Если AI-блок стоит третьим, его результат лежит в `{{aiResult_3}}`. ## Ограничения - Выборки `{{dialogs_*}}` по умолчанию ограничены 50 диалогами, лимит задаётся через двоеточие: `{{dialogs_7d:100}}`. - В другую цепочку переменные передаются через блок [Вызов цепочки](https://docs.tuk-tuk.online/chains/blocks/call-chain). --- --- title: "Блок «Генерация изображений» в цепочке | tuk-tuk.online" nav_title: "Генерация изображений" url: https://docs.tuk-tuk.online/chains/blocks/generate-image markdown: https://docs.tuk-tuk.online/chains/blocks/generate-image.md section: "Блоки" description: "Блок GENERATE_IMAGE: картинка по промпту через Kandinsky (FusionBrain) или KIE.AI (17+ моделей), text-to-image и image-to-image, размеры, результат в {{imageResult}}." keywords: ["генерация изображений бот", "GENERATE_IMAGE блок", "Kandinsky бот", "KIE.AI", "text-to-image автоматизация", "AI картинка бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок GENERATE_IMAGE создаёт картинку по промпту через Kandinsky (FusionBrain) или KIE.AI и сохраняет её URL в {{imageResult}} для отправки клиенту. > > - Настройки: провайдер, промпт с переменными, ширина и высота в пикселях, входное изображение для image-to-image > - Kandinsky: ключи API Key и Secret Key с fusionbrain.ai, только text-to-image > - KIE.AI: один API-ключ с kie.ai, 17+ моделей (SeedREAM, Flux 2, Ideogram, Google Imagen, Grok Imagine, GPT Image, Stable Diffusion, Recraft), text-to-image и image-to-image > - Результат: {{imageResult}} и {{imageResult_N}}, используется как медиа-переменная в блоке «Отправка сообщения» > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/ai/image-generation, https://docs.tuk-tuk.online/ai/providers # Генерация изображений Блок создаёт картинку по текстовому описанию через выбранный AI-провайдер и сохраняет её URL в переменную. Дальше картинку можно отправить клиенту блоком «Отправка сообщения» как медиа из переменной. Промпт поддерживает переменные, поэтому описание может прийти от клиента или от предыдущего AI-блока. ## Настройки | Поле | Описание | |---|---| | Провайдер | Kandinsky (FusionBrain) или KIE.AI | | Промпт | Описание изображения, поддерживает переменные | | Ширина | Ширина в пикселях, например 512 | | Высота | Высота в пикселях, например 512 | | Входное изображение | URL исходной картинки для режима image-to-image | ## Провайдеры Kandinsky (FusionBrain): нейросеть от Сбера, хорошо понимает описания на русском. - Подключение: API Key и Secret Key с [fusionbrain.ai](https://fusionbrain.ai). - Режимы: text-to-image. KIE.AI: агрегатор, 17+ моделей через один API-ключ с [kie.ai](https://kie.ai). Режимы: text-to-image и image-to-image. | Модель | Особенность | |---|---| | SeedREAM | Фотореалистичные изображения | | Flux 2 | Быстрая генерация с хорошим качеством | | Ideogram | Хорошо рисует текст на изображениях | | Google Imagen | Модель от Google | | Grok Imagine | Модель от xAI | | GPT Image | Модель от OpenAI | | Stable Diffusion | Гибкая open-source модель | | Recraft | Стильные иллюстрации | | Другие | Ещё 10+ моделей | Ключи провайдеров добавляются на странице [Провайдеры](https://docs.tuk-tuk.online/ai/providers), подробнее о режимах на странице [Генерация изображений](https://docs.tuk-tuk.online/ai/image-generation). ## Пример Картинка по описанию клиента: ```text Отправка: «Опишите, что нарисовать» Ожидание ответа Генерация изображений: промпт = {{lastMessage}} Отправка: «Вот ваша картинка», медиа: переменная {{imageResult}} ``` AI сочиняет промпт по продукту: ```text AI-обработка: «Опиши визуально продукт: {{lastMessage}}» Генерация изображений: промпт = {{aiResult}} Отправка: медиа: переменная {{imageResult}} ``` ## Что сохраняется в контексте | Переменная | Значение | |---|---| | `{{imageResult}}` | URL последней сгенерированной картинки | | `{{imageResult_N}}` | URL картинки из блока номер N | В блоке [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message) выберите источник медиа «Переменная» и укажите одну из них. ## Ограничения - Нужен подключённый провайдер с ключами: Kandinsky (API Key и Secret Key) или KIE.AI (один API-ключ). - Image-to-image работает только через KIE.AI. --- --- title: "Блоки «Добавить задачу» и «ИИ-задача» в цепочке | tuk-tuk.online" nav_title: "Задачи" url: https://docs.tuk-tuk.online/chains/blocks/tasks markdown: https://docs.tuk-tuk.online/chains/blocks/tasks.md section: "Блоки" description: "Блоки CREATE_TASK и AI_TASK: задача с заданными полями (статус, приоритет, исполнитель, срок) или задача, которую AI заполняет по диалогу; режимы назначения." keywords: ["создание задачи бот", "CREATE_TASK блок", "AI_TASK блок", "задачи автоматизация", "таск-менеджер бот", "AI создание задачи"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блоки CREATE_TASK и AI_TASK создают задачи из цепочки: первый с заданными вручную полями, второй заполняет название, описание, приоритет и срок через нейросеть по диалогу. > > - CREATE_TASK поля: название, описание, статус, приоритет, исполнитель, цвет, срок, привязка к диалогу, делегирование по роли > - Статусы: BACKLOG, TODO (по умолчанию), IN_PROGRESS, REVIEW, DONE; приоритеты: LOW, MEDIUM (по умолчанию), HIGH, URGENT > - AI_TASK возвращает JSON с title, description, priority, dueDate, tags; статус и приоритет по умолчанию берутся из настроек блока > - Режимы назначения AI_TASK: конкретный пользователь, по роли, все > - AI_TASK требует подключённого AI-провайдера и инструкции > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/tasks/automation, https://docs.tuk-tuk.online/chains/blocks/ai-process, https://docs.tuk-tuk.online/ai/instructions # Задачи Два блока создают задачи из цепочки. «Добавить задачу» (CREATE_TASK): вы сами задаёте название, описание, статус, приоритет и исполнителя. «ИИ-задача» (AI_TASK): нейросеть читает диалог и сама заполняет поля задачи. Задачи появляются в разделе [Задачи](https://docs.tuk-tuk.online/tasks) и могут быть привязаны к диалогу клиента. ## Настройки Добавить задачу (CREATE_TASK): | Поле | Описание | |---|---| | Название | Заголовок задачи, поддерживает переменные | | Описание | Подробности, поддерживает переменные | | Статус | BACKLOG, TODO (по умолчанию), IN_PROGRESS, REVIEW, DONE | | Приоритет | LOW, MEDIUM (по умолчанию), HIGH, URGENT | | Исполнитель | Кому назначить задачу | | Цвет | Цвет карточки | | Срок | Дата дедлайна | | Привязка к диалогу | Связать задачу с диалогом клиента | | Делегирование | Автоназначение по роли | ИИ-задача (AI_TASK): | Поле | Описание | |---|---| | Инструкция | AI-инструкция из библиотеки или свой промпт | | Источник данных | Весь диалог, последнее сообщение или свой текст | | Привязка к диалогу | Связать задачу с диалогом клиента | | Статус по умолчанию | Используется, если AI не указал статус | | Приоритет по умолчанию | Используется, если AI не указал приоритет | | Назначение | Конкретному пользователю, по роли или всем | Статусы и приоритеты: | Статус | Значение | |---|---| | BACKLOG | В очереди, без срока | | TODO | Надо сделать, по умолчанию | | IN_PROGRESS | В работе | | REVIEW | На проверке | | DONE | Готово | | Приоритет | Значение | |---|---| | LOW | Не срочно | | MEDIUM | Обычный, по умолчанию | | HIGH | Важно | | URGENT | Очень срочно | Режимы назначения для ИИ-задачи: | Режим | Кому | |---|---| | Конкретный | Выбранному пользователю | | По роли | Любому сотруднику с указанной ролью | | Все | Всем участникам проекта | ## Как ИИ-задача заполняет поля 1. AI получает диалог или сообщение из выбранного источника. 2. AI возвращает JSON с полями задачи: ```json { "title": "Клиент хочет возврат товара", "description": "Заказ #12345, причина: не подошёл размер", "priority": "HIGH", "dueDate": "2026-04-01", "tags": ["возврат", "жалоба"] } ``` 3. Система создаёт задачу из этих данных. Если статус или приоритет не указаны, берутся значения по умолчанию из настроек блока. ## Пример Задача с фиксированными полями после AI-обработки: ```text AI-обработка: «Извлеки суть обращения» Добавить задачу: Название: «Обращение: {{name}}» Описание: «{{aiResult}}» Приоритет: HIGH Исполнитель: менеджер ``` Задача для поддержки, которую заполняет AI: ```text Ожидание ответа (клиент описывает проблему) ИИ-задача: Инструкция: «Создай задачу для отдела поддержки» Источник: весь диалог Назначение: по роли «Поддержка» ``` ## Какой блок выбрать | Ситуация | Блок | |---|---| | Шаблонная задача с фиксированными полями | CREATE_TASK | | Задача из формы (имя, телефон, запрос) | CREATE_TASK | | AI должен понять суть и сам описать задачу | AI_TASK | | Автоматическая классификация обращений | AI_TASK | ## Ограничения - Для ИИ-задачи нужен подключённый [AI-провайдер](https://docs.tuk-tuk.online/ai/providers) и инструкция. - Правила автосоздания задач вне цепочек описаны на странице [Автосоздание задач](https://docs.tuk-tuk.online/tasks/automation). --- --- title: "Блок «Интеграция»: действия в AmoCRM и YClients из цепочки | tuk-tuk.online" nav_title: "Интеграция с CRM" url: https://docs.tuk-tuk.online/chains/blocks/integration markdown: https://docs.tuk-tuk.online/chains/blocks/integration.md section: "Блоки" description: "Блок INTEGRATION: создание сделки, движение по воронке, кастомные поля, ответственный, теги и примечания в AmoCRM; посещаемость, метки и цвет записи в YClients." keywords: ["интеграция бот", "INTEGRATION блок", "AmoCRM бот", "YClients бот", "CRM автоматизация", "сделка CRM бот", "воронка продаж бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Блок INTEGRATION выполняет действие в подключённой CRM из цепочки: в AmoCRM создаёт сделку, двигает по воронке, ставит теги и поля; в YClients меняет посещаемость, метки и цвет записи. > > - Предусловие: подключённая интеграция AmoCRM или YClients, иначе блок пропускается > - AmoCRM: создать сделку, движение по воронке (ID воронки и этапа), кастомное поле (contact/deal), установить ответственного (ID), тег сделки/контакта, примечание к сделке > - YClients: изменить посещаемость, добавить/удалить метку, цвет карточки; ID записи, пусто = последняя запись клиента > - Поля действий поддерживают переменные цепочки: {{name}}, {{lastMessage}}, {{aiResult}} > - Результат доступен вебхуку как integration_result > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/amocrm, https://docs.tuk-tuk.online/integrations/yclients, https://docs.tuk-tuk.online/chains/blocks/condition # Интеграция с CRM Блок выполняет действие в подключённой CRM: создаёт сделку в AmoCRM, двигает её по воронке, ставит тег, меняет метку записи в YClients. Клиент пишет «хочу купить», и сделка появляется в CRM без участия менеджера. Блок работает только с уже подключённой интеграцией. Как подключить: [Интеграции](https://docs.tuk-tuk.online/integrations). ## Настройки | Поле | Описание | |---|---| | Интеграция | Какую CRM использовать: AmoCRM или YClients | | Действие | Что сделать в CRM | | Настройки действия | Поля, зависящие от выбранного действия, поддерживают переменные | ## Действия AmoCRM Создать сделку. Создаёт сделку и привязывает клиента по телефону или email. | Поле | Описание | |---|---| | Название сделки | Поддерживает переменные, например `{{name}}` и `{{lastMessage}}` | | Теги | Теги через запятую | Движение по воронке. Переносит сделку клиента на другой этап. | Поле | Описание | |---|---| | ID воронки | Идентификатор воронки в AmoCRM | | ID этапа | Идентификатор этапа | Кастомное поле. Записывает значение в поле контакта или сделки. | Поле | Описание | |---|---| | Сущность | `contact` (контакт) или `deal` (сделка) | | Имя поля | Название кастомного поля | | Значение | Новое значение, поддерживает переменные | Установить ответственного. | Поле | Описание | |---|---| | ID ответственного | Идентификатор менеджера в AmoCRM | Тег сделки / контакта. | Поле | Описание | |---|---| | Тег | Название тега | Примечание к сделке. | Поле | Описание | |---|---| | Текст | Текст примечания, поддерживает переменные | | ID сделки | Пусто: последняя сделка клиента | ## Действия YClients | Действие | Что делает | |---|---| | Изменить посещаемость | Меняет статус attendance записи клиента | | Добавить / удалить метку | Управляет метками (категориями) записи | | Цвет карточки | Меняет цвет карточки записи | Все действия YClients принимают ID записи. Если поле пустое, используется последняя запись клиента. ## Пример Сделка в AmoCRM при намерении купить: ```text AI-обработка: «Определи: клиент хочет купить? Ответь да/нет» Условие: {{aiResult}} содержит «да»? Да → Интеграция AmoCRM: создать сделку «{{name}}: заявка из бота» Интеграция AmoCRM: тег сделки «Бот» Отправка: «Менеджер свяжется с вами» Иначе → Отправка: «Обращайтесь, когда будете готовы» ``` Квалификация лида и этап воронки: ```text AI-обработка: «Квалифицируй лида: холодный / тёплый / горячий» Условие (поле «Результат AI») «горячий» → Интеграция AmoCRM: движение по воронке, этап «Горячие» «тёплый» → Интеграция AmoCRM: движение по воронке, этап «В работе» «холодный» → Интеграция AmoCRM: движение по воронке, этап «Входящие» ``` ## Ограничения - Нужна подключённая интеграция AmoCRM или YClients. Если интеграция не настроена, блок пропускается. - Настройка подключения: [amoCRM](https://docs.tuk-tuk.online/integrations/amocrm), [YClients](https://docs.tuk-tuk.online/integrations/yclients). --- --- title: "Воронки историй: автопостинг Stories и профиля | tuk-tuk.online" nav_title: "Воронки историй" url: https://docs.tuk-tuk.online/funnels markdown: https://docs.tuk-tuk.online/funnels.md description: "Визуальный редактор воронок tuk-tuk.online: публикация Stories, обновление профиля, AI-генерация контента, рассылка по диалогам, условия и рандомайзер. Telegram, VK, Instagram. Лимиты и права." keywords: ["воронки контента", "автоматизация Stories", "Telegram воронка", "VK воронка", "Instagram воронка", "публикация Stories", "AI генерация контента", "визуальный редактор воронок", "автоматизация профиля", "рассылка сообщений"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Воронки tuk-tuk.online: визуальные сценарии, которые от имени канала публикуют Stories, меняют профиль, генерируют контент через AI и рассылают сообщения. Работают для Telegram-аккаунта, VK-сообщества и Instagram. > > - Разделы кабинета: https://lk.tuk-tuk.online/tg-funnels, https://lk.tuk-tuk.online/vk-funnels, https://lk.tuk-tuk.online/ig-funnels. Воронка привязана к одному каналу. > - 13 типов блоков в Telegram и VK, 11 в Instagram; всего 16 разных блоков. > - Лимиты: 200 шагов за запуск, 200 записей в логе, до 200 диалогов в {{dialogs_...}} (по умолчанию 50), 100 сообщений на диалог. > - Переменные: {{aiResult}}, {{imageResult}}, {{storyResult}} (с суффиксом _N по номеру блока), {{name}}, {{phone}}, {{email}}, {{dialogs_7d}} и варианты. > - История запусков обновляется каждые 5 секунд; незавершённые запуски возобновляются после перезапуска сервера. > - Права те же, что у цепочек: CHAINS_VIEW, CHAINS_CREATE, CHAINS_EDIT, CHAINS_DELETE, CHAINS_TOGGLE, CHAINS_EXECUTE, CHAINS_LOGS. > > Связанные страницы: 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/funnels/templates, https://docs.tuk-tuk.online/chains # Воронки Воронка: визуальный сценарий, который выполняет действия от вашего имени в соцсети. Публикует Stories, меняет профиль, генерирует контент через AI, рассылает сообщения по диалогам. [Цепочки](https://docs.tuk-tuk.online/chains) реагируют на входящие сообщения, воронки работают наружу: это автопостер и менеджер профиля. Каждая воронка привязана к одному каналу своего типа: Telegram-аккаунту, VK-сообществу или Instagram-аккаунту. ## Когда это нужно - Публиковать Stories по расписанию или с AI-генерацией. - Менять имя, био и аватар автоматически, например для A/B-теста профиля. - Разослать персональные сообщения выбранным клиентам. - Подготовить контент через AI и опубликовать одним запуском. - Собрать сценарий с условиями, ветвлением и паузами. ## Платформы | Платформа | Канал | Подробнее | |---|---|---| | Telegram | [Telegram-аккаунт](https://docs.tuk-tuk.online/channels/telegram-account) | [Telegram-воронки](https://docs.tuk-tuk.online/funnels/tg-funnels) | | ВКонтакте | [VK-сообщество](https://docs.tuk-tuk.online/channels/vk-community) | [VK-воронки](https://docs.tuk-tuk.online/funnels/vk-funnels) | | Instagram | [Instagram DM](https://docs.tuk-tuk.online/channels/instagram) | [Instagram-воронки](https://docs.tuk-tuk.online/funnels/ig-funnels) | ## Как создать воронку ![Список воронок Telegram](https://docs.tuk-tuk.online/assets/screens/funnels/tg-list.webp) 1. Кнопка «Создать воронку». 2. Пауза, копия и удаление воронки. 3. Статус воронки. ![Выбор шаблона воронки](https://docs.tuk-tuk.online/assets/screens/funnels/tg-create.webp "Готовые шаблоны сгруппированы по темам: контент, брендинг, вовлечение, AI. Можно начать с пустой воронки.") 1. Откройте раздел воронок нужной платформы: [Telegram](https://lk.tuk-tuk.online/tg-funnels), [VK](https://lk.tuk-tuk.online/vk-funnels) или [Instagram](https://lk.tuk-tuk.online/ig-funnels). 2. Создайте воронку: укажите название, описание и выберите канал. 3. Добавьте блоки на холст и соедините их стрелками. 4. Нажмите «Запустить»: воронка начнёт выполнение, а в истории появится новый запуск. ## Визуальный редактор ![Редактор воронки историй](https://docs.tuk-tuk.online/assets/screens/funnels/tg-editor.webp) 1. Добавить блок: история, задержка, сообщение, AI. 2. История запусков. 3. Запустить воронку вручную. 4. Сохранить. 5. Навигация по холсту: масштаб, «показать всё», полный экран. Холст 3000×3000 пикселей, блоки перетаскиваются, связи рисуются стрелками. - Холст: блоки и SVG-стрелки между ними. - Панель блоков: добавление блоков по типам. - Боковая панель: шаблонные переменные, легенда блоков, статистика. - История запусков: лог каждого выполнения с деталями по шагам. ## Типы блоков В Telegram и VK доступно 13 типов блоков, в Instagram 11. Всего 16 разных блоков. | Блок | Telegram | VK | Instagram | Что делает | |---|---|---|---|---| | Публикация Story | Да | Да | Да | Фото или видео в Stories | | Удаление Stories | Да | Да | Нет | Удалить все, конкретные или последнюю | | Публикация поста | Нет | Нет | Да | Фото-пост с подписью | | Карусель | Нет | Нет | Да | Пост с несколькими фото | | Reels | Нет | Нет | Да | Видео Reels | | Обновление профиля | Да | Да | Нет | Имя, фамилия, био | | Смена username | Да | Да | Нет | Новый @username | | Смена аватара | Да | Да | Нет | Загрузка нового фото | | Удаление аватара | Да | Да | Нет | Удаление фото профиля | | Отправка сообщений | Да | Да | Да | Рассылка в выбранные диалоги | | Задержка | Да | Да | Да | Пауза N секунд | | Условие | Да | Да | Да | Ветвление по значению | | Рандомайзер | Да | Да | Да | A/B-тест по процентам | | Вызов цепочки | Да | Да | Да | Запуск связки из воронки | | AI-обработка | Да | Да | Да | Генерация текста или анализ | | Генерация изображения | Да | Да | Да | AI-картинка (Kandinsky, KIE.AI) | Параметры каждого блока разобраны на странице [Telegram-воронок](https://docs.tuk-tuk.online/funnels/tg-funnels). ## Шаблонные переменные В текстовых полях блоков работают переменные в двойных фигурных скобках. Полный справочник: [Шаблонные переменные](https://docs.tuk-tuk.online/funnels/templates). ### Контекстные: результаты предыдущих блоков | Переменная | Значение | |---|---| | `{{aiResult}}` | Последний результат AI-обработки | | `{{aiResult_N}}` | Результат AI-блока номер N | | `{{imageResult}}` | URL последнего сгенерированного изображения | | `{{imageResult_N}}` | Изображение от блока номер N | | `{{storyResult}}` | ID последней опубликованной Story | | `{{storyResult_N}}` | ID Story от блока номер N | ### Персональные: в блоке «Отправка сообщений» | Переменная | Значение | |---|---| | `{{name}}` | Имя клиента из диалога | | `{{phone}}` | Телефон клиента | | `{{email}}` | Email клиента | ### Шаблоны диалогов Подставляют историю переписок из базы для аналитики и AI-промптов. | Переменная | Значение | |---|---| | `{{dialogs_7d}}` | Все диалоги за 7 дней, лимит 50 | | `{{dialogs_24h}}` | За 24 часа | | `{{dialogs_7d_private}}` | Только личные за 7 дней | | `{{dialogs_7d_groups}}` | Только групповые | | `{{dialogs_7d_channels}}` | Только каналы | | `{{dialogs_7d:100}}` | За 7 дней, лимит 100 | | `{{dialogs_7d_private:200}}` | Личные, лимит 200 | | `{{dialogs_7d_tag:VIP}}` | Только диалоги с тегом VIP | | `{{dialogs_30d_tag:лид:50}}` | Тег «лид» за 30 дней, лимит 50 | | `{{dialogs_7d_tag:VIP,горячий}}` | Несколько тегов одновременно (AND) | ## История запусков Каждый запуск сохраняется с полным логом: - статус: выполняется, завершён, остановлен, ошибка; - прогресс: текущий блок и число выполненных шагов; - лог: запись каждого шага с пометкой типа блока; - контекст: все переменные, результаты AI и URL сгенерированных изображений; - превью сгенерированных изображений прямо в логе. Во время выполнения история обновляется каждые 5 секунд. ## Управление воронками | Действие | Что делает | |---|---| | Запуск | Начать выполнение | | Остановка | Немедленно остановить запущенную воронку | | Вкл / Выкл | Активировать или деактивировать воронку | | Дублировать | Создать копию | | Удалить | Удалить воронку | ## Ограничения | Параметр | Значение | |---|---| | Шагов за один запуск | 200 | | Записей в логе | 200 | | Диалогов в шаблоне `{{dialogs_...}}` | 200 | | Сообщений на диалог | 100 | | Лимит диалогов по умолчанию | 50 | > [!NOTE] Если сервер перезапустился во время выполнения (например, на блоке «Задержка»), воронка продолжит с текущего блока. Незавершённые запуски находятся при старте и доигрываются без потери прогресса. ## Права доступа Воронки используют те же права, что и цепочки. | Право | Что разрешает | |---|---| | `CHAINS_VIEW` | Просмотр воронок | | `CHAINS_CREATE` | Создание | | `CHAINS_EDIT` | Редактирование | | `CHAINS_DELETE` | Удаление | | `CHAINS_TOGGLE` | Включение и выключение | | `CHAINS_EXECUTE` | Запуск | | `CHAINS_LOGS` | Просмотр истории запусков | --- --- title: "Telegram-воронки: Stories, профиль, рассылки | tuk-tuk.online" nav_title: "Telegram" url: https://docs.tuk-tuk.online/funnels/tg-funnels markdown: https://docs.tuk-tuk.online/funnels/tg-funnels.md section: "Воронки историй" description: "Воронки для Telegram-аккаунта в tuk-tuk.online: 13 блоков с параметрами. Публикация и удаление Stories, имя, био, username, аватар, рассылка по диалогам, задержка, условие, рандомайзер, AI." keywords: ["Telegram воронка", "Telegram Stories", "Telegram автоматизация профиля", "Telegram рассылка", "Telegram массовая рассылка", "Telegram Story бот", "Telegram био менеджер", "автопубликация Telegram"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Telegram-воронки tuk-tuk.online выполняют действия от имени подключённого Telegram-аккаунта: публикация и удаление Stories, смена имени, био, username и аватара, рассылка по диалогам, AI-генерация текста и изображений. > > - Раздел кабинета: https://lk.tuk-tuk.online/tg-funnels. Нужен канал «Telegram-аккаунт», бот не подходит. > - 13 блоков: Story, удаление Stories, профиль, username, аватар, удаление аватара, отправка сообщений, задержка, условие, рандомайзер, вызов цепочки, AI-обработка, генерация изображения. > - Операторы условия: equals, not_equals, contains, not_contains, starts_with, ends_with, exists, not_exists, regex. > - Результаты блоков: {{storyResult}}, {{aiResult}}, {{imageResult}}; в рассылке для каждого получателя подставляются {{name}}, {{phone}}, {{email}}. > - Вызов цепочки выполняется синхронно; задержка переживает перезапуск сервера. > - Генерация изображений: провайдеры Kandinsky и KIE.AI. > > Связанные страницы: https://docs.tuk-tuk.online/funnels, https://docs.tuk-tuk.online/funnels/vk-funnels, https://docs.tuk-tuk.online/funnels/ig-funnels, https://docs.tuk-tuk.online/funnels/templates, https://docs.tuk-tuk.online/channels/telegram-account # Telegram-воронки Telegram-воронки работают через подключённый [Telegram-аккаунт](https://docs.tuk-tuk.online/channels/telegram-account) и делают от имени вашего личного аккаунта то, что вы делаете руками: публикуют Stories, меняют аватар и био, пишут клиентам. Всё это по сценарию, одним запуском. ## Требования - Подключённый канал типа «Telegram-аккаунт», не бот. [Как подключить](https://docs.tuk-tuk.online/channels/telegram-account). - При создании воронки выберите нужный аккаунт из списка каналов. ## Типы блоков ![Палитра блоков воронки Telegram](https://docs.tuk-tuk.online/assets/screens/funnels/tg-add-block.webp "Блоки воронки: публикация Story, удаление Stories, статистика, профиль, username, аватар, задержка, условие, рандомайзер, вызов цепочки, AI и отправка сообщений.") Всего 13 блоков. Общие принципы редактора, лимиты и права описаны в [обзоре воронок](https://docs.tuk-tuk.online/funnels). ### Публикация Story Публикует фото или видео в Stories от вашего имени. | Параметр | Что указать | |---|---| | Файл | Фото или видео: загрузка либо результат генерации через `{{imageResult}}` | | Подпись | Текст к Story, поддерживает переменные | | Шаблон изображения | Необязательно: применить шаблон к изображению | Результат сохраняется в `{{storyResult}}` и `{{storyResult_N}}`. ### Удаление Stories | Параметр | Что указать | |---|---| | Режим | Удалить все, конкретные по ID или последнюю | | ID Story | Список ID для режима «конкретные» | ### Обновление профиля | Параметр | Что указать | |---|---| | Имя | Новое имя (first name) | | Фамилия | Новая фамилия (last name) | | Био | Новое описание профиля (bio) | Поля поддерживают переменные: био можно сгенерировать через AI и подставить `{{aiResult}}`. ### Смена username | Параметр | Что указать | |---|---| | Username | Новый username без символа @ | ### Смена аватара | Параметр | Что указать | |---|---| | Файл | Изображение: загрузка или `{{imageResult}}` | | Шаблон | Необязательно: применить шаблон | ### Удаление аватара Удаляет текущее фото профиля. Параметров нет. ### Отправка сообщений Рассылка в выбранные диалоги. | Параметр | Что указать | |---|---| | Получатели | Список ID диалогов, можно выбрать интерактивно | | Текст | Текст сообщения, поддерживает `{{name}}`, `{{phone}}`, `{{email}}` | | Медиа | Тип медиа (фото, видео, документ), URL или файл | Переменные `{{name}}`, `{{phone}}`, `{{email}}` подставляются для каждого получателя отдельно. ### Задержка | Параметр | Что указать | |---|---| | Секунды | Длительность паузы | > [!NOTE] Задержка: реальное ожидание. Если сервер перезапустится, воронка продолжит с этого места. ### Условие Ветвление по значению переменной. | Параметр | Что указать | |---|---| | Поле | Имя переменной из контекста, например `aiResult` | | Условия | Список правил: оператор, значение, ветка | Операторы: `equals`, `not_equals`, `contains`, `not_contains`, `starts_with`, `ends_with`, `exists`, `not_exists`, `regex`. Условий может быть несколько: выполняется первое совпавшее. Если не совпало ни одно, воронка идёт по финальной ветке. ### Рандомайзер Случайное распределение по процентам для A/B-тестов. | Параметр | Что указать | |---|---| | Сценарии | Список вариантов: название и процент, в сумме 100% | ### Вызов цепочки Запускает [связку (chain)](https://docs.tuk-tuk.online/chains) из воронки. | Параметр | Что указать | |---|---| | Цепочка | ID связки | | Идентификатор клиента | Для какого клиента запустить, поддерживает шаблоны | | Передать переменные | Какие переменные передать в цепочку | | Получить обратно | Какие переменные вернуть из цепочки | Цепочка выполняется синхронно: воронка ждёт её завершения. ### AI-обработка Генерация текста или изображения через AI. | Параметр | Что указать | |---|---| | Тип вывода | `text` или `image` | | AI-провайдер | Один из подключённых [провайдеров](https://docs.tuk-tuk.online/ai/providers) | | Промпт | Текст запроса, поддерживает все переменные, включая `{{dialogs_...}}` | | Системный промпт | Инструкция для AI (inline) | | Входные изображения | Фото для анализа (vision) | Результат: `{{aiResult}}` для текста или `{{imageResult}}` для изображения. ### Генерация изображения AI-генерация картинки (Kandinsky, KIE.AI). | Параметр | Что указать | |---|---| | AI-провайдер | Провайдер для генерации | | Промпт | Описание изображения | | Размер | Ширина и высота | | Входное изображение | URL для img2img | | Формат | Формат вывода | ## Примеры сценариев ### AI-генерация Story ```text AI-обработка: «Придумай мотивационную цитату дня» ↓ Генерация изображения: «Создай фон с текстом: {{aiResult}}» ↓ Публикация Story: файл = {{imageResult}} ``` ### A/B-тест профиля ```text Рандомайзер: 50% / 50% ├── A: Обновление профиля, био = «Маркетолог. Помогаю бизнесу расти» └── B: Обновление профиля, био = «Эксперт по продажам. 1000+ клиентов» ``` ### Персональная рассылка ```text AI-обработка: «На основе диалогов {{dialogs_7d_tag:VIP}} подготовь персональное предложение» ↓ Отправка сообщений: «Здравствуйте, {{name}}! {{aiResult}}» ``` --- --- title: "VK-воронки: Stories и контент сообщества ВКонтакте | tuk-tuk.online" nav_title: "VK" url: https://docs.tuk-tuk.online/funnels/vk-funnels markdown: https://docs.tuk-tuk.online/funnels/vk-funnels.md section: "Воронки историй" description: "Воронки для VK-сообщества в tuk-tuk.online: Stories сообщества, название и описание группы, аватар, рассылка подписчикам через личные сообщения, AI-генерация контента. Отличия от Telegram-воронок." keywords: ["VK воронка", "VK Stories", "ВКонтакте автоматизация", "VK рассылка", "VK автопостинг", "VK Story бот", "автоматизация ВКонтакте", "VK массовая рассылка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > VK-воронки tuk-tuk.online выполняют действия от имени VK-сообщества: Stories, название и описание группы, аватар, рассылка подписчикам через личные сообщения, AI-генерация. Набор блоков совпадает с Telegram-воронками. > > - Раздел кабинета: https://lk.tuk-tuk.online/vk-funnels. Нужен канал «VK-сообщество», пользователь должен быть администратором группы. > - 13 блоков, параметры такие же, как в Telegram-воронках; исполнение через VK API. > - Блок «Обновление профиля» меняет название и описание сообщества, «Смена username» меняет адрес группы. > - Рассылка идёт через личные сообщения сообщества. > - Переменные: {{aiResult}}, {{imageResult}}, {{storyResult}}, {{name}}, {{phone}}, {{email}}, {{dialogs_...}}. > > Связанные страницы: https://docs.tuk-tuk.online/funnels, https://docs.tuk-tuk.online/funnels/tg-funnels, https://docs.tuk-tuk.online/funnels/ig-funnels, https://docs.tuk-tuk.online/funnels/templates, https://docs.tuk-tuk.online/channels/vk-community # VK-воронки VK-воронки работают через подключённое [VK-сообщество](https://docs.tuk-tuk.online/channels/vk-community) и действуют от имени группы: публикуют Stories, меняют название и описание, обновляют аватар, генерируют контент и рассылают сообщения подписчикам. ## Требования ![Список воронок VK](https://docs.tuk-tuk.online/assets/screens/funnels/vk-list.webp "Воронки VK управляют историями и стеной сообщества.") - Подключённый канал «VK-сообщество». [Как подключить](https://docs.tuk-tuk.online/channels/vk-community). - Вы администратор сообщества. ## Типы блоков Те же 13 блоков, что и в [Telegram-воронках](https://docs.tuk-tuk.online/funnels/tg-funnels). Отличается только исполнение: действия идут через VK API. | Блок | Что делает | |---|---| | Публикация Story | Фото или видео в Stories сообщества | | Удаление Stories | Удалить все, конкретные или последнюю | | Обновление профиля | Название и описание сообщества | | Смена username | Адрес группы | | Смена аватара | Новое фото сообщества | | Удаление аватара | Удаление фото | | Отправка сообщений | Рассылка подписчикам через личные сообщения группы | | Задержка | Пауза N секунд | | Условие | Ветвление по значению | | Рандомайзер | A/B-тест по процентам | | Вызов цепочки | Запуск связки из воронки | | AI-обработка | Генерация текста или анализ | | Генерация изображения | AI-картинка | Параметры блоков совпадают с Telegram-воронками: [подробное описание](https://docs.tuk-tuk.online/funnels/tg-funnels). ## Отличия от Telegram-воронок | Аспект | Telegram | VK | |---|---|---| | Канал | Telegram-аккаунт | VK-сообщество (группа) | | Story | От личного аккаунта | От сообщества | | Профиль | Имя, фамилия, био | Название, описание группы | | Рассылка | По peer_id или телефону | Через личные сообщения сообщества | ## Шаблонные переменные Работают все [шаблонные переменные](https://docs.tuk-tuk.online/funnels/templates): - контекстные: `{{aiResult}}`, `{{imageResult}}`, `{{storyResult}}`; - персональные в блоке рассылки: `{{name}}`, `{{phone}}`, `{{email}}`; - шаблоны диалогов: `{{dialogs_7d}}`, `{{dialogs_7d_tag:VIP}}`. ## Пример: Story на сутки ```text AI-обработка: «Придумай 3 идеи для Stories фитнес-клуба» ↓ Генерация изображения: «Создай яркий баннер: {{aiResult}}» ↓ Публикация Story: файл = {{imageResult}}, подпись = «Новый день, новые цели» ↓ Задержка: 86400 секунд (24 часа) ↓ Удаление Stories: последняя ``` --- --- title: "Instagram-воронки: посты, Reels, Stories, Direct | tuk-tuk.online" nav_title: "Instagram" url: https://docs.tuk-tuk.online/funnels/ig-funnels markdown: https://docs.tuk-tuk.online/funnels/ig-funnels.md section: "Воронки историй" description: "Воронки для Instagram в tuk-tuk.online: публикация постов, каруселей, Reels и Stories по URL, рассылка в Direct, AI-генерация контента. 11 блоков, требования к аккаунту, чего нет по сравнению с Telegram и VK." keywords: ["Instagram воронка", "Instagram автопостинг", "Instagram Reels автоматизация", "Instagram автоматизация DM", "Instagram карусель", "Instagram Stories автоматизация", "Instagram контент-план", "Instagram AI контент"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Instagram-воронки tuk-tuk.online публикуют посты, карусели, Reels и Stories по публичным URL, рассылают сообщения в Direct и генерируют контент через AI. Единственный тип воронок с публикацией в ленту. > > - Раздел кабинета: https://lk.tuk-tuk.online/ig-funnels. Нужен канал «Instagram DM», бизнес-аккаунт или аккаунт автора и привязанная Facebook-страница. > - 11 блоков: Story, пост, карусель, Reels, отправка сообщений, задержка, условие, рандомайзер, вызов цепочки, AI-обработка, генерация изображения. > - Медиа только по публичному URL, base64 и загрузка файла не поддерживаются. Карусель: от 2 изображений. > - Недоступно: обновление профиля, смена username, смена и удаление аватара, удаление Stories. > - Переменные {{name}}, {{phone}}, {{email}} работают в блоке «Отправка сообщений». > > Связанные страницы: 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/templates, https://docs.tuk-tuk.online/channels/instagram # Instagram-воронки Instagram-воронки работают через подключённый канал [Instagram DM](https://docs.tuk-tuk.online/channels/instagram) и публикуют контент в ленту и Stories, генерируют его через AI и рассылают сообщения в Direct. Это единственный тип воронок с публикацией в ленту: посты, карусели, Reels. Telegram и VK работают только со Stories и профилем. ## Требования ![Список воронок Instagram](https://docs.tuk-tuk.online/assets/screens/funnels/ig-list.webp "Воронки Instagram живут в отдельном разделе и работают с постами, каруселями, Reels и Direct.") - Подключённый канал «Instagram DM». [Как подключить](https://docs.tuk-tuk.online/channels/instagram). - Бизнес-аккаунт или аккаунт автора в Instagram. - Привязанная Facebook-страница. ## Типы блоков Всего 11 блоков. ### Публикация Story | Параметр | Что указать | |---|---| | URL изображения | Публичный URL фото, не base64 | > [!WARNING] В отличие от Telegram и VK, Instagram принимает только URL изображения, загрузка файла не поддерживается. ### Публикация поста | Параметр | Что указать | |---|---| | URL изображения | Публичный URL фото | | Подпись | Текст под постом (caption) | ### Публикация карусели | Параметр | Что указать | |---|---| | URL изображений | Список URL, от 2 фото | | Подпись | Текст под постом | ### Публикация Reels | Параметр | Что указать | |---|---| | URL видео | Публичный URL видеофайла | | Подпись | Текст описания | | URL обложки | Обложка видео, необязательно | ### Отправка сообщений Рассылка в Direct по выбранным диалогам. | Параметр | Что указать | |---|---| | Получатели | Список ID диалогов | | Текст | Текст сообщения, поддерживает `{{name}}`, `{{phone}}`, `{{email}}` | | Медиа | Фото, видео или документ | ### Общие блоки Параметры такие же, как в [Telegram-воронках](https://docs.tuk-tuk.online/funnels/tg-funnels). | Блок | Что делает | |---|---| | Задержка | Пауза N секунд | | Условие | Ветвление по значению переменной | | Рандомайзер | Случайный выбор ветки по процентам | | Вызов цепочки | Запуск [связки](https://docs.tuk-tuk.online/chains) из воронки | | AI-обработка | Генерация текста или изображения | | Генерация изображения | AI-картинка | ## Ограничения Этих блоков в Instagram-воронках нет: Instagram API не поддерживает такие операции. | Функция | Статус | |---|---| | Обновление профиля (имя, био) | Недоступно | | Смена username | Недоступно | | Смена и удаление аватара | Недоступно | | Удаление Stories | Недоступно | ## Примеры сценариев ### Пост с AI-текстом и баннером ```text AI-обработка: «Напиши пост про скидки 20% на всю коллекцию» ↓ Генерация изображения: «Создай баннер для Instagram: СКИДКА 20%, яркие цвета» ↓ Публикация поста: URL = {{imageResult}}, подпись = {{aiResult}} ``` ### Карусель из трёх сгенерированных слайдов ```text Генерация изображения #1: «Слайд 1: проблема клиента» ↓ Генерация изображения #2: «Слайд 2: решение» ↓ Генерация изображения #3: «Слайд 3: призыв к действию» ↓ Карусель: [{{imageResult_1}}, {{imageResult_2}}, {{imageResult_3}}] ``` ### Story и рассылка в Direct через час ```text Публикация Story: баннер «Новая коллекция» ↓ Задержка: 3600 секунд (1 час) ↓ Отправка сообщений: «{{name}}, видели нашу новую коллекцию? Ссылка в био» ``` --- --- 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_<число>[_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}}! Мы подготовили специальное предложение для вас на основе вашего последнего запроса. Подробности по ссылке: ...» ``` --- --- title: "AI-ассистенты для мессенджеров: GPT, Claude, Gemini | tuk-tuk.online" nav_title: "AI-ассистенты" url: https://docs.tuk-tuk.online/ai markdown: https://docs.tuk-tuk.online/ai.md description: "AI-ассистенты tuk-tuk.online отвечают клиентам в каналах через OpenAI, Anthropic Claude, Google Gemini, Mistral и DeepSeek. Провайдеры, инструкции, ассистенты, 9 режимов поведения, статистика токенов." keywords: ["AI ассистент для бизнеса", "ChatGPT бот Telegram", "Claude бот для клиентов", "GPT автоответчик", "AI чат-бот для сайта", "OpenAI интеграция", "Anthropic Claude бот", "умный чат-бот", "нейросеть для бизнеса", "AI для поддержки клиентов", "GPT конструктор", "AI-менеджер продаж"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > AI-ассистенты tuk-tuk.online обрабатывают входящие сообщения в каналах через модели OpenAI, Anthropic, Google Gemini, Mistral и DeepSeek. Ассистент собирается из провайдера (API-ключ), инструкции (промпт) и привязки к каналам с режимом работы. > > - Провайдеры и инструкции: кабинет, раздел «AI-обработка». Ассистенты: раздел «AI-ассистенты». > - 9 режимов поведения: ассистент продаж, запись в календарь, модератор, аналитик, автоответчик, конвертер лидов, транскрибация, генерация изображений, свой режим. > - Режимы ответа: автоответ клиенту или заметка оператору. > - Ассистент работает по рабочим часам и ставится на паузу при ответе оператора. > - Статистика по каждому ассистенту: сообщения, автоответы, токены, ошибки. > > Связанные страницы: https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/ai-proxy # AI-ассистенты AI-ассистент обрабатывает входящие сообщения в подключённых каналах и отвечает клиенту или пишет подсказку оператору. Под капотом большие языковые модели: OpenAI, Anthropic, Google Gemini, Mistral, DeepSeek. Ассистент собирается из трёх частей: провайдер (API-ключ модели), инструкция (промпт) и привязка к каналам с расписанием и режимом работы. ## Из чего состоит | Компонент | Что это | Страница | |---|---|---| | Провайдеры | Подключение API-ключей AI-сервисов | [Провайдеры](https://docs.tuk-tuk.online/ai/providers) | | Инструкции | Промпты, которые задают поведение AI | [Инструкции](https://docs.tuk-tuk.online/ai/instructions) | | Ассистенты | Привязка к каналам, рабочие часы, режим работы, приоритет | [Ассистенты](https://docs.tuk-tuk.online/ai/assistants) | | Режимы поведения | 9 готовых ролей: продавец, модератор, аналитик и другие | [Режимы](https://docs.tuk-tuk.online/ai/modes) | | AI Proxy | Единая точка маршрутизации и защиты AI-запросов | [AI Proxy](https://docs.tuk-tuk.online/ai/ai-proxy) | ## Как запустить ![Раздел «AI-обработка»](https://docs.tuk-tuk.online/assets/screens/ai/overview.webp) 1. Пункт «AI-обработка» в меню. 2. Подключения к нейросетям: OpenAI, Anthropic, Gemini, Mistral, DeepSeek, Kandinsky, KIE.AI. 3. Кнопка «Подключить» на карточке провайдера. 4. Инструменты текста в диалогах: орфография и перефразирование. 5. База знаний для ассистентов. 1. Добавьте [провайдера](https://docs.tuk-tuk.online/ai/providers) в разделе [AI-обработка](https://lk.tuk-tuk.online/ai): например, OpenAI с ключом и моделью. 2. Создайте [инструкцию](https://docs.tuk-tuk.online/ai/instructions): опишите роль и правила поведения AI. 3. Создайте [ассистента](https://docs.tuk-tuk.online/ai/assistants) в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), выберите режим и привяжите к каналу: следующее входящее сообщение в канале обработает AI. ## Режимы поведения | Режим | Что делает | Страница | |---|---|---| | Ассистент продаж | Анализирует диалог, подсказывает менеджеру ответ | [Ассистент продаж](https://docs.tuk-tuk.online/ai/sales-assistant) | | Запись в календарь | Записывает клиента на приём через чат | [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking) | | Модератор | Классифицирует обращения, отмечает спам | [Модератор](https://docs.tuk-tuk.online/ai/moderator) | | Аналитик | Суммаризация, анализ тональности, рекомендации | [Аналитик](https://docs.tuk-tuk.online/ai/analyst) | | Автоответчик | Отвечает клиентам от лица компании 24/7 | [Автоответчик](https://docs.tuk-tuk.online/ai/auto-responder) | | Конвертер лидов | Квалифицирует лиды, подводит к действию | [Конвертер лидов](https://docs.tuk-tuk.online/ai/lead-converter) | | Транскрибация | Расшифровывает голосовые в текст | [Транскрибация](https://docs.tuk-tuk.online/ai/transcription) | | Генерация изображений | Создаёт картинки (Kandinsky, KIE.AI) | [Генерация изображений](https://docs.tuk-tuk.online/ai/image-generation) | | Свой режим | Произвольный промпт: извлечение данных, база знаний | [Свой режим](https://docs.tuk-tuk.online/ai/custom) | Сравнение и выбор режима: [Режимы поведения](https://docs.tuk-tuk.online/ai/modes). ## Что умеет ассистент - Видит всю историю диалога. - Знает имя клиента, канал и теги. - Работает по расписанию (рабочие часы). - Ставится на паузу, когда отвечает оператор. - Пишет рекомендации оператору в режиме заметок. - Ведёт статистику: обработанные сообщения, токены, ошибки. - Может ходить к провайдерам через выделенный [AI Proxy](https://docs.tuk-tuk.online/ai/ai-proxy). --- --- title: "Провайдеры AI: OpenAI, Claude, Gemini, Mistral, DeepSeek | tuk-tuk.online" nav_title: "Провайдеры" url: https://docs.tuk-tuk.online/ai/providers markdown: https://docs.tuk-tuk.online/ai/providers.md section: "AI-ассистенты" description: "Как подключить AI-провайдера в tuk-tuk.online: OpenAI GPT-4o, Anthropic Claude 3.5 Sonnet, Google Gemini, Mistral, DeepSeek. Где взять API-ключ у каждого сервиса и чем провайдеры отличаются." keywords: ["OpenAI GPT-4 подключение", "API ключ GPT-4", "Anthropic Claude API", "Google Gemini Pro", "Mistral AI ключ", "DeepSeek API", "AI провайдер для бота", "ChatGPT API настройка", "Claude API ключ", "нейросеть подключить"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Провайдер AI в tuk-tuk.online: подключённый сервис языковых моделей с API-ключом пользователя. Поддерживаются OpenAI, Anthropic, Google Gemini, Mistral и DeepSeek; провайдер выбирается при создании ассистента. > > - Где: кабинет, «AI-обработка», раздел «Провайдеры», кнопка «Добавить провайдера». > - При подключении задаются провайдер, API-ключ и модель (например, gpt-4o). > - Модели: GPT-4o/GPT-4/GPT-3.5 Turbo; Claude 3.5 Sonnet, Claude 3 Opus/Haiku; Gemini Pro, Gemini 1.5; Mistral Large/Medium/Small; DeepSeek Chat/Coder. > - Ключи выдают platform.openai.com, console.anthropic.com, ai.google.dev, console.mistral.ai, platform.deepseek.com. > - Транскрибация требует OpenAI или Gemini; генерация изображений использует отдельных провайдеров Kandinsky и KIE.AI. > > Связанные страницы: https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/ai-proxy, https://docs.tuk-tuk.online/ai/transcription # Провайдеры AI Провайдер: подключённый сервис языковых моделей с вашим API-ключом. Без провайдера ассистент не может отправить ни одного запроса. tuk-tuk.online поддерживает 5 провайдеров, у одного проекта их может быть несколько. ## Поддерживаемые провайдеры | Провайдер | Модели | Сайт | |---|---|---| | OpenAI | GPT-4o, GPT-4, GPT-3.5 Turbo | [platform.openai.com](https://platform.openai.com) | | Anthropic | Claude 3.5 Sonnet, Claude 3 Opus/Haiku | [console.anthropic.com](https://console.anthropic.com) | | Google Gemini | Gemini Pro, Gemini 1.5 | [ai.google.dev](https://ai.google.dev) | | Mistral | Mistral Large, Medium, Small | [console.mistral.ai](https://console.mistral.ai) | | DeepSeek | DeepSeek Chat, DeepSeek Coder | [platform.deepseek.com](https://platform.deepseek.com) | ## Как подключить ![Форма подключения провайдера](https://docs.tuk-tuk.online/assets/screens/ai/provider-form.webp) 1. Название подключения. 2. API-ключ провайдера. 3. Модель по умолчанию. 4. Кнопка «Подключить». 1. Откройте [AI-обработку](https://lk.tuk-tuk.online/ai) в кабинете. 2. В разделе «Провайдеры» нажмите «Добавить провайдера»: откроется форма. 3. Выберите провайдера из списка. 4. Вставьте API-ключ. 5. Укажите модель, например `gpt-4o`. 6. Нажмите «Сохранить»: провайдер появится в списке и станет доступен при создании ассистента. ## Где взять API-ключ ### OpenAI 1. Откройте [platform.openai.com/api-keys](https://platform.openai.com/api-keys). 2. Нажмите «Create new secret key». 3. Скопируйте ключ: он начинается с `sk-`. ### Anthropic 1. Откройте [console.anthropic.com](https://console.anthropic.com). 2. Перейдите в Settings, затем API Keys. 3. Создайте новый ключ и скопируйте его. ### Google Gemini 1. Откройте [ai.google.dev](https://ai.google.dev). 2. Нажмите «Get API Key». 3. Создайте ключ в Google AI Studio и скопируйте его. ### Mistral 1. Откройте [console.mistral.ai](https://console.mistral.ai). 2. Перейдите в API Keys. 3. Создайте новый ключ и скопируйте его. ### DeepSeek 1. Откройте [platform.deepseek.com](https://platform.deepseek.com). 2. Создайте API-ключ в разделе API и скопируйте его. > [!WARNING] Ключ показывается один раз при создании. Храните его в кабинете tuk-tuk.online и не публикуйте в открытых чатах. ## Сравнение провайдеров | Критерий | OpenAI | Anthropic | Gemini | Mistral | DeepSeek | |---|---|---|---|---|---| | Качество | 5/5 | 5/5 | 4/5 | 4/5 | 3/5 | | Скорость | Высокая | Средняя | Высокая | Высокая | Высокая | | Цена | Средняя | Высокая | Низкая | Низкая | Очень низкая | | Русский язык | Отлично | Хорошо | Хорошо | Средне | Средне | ## Что дальше - Для [транскрибации](https://docs.tuk-tuk.online/ai/transcription) нужен OpenAI (Whisper) или Google Gemini. - Для [генерации изображений](https://docs.tuk-tuk.online/ai/image-generation) подключаются отдельные провайдеры Kandinsky и KIE.AI. - Если бэкенд ходит к провайдерам через [AI Proxy](https://docs.tuk-tuk.online/ai/ai-proxy), ключи всё равно задаются здесь. --- --- title: "Инструкции и промпты AI-ассистента: конструктор, сниппеты | tuk-tuk.online" nav_title: "Инструкции и промпты" url: https://docs.tuk-tuk.online/ai/instructions markdown: https://docs.tuk-tuk.online/ai/instructions.md section: "AI-ассистенты" description: "Инструкция задаёт поведение AI-ассистента tuk-tuk.online: системный промпт, визуальный конструктор по роли и тону, сниппеты с данными компании, готовые шаблоны. Лимит 30 000 символов." keywords: ["промпт для чат-бота", "инструкция AI ассистента", "системный промпт ChatGPT", "конструктор промптов", "шаблон промпта для бота", "роль AI-ассистента", "промпт продавец", "промпт для поддержки", "настройка GPT бота", "сниппеты промптов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Инструкция в tuk-tuk.online: системный промпт AI-ассистента (роль, тон, задачи, запреты). Создаётся вручную, через визуальный конструктор или из шаблона; данные компании выносятся в сниппеты. > > - Где: кабинет, «AI-обработка», раздел «Инструкции», кнопка «Новая инструкция». > - Лимит: 30 000 символов на инструкцию и на кастомный промпт в диалоге. > - Конструктор собирает промпт по роли, контексту, тону и ограничениям. > - Сниппеты вставляются в инструкцию кнопкой «Вставить файл», у каждого есть счётчик символов. > - Шаблоны: продавец, запись на приём, техподдержка, приветствие. > > Связанные страницы: https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/knowledge-base, https://docs.tuk-tuk.online/ai/custom # Инструкции и промпты Инструкция: системный промпт, который задаёт поведение AI-ассистента. Она отвечает на четыре вопроса: кто ты (роль, имя, компания), как общаться (тон, стиль, язык), что делать (задачи) и чего не делать (запреты). Инструкцию можно написать вручную, собрать в визуальном конструкторе или взять из шаблона. Данные компании выносятся в сниппеты и подставляются в любую инструкцию. ## Как создать ![Создание AI-инструкции](https://docs.tuk-tuk.online/assets/screens/ai/instruction-form.webp) 1. Тип поведения: продажи, запись в календарь, модератор, аналитик, автоответчик, конвертер лидов, свой режим, транскрибация. 2. Название инструкции. 3. Провайдер и его ключ. 4. Системная инструкция: главный текст промпта. 5. Шаблон пользовательского сообщения, {{message}} подставит текст клиента. 6. Модель, если нужно переопределить модель провайдера. 7. Задержка ответа: нижняя граница в секундах. 8. Задержка ответа: верхняя граница. 9. Кнопка «Создать». 1. Откройте [AI-обработку](https://lk.tuk-tuk.online/ai) в кабинете. 2. В разделе «Инструкции» нажмите «Новая инструкция»: откроется текстовое поле. 3. Опишите поведение AI и сохраните: инструкция станет доступна при создании ассистента. ### Пример промпта ```text Ты менеджер интернет-магазина «МегаШоп». Твоя задача: помогать клиентам с выбором товара и оформлением заказа. Правила: - Обращайся к клиенту по имени - Будь вежлив и дружелюбен - При вопросах о доставке направляй на страницу FAQ - Никогда не обсуждай конкурентов - Отвечай на русском языке ``` ## Конструктор промптов Если писать промпт вручную не хочется, есть визуальный конструктор. 1. Выберите роль AI: продавец, модератор, аналитик и другие. 2. Укажите контекст: компания, продукты, услуги. 3. Задайте тон общения: официальный, дружелюбный, нейтральный. 4. Добавьте ограничения: что AI не должен обсуждать. 5. Конструктор соберёт промпт: его можно доработать вручную. ## Сниппеты Сниппет: переиспользуемый фрагмент текста для промптов. Обычно это описание компании, список товаров и услуг, FAQ, правила общения. Сниппеты создаются в разделе «AI-обработка» и вставляются в любую инструкцию кнопкой «Вставить файл». У каждого сниппета есть счётчик символов. Как построить на сниппетах базу знаний: [Ответы по базе знаний](https://docs.tuk-tuk.online/ai/knowledge-base). ## Шаблоны Готовые инструкции для типовых сценариев: | Шаблон | Для чего | |---|---| | Продавец | Консультирование и продажи | | Запись на приём | Бронирование через календарь | | Техподдержка | Ответы на технические вопросы | | Приветствие | Первичная обработка новых клиентов | ## Ограничения | Параметр | Значение | |---|---| | Максимальная длина инструкции | 30 000 символов | | Максимальная длина кастомного промпта в диалоге | 30 000 символов | > [!NOTE] 30 000 символов: примерно 15–20 страниц текста. Если нужно больше, разбейте контент на сниппеты и используйте несколько ассистентов. --- --- title: "Настройка AI-ассистента: каналы, рабочие часы, приоритет | tuk-tuk.online" nav_title: "Настройка ассистента" url: https://docs.tuk-tuk.online/ai/assistants markdown: https://docs.tuk-tuk.online/ai/assistants.md section: "AI-ассистенты" description: "Как создать AI-ассистента в tuk-tuk.online: провайдер, инструкция, каналы, режим автоответа или заметки, рабочие часы, приоритет, пауза при ответе оператора и статистика токенов." keywords: ["настройка AI ассистента", "привязка бота к каналу", "рабочие часы чат-бота", "автоответчик 24/7", "AI аналитика расхода", "приоритет ассистента", "ночной режим бота", "AI для Telegram", "AI для чат-виджета", "стоимость AI-бота"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > AI-ассистент в tuk-tuk.online связывает провайдера, инструкцию и каналы. Настраиваются режим (автоответ клиенту или заметка оператору), рабочие часы, приоритет и пауза при ответе оператора; по каждому ассистенту ведётся статистика. > > - Где: кабинет, раздел «AI-ассистенты», кнопка «Создать ассистента». > - Параметры: название, провайдер, инструкция, каналы, режим (автоответ / заметка), рабочие часы HH:MM, приоритет. > - При нескольких ассистентах на канале обрабатывает тот, у кого приоритет выше. > - Пауза при ответе оператора настраивается; после её окончания ассистент снова активен. > - Метрики: обработано сообщений, автоответов отправлено, среднее время обработки, ошибки, токены. > > Связанные страницы: https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/channels # Настройка ассистентов Ассистент связывает [провайдера](https://docs.tuk-tuk.online/ai/providers), [инструкцию](https://docs.tuk-tuk.online/ai/instructions) и каналы. В его настройках задаются режим работы (ответ клиенту или заметка оператору), рабочие часы, приоритет и пауза при ответе оператора. ## Как создать ![Раздел «AI-ассистенты»](https://docs.tuk-tuk.online/assets/screens/ai/assistants.webp) 1. Пункт «AI-ассистенты» в меню. 2. Создать ассистента. 3. Фильтр по режиму поведения. 4. Включить или выключить, изменить, удалить ассистента. 5. Пауза для всех ассистентов сразу. ![Форма нового ассистента](https://docs.tuk-tuk.online/assets/screens/ai/assistant-form.webp) 1. Название ассистента. 2. Тип: режим поведения. 3. AI-инструкция, можно создать прямо отсюда. 4. Длительность паузы после ответа оператора. 5. Начало рабочего окна ассистента. 6. Конец рабочего окна. 7. Приоритет, если ассистентов несколько. 8. Кнопка «Создать». 1. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) в кабинете. 2. Нажмите «Создать ассистента»: откроется форма. 3. Заполните параметры из таблиц ниже. 4. Сохраните: ассистент начнёт обрабатывать входящие сообщения выбранных каналов. ### Основные параметры | Параметр | Что задаёт | |---|---| | Название | Имя ассистента для списка в кабинете | | Провайдер | Какой AI-сервис использовать | | Инструкция | Промпт поведения | | Каналы | К каким каналам привязать | ### Режим работы ![Редактирование ассистента](https://docs.tuk-tuk.online/assets/screens/ai/assistant-edit.webp "В карточке ассистента настраиваются автоответ, ответ как примечание, пауза при ответе оператора, расписание и приоритет.") | Режим | Что происходит | |---|---| | Автоответ | AI отвечает клиенту автоматически | | Заметка | AI пишет рекомендацию оператору, клиент её не видит | ### Расписание Рабочие часы задаются как интервал с HH:MM по HH:MM. Вне интервала ассистент не обрабатывает сообщения. ### Приоритет Если к каналу привязано несколько ассистентов, сообщение обрабатывает тот, у кого приоритет выше. У [готовых режимов](https://docs.tuk-tuk.online/ai/modes) есть приоритеты по умолчанию. ## Пауза при ответе оператора Когда оператор отвечает в диалоге, ассистент ставится на паузу. Длительность паузы настраивается; после её окончания ассистент снова активен. Значения по умолчанию зависят от режима: например, 4 часа у автоответчика и 2 часа у ассистента продаж. ## Статистика По каждому ассистенту доступны метрики: | Метрика | Что показывает | |---|---| | Обработано сообщений | Сколько сообщений прошло через AI | | Автоответов отправлено | Сколько сообщений AI отправил клиентам | | Среднее время обработки | Скорость ответа | | Ошибки | Количество сбоев | | Использовано токенов | Расход токенов провайдера | ## Рекомендации - Начните с одного ассистента на канал. - Первые дни держите режим «Заметка» и читайте, что предлагает AI. - Настройте рабочие часы так, чтобы AI закрывал нерабочее время. - Регулярно смотрите расход токенов в статистике. > [!TIP] Модератор и транскрибация работают параллельно с другими ассистентами, их можно добавить на тот же канал, что и автоответчик. ## Ограничения - Ассистент работает только в заданные рабочие часы. - На паузе после ответа оператора ассистент не отвечает до истечения интервала. - Без подключённого провайдера с рабочим ключом ассистент не запускается. --- --- title: "Режимы поведения AI-ассистента: 9 готовых ролей | tuk-tuk.online" nav_title: "Режимы поведения" url: https://docs.tuk-tuk.online/ai/modes markdown: https://docs.tuk-tuk.online/ai/modes.md section: "AI-ассистенты" description: "Обзор режимов AI-ассистентов tuk-tuk.online: ассистент продаж, запись в календарь, модератор, аналитик, автоответчик, конвертер лидов, транскрибация, генерация изображений, свой режим. Как выбрать роль и совместить несколько на одном канале." keywords: ["режимы AI ассистента", "роли чат-бота", "AI для продаж", "AI модератор", "AI аналитик", "автоответчик бот", "транскрибация голосовых", "генерация изображений AI", "классификация обращений", "суммаризация диалогов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим определяет роль AI-ассистента tuk-tuk.online: 9 готовых ролей (ассистент продаж, запись в календарь, модератор, аналитик, автоответчик, конвертер лидов, транскрибация, генерация изображений, свой режим). Режим выбирается при создании ассистента и подставляет готовый промпт и настройки по умолчанию. > > - Где: кабинет, раздел «AI-ассистенты», кнопка «Создать ассистента», поле «Режим». > - Режим подставляет готовый промпт; его можно редактировать. > - К одному каналу можно привязать несколько ассистентов с разными режимами; порядок задаёт приоритет. > - Извлечение данных и ответы по базе знаний строятся на режиме «Свой» с собственным промптом. > - Генерация изображений работает через блок AI Process в цепочках, провайдеры Kandinsky и KIE.AI. > > Связанные страницы: https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/custom # Режимы поведения AI Режим задаёт роль AI-ассистента: что он делает с входящим сообщением и кому адресован результат, клиенту или оператору. Режим выбирается при создании ассистента и подставляет готовый промпт вместе с настройками по умолчанию. Дальше промпт и параметры можно менять под свой бизнес. ## Доступные режимы | Режим | Что делает | Страница | |---|---|---| | Ассистент продаж | Анализирует диалог и подсказывает менеджеру, как закрыть сделку | [Ассистент продаж](https://docs.tuk-tuk.online/ai/sales-assistant) | | Запись в календарь | Записывает клиента на приём через чат | [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking) | | Модератор | Классифицирует обращения, отмечает спам и токсичность | [Модератор](https://docs.tuk-tuk.online/ai/moderator) | | Аналитик | Суммаризирует диалог, оценивает тональность, даёт рекомендации | [Аналитик](https://docs.tuk-tuk.online/ai/analyst) | | Автоответчик | Отвечает клиентам от лица компании, в том числе в нерабочее время | [Автоответчик](https://docs.tuk-tuk.online/ai/auto-responder) | | Конвертер лидов | Квалифицирует лиды и подводит к целевому действию | [Конвертер лидов](https://docs.tuk-tuk.online/ai/lead-converter) | | Транскрибация | Расшифровывает голосовые сообщения в текст | [Транскрибация](https://docs.tuk-tuk.online/ai/transcription) | | Генерация изображений | Создаёт картинки по текстовому описанию (Kandinsky, KIE.AI) | [Генерация изображений](https://docs.tuk-tuk.online/ai/image-generation) | | Свой режим | Промпт с нуля, любая логика | [Свой режим](https://docs.tuk-tuk.online/ai/custom) | ## Какую задачу решает каждый режим | Задача | Режим | Страница | |---|---|---| | Отвечать клиенту от лица компании | Автоответчик | [Автоответчик](https://docs.tuk-tuk.online/ai/auto-responder) | | Классифицировать обращения: спам, тональность, срочность, категория | Модератор | [Модератор](https://docs.tuk-tuk.online/ai/moderator) | | Извлекать из сообщения имя, телефон, номер заказа, тип запроса | Свой режим | [Извлечение данных](https://docs.tuk-tuk.online/ai/data-extraction) | | Отвечать по базе знаний: FAQ, прайс-лист, каталог, условия | Свой режим | [База знаний](https://docs.tuk-tuk.online/ai/knowledge-base) | | Суммаризировать длинную переписку | Аналитик | [Аналитик](https://docs.tuk-tuk.online/ai/analyst) | | Оценивать эмоции клиента и риск ухода | Аналитик, Модератор | [Аналитик](https://docs.tuk-tuk.online/ai/analyst) | | Расшифровывать аудио и видео в текст | Транскрибация | [Транскрибация](https://docs.tuk-tuk.online/ai/transcription) | | Генерировать изображения по описанию | Генерация изображений | [Генерация изображений](https://docs.tuk-tuk.online/ai/image-generation) | ## Какой режим выбрать Отталкивайтесь от того, что должен делать AI. | Нужно | Режим | |---|---| | Отвечать клиентам, когда менеджера нет | Автоответчик | | Подсказывать менеджеру, что ответить | Ассистент продаж | | Записывать клиентов на приём | Запись в календарь | | Квалифицировать заявки и подводить к покупке | Конвертер лидов | | Отсеивать спам и определять срочность | Модератор | | Получить разбор диалога | Аналитик | | Расшифровывать голосовые | Транскрибация | | Генерировать картинки | Генерация изображений | | Извлекать данные из текста | [Извлечение данных](https://docs.tuk-tuk.online/ai/data-extraction) (свой режим) | | Отвечать из FAQ или базы знаний | [База знаний](https://docs.tuk-tuk.online/ai/knowledge-base) (свой режим) | | Что-то другое | Свой режим | ## Несколько режимов на одном канале К одному каналу можно привязать несколько ассистентов с разными режимами. Типичная связка: - Модератор классифицирует сообщение и пишет заметку оператору. - Автоответчик отвечает клиенту. - Транскрибация параллельно расшифровывает голосовые. Порядок обработки задаёт [приоритет ассистента](https://docs.tuk-tuk.online/ai/assistants). ## Как создать ассистента с нужным режимом 1. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) в кабинете. 2. Нажмите «Создать ассистента»: откроется форма. 3. Выберите режим из списка: в поле инструкции появится готовый промпт режима. 4. Привяжите ассистента к нужным каналам. 5. Сохраните: ассистент начнёт обрабатывать входящие сообщения выбранных каналов. > [!TIP] Готовый промпт режима можно править. Режим задаёт отправную точку и настройки по умолчанию, остальное настраивается под ваш бизнес. --- --- title: "AI-ассистент продаж: подсказки менеджеру по диалогу | tuk-tuk.online" nav_title: "Ассистент продаж" url: https://docs.tuk-tuk.online/ai/sales-assistant markdown: https://docs.tuk-tuk.online/ai/sales-assistant.md section: "AI-ассистенты" description: "Режим «Ассистент продаж» читает переписку, определяет стадию воронки и возражения клиента и пишет менеджеру готовый ответ. Работает как подсказка, клиенту ничего не отправляет." keywords: ["AI ассистент продаж", "GPT для продаж", "AI менеджер продаж", "автоматизация продаж AI", "ChatGPT для менеджера", "AI анализ возражений", "SPIN продажи бот", "воронка продаж AI", "подсказки для менеджера", "AI помощник продавца"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Ассистент продаж» анализирует переписку и пишет менеджеру заметку: стадия воронки, возражение, тактика, готовый ответ и следующий шаг. Клиенту ничего не отправляет. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Ассистент продаж». > - По умолчанию автоответ выключен, результат приходит как заметка оператору. > - Пауза при ответе оператора: 2 часа. Приоритет: 120. > - 5 стадий воронки: осведомлённость, интерес, оценка, решение, действие. > - 5 типов возражений: ценовое, временное, доверие, полномочия, потребность. > - Не выдумывает цены, сроки и гарантии; при запросе вне компетенции рекомендует эскалацию. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/lead-converter, https://docs.tuk-tuk.online/ai/analyst, https://docs.tuk-tuk.online/ai/instructions # AI-ассистент продаж Режим «Ассистент продаж» читает переписку с клиентом и пишет менеджеру подсказку: на какой стадии клиент, какое у него возражение, какой тактикой ответить и что написать. Клиент подсказку не видит, менеджер сам решает, отправлять текст или нет. ## Когда включать - Менеджеры отвечают сами, но нужна помощь с формулировками и работой с возражениями. - Хотите видеть стадию воронки по каждому диалогу без ручного разбора. - Внедряете AI осторожно: сначала подсказки, потом автоответы. ## Что делает - Определяет стадию воронки: клиент только узнал, сравнивает или готов купить. - Находит возражения, в том числе скрытые: «дорого», «надо подумать», «у конкурента дешевле». - Подбирает тактику продаж под ситуацию. - Пишет готовый ответ, который менеджер может скопировать и отправить. - Предлагает следующий шаг: позвонить, отправить КП, назначить встречу. ## Как выглядит подсказка AI отвечает структурированной заметкой в диалоге: ```text Разбор: - Стадия клиента: Оценка, сравнивает с конкурентами - Возражения: ценовое («у конкурентов дешевле») - Тактика: социальное доказательство + уникальное преимущество Рекомендованный ответ: Понимаю, что цена важна. Наши клиенты, например «Студия Лайт», выбрали нас именно потому что [преимущество]. За 3 месяца окупаемость составила 200%. Хотите, подготовлю расчёт под вашу ситуацию? Следующий шаг: подготовить персональный расчёт окупаемости ``` ## Стадии воронки AI относит клиента к одной из 5 стадий. | Стадия | Что делает клиент | Тактика AI | |---|---|---| | Осведомлённость | Только узнал, задаёт общие вопросы | Образовательный контент, ключевая выгода | | Интерес | Изучает детали, сравнивает | Фокус на преимуществах, квалифицирующий вопрос | | Оценка | Запрашивает конкретику: цены, сроки | Факты, кейсы, социальные доказательства | | Решение | Торгуется, обсуждает условия | Закрытие возражений, альтернативное предложение | | Действие | Готов к сделке | Чёткий призыв к действию: дата, время, ссылка на оплату | ## Техники продаж | Техника | Как работает | |---|---| | SPIN | Ситуация, проблема, извлечение, направление | | Альтернативное закрытие | «В понедельник или среду?» вместо «Готовы?» | | Микро-обязательство | Маленький шаг вместо большого решения | | Метод «Мост» | Связывает потребность клиента с функцией продукта | | Чувство срочности | Дедлайн или ограниченность, только реальные | ## Типы возражений | Тип | Примеры фраз клиента | |---|---| | Ценовое | «Дорого», «бюджет ограничен», «у конкурентов дешевле» | | Временное | «Потом», «не сейчас», «надо подумать» | | Доверие | «А если не сработает?», «есть отзывы?» | | Полномочия | «Надо согласовать с руководством» | | Потребность | «Не уверен, что это мне нужно» | ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Выключен: пишет рекомендацию, клиенту не отправляет | | Пауза при ответе оператора | 2 часа | | Приоритет | 120 | Настройки задаются при создании ассистента в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), подробнее в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). > [!TIP] Режим подсказки безопасен для старта: менеджер видит рекомендацию и сам решает, отправлять ли её клиенту. ## Ограничения 1. Не выдумывает цены, скидки, акции, сроки и гарантии. Если данных нет, предлагает уточнить. 2. Не манипулирует: без давления, стыда и ложной срочности. 3. Не обещает того, что компания не может выполнить. 4. При негативе сначала понимание, потом решение, потом продажа. 5. Если запрос вне компетенции, рекомендует передать специалисту. --- --- title: "AI-запись в календарь: запись клиентов через чат | tuk-tuk.online" nav_title: "Запись в календарь" url: https://docs.tuk-tuk.online/ai/calendar-booking markdown: https://docs.tuk-tuk.online/ai/calendar-booking.md section: "AI-ассистенты" description: "Режим «Запись в календарь» собирает услугу, дату, время, имя и телефон, предлагает слоты и подтверждает запись прямо в мессенджере. С Google Calendar и YClients видит реальное расписание." keywords: ["AI запись на приём", "бот записи клиентов", "автозапись через мессенджер", "запись в календарь чат-бот", "AI booking bot", "бот для салона красоты", "запись через Telegram", "бот расписание", "автоматическая запись"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Запись в календарь» записывает клиента на приём через чат: собирает услугу, дату, время, имя и телефон, предлагает 2–3 слота и подтверждает запись. С интеграциями Google Calendar и YClients опирается на реальное расписание. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Запись в календарь». > - По умолчанию автоответ включен, пауза при ответе оператора 4 часа, приоритет 80. > - Собирает не больше 1–2 параметров за сообщение, задаёт не больше 2 вопросов. > - Без интеграции данные передаются администратору для ручной записи. > - С Google Calendar создаёт события; с YClients видит расписание мастеров и услуги. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/integrations/google-calendar, https://docs.tuk-tuk.online/integrations/yclients, https://docs.tuk-tuk.online/calendar/events # AI-запись в календарь Режим «Запись в календарь» ведёт клиента от первого сообщения до подтверждённой записи: уточняет услугу, предлагает свободное время, собирает имя и телефон и фиксирует результат. Оператор в переписке не участвует. Пример: клиент пишет «Хочу записаться на стрижку в субботу». AI отвечает: «Свободны 10:00, 14:00 и 16:30. Какое время удобно?» Клиент выбирает, запись готова. ## Когда включать - Клиенты записываются через мессенджер, а администратор не успевает отвечать. - Нужна запись в нерабочее время без участия человека. - Подключены [Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar) или [YClients](https://docs.tuk-tuk.online/integrations/yclients), и AI должен опираться на реальное расписание. ## Как проходит запись AI ведёт клиента через 4 фазы. ### Сбор данных AI собирает по 1–2 параметра за сообщение: - Услуга: что именно нужно. - Дата: конкретный день или период. - Время: утро, день, вечер или точный час. - Имя: если неизвестно из контекста. - Телефон: для подтверждения. Если клиент сразу написал «Стрижка в субботу утром, Иван, +7...», AI не переспрашивает. ### Предложение слотов - Предлагает 2–3 конкретных слота: «Суббота, 15 марта, 10:00 / 14:00 / 16:30». - Если нужного времени нет, предлагает ближайшие альтернативы. - Всегда даёт выбор, одно время не навязывает. ### Подтверждение ```text Запись подтверждена: Услуга: Мужская стрижка Дата: Суббота, 15 марта Время: 14:00 Имя: Иван Телефон: +7 (999) 123-45-67 ``` ### После записи - Напоминает о подготовке к визиту: документы, адрес. - Предлагает добавить напоминание. - Объясняет политику отмены и переноса. ## Нестандартные ситуации | Ситуация | Что делает AI | |---|---| | Клиент хочет перенести | Уточняет новое время, подтверждает перенос | | Клиент хочет отменить | Принимает отмену, уточняет причину, предлагает другое время | | Записывают нескольких человек | Уточняет количество и имена | | Не знает, какую услугу выбрать | Кратко описывает варианты, помогает выбрать | | Спрашивает цену | Даёт цену из контекста или направляет к менеджеру | ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Включен: общается с клиентом напрямую | | Пауза при ответе оператора | 4 часа | | Приоритет | 80 | Ассистент создаётся в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), параметры описаны в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). ## Интеграции с расписанием | Интеграция | Что даёт | |---|---| | [Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar) | AI видит реальные свободные слоты и создаёт события | | [YClients](https://docs.tuk-tuk.online/integrations/yclients) | AI видит расписание мастеров, услуги и свободное время | > [!NOTE] Без интеграции AI собирает данные и передаёт администратору, запись создаётся вручную. ## Ограничения 1. Не выдумывает слоты: если расписание не передано, отвечает «уточню». 2. Не больше 2 вопросов за сообщение. 3. Подтверждает детали перед финализацией записи. 4. Не даёт медицинских и юридических консультаций. 5. При конфликте переводит на живого оператора. --- --- title: "AI-модератор: классификация обращений и фильтр спама | tuk-tuk.online" nav_title: "Модератор" url: https://docs.tuk-tuk.online/ai/moderator markdown: https://docs.tuk-tuk.online/ai/moderator.md section: "AI-ассистенты" description: "Режим «Модератор» оценивает каждое входящее сообщение по 7 параметрам: спам, токсичность, мат, тональность, категория, срочность, эскалация. Вердикт приходит оператору заметкой." keywords: ["AI модератор", "классификация обращений", "фильтрация спама бот", "определение тональности", "анализ токсичности", "эскалация оператору", "AI классификатор", "модерация чата", "антиспам бот", "определение срочности"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Модератор» классифицирует каждое входящее сообщение по 7 параметрам (спам, токсичность 0–3, мат, тональность, категория, срочность, эскалация) и пишет вердикт оператору заметкой. Клиенту ничего не отправляет. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Модератор». > - По умолчанию: результат заметкой, без паузы при ответе оператора, приоритет 60. > - Категории: вопрос, жалоба, благодарность, запрос действия, оффтоп, спам. > - Срочность: низкая, средняя, высокая, критическая. > - Эскалация рекомендуется при токсичности 2+, критической срочности, юридической претензии, запросе возврата, просьбе позвать оператора. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/auto-responder, https://docs.tuk-tuk.online/ai/analyst, https://docs.tuk-tuk.online/dialogs/priorities # AI-модератор Режим «Модератор» разбирает каждое входящее сообщение и выносит вердикт: спам или нет, токсичное или нет, насколько срочное, нужен ли оператор. Вердикт приходит менеджеру заметкой, клиент его не видит. ## Когда включать - Много входящих: нужна сортировка по срочности. - Открытые каналы, куда приходит спам. - Нужно видеть тональность и быстро находить недовольных клиентов. - Критичные обращения должны эскалироваться автоматически. ## Что анализирует Модератор оценивает каждое сообщение по 7 параметрам. ### Спам (да / нет) Спамом считаются: - массовая рассылка, реклама чужих услуг; - фишинговые и подозрительные ссылки; - крипто-мошеннические схемы; - шаблонный текст без привязки к контексту. Не спам: вопросы о продукте, жалобы, повторные обращения. ### Токсичность (0–3) | Уровень | Что это | Пример | |---|---|---| | 0 | Нейтрально или позитивно | «Здравствуйте, подскажите цену» | | 1 | Лёгкое раздражение | «Ну сколько можно ждать?» | | 2 | Прямые оскорбления | «Ваш сервис полный отстой!» | | 3 | Угрозы, агрессия | Угрозы, дискриминация, буллинг | ### Нецензурная лексика (да / нет) Распознаёт прямой мат, замаскированный (б\*\*\*\*, х\*й) и транслитерированный. ### Тональность | Тональность | Когда | |---|---| | Позитивная | Благодарность, удовлетворённость | | Нейтральная | Информационный запрос, констатация факта | | Негативная | Жалоба, недовольство | | Смешанная | «Спасибо, но вообще-то это безобразие» | ### Категория сообщения - Вопрос: клиент запрашивает информацию. - Жалоба: выражает недовольство. - Благодарность: положительный отзыв. - Запрос действия: записаться, купить, вернуть. - Оффтоп: не относится к бизнесу. - Спам: нежелательное сообщение. ### Срочность | Уровень | Когда | Время реакции | |---|---|---| | Низкая | Общий вопрос | В рабочее время | | Средняя | Клиент ожидает ответ | В течение часов | | Высокая | Жалоба, проблема с заказом | Как можно скорее | | Критическая | Угроза ухода, юридическая претензия | Немедленно | ### Эскалация оператору (да / нет) AI рекомендует эскалацию, если: - токсичность 2 и выше; - критическая срочность; - юридическая претензия или угроза суда; - запрос возврата средств; - клиент просит живого оператора; - вопрос требует доступа к внутренним системам. ## Пример вердикта ```text Спам: нет Токсичность: 1 Нецензурная лексика: нет Тональность: негативная Категория: жалоба Срочность: высокая Эскалация: да, клиент угрожает уходом к конкурентам Рекомендация: срочно подключить менеджера, предложить компенсацию ``` ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Включен, но результат пишется заметкой, не сообщением клиенту | | Режим | Заметка: клиент вердикт не видит | | Пауза при ответе оператора | Нет, анализирует всегда | | Приоритет | 60, обрабатывает одним из первых | Ассистент создаётся в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), параметры описаны в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). > [!NOTE] Модератор работает тихо: менеджер видит классификацию, клиент о модерации не знает. Его удобно ставить в паре с [автоответчиком](https://docs.tuk-tuk.online/ai/auto-responder) на одном канале. ## Ограничения - Модератор только классифицирует. Ответ клиенту, блокировку и другие действия выполняют оператор или другие ассистенты. - Вердикт строится по тексту сообщения и контексту диалога; вложения без текста оценить не по чему. --- --- title: "AI-аналитик: отчёт по диалогу, суммаризация, тональность | tuk-tuk.online" nav_title: "Аналитик" url: https://docs.tuk-tuk.online/ai/analyst markdown: https://docs.tuk-tuk.online/ai/analyst.md section: "AI-ассистенты" description: "Режим «Аналитик» по кнопке «Анализ AI» формирует отчёт по диалогу: резюме, профиль клиента, оценка менеджера по 5 критериям, вероятность конверсии, риск потери, проблемы и рекомендации." keywords: ["AI аналитик диалогов", "суммаризация диалогов", "анализ тональности", "AI отчёт по диалогу", "AI оценка менеджера", "конверсия диалога", "AI рекомендации продаж", "анализ переписки", "качество коммуникации", "инсайты из диалогов"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Аналитик» по кнопке «Анализ AI» в диалоге формирует отчёт: резюме, профиль клиента, оценка менеджера по 5 критериям (1–10), вероятность конверсии 0–100%, риск потери, проблемы и до 5 рекомендаций. > > - Где: кабинет, «AI-ассистенты», режим «Аналитик»; запуск кнопкой «Анализ AI» в диалоге. > - По умолчанию автоответ выключен, паузы при ответе оператора нет, приоритет 150. > - Критерии оценки менеджера: скорость первого ответа, релевантность, проактивность, обработка возражений, наличие CTA. > - Риск потери клиента: низкий, средний, высокий. > - Резюме диалога: 2–3 предложения, суть, запрос, статус. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/moderator, https://docs.tuk-tuk.online/ai/sales-assistant, https://docs.tuk-tuk.online/ai/transcription # AI-аналитик Режим «Аналитик» разбирает переписку и формирует отчёт: что произошло, как сработал менеджер, какие возможности упущены и что делать дальше. Запускается вручную кнопкой «Анализ AI» в диалоге, на входящие сообщения не реагирует. ## Когда включать - Руководителю нужно быстро оценить качество работы менеджеров по переписке. - Менеджер подключается к чужому диалогу и хочет за минуту понять суть. - Нужно найти недовольных клиентов до того, как они уйдут. - Диалог передаётся другому сотруднику вместе с кратким резюме. ## Что входит в отчёт ### Резюме диалога 2–3 предложения: суть обращения, ключевой запрос, текущий статус. ### Профиль клиента | Параметр | Пример | |---|---| | Тип клиента | новый / повторный / VIP / проблемный | | Вовлечённость | низкая / средняя / высокая | | Стадия воронки | осведомлённость, интерес, оценка, решение, действие | | Ключевая потребность | «Ищет CRM для салона красоты» | | Критерий решения | цена / качество / скорость / доверие | ### Оценка коммуникации менеджера Шкала 1–10 по 5 критериям: - скорость первого ответа; - релевантность ответов; - проактивность (предлагал ли дополнительные решения); - обработка возражений; - наличие чёткого призыва к действию. ### Вероятность конверсии Оценка 0–100% с кратким обоснованием: «72%: клиент выразил интерес к конкретному тарифу, но пока сравнивает с конкурентами». ### Риск потери клиента | Уровень | Признаки | |---|---| | Низкий | Клиент лоялен, активен в диалоге | | Средний | Есть нерешённые вопросы | | Высокий | Негатив, долгое ожидание, сравнение с конкурентами | ### Выявленные проблемы - Упущенные возможности: не задан вопрос, не предложена альтернатива. - Ошибки в обработке возражений. - Задержки с ответом. - Отсутствие персонализации. - Нечёткие формулировки. ### Рекомендации (до 5) Каждая рекомендация содержит действие, ожидаемый эффект и готовый текст, если применимо. ### Паттерны и сигналы - Ключевые слова-триггеры клиента. - Эмоциональные маркеры: нетерпение, заинтересованность, сомнение. - Скрытые потребности, которые клиент не озвучил прямо. ## Пример отчёта ```text Резюме: Клиент обратился по вопросу стоимости тарифа «Бизнес». Менеджер ответил с задержкой 2 часа, дал общую информацию. Клиент сравнивает с конкурентом, запросил скидку. Профиль: повторный клиент, высокая вовлечённость, стадия «Оценка», критерий: цена Оценка коммуникации: 5/10 - Скорость: 3/10 (задержка 2 часа) - Релевантность: 7/10 - Проактивность: 4/10 (не предложил альтернативы) - Возражения: 3/10 (проигнорировал вопрос о скидке) - CTA: 5/10 (размытый «обращайтесь если что») Вероятность конверсии: 35%, без доработки клиент уйдёт Проблемы: 1. Задержка ответа 2 часа при горячем обращении 2. Не обработано возражение по цене 3. Не предложена альтернатива (другой тариф) Рекомендации: 1. Ответьте на ценовое возражение: предложите рассрочку 2. Покажите ROI: расчёт окупаемости за 1–3 месяца 3. Предложите демо или пробный период ``` ## Суммаризация и тональность Резюме сжимает длинную переписку в 2–3 предложения: с ним менеджер быстро входит в чужой диалог, руководитель видит итоги обращений за день, диалог передаётся коллеге без пересказа. Оценка эмоционального тона клиента и качества ответов менеджера помогает находить недовольных клиентов, сравнивать эффективность менеджеров и давать точечные рекомендации. ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Выключен, запуск вручную | | Пауза при ответе оператора | Нет | | Приоритет | 150 | Ассистент создаётся в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), параметры описаны в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). ## Ограничения - Аналитик не работает автоматически: отчёт появляется только после нажатия «Анализ AI» в диалоге. - Отчёт строится по тексту переписки. Голосовые без [транскрибации](https://docs.tuk-tuk.online/ai/transcription) в анализ не попадают. - Оценки и вероятность конверсии носят рекомендательный характер, это не CRM-статистика. --- --- title: "AI-автоответчик: ответы клиентам от лица компании 24/7 | tuk-tuk.online" nav_title: "Автоответчик" url: https://docs.tuk-tuk.online/ai/auto-responder markdown: https://docs.tuk-tuk.online/ai/auto-responder.md section: "AI-ассистенты" description: "Режим «Автоответчик» отвечает клиентам от лица компании: классифицирует вопрос, отвечает из контекста или уточняет, жалобы и сложные запросы передаёт оператору. При ответе оператора замолкает на 4 часа." keywords: ["AI автоответчик", "автоматические ответы бот", "бот для поддержки клиентов", "чат-бот автоответ", "AI поддержка 24/7", "автоответ в нерабочее время", "бот первой линии", "автоответчик мессенджер", "AI для клиентской поддержки"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Автоответчик» отвечает клиентам напрямую от лица компании: классифицирует сообщение, отвечает из контекста или уточняет, жалобы и сложные вопросы передаёт оператору. Нужен для нерабочего времени и пиковой нагрузки. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Автоответчик». > - По умолчанию автоответ включен, пауза при ответе оператора 4 часа, приоритет 70. > - Ответ 1–5 предложений, один уточняющий вопрос, всегда со следующим шагом. > - Типы сообщений: информационный вопрос, запрос на действие, жалоба, приветствие, сложный вопрос (эскалация). > - Не выдумывает цены, сроки, остатки; не даёт медицинских, юридических и финансовых консультаций. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/knowledge-base, https://docs.tuk-tuk.online/ai/moderator, https://docs.tuk-tuk.online/ai/transcription # AI-автоответчик Режим «Автоответчик» отвечает клиенту напрямую от лица компании: на простые вопросы отвечает сам, собирает данные, а сложные запросы и жалобы передаёт оператору. Это первая линия поддержки в мессенджере. ## Когда включать - Нерабочее время: клиенты пишут ночью и в выходные и получают ответ. - Высокая нагрузка: менеджеры не успевают отвечать на весь поток. - Отпуск или выходные: ни одно обращение не остаётся без ответа. - Нужен быстрый первый ответ, пока менеджер занят. ## Как обрабатывает сообщения ### Классификация Сначала AI определяет тип сообщения. | Тип | Действие AI | |---|---| | Информационный вопрос | Отвечает из контекста или задаёт уточняющий вопрос | | Запрос на действие | Помогает выполнить (запись, покупка) или собирает данные | | Жалоба или проблема | Проявляет эмпатию, предлагает решение или эскалирует | | Приветствие | Кратко отвечает и направляет к делу | | Сложный вопрос | Переводит на оператора | ### Ответ - Если ответ есть в контексте, даёт его прямо. - Если ответа нет, задаёт один уточняющий вопрос. - Каждое сообщение завершает направлением: вопрос, предложение, призыв к действию. ### Завершение - Вопрос решён: спрашивает, есть ли ещё вопросы. - Нужен оператор: объясняет почему и называет ожидаемое время ответа. ## Типовые ситуации | Клиент пишет | AI отвечает | |---|---| | «Какая цена?» | Даёт цену из контекста или просит уточнить вариант | | «Вы работаете?» (ночью) | «Сейчас нерабочее время, но я могу помочь.» | | «Хочу вернуть товар» | Проявляет понимание, собирает детали, передаёт оператору | | «Позовите менеджера» | «Передаю запрос. Могу ли чем-то помочь пока?» | | Голосовое, фото или файл | «Получил ваш файл. Подскажите, что нужно сделать?» | | Не по теме бизнеса | Мягко возвращает к делу | ## Принципы общения - От лица компании: «мы», «у нас», «наша команда». - Без канцелярита, как живой человек. - Коротко: 1–5 предложений. - По имени, если оно известно из контекста. - Без шаблонов вроде «Ваш звонок очень важен для нас». ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Включен: отвечает клиенту напрямую | | Пауза при ответе оператора | 4 часа | | Приоритет | 70 | Ассистент создаётся в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), параметры описаны в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). > [!NOTE] Когда менеджер отвечает клиенту, автоответчик замолкает на 4 часа. Так AI и человек не отвечают одновременно. > [!TIP] Чтобы автоответчик отвечал по вашим ценам и условиям, добавьте в инструкцию [сниппеты базы знаний](https://docs.tuk-tuk.online/ai/knowledge-base). Голосовые сообщения он поймёт, если на канале включена [транскрибация](https://docs.tuk-tuk.online/ai/transcription). ## Ограничения 1. Не выдумывает цены, скидки, остатки, сроки, акции и гарантии. 2. Не даёт медицинских, юридических и финансовых консультаций. 3. Не спорит с клиентом: при конфликте эмпатия и эскалация. 4. Не оставляет клиента без следующего шага. 5. При подозрении на мошенничество не выдаёт конфиденциальную информацию. --- --- title: "AI-конвертер лидов: квалификация заявок по BANT+ | tuk-tuk.online" nav_title: "Конвертер лидов" url: https://docs.tuk-tuk.online/ai/lead-converter markdown: https://docs.tuk-tuk.online/ai/lead-converter.md section: "AI-ассистенты" description: "Режим «Конвертер лидов» общается с клиентом напрямую: квалифицирует по бюджету, полномочиям, потребности, срокам и соответствию, отрабатывает возражения и подводит к заявке, звонку или оплате." keywords: ["AI конвертер лидов", "квалификация лидов AI", "BANT квалификация", "AI закрытие сделок", "лидогенерация бот", "конверсия лидов", "AI для заявок", "бот для лидов", "автоматизация заявок", "обработка возражений AI"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Конвертер лидов» общается с клиентом напрямую, квалифицирует заявку по BANT+ (бюджет, полномочия, потребность, сроки, соответствие), делит лиды на холодные, тёплые и горячие и подводит к заявке, звонку или оплате. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Конвертер лидов». > - По умолчанию автоответ включен, пауза при ответе оператора 3 часа, приоритет 90. > - Ответ 1–4 предложения, один вопрос за сообщение (максимум 2 связанных). > - Уровни квалификации: холодный, тёплый, горячий. > - Не выдумывает цены и сроки, не использует ложную срочность. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/sales-assistant, https://docs.tuk-tuk.online/ai/auto-responder, https://docs.tuk-tuk.online/chains # AI-конвертер лидов Режим «Конвертер лидов» общается с потенциальным клиентом напрямую: выявляет потребность, квалифицирует заявку и подводит к конкретному действию: заявке, звонку, встрече или оплате. Горячих лидов ведёт к сделке, тёплых прогревает. ## Когда включать - Входящие заявки нужно квалифицировать до передачи менеджеру. - Менеджеры тратят время на холодные обращения без бюджета и сроков. - Нужно доводить клиента до звонка или оплаты в переписке, без участия человека. ## Квалификация по BANT+ AI собирает 5 параметров, вплетая вопросы в диалог. | Параметр | Что выясняет | Пример вопроса | |---|---|---| | Budget | Есть ли ресурсы, какой диапазон | «На какой бюджет ориентируетесь?» | | Authority | Принимает решение сам или нужно согласование | «Вы принимаете решение или нужно согласование?» | | Need | В чём конкретная боль | «Какую задачу хотите решить?» | | Timeline | Когда нужно решение | «Когда планируете запуск?» | | Fit | Подходит ли продукт | Оценивает автоматически | ## Уровни квалификации | Уровень | Описание | Тактика AI | |---|---|---| | Холодный | Только узнаёт, конкретной потребности нет | Прогревает ценностью, даёт полезный контент | | Тёплый | Есть потребность, сравнивает варианты | Отстраивается от конкурентов, даёт кейсы | | Горячий | Конкретная потребность, сроки и бюджет | Закрывает на действие: заявка, звонок, оплата | ## Тактика по стадиям диалога ### Первое сообщение клиента Краткий ответ (1–2 предложения) плюс один квалифицирующий вопрос. Пример: «Подскажите, для какой задачи рассматриваете? Так смогу предложить оптимальный вариант.» ### Середина диалога Техника «Мост»: связывает потребность клиента с преимуществом продукта. «Вы упомянули, что [боль клиента]. Именно для этого у нас есть [решение].» ### Закрытие - Альтернативное закрытие: «Вам удобнее созвониться сегодня в 15:00 или завтра утром?» - Микро-обязательство: «Давайте я подготовлю расчёт?» Маленький шаг вместо большого решения. ## Обработка возражений | Клиент говорит | AI отвечает | |---|---| | «Дорого» | «Понимаю. На какой бюджет ориентируетесь? Предложу подходящий вариант.» | | «Надо подумать» | «Конечно. Что именно хотели бы обдумать? Помогу с выбором.» | | «Позже» | «Хорошо. Когда удобно вернуться? Я напомню.» | | «Нужно согласовать» | «Могу подготовить краткую презентацию для руководства.» | | «У конкурента дешевле» | «Подскажите, что предлагают? Сравним по параметрам.» | ## Стиль общения - Без штампов и канцелярита. - 1–4 предложения за ответ. - Один вопрос за сообщение, максимум 2 связанных. - Каждое сообщение заканчивается вопросом или предложением. - Обращается по имени, если оно известно. ## Настройки по умолчанию | Параметр | Значение | |---|---| | Автоответ | Включен: общается с клиентом напрямую | | Пауза при ответе оператора | 3 часа | | Приоритет | 90 | Ассистент создаётся в разделе [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants), параметры описаны в [настройке ассистентов](https://docs.tuk-tuk.online/ai/assistants). > [!TIP] Если нужны только подсказки менеджеру без общения с клиентом, используйте [Ассистент продаж](https://docs.tuk-tuk.online/ai/sales-assistant). ## Ограничения 1. Не выдумывает цены, характеристики, сроки и наличие. 2. Не давит: без манипуляций и ложной срочности. 3. При агрессии переходит к эмпатии и деэскалации. 4. Вне зоны компетенции передаёт специалисту. 5. Не повторяет одни и те же фразы в рамках диалога. --- --- title: "Транскрибация голосовых в текст: Whisper и Gemini | tuk-tuk.online" nav_title: "Транскрибация" url: https://docs.tuk-tuk.online/ai/transcription markdown: https://docs.tuk-tuk.online/ai/transcription.md section: "AI-ассистенты" description: "Режим «Транскрибация» расшифровывает голосовые и аудиофайлы в текст прямо в диалоге через OpenAI Whisper или Google Gemini. Файлы до 50 МБ, форматы OGG, MP3, WAV, M4A, WEBM, работает параллельно с другими ассистентами." keywords: ["транскрибация голосовых", "расшифровка аудио в текст", "Whisper транскрибация", "голосовые в текст бот", "транскрипция сообщений", "Gemini аудио", "распознавание речи бот", "STT для мессенджера", "голосовые сообщения текст"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Транскрибация» расшифровывает голосовые сообщения и аудиофайлы в текст внутри диалога через OpenAI Whisper (whisper-1) или Google Gemini. Текст видят менеджер и другие AI-ассистенты канала. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Транскрибация аудио»; нужны провайдер и модель, промпт не нужен. > - Приоритет провайдеров: OpenAI Whisper, если подключён; иначе Gemini (gemini-2.0-flash, gemini-2.5-pro, gemini-2.5-flash). > - Лимиты: файл до 50 МБ, тайм-аут 120 секунд, форматы OGG, MP3, WAV, M4A, WEBM. > - Язык по умолчанию русский, поддерживается 50+ языков. > - Работает параллельно с другими ассистентами на том же канале; реагирует только на аудио. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/ai/auto-responder, https://docs.tuk-tuk.online/dialogs/messages # Транскрибация аудио и видео Режим «Транскрибация» превращает голосовые сообщения и аудиофайлы в текст. Расшифровка появляется в диалоге: её читает менеджер, и её же видят другие AI-ассистенты канала, которые без транскрибации получают только пометку «[Voice message]». ## Когда включать - Клиенты часто присылают голосовые, а менеджеры не хотят их слушать. - На канале работают автоответчик или конвертер лидов, и они должны понимать голосовые. - Нужна текстовая история всех обращений для поиска, аналитики и отчётов. ## Как работает 1. Клиент отправляет голосовое сообщение или аудиофайл. 2. AI определяет, что это аудио, и отправляет файл на распознавание речи. 3. Текст появляется в диалоге: его видят менеджер и другие AI-ассистенты. Обработка занимает 2–10 секунд в зависимости от длины записи. ## Провайдеры | Провайдер | Модель | Особенности | |---|---|---| | OpenAI Whisper | whisper-1 | Лучшее качество, 50+ языков, используется по умолчанию | | Google Gemini | gemini-2.0-flash, gemini-2.5-pro, gemini-2.5-flash | Хорошее качество, быстрая обработка | Если подключён OpenAI, используется Whisper. Если OpenAI нет, используется Gemini как запасной вариант. ## Как включить 1. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) в кабинете. 2. Нажмите «Создать ассистента»: откроется форма. 3. Выберите режим «Транскрибация аудио». 4. Выберите провайдера: OpenAI (Whisper) или Gemini. 5. Выберите модель транскрибации. 6. Привяжите ассистента к нужным каналам и сохраните: следующее голосовое в этих каналах будет расшифровано. > [!NOTE] Транскрибации не нужна инструкция (промпт), только провайдер и модель. Провайдер подключается заранее в [провайдерах AI](https://docs.tuk-tuk.online/ai/providers). ## Настройки | Параметр | Значение | |---|---| | Язык распознавания | Русский по умолчанию, поддерживаются 50+ языков | | Максимальный размер файла | 50 МБ | | Тайм-аут обработки | 120 секунд | | Форматы | OGG, MP3, WAV, M4A, WEBM | ## Особенности режима - Работает параллельно с другими ассистентами: к одному каналу можно подключить транскрибацию и автоответчик. - Запускается только на аудио и голосовые, текстовые сообщения игнорирует. - Расшифровка сохраняется в диалоге, к ней можно вернуться. ## Ограничения - Файлы больше 50 МБ не обрабатываются. - Если распознавание не уложилось в 120 секунд, расшифровка не появится. - Нужен подключённый провайдер OpenAI или Google Gemini с рабочим API-ключом. --- --- title: "Генерация изображений: Kandinsky, KIE.AI, GPT Image | tuk-tuk.online" nav_title: "Генерация изображений" url: https://docs.tuk-tuk.online/ai/image-generation markdown: https://docs.tuk-tuk.online/ai/image-generation.md section: "AI-ассистенты" description: "Создание изображений по текстовому описанию в цепочках tuk-tuk.online: Kandinsky (FusionBrain) и KIE.AI с 17+ моделями, включая Flux, Ideogram, Imagen, GPT Image. Text-to-image и image-to-image, дедупликация по хешу." keywords: ["генерация изображений AI", "Kandinsky FusionBrain", "KIE AI генерация", "текст в картинку", "AI создание изображений", "text-to-image бот", "GPT image", "нейросеть картинки", "Flux генерация", "Ideogram бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Генерация изображений в tuk-tuk.online работает из цепочек через блок AI Process с выходным форматом «изображение». Провайдеры: Kandinsky (FusionBrain) и KIE.AI (17+ моделей: seedream, flux-2, flux-kontext, ideogram, imagen, qwen, grok-imagine, gpt-image, nano-banana). > > - Провайдер подключается в кабинете: «AI-обработка», раздел «Провайдеры», кнопка «Добавить». > - Kandinsky требует API Key и Secret Key; KIE.AI требует один API-ключ. > - Параметры блока: промпт, ширина и высота (по умолчанию 1024×1024), входное изображение для image-to-image, формат (PNG). > - Image-to-image модели KIE.AI: nano-banana, nano-banana-2, nano-banana-edit, flux-kontext. > - Повторные запросы дедуплицируются по хешу содержимого. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/chains/blocks/ai-process, https://docs.tuk-tuk.online/chains/blocks/generate-image, https://docs.tuk-tuk.online/files # Генерация изображений tuk-tuk.online создаёт изображения по текстовому описанию через провайдеров Kandinsky и KIE.AI. Генерация запускается из [цепочек автоматизации](https://docs.tuk-tuk.online/chains): блок AI Process с выходным форматом «изображение» получает промпт и возвращает файл. ## Когда это нужно - Контент для рассылок и историй прямо в цепочке. - Иллюстрации и быстрые макеты по описанию клиента. - Редактирование существующего изображения (image-to-image). ## Провайдеры ### Kandinsky (FusionBrain) Российская нейросеть от Сбера, хорошо понимает русскоязычные промпты. | Параметр | Значение | |---|---| | Модель | kandinsky | | Авторизация | API Key и Secret Key, нужны оба | | Размеры | 1024×1024 по умолчанию, доступны другие пропорции | | Сильная сторона | Иллюстрации, креативные изображения | ### KIE.AI Платформа с доступом к 17+ моделям генерации. Один провайдер, много нейросетей. Text-to-image: | Модель | Описание | |---|---| | seedream / seedream-4.5 / seedream-5-lite | Быстрая и качественная генерация | | flux-2 | Высокая детализация | | flux-kontext | Контекстное редактирование изображений | | ideogram | Лучше всего работает с текстом на изображениях | | google-imagen / imagen-ultra / imagen-4 | Модели Google, фотореализм | | qwen | Модель Alibaba | | grok-imagine | Модель xAI | | gpt-image / 4o-image | Модели OpenAI, универсальные | Image-to-image: | Модель | Описание | |---|---| | nano-banana / nano-banana-2 | Редактирование существующих изображений | | nano-banana-edit | Точечное редактирование по маске | | flux-kontext | Изменение изображений с учётом контекста | ## Как подключить провайдера ### Kandinsky 1. Зарегистрируйтесь на [fusionbrain.ai](https://fusionbrain.ai) и получите API Key и Secret Key. 2. Откройте [AI-обработку](https://lk.tuk-tuk.online/ai) в кабинете, раздел «Провайдеры». 3. Нажмите «Добавить» и выберите Kandinsky. 4. Введите оба ключа и сохраните: провайдер появится в списке. ### KIE.AI 1. Зарегистрируйтесь на платформе KIE.AI и получите API-ключ. 2. В разделе «Провайдеры» нажмите «Добавить» и выберите KIE.AI. 3. Введите ключ и сохраните: все модели KIE.AI станут доступны в блоке. ## Как использовать в цепочке 1. Добавьте в цепочку блок [AI Process](https://docs.tuk-tuk.online/chains/blocks/ai-process). 2. Выберите провайдера: Kandinsky или KIE.AI. 3. Выберите выходной формат «изображение». 4. Укажите промпт: описание того, что нужно нарисовать. 5. Задайте размеры (ширина и высота) и сохраните блок: при выполнении цепочки он вернёт готовый файл. ## Параметры блока | Параметр | Описание | По умолчанию | |---|---|---| | Промпт | Текстовое описание изображения | нет | | Ширина | Ширина в пикселях | 1024 | | Высота | Высота в пикселях | 1024 | | Входное изображение | URL для режима image-to-image | нет, опционально | | Формат | Формат выходного файла | PNG | ## Примеры промптов | Промпт | Результат | |---|---| | «Красивый закат над морем, в стиле акварели» | Художественная иллюстрация | | «Фото современного офиса, минималистичный интерьер» | Фотореалистичное изображение | | «Логотип для кофейни, простой, плоский дизайн» | Графический дизайн | | «Баннер распродажи 50%, яркие цвета, текст на русском» | Рекламный баннер | > [!TIP] Для надписей на изображении выбирайте модель ideogram: она лучше остальных справляется с текстом. ## Дедупликация Система считает хеш содержимого запроса. Если такое же изображение уже генерировалось, новое не создаётся, используется сохранённая копия. Это экономит время и деньги. ## Ограничения - Генерация доступна только из цепочек, отдельного режима ассистента для диалогов нет. - Для Kandinsky нужны оба ключа: API Key и Secret Key. - Размер и формат задаются в блоке; по умолчанию 1024×1024 и PNG. --- --- title: "Извлечение данных из сообщений: имя, телефон, заказ | tuk-tuk.online" nav_title: "Извлечение данных" url: https://docs.tuk-tuk.online/ai/data-extraction markdown: https://docs.tuk-tuk.online/ai/data-extraction.md section: "AI-ассистенты" description: "AI-ассистент в режиме «Свой» извлекает из свободного текста клиента имя, телефон, email, номер заказа и тип запроса и пишет результат заметкой оператору. Готовый промпт и примеры для магазина, сервиса, клиники." keywords: ["извлечение данных AI", "парсинг сообщений", "распознавание контактов", "NER бот", "AI извлечение полей", "структурирование данных", "автопарсинг заявок", "AI анализ текста", "извлечение email телефона"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Сценарий извлечения данных: AI-ассистент в режиме «Свой» с промптом-шаблоном разбирает свободный текст клиента на поля (имя, телефон, email, тип запроса, номер заказа, товар, дата) и пишет результат заметкой оператору. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Свой режим», промпт вставляется вручную. > - Рекомендуемые настройки: автоответ выключен, режим заметки включен. > - Отсутствующие поля возвращаются как «не указано»; AI не выдумывает данные. > - Формат ответа задаётся в промпте, стабильнее с 1–2 примерами «вход и выход». > - Можно совмещать с автоответчиком на одном канале. > > Связанные страницы: https://docs.tuk-tuk.online/ai/custom, https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/knowledge-base, https://docs.tuk-tuk.online/dialogs/info-panel # Извлечение данных из сообщений Клиент пишет в свободной форме: «Привет, меня зовут Анна, хочу вернуть платье, заказ 12345, позвоните на +7-999-123-45-67». AI разбирает текст на поля: имя, телефон, номер заказа, тип запроса. Результат приходит менеджеру заметкой в диалоге. Сценарий строится на режиме [Свой режим](https://docs.tuk-tuk.online/ai/custom) с промптом, который задаёт список полей и формат ответа. ## Когда это нужно - Автозаполнение карточки клиента: имя, телефон, email без ручного копирования. - Классификация заявок: вопрос, заказ, жалоба, возврат. - Привязка обращения к номеру заказа. - Экономия времени: менеджер не перечитывает длинные сообщения. ## Как настроить 1. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) и нажмите «Создать ассистента». 2. Выберите режим «Свой режим»: поле инструкции останется пустым. 3. Вставьте промпт из шаблона ниже и адаптируйте список полей под свой бизнес. 4. Выключите автоответ и включите режим заметки: результат увидит менеджер, клиент нет. 5. Привяжите ассистента к каналам и сохраните: следующее входящее сообщение будет разобрано на поля. ### Шаблон промпта ```text Ты ассистент по извлечению данных из сообщений клиентов. Из каждого сообщения извлеки следующую информацию: - Имя клиента - Телефон - Email - Тип запроса (вопрос / заказ / жалоба / возврат / другое) - Номер заказа (если упоминается) - Товар или услуга (если упоминается) - Дата или срок (если упоминается) Правила: - Если данных в сообщении нет, пиши «не указано» - Не выдумывай данные, которых нет в тексте - Ответ давай строго в указанном формате Формат ответа: Имя: [значение] Телефон: [значение] Email: [значение] Тип: [тип запроса] Заказ: [номер] Товар: [название] Дата: [значение] ``` ### Настройки ассистента | Параметр | Рекомендация | |---|---| | Режим | Свой режим | | Автоответ | Выключить: результат не должен уходить клиенту | | Режим заметки | Включить: извлечённые данные видит менеджер | ## Примеры работы ### Интернет-магазин Клиент пишет: «Здравствуйте! Меня зовут Анна Петрова, заказ №12345, хочу вернуть синее платье. Позвоните мне на +7-999-123-45-67». ```text Имя: Анна Петрова Телефон: +7-999-123-45-67 Email: не указано Тип: возврат Заказ: 12345 Товар: синее платье Дата: не указано ``` ### Сервисная компания Клиент пишет: «Добрый день, не работает кондиционер, купленный 15 марта. Номер чека 789. Жду решения до пятницы. Иван, iva@mail.ru». ```text Имя: Иван Телефон: не указано Email: iva@mail.ru Тип: жалоба Заказ: 789 Товар: кондиционер Дата: до пятницы ``` ### Сообщение без данных Клиент пишет: «ну когда уже привезут???». ```text Имя: не указано Телефон: не указано Email: не указано Тип: вопрос Заказ: не указано Товар: не указано Дата: не указано ``` ## Какие поля извлекать Набор полей задаёте вы. Примеры для разных бизнесов: | Бизнес | Поля | |---|---| | Интернет-магазин | Имя, телефон, номер заказа, товар, размер, цвет | | Салон красоты | Имя, телефон, услуга, мастер, дата, время | | Клиника | Имя, телефон, специалист, симптомы, дата | | Недвижимость | Имя, бюджет, район, площадь, тип (аренда / покупка) | | Онлайн-школа | Имя, email, курс, уровень, цель обучения | > [!TIP] Чем точнее задан формат ответа, тем стабильнее результат. Добавьте в промпт 1–2 примера «вход и выход». ## Ограничения - AI извлекает только то, что есть в тексте; отсутствующие поля помечаются «не указано». - Результат приходит текстом в заметке. Автоматическая запись в карточку клиента этим сценарием не выполняется. - Голосовые сообщения разбираются только при включённой [транскрибации](https://docs.tuk-tuk.online/ai/transcription) на канале. - Длина инструкции ограничена 30 000 символов, как у любой [инструкции](https://docs.tuk-tuk.online/ai/instructions). --- --- title: "Ответы по базе знаний: FAQ, прайс-лист, каталог | tuk-tuk.online" nav_title: "База знаний" url: https://docs.tuk-tuk.online/ai/knowledge-base markdown: https://docs.tuk-tuk.online/ai/knowledge-base.md section: "AI-ассистенты" description: "AI-ассистент отвечает клиентам только по вашим данным: прайс-лист, FAQ, условия доставки, каталог. База знаний хранится в сниппетах, промпт собирается из блоков, лимит около 30 000 символов." keywords: ["AI база знаний", "FAQ бот", "бот по базе знаний", "ответы из документации", "RAG чат-бот", "AI по каталогу", "бот прайс-лист", "AI ответы по FAQ", "чат-бот знания", "справочный бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Сценарий ответов по базе знаний: AI-ассистент отвечает клиентам только по данным из сниппетов (прайс-лист, FAQ, каталог, доставка), промпт собирается из блоков «Текст» и «Сниппет» и пересобирается при каждом сообщении. При отсутствии ответа AI говорит «уточню». > > - Сниппеты: кабинет, «AI-обработка», раздел «Сниппеты», кнопка «+ Новый сниппет». > - Ассистент: «AI-ассистенты», режим «Свой режим» или «Автоответчик», сниппеты вставляются кнопкой «Вставить файл». > - Лимит собранного промпта около 30 000 символов; у каждого сниппета есть счётчик символов. > - Автоответ включен и режим «Ответ»: AI пишет клиенту; автоответ выключен и режим «Заметка»: подсказка менеджеру. > - Изменения в сниппете применяются сразу, ассистент пересоздавать не нужно. > > Связанные страницы: https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/custom, https://docs.tuk-tuk.online/ai/auto-responder, https://docs.tuk-tuk.online/ai/data-extraction, https://docs.tuk-tuk.online/ai/assistants # Ответы по базе знаний AI отвечает клиентам, опираясь только на ваши данные: прайс-лист, FAQ, каталог, условия доставки. База знаний хранится в сниппетах, промпт ассистента собирается из блоков текста и сниппетов. Если ответа в данных нет, AI отвечает «уточню» вместо выдумки. ## Когда это нужно - Разгрузить поддержку: типовые вопросы закрывает AI. - Отвечать круглосуточно, без выходных. - Давать точные ответы по актуальным ценам и условиям. - Масштабировать поддержку без найма: один ассистент обрабатывает любое число чатов. ## Как устроено ### Сниппеты Сниппет: блок текста с информацией о компании. У каждого есть название и содержимое. | Сниппет | Пример содержимого | |---|---| | Прайс-лист | Стрижка мужская 1500 ₽, женская 2500 ₽, окрашивание от 5000 ₽ | | FAQ | В: Как отменить запись? О: Позвоните за 2 часа или напишите в чат | | Доставка | Бесплатно от 3000 ₽, курьер 1–2 дня, самовывоз из 5 точек | | Контакты | Москва, ул. Примерная 1, Пн-Сб 10:00-20:00, +7-495-... | | Каталог | Перечень товаров с описанием и ценами | ### Блочный конструктор промпта Промпт собирается из блоков двух типов. | Тип блока | Что делает | |---|---| | Текст | Ваши правила и инструкции для AI | | Сниппет | Ссылка на сниппет, содержимое подставляется автоматически | ```text [Текст] Ты консультант компании «МегаШоп». Отвечай только на основе предоставленной информации. [Сниппет] Прайс-лист [Сниппет] FAQ [Сниппет] Условия доставки [Текст] Если ответа нет в данных, скажи «Уточню у менеджера и вернусь с ответом». Не выдумывай информацию. ``` При каждом сообщении клиента система собирает полный промпт из блоков и подставляет актуальное содержимое сниппетов. Обновили прайс-лист в сниппете: AI сразу отвечает по новым ценам. ## Как настроить 1. Откройте [AI-обработку](https://lk.tuk-tuk.online/ai), раздел «Сниппеты», и нажмите «+ Новый сниппет». 2. Введите название (например, «Прайс-лист») и содержимое, сохраните. Повторите для каждого блока информации. 3. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) и нажмите «Создать ассистента». 4. Выберите режим «Свой режим» или «Автоответчик», если AI должен сам отвечать клиенту. 5. В поле инструкции нажмите «Вставить файл» для каждого сниппета и добавьте текстовые блоки с правилами. Порядок: сначала роль, потом данные, потом ограничения. 6. Выберите режим ответа по таблице ниже. 7. Привяжите ассистента к каналам и сохраните: AI начнёт отвечать по базе знаний. | Сценарий | Автоответ | Режим | |---|---|---| | AI отвечает клиенту сам | Включен | Ответ | | AI подсказывает менеджеру | Выключен | Заметка | ## Пример: салон красоты Сниппет «Услуги и цены»: ```text Наши услуги: - Стрижка мужская: 1 500 ₽ (30 мин) - Стрижка женская: 2 500 ₽ (45 мин) - Окрашивание: от 5 000 ₽ (2 часа) - Маникюр: 2 000 ₽ (1 час) - Педикюр: 2 500 ₽ (1.5 часа) ``` Сниппет «FAQ»: ```text В: Как записаться? О: Напишите нам услугу, дату и удобное время. В: Как отменить запись? О: Напишите или позвоните за 2 часа до визита. В: Есть ли парковка? О: Да, бесплатная парковка на 10 мест у входа. В: Работаете в выходные? О: Да, Пн-Сб 10:00-20:00, Вс 11:00-18:00. ``` Промпт: ```text Ты администратор салона красоты «Стиль». Отвечай на вопросы клиентов вежливо и коротко (1-3 предложения). Используй ТОЛЬКО информацию из данных ниже. Если ответа нет, скажи: «Уточню у мастера, напишу вам в течение 15 минут». [Сниппет: Услуги и цены] [Сниппет: FAQ] ``` Как отвечает AI: | Клиент спрашивает | AI отвечает | |---|---| | «Сколько стоит стрижка?» | «Мужская стрижка 1 500 ₽ (30 мин), женская 2 500 ₽ (45 мин). Записать вас?» | | «Вы работаете в воскресенье?» | «Да, в воскресенье работаем с 11:00 до 18:00. Ждём вас!» | | «Делаете ли вы наращивание ресниц?» | «Уточню у мастера, напишу вам в течение 15 минут.» | ## Обновление базы знаний 1. Откройте нужный сниппет в разделе «Сниппеты». 2. Отредактируйте содержимое. 3. Нажмите «Сохранить»: AI использует новые данные со следующего сообщения, пересоздавать ассистента не нужно. ## Ограничения Максимальная длина собранного промпта около 30 000 символов (примерно 15–20 страниц текста). Этого хватает на прайс-лист из 50+ позиций, FAQ из 30–40 вопросов и описание услуг с условиями. У каждого сниппета есть счётчик символов. > [!TIP] Разбивайте информацию на несколько сниппетов. Поменялись цены: правите только «Прайс-лист», остальное не трогаете. --- --- title: "Свой режим AI: промпт с нуля под любую задачу | tuk-tuk.online" nav_title: "Свой режим" url: https://docs.tuk-tuk.online/ai/custom markdown: https://docs.tuk-tuk.online/ai/custom.md section: "AI-ассистенты" description: "Режим «Свой» запускает AI-ассистента с пустым промптом: извлечение данных, ответы по базе знаний из сниппетов, перевод, теги, резюме диалога. Примеры промптов и советы по настройке." keywords: ["свой режим AI", "кастомный бот", "произвольный промпт", "извлечение данных AI", "база знаний бот", "RAG чат-бот", "AI с кастомным промптом", "свой AI ассистент", "NER бот", "AI парсер данных"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Режим AI-ассистента «Свой» запускается с пустым системным промптом: пользователь сам описывает поведение. Типовые применения: извлечение данных, ответы по базе знаний из сниппетов, перевод, теги, резюме диалога. > > - Где: кабинет, «AI-ассистенты», «Создать ассистента», режим «Свой режим». > - Системный промпт пустой; автоответ и остальные параметры настраиваются вручную. > - Максимальная длина инструкции 30 000 символов. > - Сниппеты вставляются в инструкцию кнопкой «Вставить файл». > - Рекомендуется тестировать в режиме «Заметка» до включения автоответа. > > Связанные страницы: https://docs.tuk-tuk.online/ai/modes, https://docs.tuk-tuk.online/ai/data-extraction, https://docs.tuk-tuk.online/ai/knowledge-base, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/ai/assistants # Свой режим Режим «Свой» не содержит предустановленного промпта и правил. Вы пишете инструкцию с нуля и полностью определяете, что делает AI: извлекает данные, отвечает по базе знаний, переводит, ставит теги или делает что-то своё. ## Когда использовать - Нужна логика, которой нет в [готовых режимах](https://docs.tuk-tuk.online/ai/modes). - Извлечение данных из сообщений клиентов. - Ответы по базе знаний: FAQ, документация, каталог. - Перевод или другая языковая обработка. - Специфическая бизнес-логика вашей компании. ## Как создать 1. Откройте [AI-ассистенты](https://lk.tuk-tuk.online/ai-assistants) и нажмите «Создать ассистента». 2. Выберите режим «Свой режим»: поле инструкции останется пустым. 3. Напишите промпт или вставьте один из примеров ниже. 4. Выберите режим ответа: автоответ, если результат нужен клиенту; заметка, если результат нужен менеджеру. 5. Привяжите ассистента к каналам и сохраните: он начнёт обрабатывать входящие по вашей инструкции. ## Настройки по умолчанию | Параметр | Значение | |---|---| | Системный промпт | Пустой, пишется вручную | | Автоответ | Зависит от задачи, настраивается вручную | | Остальные параметры | На ваше усмотрение | ## Пример: извлечение данных AI читает свободный текст клиента и достаёт из него конкретные поля. Подробный сценарий на странице [Извлечение данных](https://docs.tuk-tuk.online/ai/data-extraction). ```text Ты ассистент по извлечению данных. Из каждого сообщения клиента извлеки следующую информацию (если она есть): - Имя клиента - Телефон - Email - Тип запроса (вопрос / заказ / жалоба / возврат) - Номер заказа (если упоминается) - Товар или услуга (если упоминается) Ответь строго в формате: Имя: [значение или «не указано»] Телефон: [значение или «не указано»] Email: [значение или «не указано»] Тип: [тип] Заказ: [номер или «не указано»] Товар: [название или «не указано»] ``` Клиент пишет: «Здравствуйте! Меня зовут Анна, заказ №12345, хочу вернуть платье синее. Позвоните мне на +7-999-123-4567». ```text Имя: Анна Телефон: +7-999-123-4567 Email: не указано Тип: возврат Заказ: 12345 Товар: платье синее ``` ## Пример: ответы по базе знаний Данные о компании хранятся в [сниппетах](https://docs.tuk-tuk.online/ai/instructions), AI отвечает только по ним. Подробный сценарий на странице [База знаний](https://docs.tuk-tuk.online/ai/knowledge-base). 1. Создайте сниппеты: услуги и цены, FAQ, условия доставки и возврата, контакты. 2. Вставьте сниппеты в инструкцию кнопкой «Вставить файл». 3. Добавьте промпт: ```text Ты консультант компании «МегаШоп». Отвечай только на основе предоставленной информации. Если ответа нет в данных, скажи «Уточню у менеджера и вернусь с ответом» и НЕ ВЫДУМЫВАЙ. Информация о компании: [Здесь будут вставленные сниппеты] ``` > [!NOTE] У каждого сниппета есть счётчик символов. Максимальная длина инструкции 30 000 символов, примерно 15–20 страниц текста. ## Другие примеры промптов ### Переводчик ```text Ты переводчик. Переведи сообщение клиента на английский язык. Ответь только переводом, без комментариев. ``` ### Генератор тегов ```text Прочитай сообщение клиента и присвой от 1 до 3 тегов из списка: #продажа, #поддержка, #жалоба, #возврат, #вопрос, #срочно, #VIP Ответь только тегами через пробел. ``` ### Краткое резюме ```text Сформируй резюме диалога в 1-2 предложения. Укажи: суть запроса, статус (решён / в работе / нужна помощь). ``` ## Как писать промпт 1. Конкретно: что делать, как отвечать, чего не делать. 2. С примерами: покажите вход и ожидаемый выход. 3. С форматом: «Ответь в формате JSON» или «Ответь одним словом». 4. С ограничениями: «Не выдумывай данных», «Не выходи за рамки темы». 5. С проверкой: начните в режиме «Заметка» и оцените качество ответов до включения автоответа. ## Ограничения - Готовых правил безопасности из других режимов здесь нет: запреты на выдумывание цен и эскалацию нужно прописать самим. - Длина инструкции не больше 30 000 символов. - Качество результата зависит от промпта и выбранной модели [провайдера](https://docs.tuk-tuk.online/ai/providers). --- --- title: "AI Proxy: единая точка доступа к OpenAI, Anthropic, Gemini | tuk-tuk.online" nav_title: "AI Proxy" url: https://docs.tuk-tuk.online/ai/ai-proxy markdown: https://docs.tuk-tuk.online/ai/ai-proxy.md section: "AI-ассистенты" description: "AI Proxy принимает запросы бэкенда tuk-tuk.online и проксирует их к OpenAI, Anthropic, Gemini, Mistral и DeepSeek. Защита заголовком x-proxy-secret, переменные AI_PROXY_URL, AI_PROXY_SECRET, PROXY_SECRET, диагностика." keywords: ["AI proxy", "Railway proxy", "AI_PROXY_URL", "AI_PROXY_SECRET", "OpenAI proxy", "Anthropic proxy", "Gemini proxy", "Mistral proxy", "DeepSeek proxy"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > AI Proxy: отдельный сервис tuk-tuk.online, через который бэкенд отправляет запросы к OpenAI, Anthropic, Gemini, Mistral и DeepSeek. Авторизация по заголовку x-proxy-secret; без AI_PROXY_URL бэкенд ходит к провайдерам напрямую. > > - Маршруты: /openai, /anthropic, /gemini, /mistral, /deepseek. > - Переменные прокси: PORT (по умолчанию 3100), PROXY_SECRET. > - Переменные бэкенда: AI_PROXY_URL, AI_PROXY_SECRET (равен PROXY_SECRET). > - Прокси удаляет заголовок x-proxy-secret перед запросом во внешний API. > - Проверка: GET /health на прокси; 403 означает несовпадение секретов. > > Связанные страницы: https://docs.tuk-tuk.online/ai, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/ai/assistants, https://docs.tuk-tuk.online/integrations # AI Proxy AI Proxy: отдельный сервис, который принимает запросы бэкенда и проксирует их к AI-провайдерам. Все AI-запросы выходят из одной точки, авторизация между бэкендом и прокси идёт по общему секрету. ## Когда это нужно - Единый egress для всех AI-запросов. - Централизованная защита по заголовку `x-proxy-secret`. - Стабильная маршрутизация к разным провайдерам из одной конфигурации бэкенда. Если `AI_PROXY_URL` не задан, бэкенд отправляет запросы напрямую провайдерам. ## Маршруты | Префикс | Провайдер | Целевой API | |---|---|---| | `/openai` | OpenAI | `https://api.openai.com` | | `/anthropic` | Anthropic | `https://api.anthropic.com` | | `/gemini` | Google Gemini | `https://generativelanguage.googleapis.com` | | `/mistral` | Mistral | `https://api.mistral.ai` | | `/deepseek` | DeepSeek | `https://api.deepseek.com` | Перед отправкой во внешний API прокси удаляет внутренний заголовок `x-proxy-secret`. ## Переменные окружения ### `apps/ai-proxy` | Переменная | Назначение | |---|---| | `PORT` | Порт сервиса, по умолчанию `3100` | | `PROXY_SECRET` | Общий секрет для авторизации запросов от бэкенда | ### `apps/backend` | Переменная | Назначение | |---|---| | `AI_PROXY_URL` | Базовый URL прокси, например `https://your-ai-proxy.up.railway.app` | | `AI_PROXY_SECRET` | Тот же секрет, что и `PROXY_SECRET` | ## Проверить, что работает 1. Откройте health-эндпоинт прокси: `GET /health` должен ответить успешно. 2. Сверьте `AI_PROXY_SECRET` бэкенда и `PROXY_SECRET` прокси: значения совпадают. 3. Выполните тестовый AI-запрос через ассистента: в логах нет `403 Forbidden` от прокси. ## Частые проблемы | Симптом | Причина | Решение | |---|---|---| | 403 от прокси | Не совпадают `AI_PROXY_SECRET` и `PROXY_SECRET` | Синхронизируйте секреты в бэкенде и ai-proxy | | Запросы идут мимо прокси | Не задан `AI_PROXY_URL` | Укажите URL в env бэкенда | | Нет ответа провайдера | Ошибка API-ключа у выбранного провайдера | Проверьте ключ в [провайдерах AI](https://docs.tuk-tuk.online/ai/providers) | --- --- title: "Интеграции: amoCRM, YClients, Битрикс24, GetCourse, RetailCRM, 1С, Notion, Яндекс.Метрика" nav_title: "Интеграции" url: https://docs.tuk-tuk.online/integrations markdown: https://docs.tuk-tuk.online/integrations.md description: "Как tuk-tuk.online связывает мессенджеры с CRM, онлайн-записью и учётными системами: список интеграций, способы авторизации, что читается и что создаётся, где подключить в кабинете." keywords: ["CRM интеграция мессенджеры", "AmoCRM Telegram интеграция", "YClients запись онлайн", "Google Calendar бот", "Битрикс24 мессенджер", "1С интеграция чат", "GetCourse webhook", "RetailCRM интеграция", "синхронизация CRM", "автоматизация продаж CRM"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Раздел «Интеграции» связывает tuk-tuk.online с amoCRM, YClients, Google Calendar, Битрикс24, GetCourse, RetailCRM, 1С:Предприятие, Notion, Яндекс.Метрикой и произвольными сервисами через вебхуки. Данные читаются и записываются в обе стороны, действия выполняют цепочки и AI-ассистенты. > > - Где: кабинет, раздел «Интеграции» (lk.tuk-tuk.online/integrations); у каждой карточки кнопки «Подключить» и «Управлять». > - Авторизация: amoCRM через OAuth 2.0, YClients через маркетплейс, Битрикс24 через URL входящего вебхука, GetCourse и RetailCRM через API-ключ, 1С через логин и пароль (Basic Auth, OData), Notion через Internal Integration Secret, Яндекс.Метрика через OAuth-токен, Google Calendar через Google OAuth. > - В окне подключённой интеграции есть кнопка «Проверить»: живая проверка доступа с подсказками. > - Разрешения роли: INTEGRATIONS_VIEW, INTEGRATIONS_CONNECT, INTEGRATIONS_CONFIGURE. > - В цепочках доступны блок «Интеграция с CRM» (amoCRM, YClients) и блок «Webhook». > - Исходящие вебхуки о событиях платформы настраиваются отдельно, в настройках проекта. > > Связанные страницы: https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/users/roles-permissions # Интеграции tuk-tuk.online подключается к CRM, сервисам онлайн-записи и учётным системам. Обращение из мессенджера превращается в контакт, сделку или запись во внешнем сервисе, а AI-ассистенты и цепочки читают оттуда расписание, заказы и справочники, чтобы отвечать клиенту по делу. Все интеграции подключаются в одном разделе кабинета и работают по одной схеме: авторизация, чтение данных, запись данных, автоматизация. ## Список интеграций | Интеграция | Что синхронизируется | Авторизация | Инструкция | |---|---|---|---| | amoCRM | Контакты, сделки, воронки, примечания, чат Amojo, конструктор правил | OAuth 2.0 | [Подключить amoCRM](https://docs.tuk-tuk.online/integrations/amocrm) | | YClients | Записи, клиенты, услуги, мастера, филиалы, метки | Маркетплейс YClients (подпись HMAC-SHA256) | [Подключить YClients](https://docs.tuk-tuk.online/integrations/yclients) | | Google Calendar | События основного календаря, ссылки Google Meet | Google OAuth 2.0 | [Подключить Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar) | | Битрикс24 | Контакты, сделки, лиды, компании, справочники стадий | Входящий вебхук (URL вебхука) | [Подключить Битрикс24](https://docs.tuk-tuk.online/integrations/bitrix24) | | GetCourse | Пользователи, сделки, группы обучения | API Secret Key | [Подключить GetCourse](https://docs.tuk-tuk.online/integrations/getcourse) | | RetailCRM | Клиенты, заказы, статусы, типы доставки, магазины | API-ключ | [Подключить RetailCRM](https://docs.tuk-tuk.online/integrations/retailcrm) | | 1С:Предприятие | Контрагенты, номенклатура, заказы покупателей, склады, организации | Логин и пароль (Basic Auth, OData) | [Подключить 1С](https://docs.tuk-tuk.online/integrations/onec) | | Notion | Задачи и заметки страницами в базе данных | Internal Integration Secret + доступ к базе | [Подключить Notion](https://docs.tuk-tuk.online/integrations/notion) | | Яндекс.Метрика | Офлайн-конверсии по событиям кабинета | OAuth-токен | [Подключить Метрику](https://docs.tuk-tuk.online/integrations/yandex-metrika) | | Вебхуки | Исходящие HTTP-уведомления о событиях в любой сервис | Секрет подписи HMAC-SHA256 | [Настроить вебхуки](https://docs.tuk-tuk.online/integrations/webhooks) | ## Как это устроено 1. **Авторизация.** Вы подключаете внешний сервис: через OAuth, маркетплейс, API-ключ или логин и пароль. Платформа проверяет доступ сразу при сохранении. 2. **Чтение данных.** Платформа запрашивает у сервиса клиентов, сделки, записи, справочники. Их видят AI-ассистенты и операторы. 3. **Запись данных.** Платформа создаёт и обновляет записи в сервисе: новые сделки, контакты, заказы, события. 4. **Автоматизация.** Действия выполняют [цепочки](https://docs.tuk-tuk.online/chains) и [AI-ассистенты](https://docs.tuk-tuk.online/ai/assistants) без участия оператора. ## Как подключить ![Раздел «Интеграции»](https://docs.tuk-tuk.online/assets/screens/integrations/list.webp) 1. Пункт «Интеграции» в меню. 2. Фильтр по типу: CRM, онлайн-запись, учёт, обучение, мессенджер, заметки, аналитика. 3. Кнопка «Подключить» на карточке сервиса. 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations): появится список сервисов со счётчиком «Подключено N из M». 2. Выберите сервис и нажмите «Подключить»: откроется окно авторизации или форма с полями для ключей. 3. Пройдите авторизацию или введите ключи и сохраните: карточка получит отметку «Интеграция подключена». 4. Нажмите «Управлять», чтобы перейти на страницу интеграции и настроить правила, воронку или филиал. 5. В окне подключённой интеграции нажмите «Проверить»: платформа обратится к сервису тем же методом, что и при подключении, и покажет статус с подсказками (например, каких целей нет в Метрике). > [!NOTE] Авито в этом разделе показан карточкой-ссылкой: это канал связи, он настраивается на своей странице. > [!NOTE] Для работы с интеграциями нужны разрешения роли: `INTEGRATIONS_VIEW` (просмотр), `INTEGRATIONS_CONNECT` (подключение и отключение), `INTEGRATIONS_CONFIGURE` (настройка). Подробнее в разделе [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions). ## Что делают AI-ассистенты с интеграциями - Смотрят расписание в YClients или Google Calendar и предлагают клиенту свободные слоты. - Записывают клиента на услугу прямо из переписки: режим [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking). - Создают сделки в amoCRM или Битрикс24, когда клиент готов к покупке. - Проверяют заказы в RetailCRM или 1С и отвечают клиенту о статусе. ## Интеграции в цепочках - Блок [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration): действия amoCRM (создать сделку, переместить по воронке, тег, примечание, кастомное поле, ответственный) и YClients (посещаемость, метки, цвет записи). - Блок [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook): HTTP-запрос в любой внешний сервис как шаг сценария. - [Исходящие вебхуки](https://docs.tuk-tuk.online/integrations/webhooks): уведомления о событиях платформы на ваш URL, независимо от цепочек. --- --- title: "Интеграция amoCRM: сделки, контакты и чат Amojo из мессенджеров" nav_title: "amoCRM" url: https://docs.tuk-tuk.online/integrations/amocrm markdown: https://docs.tuk-tuk.online/integrations/amocrm.md section: "Интеграции" description: "Как подключить amoCRM к tuk-tuk.online по OAuth 2.0: автосоздание контактов и сделок, переписка из Telegram в карточке сделки через Amojo, теги, примечания, конструктор правил и блоки в цепочках." keywords: ["AmoCRM интеграция Telegram", "AmoCRM подключить мессенджер", "Amojo мессенджер Telegram", "AmoCRM автоматизация продаж", "AmoCRM воронки продаж", "AmoCRM чат-бот", "CRM мессенджер интеграция", "сделки AmoCRM авто", "AmoCRM конструктор правил"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция amoCRM подключается по OAuth 2.0 в один клик и даёт двустороннюю связь мессенджеров с CRM: автосоздание контактов и сделок, переписка в карточке сделки через Amojo, теги, примечания, кастомные поля, конструктор правил и действия в цепочках. > > - Где: «Интеграции» → amoCRM → «Подключить AmoCRM» (всплывающее окно amoCRM); настройки и конструктор правил на странице amoCRM по кнопке «Управлять». > - Client ID и Client Secret вводить не нужно; refresh_token обновляется автоматически. > - При подключении автоматически создаётся скрытый канал amoCRM (Amojo) для обмена сообщениями. > - Действия в цепочках: create_deal, move_pipeline, set_custom_field, set_responsible, tag_deal, tag_contact, add_note. > - Входящие вебхуки Amojo проверяются по HMAC-SHA1 (заголовок X-Signature), без подписи отклоняются (401). > - Одна интеграция = один аккаунт amoCRM; действия конструктора повторяются до 3 раз при ошибке. > > Связанные страницы: https://docs.tuk-tuk.online/channels/amocrm-chat, https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/ai/sales-assistant, https://docs.tuk-tuk.online/users/roles-permissions # Интеграция amoCRM Интеграция связывает мессенджеры клиентов с воронкой продаж amoCRM в обе стороны. Клиент пишет в Telegram, в amoCRM появляются контакт и сделка, менеджер видит переписку в карточке сделки и отвечает оттуда: ответ уходит клиенту в тот же мессенджер. Подключение занимает одну авторизацию по OAuth 2.0. Токены обновляются автоматически, канал для обмена сообщениями создаётся сам. ## Что синхронизируется | Сущность amoCRM | Чтение | Запись | |---|---|---| | Контакты | Поиск по телефону и email | Создание контакта при первом обращении, привязка к диалогу | | Сделки | Список сделок клиента, последняя сделка | Создание, перемещение по этапам, теги, кастомные поля, ответственный | | Воронки и этапы | Все воронки (pipelines) и их этапы (statuses) | Выбор воронки для новых сделок | | Пользователи amoCRM | Список менеджеров | Назначение ответственного за сделку | | Примечания | Нет | Добавление примечаний (notes) к сделке | | Кастомные поля | Список полей контакта и сделки | Заполнение значениями из диалога | | Чат Amojo | Входящие сообщения из чата amoCRM | Исходящие сообщения в чат сделки, «Написать первым» из карточки | > [!NOTE] Для обмена сообщениями при подключении автоматически создаётся скрытый канал [amoCRM (Amojo)](https://docs.tuk-tuk.online/channels/amocrm-chat). Не удаляйте его: без него переписка перестанет попадать в amoCRM. ## Что нужно на стороне amoCRM - Аккаунт amoCRM с правом устанавливать интеграции. - Доступ менеджеров к воронке и к чатам: иначе они не увидят переписку в карточке сделки. - Разрешение `INTEGRATIONS_CONNECT` у вашей роли в tuk-tuk.online (см. [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions)). Вводить Client ID и Client Secret не нужно: авторизация проходит через кнопку amoCRM. ## Как подключить ![Подключение amoCRM](https://docs.tuk-tuk.online/assets/screens/integrations/amocrm.webp "amoCRM подключается в один клик: вход в аккаунт amoCRM, права выдаются автоматически.") 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations) и выберите amoCRM: в карточке написано «Авторизация в один клик». 2. Нажмите «Подключить AmoCRM»: откроется всплывающее окно amoCRM. 3. Войдите в amoCRM, выберите аккаунт и разрешите доступ: окно закроется, карточка получит отметку «Интеграция подключена». 4. Нажмите «Управлять»: откроется страница amoCRM в кабинете со статусом «Подключено» и адресом Webhook URL. После авторизации платформа сама получает OAuth-токен, сохраняет идентификатор аккаунта для Chat API, включает синхронизацию контактов и сделок, создаёт канал Amojo и регистрирует вебхук для входящих сообщений из amoCRM. ## Проверить, что работает 1. Напишите боту с тестового номера: в amoCRM появится контакт и сделка в выбранной воронке. 2. Откройте сделку в amoCRM: во вкладке чата видно входящее сообщение. 3. Ответьте из amoCRM: сообщение придёт клиенту в мессенджер, а в tuk-tuk.online появится в диалоге как исходящее. ## Что происходит после подключения | Событие | Действие платформы | |---|---| | Новый клиент написал в мессенджер | Поиск контакта по телефону или email; если нет, создание контакта и сделки в выбранной воронке | | Входящее сообщение | Копия сообщения в чат сделки в amoCRM (Amojo) | | Менеджер ответил из amoCRM | Ответ отправляется клиенту в мессенджер | | Цепочка дошла до блока «Интеграция с CRM» | Сделка создаётся, перемещается, получает тег, примечание, поле или ответственного | | Событие в amoCRM попало под правило конструктора | Действия правила ставятся в очередь и выполняются по порядку | ## Конструктор правил Конструктор правил живёт на странице amoCRM в кабинете (кнопка «Управлять» в разделе интеграций). Правило состоит из двух частей: - **Условия срабатывания**: когда вебхук от amoCRM должен запускать действия. Проверяются поля сделки (воронка, этап, ответственный, бюджет, название, даты создания и обновления, причина отказа) и контакта (имя, фамилия, телефон, email) операторами «равно», «содержит», «начинается с», «больше», «входит в список», «пусто» и их отрицаниями. - **Действия**: что выполнить при срабатывании, по порядку: сменить этап, заполнить поле, добавить примечание, добавить или удалить тег, создать задачу, создать сделку, ИИ-обработка, задержка. У каждого правила есть журнал срабатываний и логи. Действие с ошибкой повторяется до 3 раз, затем помечается как невыполненное. ## amoCRM в цепочках Блок [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration) выполняет действия amoCRM как шаг сценария. | Действие | Ключ | Что делает | |---|---|---| | Создать сделку | `create_deal` | Создаёт сделку и привязывает контакт по телефону или email | | Переместить по воронке | `move_pipeline` | Переводит сделку на указанный этап воронки | | Кастомное поле | `set_custom_field` | Заполняет поле контакта или сделки | | Ответственный | `set_responsible` | Назначает менеджера | | Тег сделки | `tag_deal` | Добавляет тег к сделке | | Тег контакта | `tag_contact` | Добавляет тег к контакту | | Примечание | `add_note` | Записывает текст в историю сделки | ## Безопасность - Авторизация по OAuth 2.0, refresh_token обновляется автоматически. - Входящие сообщения из Amojo проверяются по подписи HMAC-SHA1 в заголовке `X-Signature`; запрос без подписи или с неверной подписью отклоняется с кодом 401. - Секрет вебхука (24 байта, 48 hex-символов) генерируется автоматически при подключении. - Пересылку сообщений в amoCRM можно приостановить, не отключая интеграцию. ## Ограничения - Одна интеграция = один аккаунт amoCRM. - Канал Amojo создаётся только через интеграцию; вручную его не добавить. - Переписка попадает в amoCRM только после подключения; старые диалоги задним числом не переносятся. ## Частые проблемы | Проблема | Что делать | |---|---| | Не создаются сделки | Проверьте, что на странице amoCRM выбрана воронка и включено автосоздание | | Сообщения не попадают в amoCRM | Убедитесь, что интеграция в статусе «Подключено», канал amoCRM (Amojo) активен и пересылка не приостановлена | | Ошибка OAuth при подключении | Закройте всплывающее окно, обновите страницу и повторите «Подключить AmoCRM» под администратором amoCRM | | Amojo не подключился | Проверьте, что у аккаунта amoCRM есть доступ к чатам (мессенджинг) | | Менеджер не видит чат | Выдайте менеджеру доступ к воронке и чатам в настройках amoCRM | --- --- title: "Интеграция YClients: онлайн-запись клиентов через мессенджеры" nav_title: "YClients" url: https://docs.tuk-tuk.online/integrations/yclients markdown: https://docs.tuk-tuk.online/integrations/yclients.md section: "Интеграции" description: "Как подключить YClients к tuk-tuk.online через маркетплейс: расписание мастеров, услуги, записи и клиенты в чате, метки и статусы посещения из цепочек, запись через AI-ассистента." keywords: ["YClients интеграция мессенджер", "онлайн запись через Telegram", "YClients подключить бот", "CRM салон красоты", "запись клиентов чат-бот", "YClients бот записи", "напоминание о записи", "автозапись через мессенджер", "YClients Marketplace"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция YClients подключается через маркетплейс YClients и даёт доступ к записям, мастерам, услугам, клиентам, филиалам и меткам. AI-ассистент записывает клиентов из чата, цепочки меняют статус посещения, метки и цвет записи. > > - Где: «Интеграции» → YClients → «Подключить» → страница приложения в маркетплейсе YClients → возврат на lk.tuk-tuk.online/yclients/callback → подтверждение. > - Подпись возврата из маркетплейса проверяется по HMAC-SHA256; ручной ввод токенов не предусмотрен. > - Действия в цепочках: yc_change_attendance (2, 1, 0, -1), yc_add_label, yc_remove_label, yc_change_color. > - Без ID записи действие применяется к ближайшей записи клиента, найденного по телефону. > - Нужна подписка YClients с доступом к API; поддерживаются несколько филиалов в одной интеграции. > - Страница интеграции в кабинете: карточка компании, записи, сотрудники, услуги, поиск клиентов, создание и отмена записи. > > Связанные страницы: https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/chains/blocks/integration, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/integrations/google-calendar, https://docs.tuk-tuk.online/integrations # Интеграция YClients YClients ведёт расписание салонов, клиник, автосервисов и фитнес-клубов. Интеграция открывает это расписание мессенджерам: клиент пишет боту «хочу подстричься в пятницу», AI-ассистент смотрит свободные окна мастеров в YClients, предлагает время и создаёт запись, не выводя клиента из чата. Записями можно управлять и из tuk-tuk.online: смотреть расписание, создавать и отменять записи, менять статус посещения и метки из цепочек. ## Что синхронизируется | Данные YClients | Чтение | Запись | |---|---|---| | Записи | Расписание за период, записи клиента | Создание записи, отмена, статус посещения, метки, цвет | | Сотрудники | Список мастеров с рейтингом и специализацией | Нет | | Услуги | Каталог с ценами и длительностью, услуги конкретного мастера | Нет | | Клиенты | Поиск по имени и телефону | Клиент создаётся вместе с первой записью | | Метки записей | Список меток компании | Добавление и удаление метки на записи | | Филиалы | Список филиалов и карточка компании (город, адрес, телефон, сайт, часовой пояс, расписание) | Выбор филиала для записи | ## Что нужно на стороне YClients - Подписка YClients с доступом к API. - Права владельца или администратора компании: установка приложений из маркетплейса доступна только им. - Один или несколько филиалов: интеграция поддерживает мультифилиалы, филиал выбирается при записи. ## Как подключить ![Подключение YClients](https://docs.tuk-tuk.online/assets/screens/integrations/yclients.webp "YClients подключается через маркетплейс: установите интеграцию там, вас вернут обратно для подтверждения.") Подключение идёт только через маркетплейс YClients: ключи вручную вводить не нужно. 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите YClients и нажмите «Подключить»: появится подсказка «Подключение происходит через маркетплейс YClients» и ссылка на страницу приложения. 2. Перейдите по ссылке в маркетплейс YClients и нажмите «Подключить» на странице приложения tuk-tuk.online. 3. Дождитесь возврата на `lk.tuk-tuk.online/yclients/callback`: платформа проверит подпись HMAC-SHA256 от YClients и покажет экран подтверждения. 4. Подтвердите подключение: интеграция активируется через Partner API YClients, карточка получит отметку «Интеграция подключена». 5. Нажмите «Управлять»: откроется страница YClients в кабинете с карточкой компании, записями, сотрудниками, услугами и клиентами. ## Проверить, что работает 1. На странице YClients в кабинете откройте вкладку «Сотрудники»: список мастеров загрузился из YClients. 2. Откройте «Записи» за текущую неделю: видны записи из журнала YClients. 3. Создайте тестовую запись (телефон, имя, email, комментарий): она появится в журнале YClients у выбранного мастера. ## Что происходит после подключения | Событие | Действие платформы | |---|---| | Клиент просит записаться в чате | AI-ассистент в режиме [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking) читает услуги, мастеров и свободные окна и создаёт запись в YClients | | Клиент просит отменить запись | Запись удаляется в YClients | | Цепочка дошла до действия YClients | Меняется статус посещения, метка или цвет записи | | Оператор создал запись в кабинете | Запись появляется в журнале YClients с указанным клиентом | ## YClients в цепочках Действия доступны в блоке [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration). Если ID записи не указан, платформа находит клиента в YClients по телефону и берёт его ближайшую запись начиная с сегодняшнего дня. | Действие | Ключ | Что делает | |---|---|---| | Изменить посещаемость | `yc_change_attendance` | Ставит статус посещения записи: 2 подтвердил, 1 пришёл, 0 ожидание, -1 не пришёл | | Добавить метку | `yc_add_label` | Добавляет метку к записи, существующие метки сохраняются | | Удалить метку | `yc_remove_label` | Снимает метку с записи | | Изменить цвет | `yc_change_color` | Меняет цвет записи в журнале | > [!TIP] Клиент подтвердил визит в чате: цепочка ставит статус «подтвердил» и зелёный цвет записи. Администратор видит подтверждение в журнале YClients без звонка. ## Что умеет AI-ассистент С доступом к YClients ассистент отвечает на вопросы в естественном разговоре: - «Когда можно записаться на маникюр?»: показывает свободные окна. - «Кто свободен в субботу?»: предлагает мастера. - «Запишите меня на 15:00 к Марии»: создаёт запись. - «Хочу отменить запись на пятницу»: отменяет запись. - «Сколько стоит стрижка?»: называет цену из каталога услуг. ## Ограничения - Подключение только через маркетплейс YClients; ручной ввод токенов не предусмотрен. - Данные читаются из API YClients в момент запроса, локальной копии расписания нет. - Действия цепочек работают с одной записью: последней записью клиента или записью с указанным ID. ## Частые проблемы | Проблема | Что делать | |---|---| | AI не видит расписание | Проверьте, что интеграция активна и в настройках ассистента выбран филиал | | Не создаётся запись | Убедитесь, что у мастера есть свободное окно нужной длительности и услуга привязана к мастеру | | Ошибка авторизации | Переустановите приложение из маркетплейса YClients и подтвердите подключение заново | | Филиалы не загружаются | Проверьте, что у аккаунта YClients есть доступ к API и приложение установлено для нужной компании | | Пришёл возврат из маркетплейса с ошибкой подписи | Начните подключение заново со страницы приложения в маркетплейсе, не редактируя адрес возврата | --- --- title: "Интеграция Google Calendar: запись клиентов и Google Meet из чата" nav_title: "Google Calendar" url: https://docs.tuk-tuk.online/integrations/google-calendar markdown: https://docs.tuk-tuk.online/integrations/google-calendar.md section: "Интеграции" description: "Как подключить Google Calendar к tuk-tuk.online: AI-ассистент видит занятость, создаёт события в основном календаре, добавляет ссылку Google Meet. Яндекс Календарь подключается по CalDAV." keywords: ["Google Calendar интеграция бот", "календарь Telegram бот", "синхронизация событий", "запись в календарь через мессенджер", "бот расписание", "Google Calendar API", "напоминания в Telegram", "автозапись Google Calendar", "Google Meet бот"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция Google Calendar связывает раздел «Календарь» кабинета с основным календарём Google-аккаунта по OAuth 2.0: чтение занятости, создание, изменение и удаление событий, ссылки Google Meet. AI-ассистент записывает клиентов из чата, Яндекс Календарь подключается по CalDAV. > > - Где: «Интеграции» → Google Calendar → «Подключить» (окно авторизации Google); события в разделе «Календарь», импорт кнопкой «Синхронизировать». > - Используется только основной календарь аккаунта (primary), API Google Calendar v3; токен OAuth 2.0 обновляется автоматически. > - Ссылка Google Meet создаётся по опции при создании события (conferenceData, hangoutsMeet). > - Яндекс Календарь: CalDAV caldav.yandex.ru, логин плюс OAuth-токен или пароль приложения, календарь events-default. > - Создание события вызывает исходящий вебхук calendar.event_created с полем provider. > - Запись клиентов через AI: режим «Запись в календарь». > > Связанные страницы: https://docs.tuk-tuk.online/ai/calendar-booking, https://docs.tuk-tuk.online/calendar/events, https://docs.tuk-tuk.online/calendar/staff, https://docs.tuk-tuk.online/integrations/yclients, https://docs.tuk-tuk.online/integrations # Интеграция Google Calendar Интеграция связывает раздел «Календарь» в кабинете с основным календарём вашего Google-аккаунта. AI-ассистент видит занятость, предлагает клиенту свободное время и создаёт событие, при необходимости со ссылкой на Google Meet. Оператор работает с теми же событиями в кабинете. Тем же способом, только по протоколу CalDAV, подключается Яндекс Календарь. ## Что синхронизируется | Действие | Google Calendar | Что видно в кабинете | |---|---|---| | Чтение событий | Список событий основного календаря (`primary`) за период | Импорт в раздел «Календарь» по кнопке «Синхронизировать» | | Создание события | Событие в основном календаре, по желанию с конференцией Google Meet | Событие с пометкой провайдера `google` | | Изменение события | Перенос, новое название и описание | Обновлённое событие | | Удаление события | Событие удаляется из Google Calendar | Событие удаляется из кабинета | ## Что нужно на стороне Google - Google-аккаунт, в основном календаре которого будут создаваться события. - Согласие на доступ к календарю в окне авторизации Google. - Для ссылок Google Meet: аккаунт, в котором доступен Meet (личный Google или Google Workspace). ## Как подключить 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Google Calendar и нажмите «Подключить»: откроется окно авторизации Google. 2. Войдите в нужный Google-аккаунт и разрешите доступ к календарю: окно закроется, карточка получит отметку «Интеграция подключена». 3. Откройте раздел «Календарь» в кабинете: в шапке появится переключатель календарей с подключённым Google-аккаунтом. 4. Нажмите «Синхронизировать»: события из Google Calendar появятся на таймлайне. События создаются в основном календаре аккаунта (`primary`). Чтобы клиентские записи не смешивались с личными, подключайте отдельный Google-аккаунт. ## Проверить, что работает 1. Создайте событие в кабинете через «+ Новое событие», выбрав подключённый Google-календарь: событие появится в Google Calendar через несколько секунд. 2. Создайте событие в Google Calendar и нажмите «Синхронизировать» в кабинете: событие появится на таймлайне. 3. Напишите боту с тестового номера «хочу на консультацию завтра»: ассистент предложит свободные слоты, а после выбора создаст событие. ## Что происходит после подключения | Событие | Действие платформы | |---|---| | Клиент просит записаться | AI-ассистент в режиме [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking) читает занятость и создаёт событие в Google Calendar | | Оператор создал событие в кабинете с этим календарём | Событие создаётся в Google Calendar, в кабинете сохраняется внешний ID | | Оператор изменил или удалил событие | Изменение уходит в Google Calendar | | Нажата кнопка «Синхронизировать» | События из Google Calendar импортируются в кабинет | | Событие создано | Срабатывает исходящий вебхук `calendar.event_created` с полем `provider: google` | ## Пример диалога с AI-ассистентом | Кто | Сообщение | |---|---| | Клиент | Хочу записаться на консультацию | | AI | Свободные слоты на этой неделе: среда 14:00–15:00, четверг 10:00–11:00, пятница 16:00–17:00. Какое время удобно? | | Клиент | Четверг в 10 | | AI | Записал вас на четверг, 10:00. Ссылка на Google Meet: … | ## Яндекс Календарь Яндекс Календарь подключается по CalDAV (`caldav.yandex.ru`) с логином Яндекса и OAuth-токеном или паролем приложения. События создаются в календаре по умолчанию (`events-default`). В разделе «Календарь» кабинета Яндекс и Google переключаются в одном списке. ## Ограничения - Используется только основной календарь аккаунта (`primary`); выбрать другой календарь нельзя. - Токен Google OAuth 2.0 обновляется автоматически; при отзыве доступа в Google интеграцию нужно подключить заново. - События создаются от имени подключённого Google-аккаунта: приглашения и Meet-ссылки клиент видит как отправленные им. - Импорт из Google запускается кнопкой «Синхронизировать», а не по расписанию. ## Частые проблемы | Проблема | Что делать | |---|---| | AI не видит расписание | Проверьте, что интеграция активна и в настройках ассистента выбран этот календарь | | Ошибка авторизации | Подключите интеграцию заново: токен мог быть отозван в настройках Google-аккаунта | | Google Meet не создаётся | Убедитесь, что в аккаунте доступен Meet и при создании события включена опция ссылки на встречу | | Событие не в том календаре | События всегда идут в основной календарь подключённого аккаунта; подключите другой аккаунт | | События из Google не появились | Нажмите «Синхронизировать» и проверьте период отображения на таймлайне | --- --- title: "Интеграция Битрикс24: лиды, сделки и контакты из мессенджеров" nav_title: "Битрикс24" url: https://docs.tuk-tuk.online/integrations/bitrix24 markdown: https://docs.tuk-tuk.online/integrations/bitrix24.md section: "Интеграции" description: "Как подключить Битрикс24 к tuk-tuk.online через входящий вебхук: создание лидов, сделок и контактов из обращений в мессенджерах, поиск компаний, справочники стадий и статусов." keywords: ["Битрикс24 Telegram интеграция", "Bitrix24 мессенджер подключить", "CRM Битрикс мессенджеры", "лиды из мессенджеров", "автоматизация продаж Битрикс24", "Битрикс24 чат-бот", "CRM воронка мессенджеры", "Битрикс24 API webhook"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция Битрикс24 подключается через входящий вебхук (вставляется URL вебхука целиком) и создаёт из обращений в мессенджерах контакты, лиды и сделки, читает компании и справочники стадий и статусов. > > - Где: «Интеграции» → Битрикс24 → «Подключить»; одно поле «URL входящего вебхука» (https://mycompany.bitrix24.ru/rest/1/abc123xyz/), адрес портала и токен извлекаются автоматически. > - Предусловие: входящий вебхук в Битрикс24 («Приложения» → «Вебхуки») с правами crm и user. > - Проверка при подключении: метод profile; вызовы идут на {портал}/rest/{token}/{метод}.json. > - Методы: crm.contact.list/add, crm.deal.list/add, crm.lead.list/add, crm.company.list, crm.dealcategory.stage.list, crm.status.list. > - Вебхук работает от имени сотрудника, который его создал, и с его правами. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/amocrm, https://docs.tuk-tuk.online/integrations/retailcrm, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/ai/lead-converter # Интеграция Битрикс24 Интеграция создаёт в Битрикс24 лиды, сделки и контакты из обращений в мессенджерах. Клиент пишет в Telegram, менеджер видит лид с телефоном и историей в привычной CRM. Подключение идёт через входящий вебхук Битрикс24: без OAuth, без приложения в маркетплейсе. Токен вебхука вводится один раз. ## Что синхронизируется | Сущность Битрикс24 | Чтение | Запись | |---|---|---| | Контакты | Поиск по имени, телефону и email, список | Создание из диалога: фамилия, имя, отчество, email, телефон, должность, источник | | Сделки | Список с фильтрами | Создание с названием, суммой, воронкой, ответственным, источником и комментарием | | Лиды | Список с фильтрами | Создание из первого обращения: имя, фамилия, телефон, email, источник, комментарий | | Компании | Поиск и список для привязки к контактам и сделкам | Нет | | Справочники | Стадии сделок (`crm.dealcategory.stage.list`), статусы лидов (`crm.status.list`) | Нет | ## Что нужно на стороне Битрикс24 - Портал Битрикс24 (облачный или коробочный) с включённым модулем CRM. - Сотрудник с правом создавать вебхуки: вебхук работает от его имени и с его правами. - Входящий вебхук с правами `crm` (CRM) и `user` (Пользователи). ## Как подключить ![Подключение Битрикс24](https://docs.tuk-tuk.online/assets/screens/integrations/bitrix24.webp) 1. Поле «URL входящего вебхука». 2. Кнопка подключения. ### Создать вебхук в Битрикс24 1. Откройте Битрикс24 → «Приложения» → «Вебхуки» и нажмите «Добавить вебхук» → «Входящий вебхук». 2. Задайте название, например «tuk-tuk.online», и отметьте права CRM (`crm`) и Пользователи (`user`). 3. Сохраните и скопируйте URL вебхука: он выглядит так. ```text https://mycompany.bitrix24.ru/rest/1/abc123xyz/ ``` Токен доступа уже зашит в URL: часть после `/rest/` (здесь `1/abc123xyz`). Отдельно копировать его не нужно. ### Подключить в tuk-tuk.online 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Битрикс24 и нажмите «Подключить»: появится форма с одним полем. 2. Вставьте в поле «URL входящего вебхука» ссылку целиком, например `https://mycompany.bitrix24.ru/rest/1/abc123xyz/`: платформа сама разберёт её на адрес портала и токен. 3. Нажмите «Подключить»: платформа вызовет метод `profile` и при успехе отметит карточку «Интеграция подключена». При неверном токене форма покажет «Неверный Webhook Token Битрикс24». ## Проверить, что работает 1. Нажмите «Управлять» и откройте страницу Битрикс24 в кабинете: во вкладке «Контакты» загрузится список из портала. 2. Создайте тестовый контакт или лид в форме на этой странице: запись появится в CRM Битрикс24 у сотрудника, от имени которого создан вебхук. ## Что происходит после подключения | Событие | Вызов Битрикс24 | |---|---| | Создание контакта из диалога | `crm.contact.add` | | Создание сделки | `crm.deal.add` | | Создание лида | `crm.lead.add` | | Поиск контакта, сделки, лида, компании | `crm.contact.list`, `crm.deal.list`, `crm.lead.list`, `crm.company.list` | | Загрузка стадий и статусов | `crm.dealcategory.stage.list`, `crm.status.list` | Все вызовы идут POST-запросами на `{адрес портала}/rest/{token}/{метод}.json`. Авторизация встроена в URL, отдельных запросов на токен нет. ## Ограничения - Вебхук действует от имени конкретного сотрудника Битрикс24 и наследует его права на CRM. - Права вебхука задаются при создании; для интеграции достаточно `crm` и `user`. - URL вебхука содержит токен: не публикуйте его и не пересылайте в открытых чатах. - Двусторонней переписки внутри Битрикс24 нет: сообщения клиентов остаются в tuk-tuk.online, в CRM уходят контакты, лиды и сделки. ## Частые проблемы | Проблема | Что делать | |---|---| | Контакты не создаются | Проверьте, что у вебхука есть право `crm` | | Ошибка 401 или «Неверный Webhook Token» | Скопируйте URL вебхука заново из Битрикс24: администратор мог пересоздать секретный код | | Сделка не в той воронке | При создании сделки укажите воронку и стадию из справочника стадий | | Лиды дублируются | Перед созданием ищите контакт по телефону или email и создавайте лид только для новых | | Вебхук перестал работать | Сотрудник, создавший вебхук, уволен или лишён прав: создайте вебхук от другого сотрудника и обновите токен | --- --- title: "Интеграция GetCourse: пользователи, сделки и группы обучения" nav_title: "GetCourse" url: https://docs.tuk-tuk.online/integrations/getcourse markdown: https://docs.tuk-tuk.online/integrations/getcourse.md section: "Интеграции" description: "Как подключить GetCourse к tuk-tuk.online по API Secret Key: выгрузка пользователей, сделок и групп, создание пользователей и заказов из мессенджеров, асинхронный экспорт с опросом статуса." keywords: ["GetCourse интеграция", "GetCourse API", "GetCourse Telegram бот", "GetCourse подключить", "GetCourse вебхук", "онлайн-курсы автоматизация", "GetCourse пользователи", "GetCourse сделки", "инфобизнес автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция GetCourse подключается по имени аккаунта и API Secret Key: выгрузка пользователей, сделок и групп обучения, создание пользователей и сделок из мессенджеров и AI-ассистентов. > > - Где: «Интеграции» → GetCourse → «Подключить»; поля «Имя аккаунта» (поддомен без .getcourse.ru) и «API Secret Key». > - Предусловие: тариф GetCourse с доступом к API, секретный ключ из «Настройки» → «Профиль» → «API». > - API: POST https://{аккаунт}.getcourse.ru/pl/api/{путь}, тело application/x-www-form-urlencoded (key, action, params). > - Экспорт асинхронный: account/users, account/deals, account/groups, опрос account/exports/{id} каждые 5 с, до 6 попыток (30 с). > - Создание: users add с refresh_if_exists=1 (email, имя, фамилия, телефон, группа); deals add с offer_code, deal_cost, deal_comment, addToGroup. > - Одна интеграция = один аккаунт GetCourse. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/ai/lead-converter, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/dialogs/import-export # Интеграция GetCourse Интеграция связывает школу на GetCourse с мессенджерами. Человек пишет боту «хочу на курс», AI-ассистент проверяет группы обучения в GetCourse и создаёт пользователя и заказ по коду предложения, без ручной регистрации. Подключение требует только имя аккаунта и секретный ключ API. ## Что синхронизируется | Данные GetCourse | Чтение | Запись | |---|---|---| | Пользователи | Выгрузка списка, поиск по email и имени | Создание или обновление пользователя: email, имя, фамилия, телефон, группа | | Сделки (заказы) | Выгрузка списка | Создание сделки: email пользователя, код предложения, стоимость, комментарий, добавление в группу | | Группы обучения | Выгрузка списка групп, курсов и потоков | Нет | ## Что нужно на стороне GetCourse - Тариф GetCourse с доступом к API. - Секретный ключ API из настроек аккаунта. - Имя аккаунта (поддомен), например `myschool` из `myschool.getcourse.ru`. ## Как подключить ![Подключение GetCourse](https://docs.tuk-tuk.online/assets/screens/integrations/getcourse.webp) 1. Имя аккаунта GetCourse. 2. API Secret Key. 3. Кнопка подключения. 1. Откройте GetCourse → «Настройки» → «Профиль» → «API» и скопируйте секретный ключ (Secret Key). 2. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите GetCourse и нажмите «Подключить»: появится форма с двумя полями. 3. В поле «Имя аккаунта» введите поддомен без `.getcourse.ru`, в поле «API Secret Key» вставьте ключ. 4. Нажмите «Подключить»: платформа запросит выгрузку пользователей и при успехе отметит карточку «Интеграция подключена». > [!WARNING] Секретный ключ даёт доступ ко всем данным аккаунта GetCourse. Не пересылайте его в чатах и не храните в открытых документах. ## Проверить, что работает 1. Нажмите «Управлять» и откройте страницу GetCourse в кабинете: во вкладке пользователей появится список из GetCourse (выгрузка занимает 5–30 секунд). 2. Найдите пользователя по email через поле «Поиск по email»: карточка найдётся. 3. Создайте тестового пользователя в форме (email, имя, фамилия, телефон, группа): он появится в GetCourse, а если email уже есть, данные обновятся. ## Что происходит после подключения | Действие | Вызов GetCourse | |---|---| | Выгрузка пользователей | `POST /pl/api/account/users`, затем опрос `account/exports/{id}` | | Выгрузка сделок | `POST /pl/api/account/deals`, затем опрос экспорта | | Выгрузка групп | `POST /pl/api/account/groups`, затем опрос экспорта | | Создание пользователя | `POST /pl/api/users` с `action=add` и `refresh_if_exists=1` | | Создание сделки | `POST /pl/api/deals` с `action=add`, `offer_code`, `deal_cost`, `deal_comment`, `addToGroup` | ### Как устроен экспорт GetCourse отдаёт списки асинхронно: мгновенной выдачи нет, потому что в аккаунте могут быть тысячи пользователей. 1. Платформа отправляет запрос на экспорт и получает `export_id`. 2. Каждые 5 секунд платформа опрашивает `account/exports/{export_id}`. 3. Когда статус становится `exported`, платформа забирает данные. Максимум 6 попыток, то есть до 30 секунд ожидания. ```text tuk-tuk.online -> POST https://myschool.getcourse.ru/pl/api/account/users (запуск экспорта, ответ: export_id) tuk-tuk.online -> POST https://myschool.getcourse.ru/pl/api/account/exports/{export_id} (опрос статуса, каждые 5 с) tuk-tuk.online <- JSON с данными (status: exported) ``` ## Ограничения - API GetCourse принимает только `POST` с телом `application/x-www-form-urlencoded`: поля `key`, `action`, `params` (JSON-строка). - Экспорт списка занимает до 30 секунд (6 опросов по 5 секунд); при превышении возвращается пустой список. - Один ключ = один аккаунт GetCourse; одна интеграция = один аккаунт. - Пользователь с существующим email обновляется, а не дублируется (`refresh_if_exists=1`). ## Частые проблемы | Проблема | Что делать | |---|---| | Нет доступа к API | Проверьте, что API включён в настройках GetCourse и тариф его поддерживает | | Ошибка экспорта | Сверьте имя аккаунта: только поддомен, без `https://` и `.getcourse.ru` | | Пользователь не создаётся | Убедитесь, что указан email, а ключ выдан для аккаунта с правом записи | | Экспорт вернул пустой список | GetCourse не успел подготовить выгрузку за 30 секунд: повторите запрос | | Сделка создаётся без предложения | Укажите действующий код предложения (`offer_code`) из GetCourse | --- --- title: "Интеграция RetailCRM: клиенты и заказы из мессенджеров" nav_title: "RetailCRM" url: https://docs.tuk-tuk.online/integrations/retailcrm markdown: https://docs.tuk-tuk.online/integrations/retailcrm.md section: "Интеграции" description: "Как подключить RetailCRM к tuk-tuk.online по API-ключу (REST API v5): поиск клиентов и заказов, создание заказов из диалога, справочники статусов, доставок и магазинов, ответы о статусе заказа через AI." keywords: ["RetailCRM интеграция", "RetailCRM API", "RetailCRM подключить", "RetailCRM Telegram", "RetailCRM заказы", "RetailCRM мессенджер", "интернет-магазин CRM", "e-commerce CRM", "RetailCRM автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция RetailCRM подключается по адресу инстанса и API-ключу (REST API v5): чтение и создание клиентов и заказов, справочники статусов, типов доставки и магазинов; AI-ассистент отвечает о статусе заказа по телефону клиента. > > - Где: «Интеграции» → RetailCRM → «Подключить»; поля «API URL» (https://myshop.retailcrm.ru), «API Key», «Код сайта (опционально)». > - Предусловие: API-ключ из «Настройки» → «Интеграция» → «API-ключи» с правами на клиентов, заказы и справочники. > - Проверка при подключении: GET /api/v5/credentials?apiKey=... > - Эндпоинты: customers, orders, reference/statuses, reference/delivery-types, reference/sites, customers/create, orders/create. > - GET передаёт apiKey в query, POST отправляет форму; «Код сайта» подставляется в поле site заказа. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/bitrix24, https://docs.tuk-tuk.online/integrations/onec, https://docs.tuk-tuk.online/ai/sales-assistant, https://docs.tuk-tuk.online/chains/blocks/webhook # Интеграция RetailCRM Интеграция открывает клиентскую базу и заказы интернет-магазина мессенджерам. Клиент спрашивает в чате «где мой заказ?», AI-ассистент находит заказ в RetailCRM по телефону и отвечает статусом. Оператор создаёт заказ из диалога, не переключаясь в CRM. Подключение по API-ключу RetailCRM с нужными правами, через REST API v5. ## Что синхронизируется | Данные RetailCRM | Чтение | Запись | |---|---|---| | Клиенты | Список с пагинацией, поиск по имени, телефону и email | Создание: фамилия, имя, отчество, email, телефон, внешний ID, теги | | Заказы | Список с фильтрами, статус заказа | Создание: клиент, товары, доставка, адрес, комментарий | | Статусы заказов | Справочник `reference/statuses` | Нет | | Типы доставки | Справочник `reference/delivery-types` | Нет | | Сайты (магазины) | Справочник `reference/sites` | Заказ привязывается к магазину из поля «Код сайта» | ## Что нужно на стороне RetailCRM - Адрес вашего инстанса, например `https://myshop.retailcrm.ru`. - API-ключ с правами: клиенты (чтение и запись), заказы (чтение и запись), справочники (чтение). - Код сайта, если в RetailCRM несколько магазинов и заказы должны попадать в конкретный. ## Как подключить ![Подключение RetailCRM](https://docs.tuk-tuk.online/assets/screens/integrations/retailcrm.webp) 1. API URL вашей CRM. 2. API Key. 3. Код сайта, если магазинов несколько. 4. Кнопка подключения. 1. Откройте RetailCRM → «Настройки» → «Интеграция» → «API-ключи» и нажмите «Добавить». 2. Задайте имя ключа, например «tuk-tuk.online», отметьте права на клиентов, заказы и справочники, сохраните и скопируйте ключ. 3. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите RetailCRM и нажмите «Подключить»: появится форма с тремя полями. 4. Заполните «API URL» (адрес инстанса без завершающего слэша), «API Key» и при необходимости «Код сайта (опционально)», например `main`. 5. Нажмите «Подключить»: платформа вызовет `GET /api/v5/credentials` и при успехе отметит карточку «Интеграция подключена». При неверном ключе форма покажет «Неверный API ключ RetailCRM». ## Проверить, что работает 1. Нажмите «Управлять» и откройте страницу RetailCRM в кабинете: во вкладке клиентов загрузится список из CRM, работает «Поиск по имени». 2. Создайте тестового клиента в форме: он появится в RetailCRM с указанными тегами. 3. Создайте тестовый заказ (имя, фамилия, телефон, email, товар, адрес доставки, комментарий): заказ появится в RetailCRM в магазине из поля «Код сайта». ## Что происходит после подключения | Действие | Вызов RetailCRM | |---|---| | Список и поиск клиентов | `GET /api/v5/customers?apiKey=...` | | Список заказов и статус заказа | `GET /api/v5/orders?apiKey=...` | | Справочники | `GET /api/v5/reference/statuses`, `reference/delivery-types`, `reference/sites` | | Создание клиента | `POST /api/v5/customers/create` | | Создание заказа | `POST /api/v5/orders/create` (поле `site` берётся из «Код сайта») | GET-запросы передают `apiKey` в query-параметре, POST-запросы отправляют данные формой (`application/x-www-form-urlencoded`). ## Ограничения - Используется REST API v5 RetailCRM. - Права ключа определяют доступ: без права на запись заказов заказ не создастся. - Одна интеграция = один инстанс RetailCRM; для второго магазина в том же инстансе используйте «Код сайта». - Двусторонней переписки внутри RetailCRM нет: сообщения остаются в tuk-tuk.online, в CRM уходят клиенты и заказы. ## Частые проблемы | Проблема | Что делать | |---|---| | Клиенты не загружаются | Проверьте, что у ключа есть право на чтение клиентов | | Заказ не создаётся | Заполните обязательные поля: клиент (телефон или email) и хотя бы один товар | | Ошибка 403 | У ключа нет нужных прав: создайте новый ключ с правами на клиентов, заказы и справочники | | «Не удалось подключиться» | Сверьте «API URL»: адрес инстанса без пути и без завершающего слэша, например `https://myshop.retailcrm.ru` | | Заказ попал не в тот магазин | Укажите код нужного магазина в поле «Код сайта» (справочник `reference/sites`) | --- --- title: "Интеграция 1С:Предприятие: контрагенты, заказы и номенклатура" nav_title: "1С:Предприятие" url: https://docs.tuk-tuk.online/integrations/onec markdown: https://docs.tuk-tuk.online/integrations/onec.md section: "Интеграции" description: "Как подключить 1С:Предприятие к tuk-tuk.online через стандартный OData-интерфейс с Basic Auth: справочники контрагентов, номенклатуры, складов и организаций, заказы покупателей, создание контрагентов и заказов из мессенджеров." keywords: ["1С интеграция", "1С CRM мессенджер", "1С Предприятие API", "1С OData", "1С подключить Telegram", "1С контрагенты", "1С заказы", "1С интеграция чат-бот", "1С автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция 1С:Предприятие подключается к стандартному OData-интерфейсу базы по логину и паролю (Basic Auth): чтение контрагентов, номенклатуры, заказов покупателей, складов и организаций, создание контрагентов и заказов из мессенджеров. > > - Где: «Интеграции» → 1С:Предприятие → «Подключить»; поля «URL базы 1С» (адрес публикации без /odata/standard.odata), «Пользователь», «Пароль». > - Предусловие: база опубликована на веб-сервере с включённым OData, объекты Catalog_Контрагенты, Catalog_Номенклатура, Document_ЗаказПокупателя, Catalog_Склады, Catalog_Организации входят в публикацию. > - Проверка при подключении: GET {URL базы}/odata/standard.odata/$metadata. > - Списки читаются по 50 записей ($top=50, $skip); заказы фильтруются по Posted eq true/false. > - Запись: POST Catalog_Контрагенты и POST Document_ЗаказПокупателя. > - Авторизация Basic Auth в каждом запросе; рекомендуется отдельный пользователь 1С с минимальными правами и HTTPS. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/integrations/retailcrm, https://docs.tuk-tuk.online/integrations/bitrix24, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/ai/sales-assistant # Интеграция 1С:Предприятие Интеграция открывает справочники и документы 1С мессенджерам. Клиент спрашивает «есть ли товар в наличии?», AI-ассистент проверяет номенклатуру в 1С. Менеджер пишет имя клиента, платформа находит контрагента и показывает его заказы. Подключение идёт через стандартный OData-интерфейс 1С с авторизацией по логину и паролю. ## Что синхронизируется | Объект 1С | OData-сущность | Чтение | Запись | |---|---|---|---| | Контрагенты | `Catalog_Контрагенты` | Список, поиск по наименованию | Создание с ИНН, КПП и контактами | | Номенклатура | `Catalog_Номенклатура` | Список товаров и услуг, поиск по названию | Нет | | Заказы покупателей | `Document_ЗаказПокупателя` | Список с фильтром по проведённости | Создание заказа | | Склады | `Catalog_Склады` | Список складов и филиалов | Нет | | Организации | `Catalog_Организации` | Список ваших юрлиц | Нет | ## Что нужно на стороне 1С - Информационная база, опубликованная на веб-сервере (Apache или IIS) с включённым стандартным интерфейсом OData. - В публикации OData разрешены объекты из таблицы выше: без этого справочник вернёт ошибку «не найден». - Отдельный пользователь 1С для интеграции с правами на чтение нужных справочников и документов и на запись контрагентов и заказов. - Доступ к серверу 1С из интернета напрямую или через VPN и туннель. ## Как подключить ![Подключение 1С:Предприятие](https://docs.tuk-tuk.online/assets/screens/integrations/onec.webp) 1. URL базы 1С с включённым OData. 2. Пользователь. 3. Пароль. 4. Кнопка подключения. ### Настроить OData в 1С 1. Откройте базу в конфигураторе и включите публикацию стандартного интерфейса OData для нужных справочников и документов. 2. Опубликуйте базу на веб-сервере: появится адрес вида `https://my1c.company.ru/base`. 3. Создайте пользователя 1С для интеграции и выдайте ему минимальные права. 4. Проверьте в браузере адрес `https://my1c.company.ru/base/odata/standard.odata/$metadata` под этим пользователем: откроется XML с описанием объектов. ### Подключить в tuk-tuk.online 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите 1С:Предприятие и нажмите «Подключить»: появится форма с тремя полями. 2. В поле «URL базы 1С» введите адрес публикации базы без `/odata/standard.odata`, например `https://my1c.company.ru/base`: путь к OData платформа добавляет сама. 3. Заполните «Пользователь» и «Пароль» пользователя 1С. 4. Нажмите «Подключить»: платформа запросит `$metadata` и при успехе отметит карточку «Интеграция подключена». При неверных данных форма покажет «Неверный логин или пароль 1С». ## Проверить, что работает 1. Нажмите «Управлять» и откройте страницу 1С в кабинете: работает «Поиск контрагента», список подгружается страницами по 50 записей. 2. Откройте номенклатуру и найдите товар через «Поиск номенклатуры»: карточка найдётся. 3. Создайте тестового контрагента: он появится в справочнике 1С. ## Что происходит после подключения | Действие | Запрос к 1С | |---|---| | Список и поиск контрагентов | `GET /odata/standard.odata/Catalog_Контрагенты?$format=json&$top=50&$skip=N` | | Список товаров | `GET /odata/standard.odata/Catalog_Номенклатура?$format=json&$top=50` | | Список заказов | `GET /odata/standard.odata/Document_ЗаказПокупателя?$format=json&$orderby=Date desc` | | Только проведённые заказы | тот же запрос с `$filter=Posted eq true` | | Склады и организации | `GET .../Catalog_Склады`, `GET .../Catalog_Организации` | | Создание контрагента | `POST /odata/standard.odata/Catalog_Контрагенты` | | Создание заказа | `POST /odata/standard.odata/Document_ЗаказПокупателя` | Каждый запрос уходит с заголовком `Authorization: Basic` (логин и пароль в base64). ## Ограничения - Только стандартный OData-интерфейс 1С; HTTP-сервисы собственной разработки не используются. - Списки читаются страницами по 50 записей. - Логин и пароль передаются в каждом запросе: публикуйте базу только по HTTPS. - Названия объектов фиксированы (`Catalog_Контрагенты`, `Document_ЗаказПокупателя` и другие из таблицы): конфигурации без этих объектов интеграция не поддерживает. - Фильтр заказов работает по признаку проведения (`Posted`). ## Частые проблемы | Проблема | Что делать | |---|---| | «Не удалось подключиться» | Проверьте, что база опубликована, OData включён и адрес открывается из интернета; в поле «URL базы 1С» не должно быть `/odata/standard.odata` | | 401 Unauthorized, «Неверный логин или пароль 1С» | Сверьте учётные данные пользователя 1С, попробуйте войти ими в веб-клиент | | Справочник не найден | Включите нужный объект в состав публикации OData в конфигураторе | | Нет данных | Выдайте пользователю 1С права на чтение справочника или документа | | Медленный ответ | Сервер 1С перегружен или база большая: сузьте поиск по наименованию и повторите позже | --- --- title: "Интеграция Notion: задачи и заметки из мессенджеров в базу Notion" nav_title: "Notion" url: https://docs.tuk-tuk.online/integrations/notion markdown: https://docs.tuk-tuk.online/integrations/notion.md section: "Интеграции" description: "Как подключить Notion к tuk-tuk.online по токену внутренней интеграции: выбор базы данных, выдача доступа через Connections, экспорт задач и заметок страницами Notion, проверка подключения." keywords: ["Notion интеграция", "Notion API токен", "экспорт задач в Notion", "Notion из Telegram", "заметки в Notion", "Notion database id", "Notion internal integration", "Notion Connections"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция Notion подключается по токену внутренней интеграции и базе данных с выданным доступом (Connections); задачи и заметки экспортируются страницами Notion с заголовком в title-свойство и текстом абзацами. > > - Где: «Интеграции» → Notion → «Подключить»; поля «Internal Integration Secret» (ntn_… или secret_…) и «База данных по умолчанию» (ссылка или ID, нормализуется в UUID). > - Предусловие: интеграция добавлена в базу через «•••» → «Connections», иначе Notion возвращает 404. > - Проверка при подключении: GET /v1/users/me и GET /v1/databases/{id}; сохраняются название базы и имя title-свойства. > - Экспорт: POST /v1/pages с parent.database_id, Notion-Version 2022-06-28; текст разбивается на абзацы. > - Кнопка «Проверить» в окне интеграции повторяет проверку и подсказывает, если база по умолчанию не задана. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/tasks, https://docs.tuk-tuk.online/integrations/yandex-metrika, https://docs.tuk-tuk.online/chains/blocks/integration # Интеграция Notion Интеграция отправляет задачи и заметки из кабинета в базу данных Notion. Оператор фиксирует договорённость с клиентом прямо из диалога, и в Notion появляется страница с заголовком и текстом: команда работает в привычном пространстве, ничего не переписывая руками. Подключение требует токен внутренней интеграции Notion и базу данных, которой выдан доступ. ## Что синхронизируется | Данные | Чтение | Запись | |---|---|---| | База данных по умолчанию | Заголовок базы и имя свойства-заголовка проверяются при подключении | Нет | | Страницы в базе | Нет | Создание страницы: заголовок в title-свойство базы, текст абзацами в теле страницы | ## Что нужно на стороне Notion - Рабочее пространство Notion, где вы владелец или администратор. - Внутренняя интеграция (Internal integration) с правами «Insert content» и «Read content». - База данных, к которой этой интеграции выдан доступ. ## Как подключить ### Создать интеграцию в Notion 1. Откройте [notion.so/profile/integrations](https://www.notion.so/profile/integrations) и нажмите «New integration». 2. Выберите рабочее пространство, тип «Internal», отметьте права чтения и вставки контента. 3. Скопируйте «Internal Integration Secret». Новые токены начинаются с `ntn_`, старые начинаются с `secret_`; работают оба. ### Выдать доступ к базе 1. Откройте базу данных в Notion, нажмите «•••» в правом верхнем углу. 2. В разделе «Connections» добавьте созданную интеграцию. 3. Скопируйте ссылку на базу («Copy link») или её ID из адресной строки. > [!WARNING] Без шага «Connections» Notion отвечает 404 на любой запрос к базе. Платформа покажет подсказку «интеграции не выдан доступ» и не сохранит подключение. ### Подключить в tuk-tuk.online 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Notion и нажмите «Подключить». 2. Вставьте токен в поле «Internal Integration Secret». 3. В поле «База данных по умолчанию» вставьте ссылку на базу целиком или её ID: платформа сама приведёт ссылку к идентификатору. 4. Нажмите «Подключить»: платформа проверит токен методом `GET /v1/users/me`, прочитает базу, запомнит её название и имя title-свойства. ## Проверить, что работает 1. В окне интеграции нажмите «Проверить»: блок «Состояние подключения» покажет «Токен работает, база «…» доступна». 2. Откройте любой диалог или задачу и выполните «Отправить в Notion»: в базе появится новая страница, а в ответе придёт ссылка на неё. ## Что происходит после подключения | Действие | Вызов Notion | |---|---| | Проверка токена | `GET https://api.notion.com/v1/users/me` | | Проверка базы | `GET https://api.notion.com/v1/databases/{id}` | | Экспорт задачи или заметки | `POST https://api.notion.com/v1/pages` с `parent.database_id`, заголовком в title-свойство и абзацами в `children` | Запросы идут с заголовком `Notion-Version: 2022-06-28`: эта версия принимает `database_id` для баз с одним источником данных. Каждый запрос ограничен 15 секундами. ## Ограничения - Экспорт создаёт страницу только в базе; страницы-родители без базы не поддерживаются. - Заголовок попадает в title-свойство базы (как бы оно ни называлось); остальные свойства базы не заполняются. - Если в базе несколько источников данных (multi-source database), Notion может отклонить создание страницы: оставьте один источник или создайте отдельную базу для экспорта. - Текст разбивается на абзацы по переносам строк; форматирование Markdown не переносится. ## Частые проблемы | Проблема | Что делать | |---|---| | «База данных Notion не найдена или интеграции не выдан доступ» | Откройте базу → «•••» → «Connections» и добавьте интеграцию | | «Неверный Integration Token» | Скопируйте секрет заново на странице интеграций Notion; проверьте, что нет лишних пробелов | | Страница создаётся не в той базе | Проверьте «База данных по умолчанию» в настройках интеграции; при экспорте можно указать другую базу | | Страница без текста | Текст пустой или состоит только из пробелов: абзацы формируются из непустых строк | --- --- title: "Интеграция Яндекс.Метрики: офлайн-конверсии из мессенджеров" nav_title: "Яндекс.Метрика" url: https://docs.tuk-tuk.online/integrations/yandex-metrika markdown: https://docs.tuk-tuk.online/integrations/yandex-metrika.md section: "Интеграции" description: "Как подключить Яндекс.Метрику к tuk-tuk.online по OAuth-токену: выбор событий, цели типа «JavaScript-событие», формат офлайн-конверсий, проверка счётчика и целей." keywords: ["Яндекс Метрика интеграция", "офлайн-конверсии Метрика", "Метрика API токен", "конверсии из Telegram", "цели JavaScript-событие", "Метрика мессенджер", "сквозная аналитика чат-бот", "Метрика OAuth"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Интеграция Яндекс.Метрики подключается по номеру счётчика и OAuth-токену и отправляет выбранные события кабинета офлайн-конверсиями (multipart CSV, UserId, Unix-время) в цели типа «JavaScript-событие» с идентификаторами dialog.created, message.inbound и другими. > > - Где: «Интеграции» → Яндекс.Метрика → «Подключить»; поля «Номер счётчика» и «OAuth-токен» (y0_…). > - Предусловия: включены офлайн-конверсии в настройках счётчика; созданы цели «JavaScript-событие» с идентификаторами, равными кодам событий. > - События: dialog.created, dialog.updated, message.inbound, calendar.event_created, chain.execution_completed, payment.succeeded; выбираются в окне интеграции. > - Отправка: POST /management/v1/counter/{id}/offline_conversions/upload?client_id_type=USER_ID, multipart/form-data с CSV-файлом UserId,Target,DateTime[,Price,Currency]. > - Кнопка «Проверить» подтверждает доступ к счётчику и перечисляет события без соответствующей цели. > > Связанные страницы: https://docs.tuk-tuk.online/integrations, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/integrations/notion, https://docs.tuk-tuk.online/dashboard # Интеграция Яндекс.Метрики Интеграция отправляет события кабинета в Яндекс.Метрику как офлайн-конверсии. Новый диалог, входящее сообщение, запись на услугу, выполненная цепочка или оплата становятся целями в отчётах Метрики, и реклама оценивается по реальным обращениям, а не по кликам. Подключение требует номер счётчика и OAuth-токен с правами Метрики. ## Что синхронизируется | Событие кабинета | Код события (идентификатор цели) | |---|---| | Новый диалог | `dialog.created` | | Обновление диалога (закрытие, статус) | `dialog.updated` | | Входящее сообщение | `message.inbound` | | Запись на услугу | `calendar.event_created` | | Цепочка выполнена | `chain.execution_completed` | | Успешная оплата | `payment.succeeded` | Конверсия уходит с идентификатором посетителя `UserId` (ID диалога или события) и временем события. Для оплаты добавляются сумма и валюта. ## Что нужно на стороне Метрики - Счётчик Метрики, где у вас есть право редактирования. - OAuth-токен с правом «Метрика: получение статистики, чтение и изменение параметров счётчиков». - Включённая загрузка офлайн-конверсий в настройках счётчика. - Цели типа «JavaScript-событие» с идентификаторами из таблицы выше. ## Как подключить ### Получить OAuth-токен 1. Откройте [oauth.yandex.ru](https://oauth.yandex.ru) и создайте приложение с правами Яндекс.Метрики. 2. Получите токен для своего аккаунта (ссылка вида `oauth.yandex.ru/authorize?response_type=token&client_id=…`). 3. Скопируйте токен: он начинается с `y0_`. ### Подготовить счётчик 1. В Метрике откройте «Настройки → Загрузка данных» и включите «Офлайн-конверсии». 2. В разделе «Цели» создайте цель «JavaScript-событие» для каждого нужного события. Идентификатор цели должен совпадать с кодом события, например `dialog.created`. ### Подключить в tuk-tuk.online 1. Откройте раздел [Интеграции](https://lk.tuk-tuk.online/integrations), выберите Яндекс.Метрику и нажмите «Подключить». 2. Введите номер счётчика (число из адреса `metrika.yandex.ru/dashboard?id=…`) и OAuth-токен. 3. Нажмите «Подключить»: платформа проверит доступ к счётчику методом `GET /management/v1/counter/{id}`. 4. В окне интеграции отметьте события, которые нужно отправлять. Список сохраняется сразу. ## Проверить, что работает 1. Нажмите «Проверить» в блоке «Состояние подключения»: платформа подтвердит доступ к счётчику и перечислит события, для которых в счётчике нет цели «JavaScript-событие». 2. Создайте тестовый диалог (напишите боту с другого номера): конверсия `dialog.created` появится в отчёте «Конверсии» в течение нескольких часов. ## Что происходит после подключения | Действие | Вызов Метрики | |---|---| | Проверка счётчика | `GET https://api-metrika.yandex.net/management/v1/counter/{id}` | | Проверка целей | `GET https://api-metrika.yandex.net/management/v1/counter/{id}/goals` | | Отправка конверсии | `POST https://api-metrika.yandex.net/management/v1/counter/{id}/offline_conversions/upload?client_id_type=USER_ID`, тело `multipart/form-data` с файлом `file` | Файл конверсии: CSV в формате Метрики. ```text UserId,Target,DateTime dlg-8f3a…,dialog.created,1788602400 ``` `DateTime` передаётся как Unix-время в секундах; для оплаты добавляются колонки `Price` и `Currency`. ## Ограничения - На каждое событие уходит отдельная загрузка; Метрика показывает данные в отчётах в течение 2–3 часов. - Конверсия засчитается только при совпадении `Target` с идентификатором цели «JavaScript-событие»; цели по URL не подходят. - Время конверсии всегда «сейчас»: события из прошлого не досылаются. - Отправка не блокирует работу кабинета: при сбое Метрики событие пропускается и пишется в лог. ## Частые проблемы | Проблема | Что делать | |---|---| | «Неверный OAuth-токен или нет доступа к счётчику» | Выпустите токен под аккаунтом с правом редактирования счётчика и правами Метрики | | «Счётчик … не найден» | Сверьте номер счётчика с адресом страницы Метрики | | Конверсии не появляются в отчётах | Проверьте цель «JavaScript-событие» с точным идентификатором и включённую загрузку офлайн-конверсий; нажмите «Проверить» в окне интеграции | | Не выбрано ни одного события | Отметьте события в окне интеграции: без этого конверсии не отправляются | --- --- title: "Вебхуки: уведомления о событиях в Make, n8n, Zapier и свой сервер" nav_title: "Вебхуки" url: https://docs.tuk-tuk.online/integrations/webhooks markdown: https://docs.tuk-tuk.online/integrations/webhooks.md section: "Интеграции" description: "Исходящие вебхуки tuk-tuk.online: HTTP POST о новых сообщениях, диалогах, цепочках, оплатах и интеграциях на ваш URL с подписью HMAC-SHA256. Настройка, список событий, формат данных, отличие от блока Webhook в цепочках." keywords: ["webhook интеграция", "вебхук для бота", "HTTP API интеграция", "event webhook", "Make.com webhook", "n8n webhook", "Zapier интеграция", "REST API чат-бот", "исходящий вебхук", "событийный вебхук"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Исходящие вебхуки tuk-tuk.online отправляют HTTP POST с JSON и подписью HMAC-SHA256 на ваш URL при событиях платформы: сообщения, диалоги, цепочки, каналы, AI, платежи, календарь, интеграции, SMS, файлы. Настраиваются в настройках проекта, работают независимо от цепочек. > > - Где: «Настройки проекта» → блок «Вебхуки API» → «Создать вебхук» (поля «Название», «URL», список событий); действия «Редактировать», «Секрет», «Логи», «Удалить». > - 51 тип события в 10 группах; имя события в поле event и заголовке X-Webhook-Event. > - Заголовки: Content-Type: application/json, X-Webhook-Signature (HMAC-SHA256 hex), X-Webhook-Event, X-Webhook-Timestamp; тело {event, timestamp, data}. > - Доставка: одна попытка, таймаут 10 с, успех при 2xx, повторов нет; после 50 ошибок подряд вебхук отключается автоматически. > - Свои заголовки добавить нельзя: защита endpoint только проверкой подписи. > - Для запросов внутри сценария используется блок Webhook в цепочках, это другой инструмент. > > Связанные страницы: https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/api/rest, https://docs.tuk-tuk.online/channels/webhook, https://docs.tuk-tuk.online/integrations # Вебхуки Вебхуки (Event Webhooks) отправляют на ваш URL HTTP-уведомление каждый раз, когда в tuk-tuk.online происходит выбранное событие: пришло сообщение, создан диалог, завершилась цепочка, прошла оплата. Так платформа связывается с любым сервисом, у которого есть HTTP-адрес: Make.com, n8n, Zapier, ERP, собственный сервер. Вебхук работает независимо от цепочек и AI. Это уведомление «снаружи», а не шаг сценария: для запросов внутри сценария есть блок [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook). ## Когда это нужно - Передавать обращения в Make.com, n8n или Zapier и дальше в таблицы, CRM, почту. - Уведомлять внутреннюю систему (ERP, CMS, 1С) о новых клиентах и сообщениях. - Вести собственную аналитику по событиям платформы. - Запускать внешние процессы по событию: выставить счёт после оплаты, отправить SMS после закрытия диалога. ## Какие события доступны Всего 51 тип события в 10 группах. Имя события приходит в поле `event` и в заголовке `X-Webhook-Event`. | Группа | События | |---|---| | Сообщения | `message.inbound`, `message.outbound`, `message.status_changed` | | Диалоги | `dialog.created`, `dialog.updated`, `dialog.closed`, `dialog.tag_added`, `dialog.tag_removed`, `dialog.note_added`, `dialog.read`, `dialog.merged`, `dialog.custom_fields_updated` | | Цепочки | `chain.created`, `chain.updated`, `chain.removed`, `chain.toggled`, `chain.execution_started`, `chain.execution_completed`, `chain.execution_failed` | | Каналы | `channel.created`, `channel.removed`, `channel.toggled`, `channel.config_updated`, `channel.error` | | AI | `ai.provider_created`, `ai.provider_removed`, `ai.instruction_created`, `ai.instruction_updated`, `ai.instruction_removed`, `ai.assistant_created`, `ai.assistant_updated`, `ai.assistant_removed`, `ai.assistant_toggled`, `ai.assistant_replied` | | Платежи и баланс | `payment.created`, `payment.succeeded`, `payment.refunded`, `balance.changed`, `tier.changed` | | Календарь | `calendar.event_created`, `calendar.event_updated`, `calendar.event_removed` | | Интеграции | `integration.connected`, `integration.disconnected`, `integration.updated` | | SMS | `sms.sent`, `sms.status_changed`, `sms.device_connected`, `sms.device_disconnected` | | Файлы | `file.uploaded`, `file.deleted` | ## Как настроить ![Вебхуки API в настройках проекта](https://docs.tuk-tuk.online/assets/screens/settings/webhooks.webp) 1. Кнопка «Добавить вебхук». 2. Карточка вебхука: название, URL, события, секрет и журнал доставки. ![Форма нового вебхука](https://docs.tuk-tuk.online/assets/screens/settings/webhook-form.webp) 1. Название вебхука. 2. URL вашего сервера. 3. Выбор событий: отметьте нужные группы, всего 50 событий. 1. Откройте [Настройки проекта](https://lk.tuk-tuk.online/settings) и найдите блок «Вебхуки API». 2. Нажмите «Создать вебхук» и заполните «Название» (например, «Мой CRM webhook») и «URL» (адрес вашего сервера или сценария Make.com, n8n). 3. Отметьте события, о которых хотите получать уведомления, и сохраните: вебхук появится в списке включённым. 4. Нажмите «Секрет» у вебхука и скопируйте Signing Secret: он нужен для проверки подписи на вашей стороне. У каждого вебхука в списке есть действия «Редактировать», «Секрет», «Логи», «Удалить». Вебхук можно временно выключить, не удаляя. ## Проверить, что работает 1. Создайте вебхук с событием `message.inbound` и напишите боту с тестового номера: ваш сервер получит POST-запрос. 2. Откройте «Логи» у вебхука: в таблице появится строка с событием, HTTP-статусом ответа, временем доставки и датой. 3. Проверьте подпись из заголовка `X-Webhook-Signature` по примеру со страницы [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). ## Что приходит на ваш URL При событии платформа отправляет один POST-запрос с JSON-телом и четырьмя заголовками. | Заголовок | Значение | |---|---| | `Content-Type` | `application/json` | | `X-Webhook-Signature` | HMAC-SHA256 от тела запроса с вашим Signing Secret, hex | | `X-Webhook-Event` | Тип события, например `message.inbound` | | `X-Webhook-Timestamp` | Время события в ISO 8601 | Тело всегда одной структуры: `event`, `timestamp`, `data`. Состав `data` зависит от события. ```json { "event": "message.inbound", "timestamp": "2026-01-15T14:30:00.000Z", "data": { "messageId": "msg-uuid", "dialogId": "dialog-uuid", "body": "Здравствуйте, хочу узнать о доставке", "channelType": "TELEGRAM_BOT", "channelId": "ch-uuid", "mediaType": null } } ``` ## Как устроена доставка | Параметр | Значение | |---|---| | Метод | `POST`, тело JSON | | Таймаут ответа | 10 секунд | | Успех | Любой ответ с кодом 2xx | | Повторы | Нет: одна попытка на событие, результат пишется в «Логи» | | Автоотключение | После 50 неудачных доставок подряд вебхук выключается; после исправления включите его вручную | | Подпись | HMAC-SHA256, секрет можно перегенерировать в «Секрет» | > [!WARNING] Повторных попыток нет. Если ваш сервер не ответил за 10 секунд или вернул ошибку, событие не доставляется повторно. Отвечайте `200` сразу, а обработку выполняйте после ответа. ## Примеры сценариев ### Make.com или n8n 1. Создайте сценарий с триггером «Webhook» и скопируйте его URL. 2. Создайте вебхук в tuk-tuk.online с этим URL и событием `message.inbound` или `dialog.created`. 3. Напишите боту: в сценарии появится запрос с телом события, дальше данные можно передать в таблицу или CRM. ### Google Sheets Прямой записи в таблицу нет. Используйте Make.com или n8n как промежуточный шаг: вебхук → сценарий → строка в Google Sheets. ### Собственный сервер Поднимите endpoint, который принимает POST с JSON, проверяет подпись `X-Webhook-Signature` и отвечает `200`. Готовый код проверки на JavaScript и PHP: [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). ## Вебхуки и блок Webhook в цепочках | | Вебхуки (эта страница) | Блок [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook) | |---|---|---| | Когда срабатывает | При событии платформы, независимо от цепочек | Когда цепочка доходит до блока | | Направление | Уведомление на ваш URL | Запрос к внешнему API с ожиданием ответа | | Данные | Фиксированная структура события | Свои параметры с переменными вроде `{{name}}`, `{{lastMessage}}`, `{{aiResult}}` | | Ответ | Не используется | Сохраняется в `{{webhookResult}}` и доступен следующим блокам | | Где настраивается | Настройки проекта → «Вебхуки API» | Редактор цепочки | ## Ограничения - Одна попытка доставки без повторов, таймаут 10 секунд. - После 50 ошибок подряд вебхук выключается автоматически. - Тело только JSON (`Content-Type: application/json`); другие форматы не поддерживаются. - Заголовки запроса фиксированы: свои заголовки (например, `Authorization`) добавить нельзя, защищайте endpoint проверкой подписи. ## Частые проблемы | Проблема | Что делать | |---|---| | Вебхук не срабатывает | Проверьте, что нужное событие отмечено и вебхук включён; загляните в «Логи» | | Сервер не получает запрос | Убедитесь, что URL доступен из интернета по HTTPS и принимает POST | | В логах статус 401 или 403 | Ваш endpoint отклоняет запрос: проверяйте подпись `X-Webhook-Signature`, а не заголовок `Authorization` | | В логах «Timeout» | Сервер отвечает дольше 10 секунд: отвечайте `200` сразу, обработку переносите в фон | | Вебхук сам выключился | Накопилось 50 ошибок подряд: исправьте endpoint и включите вебхук снова | --- --- title: "API tuk-tuk.online: REST API v1, коды подтверждения, Event Webhooks" nav_title: "API для разработчиков" url: https://docs.tuk-tuk.online/api markdown: https://docs.tuk-tuk.online/api.md description: "Три способа интеграции с tuk-tuk.online: REST API v1 с авторизацией по API-ключу (мессенджеры, контакты, история, медиа, отправка сообщений), вебхук для отправки кодов подтверждения по SMS и Email, Event Webhooks с подписью HMAC-SHA256." keywords: ["API мессенджер", "REST API", "API-ключ", "отправка сообщений API", "Event Webhooks", "webhook события", "HMAC подпись", "API для разработчиков", "интеграция мессенджеров", "send message API"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Обзор способов интеграции с tuk-tuk.online для разработчиков: REST API v1 (ваш сервер вызывает платформу), вебхук кодов подтверждения (отправка кода по SMS или Email одним POST) и Event Webhooks (платформа присылает события на ваш сервер). > > - REST API v1: базовый URL `https://back.tuk-tuk.online/api/v1`, JSON, авторизация API-ключом в заголовке `Authorization: Bearer` или `X-Api-Key`. > - API-ключи создаются в кабинете: Настройки проекта → API. Права задаются через scopes. > - Коды подтверждения: POST на персональный вебхук, код уходит по SMS или Email, в тексте плейсхолдер `{{code}}`. > - Event Webhooks: 50 типов событий, подпись HMAC-SHA256, настройка в Настройках проекта. > - Вебхук отключается автоматически после 50 последовательных ошибок доставки. > > Связанные страницы: https://docs.tuk-tuk.online/api/rest, https://docs.tuk-tuk.online/api/verification, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/chains/blocks/webhook # API для разработчиков tuk-tuk.online открывает три точки интеграции. REST API v1: ваш сервер сам вызывает платформу и отправляет сообщения. Коды подтверждения: один POST-запрос, и клиент получает код по SMS или Email. Event Webhooks: платформа сама присылает HTTP-уведомления о событиях на ваш сервер. ## Что выбрать | Задача | Инструмент | Страница | |---|---|---| | Отправить сообщение клиенту, прочитать историю, получить контакт или медиа | REST API v1 | [REST API v1](https://docs.tuk-tuk.online/api/rest) | | Отправить клиенту код подтверждения по SMS или Email | Вебхук верификации | [Коды подтверждения](https://docs.tuk-tuk.online/api/verification) | | Узнавать о новых сообщениях, статусах диалогов, платежах в реальном времени | Event Webhooks | [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks) | ## REST API v1 | Параметр | Значение | |---|---| | Базовый URL | `https://back.tuk-tuk.online/api/v1` | | Протокол | REST (HTTP), формат JSON | | Авторизация | API-ключ в заголовке `Authorization: Bearer` или `X-Api-Key` | | Права | scopes: чтение мессенджеров, контактов, сообщений, медиа; отправка | | Управление ключами | Личный кабинет → Настройки → API | Что умеет: - список привязанных мессенджеров; - карточка контакта по ID, поиск по телефону или email; - история сообщений с контактом; - ссылки на медиа (картинки, голосовые, файлы); - отправка текста, голосовых, медиа и email по ID контакта, номеру телефона или email. Все эндпоинты с примерами на JavaScript, PHP и Python: [REST API v1](https://docs.tuk-tuk.online/api/rest). ## Коды подтверждения Один POST-запрос на персональный вебхук, и клиент получает код верификации по SMS или Email. Можно прислать свой текст сообщения (в том числе HTML-письмо) с плейсхолдером `{{code}}`. Подробнее: [Коды подтверждения](https://docs.tuk-tuk.online/api/verification). ## Event Webhooks - 50 типов событий: сообщения, диалоги, каналы, AI, цепочки, платежи, интеграции, файлы и другие. - Каждый запрос подписан HMAC-SHA256. - Вебхуки создаются в [Настройках проекта](https://lk.tuk-tuk.online/settings). - После 50 последовательных ошибок доставки вебхук отключается автоматически. Заголовки, формат тела, проверка подписи и полный список событий: [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). --- --- title: "REST API v1: контакты, история и отправка сообщений" nav_title: "REST API v1" url: https://docs.tuk-tuk.online/api/rest markdown: https://docs.tuk-tuk.online/api/rest.md section: "API для разработчиков" description: "REST API v1 tuk-tuk.online: авторизация по API-ключу со scopes, список мессенджеров, карточки контактов, история сообщений, ссылки на медиа и отправка сообщений (текст, голосовые, медиа, email) по ID контакта, телефону или email. Примеры на JavaScript, PHP и Python." keywords: ["REST API", "API-ключ", "отправка сообщений через API", "send message API", "история сообщений API", "контакты API", "медиа API", "scopes", "rate limit", "API мессенджер для бизнеса", "API пример JavaScript", "API пример PHP"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > REST API v1 tuk-tuk.online для серверных интеграций: список каналов, карточки контактов, история сообщений, ссылки на медиа и отправка сообщений (текст, голосовые, медиа, email) в любой подключённый канал. Авторизация по API-ключу со scopes, ответы в JSON. > > - Базовый URL: `https://back.tuk-tuk.online/api/v1`. Ключ вида `tuk_sk_...` передаётся в заголовке `Authorization: Bearer <ключ>` или `X-Api-Key: <ключ>`. > - Ключ создаётся в кабинете: Настройки проекта → вкладка API → «Создать ключ». Показывается один раз, хранится как SHA-256 хэш; можно задать scopes, срок действия, белый список IP и лимит запросов в минуту. > - Scopes: `messengers:read`, `contacts:read`, `messages:read`, `media:read`, `messages:send`. Без нужного scope ответ `403`. > - Эндпоинты: `GET /me`, `GET /messengers`, `GET /contacts/:id`, `GET /contacts?phone=|email=`, `GET /contacts/:id/messages` (`limit` 1–100, по умолчанию 30, `offset`), `GET /media/:fileId`, `POST /messages`. > - Формат ответа: успех `{ "data": ... }` (у списков плюс `{ "meta": ... }`), ошибка `{ "statusCode", "error", "message" }`; у `429` тело `{ "error": { "code": "rate_limited", "message" } }`. > - Отправка `POST /messages`: адресат `dialogId`/`contactId` или `channelId` + `phone`/`email`/`identifier`; обязателен `text` или `mediaUrl`; `mediaType`: `photo`, `voice`, `audio`, `video`, `document`; для EMAIL `subject` и `rawEmail`. > - Коды ошибок: `400` (нет text и mediaUrl), `403` (ключ или scope), `404` (не найдено в рабочем пространстве), `429` (лимит запросов ключа в минуту). > > Связанные страницы: https://docs.tuk-tuk.online/api, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/api/verification, https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/dialogs/messages # REST API v1 REST API v1 даёт вашему серверу прямой доступ к платформе: список каналов, карточки контактов, история переписки, медиа-файлы и отправка сообщений в любой подключённый мессенджер. Авторизация по API-ключу, ответы в JSON. Базовый URL: `https://back.tuk-tuk.online/api/v1`. Успешные ответы обёрнуты в `{ "data": ... }`, у списков добавляется `{ "meta": ... }`. ## Для ИИ-агента - Чтобы отправить сообщение, вызови `POST /api/v1/messages` с заголовком `Authorization: Bearer tuk_sk_...` и телом `{ "dialogId": "...", "text": "..." }` (нужен scope `messages:send`). - Чтобы отправить по номеру телефона или email без известного контакта, передай `channelId` и `phone` или `email`: контакт найдётся или создастся в этом канале. - Чтобы прочитать историю, вызови `GET /api/v1/contacts/:id/messages?limit=30&offset=0` (scope `messages:read`); новые сообщения идут первыми. - Чтобы найти контакт, вызови `GET /api/v1/contacts?phone=...` или `?email=...` (scope `contacts:read`); при отсутствии получишь `404`. - Ключ создаётся в кабинете: Настройки проекта → вкладка API → «Создать ключ». Ключ показывается один раз, формат `tuk_sk_...`. Проверить ключ: `GET /api/v1/me`. ## Создать API-ключ ![Вкладка «API» в настройках проекта](https://docs.tuk-tuk.online/assets/screens/settings/api-keys.webp "Ключи выпускаются во вкладке «API» настроек проекта. Секрет показывается один раз.") 1. Откройте [Настройки проекта](https://lk.tuk-tuk.online/settings) в личном кабинете. 2. Перейдите на вкладку **API**. 3. Нажмите **Создать ключ**, задайте название и выберите права (scopes). 4. Скопируйте ключ сразу: он показывается один раз и хранится в зашифрованном виде. Потеряли: отзовите и создайте новый. Для ключа можно задать срок действия, белый список IP и лимит запросов в минуту. В любой момент ключ можно **отозвать** или **удалить**. ## Авторизация ![Создание API-ключа](https://docs.tuk-tuk.online/assets/screens/settings/api-key-form.webp) 1. Название ключа. 2. Права (scopes) и срок действия задаются здесь же; секрет показывается один раз. Передавайте ключ в одном из заголовков: ```http Authorization: Bearer tuk_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X-Api-Key: tuk_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` У каждого метода ниже примеры на JavaScript, PHP и Python, переключайте вкладки. ## Права (scopes) У ключа есть набор прав, каждый метод требует своё: | Scope | Право | |---|---| | `messengers:read` | Список привязанных мессенджеров | | `contacts:read` | Чтение карточек контактов | | `messages:read` | Чтение истории сообщений | | `media:read` | Получение ссылок на медиа | | `messages:send` | Отправка сообщений | Если у ключа нет нужного права, ответ `403` с указанием недостающего scope. ## Формат ответа Все ответы в JSON. Полезные данные всегда в поле `data`. У списков дополнительно приходит объект `meta` (счётчики и пагинация). Ошибки возвращаются с кодом 4xx/5xx и телом с полями `statusCode`, `error`, `message`. ```json // один объект { "data": { } } // список { "data": [ ], "meta": { "total": 12 } } // ошибка { "statusCode": 403, "error": "Forbidden", "message": "Описание ошибки" } ``` ## Эндпоинты ### GET /api/v1/me Данные ключа и рабочего пространства. Удобно проверить, что ключ работает. Scope не требуется. Параметров нет. **Запрос** **JavaScript** ```javascript const res = await fetch("https://back.tuk-tuk.online/api/v1/me", { headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ" }, }); const json = await res.json(); console.log(json.data); ``` **PHP** ```php $ch = curl_init("https://back.tuk-tuk.online/api/v1/me"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests r = requests.get( "https://back.tuk-tuk.online/api/v1/me", headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]) ``` **Ответ** ```json { "data": { "keyName": "Интеграция с CRM", "scopes": ["messengers:read", "contacts:read", "messages:read", "messages:send"], "projectId": null } } ``` **Ошибки:** `403` (нет ключа, неверный, отозван, истёк, IP не разрешён), `429` (лимит запросов). ### GET /api/v1/messengers Все подключённые каналы. Секреты (токены ботов и т.п.) не возвращаются. Scope: `messengers:read`. Параметров нет. **Запрос** **JavaScript** ```javascript const res = await fetch("https://back.tuk-tuk.online/api/v1/messengers", { headers: { "X-Api-Key": "tuk_sk_ВАШ_КЛЮЧ" }, }); const { data } = await res.json(); console.log(data); ``` **PHP** ```php $ch = curl_init("https://back.tuk-tuk.online/api/v1/messengers"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-Api-Key: tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests r = requests.get( "https://back.tuk-tuk.online/api/v1/messengers", headers={"X-Api-Key": "tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]) ``` **Ответ** ```json { "data": [ { "id": "550e8400-e29b-41d4-a716-446655440001", "type": "TELEGRAM_BOT", "name": "Бот поддержки", "botName": "@my_support_bot", "isActive": true, "status": "connected", "error": null, "errorAt": null, "createdAt": "2026-01-12T09:30:00.000Z", "updatedAt": "2026-05-20T15:45:00.000Z" }, { "id": "550e8400-e29b-41d4-a716-446655440002", "type": "EMAIL", "name": "Почта поддержки", "botName": null, "isActive": false, "status": "disabled", "error": null, "errorAt": null, "createdAt": "2026-02-01T10:00:00.000Z", "updatedAt": "2026-05-10T08:15:00.000Z" } ], "meta": { "total": 2 } } ``` Поле `status`: `connected` (подключён), `error` (активен, но есть ошибка), `disabled` (выключен). **Ошибки:** `403` (нет scope `messengers:read` или проблема с ключом), `429`. ### GET /api/v1/contacts/:id Карточка контакта по его ID. Scope: `contacts:read`. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `id` (в пути) | string | да | ID контакта | **Запрос** **JavaScript** ```javascript const id = "f1e2aaaa-1111-2222-3333-444455556666"; const res = await fetch("https://back.tuk-tuk.online/api/v1/contacts/" + id, { headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ" }, }); console.log((await res.json()).data); ``` **PHP** ```php $id = "f1e2aaaa-1111-2222-3333-444455556666"; $ch = curl_init("https://back.tuk-tuk.online/api/v1/contacts/$id"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests contact_id = "f1e2aaaa-1111-2222-3333-444455556666" r = requests.get( f"https://back.tuk-tuk.online/api/v1/contacts/{contact_id}", headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]) ``` **Ответ** ```json { "data": { "id": "f1e2aaaa-1111-2222-3333-444455556666", "name": "Иван Петров", "identifier": "123456789", "phone": "+79991234567", "email": "ivan@example.com", "avatarUrl": "https://back.tuk-tuk.online/uploads/avatars/abc.jpg", "channelId": "550e8400-e29b-41d4-a716-446655440001", "channelType": "TELEGRAM_BOT", "source": "Telegram", "tags": ["vip", "оплатил"], "customFields": { "Город": "Москва" }, "dialogStatus": "IN_PROGRESS", "archivedAt": null, "unreadCount": 0, "lastMessageAt": "2026-05-28T10:00:00.000Z", "createdAt": "2026-01-12T09:30:00.000Z", "updatedAt": "2026-05-28T10:00:00.000Z" } } ``` **Ошибки:** `403` (нет scope `contacts:read`), `404` (контакт не найден в этом рабочем пространстве), `429`. ### GET /api/v1/contacts Поиск контакта по телефону или email. Возвращает ту же карточку, что и запрос по ID, либо `404`, если контакт не найден. Scope: `contacts:read`. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `phone` (query) | string | одно из двух | Телефон контакта | | `email` (query) | string | одно из двух | Email контакта | **Запрос** **JavaScript** ```javascript const phone = encodeURIComponent("+79991234567"); const res = await fetch("https://back.tuk-tuk.online/api/v1/contacts?phone=" + phone, { headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ" }, }); console.log((await res.json()).data); ``` **PHP** ```php $phone = urlencode("+79991234567"); $ch = curl_init("https://back.tuk-tuk.online/api/v1/contacts?phone=$phone"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests r = requests.get( "https://back.tuk-tuk.online/api/v1/contacts", params={"phone": "+79991234567"}, headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]) ``` **Ответ** Карточка контакта в поле `data`, структура как у `GET /api/v1/contacts/:id`. ```json { "data": { "id": "f1e2aaaa-1111-2222-3333-444455556666", "name": "Иван Петров", "phone": "+79991234567", "email": "ivan@example.com", "channelId": "550e8400-e29b-41d4-a716-446655440001", "channelType": "TELEGRAM_BOT", "dialogStatus": "IN_PROGRESS" } } ``` **Ошибки:** `403` (нет scope `contacts:read`), `404` (контакт не найден), `429`. ### GET /api/v1/contacts/:id/messages История переписки с контактом, новые сообщения сверху. Scope: `messages:read`. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `id` (в пути) | string | да | ID контакта | | `limit` (query) | number | нет | Сколько сообщений вернуть, 1–100, по умолчанию 30 | | `offset` (query) | number | нет | Смещение для пагинации, по умолчанию 0 | **Запрос** **JavaScript** ```javascript const id = "f1e2aaaa-1111-2222-3333-444455556666"; const res = await fetch("https://back.tuk-tuk.online/api/v1/contacts/" + id + "/messages?limit=2", { headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ" }, }); const { data, meta } = await res.json(); console.log(data, meta); ``` **PHP** ```php $id = "f1e2aaaa-1111-2222-3333-444455556666"; $ch = curl_init("https://back.tuk-tuk.online/api/v1/contacts/$id/messages?limit=2"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests contact_id = "f1e2aaaa-1111-2222-3333-444455556666" r = requests.get( f"https://back.tuk-tuk.online/api/v1/contacts/{contact_id}/messages", params={"limit": 2}, headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]) ``` **Ответ** ```json { "data": [ { "id": "9c0f-msg-2", "direction": "OUTBOUND", "body": "Здравствуйте! Чем можем помочь?", "channelId": "550e8400-e29b-41d4-a716-446655440001", "channelType": "TELEGRAM_BOT", "mediaUrl": null, "mediaType": null, "downloadUrl": null, "transcription": null, "messageStatus": "SENT", "externalMessageId": "12346", "senderName": null, "createdAt": "2026-05-28T10:01:00.000Z" }, { "id": "9c0f-msg-1", "direction": "INBOUND", "body": "", "channelId": "550e8400-e29b-41d4-a716-446655440001", "channelType": "TELEGRAM_BOT", "mediaUrl": "https://back.tuk-tuk.online/uploads/voice/xyz.ogg", "mediaType": "voice", "downloadUrl": "https://back.tuk-tuk.online/uploads/voice/xyz.ogg", "transcription": "Здравствуйте, есть вопрос по заказу", "messageStatus": null, "externalMessageId": "12345", "senderName": null, "createdAt": "2026-05-28T10:00:00.000Z" } ], "meta": { "total": 142, "hasMore": true, "limit": 2, "offset": 0 } } ``` Поле `direction`: `INBOUND` (от клиента), `OUTBOUND` (клиенту), `SYSTEM`, `NOTE`. У медиа-сообщений есть готовая ссылка `downloadUrl` для скачивания. Пагинация: `meta.hasMore` говорит, есть ли ещё сообщения за пределами `limit` + `offset`. **Ошибки:** `403` (нет scope `messages:read`), `404` (контакт не найден), `429`. ### GET /api/v1/media/:fileId Метаданные файла и ссылка на скачивание. Scope: `media:read`. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `fileId` (в пути) | string | да | ID файла | **Запрос** **JavaScript** ```javascript const fileId = "file-uuid-1234"; const res = await fetch("https://back.tuk-tuk.online/api/v1/media/" + fileId, { headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ" }, }); const { data } = await res.json(); console.log(data.downloadUrl); ``` **PHP** ```php $fileId = "file-uuid-1234"; $ch = curl_init("https://back.tuk-tuk.online/api/v1/media/$fileId"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ"], ]); $json = json_decode(curl_exec($ch), true); echo $json["data"]["downloadUrl"]; ``` **Python** ```python import requests file_id = "file-uuid-1234" r = requests.get( f"https://back.tuk-tuk.online/api/v1/media/{file_id}", headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, ) print(r.json()["data"]["downloadUrl"]) ``` **Ответ** ```json { "data": { "id": "file-uuid-1234", "originalName": "photo.jpg", "mimeType": "image/jpeg", "size": 184320, "url": "https://back.tuk-tuk.online/uploads/2026/05/abc.jpg", "downloadUrl": "https://back.tuk-tuk.online/uploads/2026/05/abc.jpg", "dialogId": "f1e2aaaa-1111-2222-3333-444455556666", "createdAt": "2026-05-28T10:00:00.000Z" } } ``` **Ошибки:** `403` (нет scope `media:read`), `404` (файл не найден), `429`. ### POST /api/v1/messages Отправка текста, голосового, медиа или email. Scope: `messages:send`. Получателя задают одним из двух способов: - `dialogId` или `contactId`: в существующий диалог (контакт); - `channelId` + `phone`, `email` или `identifier`: найти или создать контакт в указанном канале. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `dialogId` / `contactId` | string | один из способов адресации | ID существующего контакта | | `channelId` | string | да, при отправке по телефону, email или identifier | Канал, через который уходит сообщение | | `phone` / `email` / `identifier` | string | один из способов адресации | Получатель: контакт ищется или создаётся в канале `channelId` | | `text` | string | да, если нет `mediaUrl` | Текст сообщения | | `subject` | string | нет | Тема письма, только для канала EMAIL | | `mediaUrl` | string | нет | Ссылка на вложение (картинка, голосовое, видео, документ) | | `mediaType` | string | нет | `photo`, `voice`, `audio`, `video`, `document` | | `rawEmail` | boolean | нет | EMAIL: `true`, отправить письмо как есть, без обёртки и футера с отпиской | > [!NOTE] > Полная замена письма (`rawEmail: true`). По умолчанию для EMAIL TukTuk оборачивает тело в адаптивный шаблон и добавляет футер со ссылкой на отписку (List-Unsubscribe). С флагом `rawEmail: true` уходит ровно ваш HTML, ничего не добавляется. Вёрстка и ссылка на отписку тогда на вашей стороне (её требуют Gmail и Yahoo для массовых рассылок). **Запрос** **JavaScript** ```javascript const res = await fetch("https://back.tuk-tuk.online/api/v1/messages", { method: "POST", headers: { "Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ", "Content-Type": "application/json", }, body: JSON.stringify({ dialogId: "f1e2aaaa-1111-2222-3333-444455556666", text: "Ваш заказ готов к выдаче!", }), }); console.log((await res.json()).data); ``` **PHP** ```php $ch = curl_init("https://back.tuk-tuk.online/api/v1/messages"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer tuk_sk_ВАШ_КЛЮЧ", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => json_encode([ "dialogId" => "f1e2aaaa-1111-2222-3333-444455556666", "text" => "Ваш заказ готов к выдаче!", ]), ]); $json = json_decode(curl_exec($ch), true); print_r($json["data"]); ``` **Python** ```python import requests r = requests.post( "https://back.tuk-tuk.online/api/v1/messages", headers={"Authorization": "Bearer tuk_sk_ВАШ_КЛЮЧ"}, json={ "dialogId": "f1e2aaaa-1111-2222-3333-444455556666", "text": "Ваш заказ готов к выдаче!", }, ) print(r.json()["data"]) ``` **Другие варианты тела** (меняется только JSON). По номеру телефона, контакт создастся при необходимости: ```json { "channelId": "550e8400-...-099", "phone": "+79991234567", "text": "Код подтверждения: 1234" } ``` Голосовое сообщение: ```json { "dialogId": "f1e2aaaa-...", "mediaUrl": "https://example.com/note.ogg", "mediaType": "voice" } ``` Email через канал EMAIL: ```json { "channelId": "550e8400-...-0ee", "email": "ivan@example.com", "subject": "Ваш договор", "text": "Здравствуйте! Во вложении договор." } ``` **Ответ** (одинаковый по структуре для всех вариантов) ```json { "data": { "id": "a1b2-new-msg", "dialogId": "f1e2aaaa-1111-2222-3333-444455556666", "direction": "OUTBOUND", "body": "Ваш заказ готов к выдаче!", "mediaUrl": null, "mediaType": null, "messageStatus": "SENT", "externalMessageId": "67890", "createdAt": "2026-05-29T12:00:00.000Z" } } ``` Поле `messageStatus`: `SENT` (отправлено), `FAILED` (доставка не удалась). Отправка списывается с баланса так же, как ответ оператора, и идёт через тот же канал, что и в личном кабинете. **Ошибки:** `400` (нет ни `text`, ни `mediaUrl`), `403` (нет scope `messages:send`), `404` (контакт не найден), `429`. ## Коды ошибок Ошибки приходят с HTTP-кодом и телом вида `{ "statusCode": ..., "error": ..., "message": ... }`. | Код | Когда возникает | |---|---| | `400` | Некорректный запрос (например, нет ни `text`, ни `mediaUrl`) | | `403` | Нет ключа, неверный, отозван, истёк, IP не разрешён, не хватает scope | | `404` | Ресурс не найден в этом рабочем пространстве | | `429` | Превышен лимит запросов ключа в минуту | Примеры тел ошибок: ```json // 403: не хватает прав ключа { "statusCode": 403, "error": "Forbidden", "message": "Недостаточно прав ключа. Требуется scope: messages:send" } // 404: контакт не найден { "statusCode": 404, "error": "Not Found", "message": "Контакт не найден" } // 429: превышен лимит запросов { "error": { "code": "rate_limited", "message": "Превышен лимит запросов (120/мин) для этого API-ключа" } } ``` > [!WARNING] > Тело ответа `429` отличается от остальных ошибок: вместо `statusCode` / `error` / `message` приходит объект `error` с полями `code` и `message`. Учитывайте это при разборе ошибок. ## Безопасность - Ключ хранится только в виде SHA-256 хэша. Восстановить его нельзя, поэтому копируйте сразу при создании. - Ключ привязан к одному рабочему пространству и видит только его данные. - Ключ можно ограничить по правам (scopes), сроку действия, IP и лимиту запросов в минуту. - Отозванный ключ перестаёт работать немедленно. Уведомления о событиях в обратную сторону (новое сообщение, смена статуса диалога) приходят через [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks). --- --- title: "Коды подтверждения по SMS и Email через API" nav_title: "Коды подтверждения" url: https://docs.tuk-tuk.online/api/verification markdown: https://docs.tuk-tuk.online/api/verification.md section: "API для разработчиков" description: "Отправка кодов верификации клиентам по SMS или Email одним POST-запросом на персональный вебхук tuk-tuk.online. Свой текст сообщения с плейсхолдером {{code}}, HTML-письма, режим rawEmail." keywords: ["подтверждение личности", "верификация по SMS", "код подтверждения API", "OTP API", "one-time password", "верификация email", "отправка кода", "webhook верификация", "{{code}}", "HTML письмо с кодом"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Вебхук верификации tuk-tuk.online: один POST-запрос генерирует 6-значный код и отправляет его клиенту по SMS или Email, код возвращается в ответе для сверки на вашей стороне. Для сервисов, которым нужно подтверждать телефон или почту клиента. > > - Эндпоинт: `POST https://back.tuk-tuk.online/api/verify/:token`, авторизация токеном в URL, заголовки не нужны. > - Система создаётся в кабинете: Связки → Подтверждение личности; там же копируется вебхук-URL. Доступно на платном тарифе. > - Тело: `recipient` (обязательно, телефон или email), `recipientName`, `text` (свой текст, применяется только с `{{code}}`), `rawEmail` (письмо как есть). > - Ответ: `{ "success": true, "code": "123456" }`; при ошибке `{ "success": false, "error": "..." }`. > - Тип получателя по `recipient`: есть `@`, уходит Email, иначе SMS; нужен активный канал соответствующего типа. > - Код 6-значный, отправка списывается с баланса. Для Email `text` может быть HTML; по умолчанию оборачивается в шаблон с футером отписки. > > Связанные страницы: https://docs.tuk-tuk.online/api, https://docs.tuk-tuk.online/api/rest, https://docs.tuk-tuk.online/channels/sms, https://docs.tuk-tuk.online/channels/email, https://docs.tuk-tuk.online/sms-gateway # Коды подтверждения Система подтверждения отправляет клиенту 6-значный код по SMS или Email по одному POST-запросу на ваш персональный вебхук. Платформа сама генерирует код, подставляет его в шаблон и отправляет через настроенные каналы. В ответе код возвращается вам: сверяете его на своей стороне. Доступно на платном тарифе. Система создаётся в личном кабинете: [Связки → Подтверждение личности](https://lk.tuk-tuk.online/bindings). ## Как подключить 1. Откройте [Связки → Подтверждение личности](https://lk.tuk-tuk.online/bindings) в личном кабинете. 2. Создайте систему: задайте название, выберите канал или каналы (SMS и/или Email) и шаблон сообщения с плейсхолдером `{{code}}`. 3. Скопируйте вебхук-URL вида `https://back.tuk-tuk.online/api/verify/ВАШ-ТОКЕН`. 4. Отправляйте на него POST-запросы из своего сервиса: в ответе придёт `{ "success": true, "code": "..." }`. Авторизация: сам токен в URL. Заголовков не нужно, токен держите в секрете. ## Эндпоинт ### POST /api/verify/:token Сгенерировать код и отправить его получателю по SMS или Email. Авторизация по токену в пути, заголовки авторизации не нужны. | Поле | Тип | Обязательно | Описание | |---|---|---|---| | `token` (в пути) | string | да | Персональный токен вебхука из кабинета | | `recipient` | string | да | Телефон (для SMS) или email (для Email) получателя | | `recipientName` | string | нет | Имя получателя для персонализации | | `text` | string | нет | Свой текст сообщения. Применяется только если содержит `{{code}}` | | `rawEmail` | boolean | нет | EMAIL: `true`, отправить письмо как есть, без обёртки и футера с отпиской | **Запрос** **JavaScript** ```javascript await fetch("https://back.tuk-tuk.online/api/verify/ВАШ-ВЕБХУК-ТОКЕН", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ recipient: "+79991234567", text: "Ваш код подтверждения: {{code}}", }), }); ``` **PHP** ```php $ch = curl_init("https://back.tuk-tuk.online/api/verify/ВАШ-ВЕБХУК-ТОКЕН"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode([ "recipient" => "+79991234567", "text" => "Ваш код подтверждения: {{code}}", ]), ]); $json = json_decode(curl_exec($ch), true); echo $json["code"]; ``` **Python** ```python import requests r = requests.post( "https://back.tuk-tuk.online/api/verify/ВАШ-ВЕБХУК-ТОКЕН", json={ "recipient": "+79991234567", "text": "Ваш код подтверждения: {{code}}", }, ) print(r.json()["code"]) ``` **Ответ** ```json { "success": true, "code": "123456" } ``` Сохраните `code` у себя и попросите клиента ввести его. **Ошибки** ```json { "success": false, "error": "Описание ошибки" } ``` ## Своё сообщение в поле text По умолчанию текст берётся из шаблона, заданного в системе. Поле `text` в запросе заменяет его: так удобно отправлять письмо, собранное на вашей стороне. > [!WARNING] > Поле `text` применяется только если содержит плейсхолдер `{{code}}`. Без него поле игнорируется и используется шаблон системы, чтобы код не потерялся. На месте `{{code}}` подставляется сгенерированный код. Для Email-каналов `text` может быть HTML: платформа определит разметку, обернёт её в адаптивный шаблон и добавит футер отписки (подробнее в [REST API v1](https://docs.tuk-tuk.online/api/rest), поле `rawEmail`). Чтобы отправить письмо ровно как есть, без обёртки и футера, добавьте `"rawEmail": true`: уйдёт только ваш HTML, вёрстка и ссылка на отписку на вашей стороне. Тот же режим включается один раз в редакторе системы тумблером «Отправлять письмо как есть», тогда флаг в каждом запросе не нужен. HTML-письмо с кодом: ```json { "recipient": "ivan@example.com", "recipientName": "Иван", "text": "

Подтверждение входа

Здравствуйте, Иван!

Ваш код:

{{code}}

Код действует 10 минут.

" } ``` Для SMS достаточно текста: `"text": "Ваш код: {{code}}"`. ## Ограничения - Каналы и тариф настраиваются в системе; код генерируется и списывается с баланса при отправке. - Тип получателя определяется автоматически: есть `@` в `recipient`, уходит Email, иначе SMS. Нужен подходящий активный канал. - `{{code}}` единственный обязательный плейсхолдер; без него ваш `text` игнорируется. --- --- title: "Event Webhooks: события tuk-tuk.online на ваш сервер" nav_title: "Event Webhooks" url: https://docs.tuk-tuk.online/api/webhooks markdown: https://docs.tuk-tuk.online/api/webhooks.md section: "API для разработчиков" description: "Event Webhooks tuk-tuk.online: HTTP POST уведомления о 50 типах событий (сообщения, диалоги, цепочки, каналы, AI, платежи) с подписью HMAC-SHA256 в заголовке X-Webhook-Signature. Формат, проверка подписи, список событий." keywords: ["webhooks API", "webhook события", "серверные уведомления", "HMAC подпись webhook", "HTTP callback", "webhook интеграция", "event-driven API", "webhook сообщения мессенджер"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Event Webhooks tuk-tuk.online: платформа отправляет HTTP POST с JSON на URL вашего сервера при каждом из 50 типов событий (сообщения, диалоги, цепочки, каналы, AI, платежи, календарь, интеграции, SMS, файлы). Каждый запрос подписан HMAC-SHA256 секретным ключом вебхука. > > - Настройка в кабинете: Настройки проекта → Вебхуки → «Создать вебхук»: URL, типы событий, секретный ключ. Там же включение/выключение, перегенерация ключа, логи доставки. > - Заголовки запроса: `Content-Type: application/json`, `X-Webhook-Event` (тип события), `X-Webhook-Timestamp` (ISO 8601), `X-Webhook-Signature` (HMAC-SHA256 сырого тела, hex, ключ: секрет вебхука). > - Тело: `{ "event": "<тип>", "timestamp": "", "data": { ... } }`; состав `data` зависит от типа события. > - Группы событий (50 типов): `message.*` (3), `dialog.*` (8), `chain.*` (7), `channel.*` (5), `ai.*` (10), `payment.*`/`balance.changed`/`tier.changed` (5), `calendar.*` (3), `integration.*` (3), `sms.*` (4), `file.*` (2). > - Доставка: таймаут 10 секунд, без повторных попыток (fire-and-forget). После 50 последовательных ошибок вебхук отключается; успешная доставка обнуляет счётчик. > - Проверка подписи: HMAC-SHA256 от raw body с секретом, сравнение через `crypto.timingSafeEqual` (Node.js) или `hash_equals` (PHP); при несовпадении отвечать `401`. > > Связанные страницы: https://docs.tuk-tuk.online/api, https://docs.tuk-tuk.online/api/rest, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/chains/blocks/webhook, https://docs.tuk-tuk.online/channels/webhook # Event Webhooks Event Webhooks доставляют события tuk-tuk.online на ваш сервер HTTP POST запросом в момент, когда они происходят: новое сообщение, смена статуса диалога, запуск цепочки, платёж. Соединение server-to-server, без постоянного подключения с вашей стороны. Каждый запрос подписан HMAC-SHA256, поэтому подделать событие без вашего секретного ключа нельзя. Всего 50 типов событий в 10 группах. ## Для ИИ-агента - Чтобы получать события, создай вебхук в кабинете: Настройки проекта → Вебхуки → «Создать вебхук», укажи URL, выбери типы событий, скопируй секретный ключ. - Каждое событие приходит как HTTP POST с JSON `{ "event", "timestamp", "data" }` и заголовками `X-Webhook-Event`, `X-Webhook-Timestamp`, `X-Webhook-Signature`. - Чтобы проверить подлинность, посчитай HMAC-SHA256 от сырого тела запроса с секретным ключом (hex) и сравни с `X-Webhook-Signature` через безопасное сравнение. - Чтобы узнать о новом сообщении клиента, подпишись на `message.inbound`: в `data` придут `messageId`, `dialogId`, `body`, `channelType`, `channelId`, `mediaType`. - Отвечай `200` в течение 10 секунд. Повторных попыток нет; после 50 ошибок подряд вебхук отключается. ## Как подключить 1. Откройте [Настройки проекта](https://lk.tuk-tuk.online/settings), раздел **Вебхуки**. 2. Нажмите **Создать вебхук**. 3. Укажите URL вашего сервера (рекомендуется HTTPS). 4. Выберите типы событий, которые хотите получать. 5. Скопируйте секретный ключ: он нужен для проверки подписи. В настройках вебхука доступны: включение и выключение, смена URL и списка событий, перегенерация секретного ключа, логи доставки. ## Формат доставки При наступлении события tuk-tuk.online отправляет HTTP POST на ваш URL. ### Заголовки | Заголовок | Описание | |---|---| | `Content-Type` | `application/json` | | `X-Webhook-Signature` | HMAC-SHA256 подпись тела запроса (hex) | | `X-Webhook-Event` | Тип события (например, `message.inbound`) | | `X-Webhook-Timestamp` | Время события в формате ISO 8601 | ### Тело запроса Все события приходят в единой структуре: ```json { "event": "message.inbound", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "messageId": "msg-uuid", "dialogId": "dialog-uuid", "body": "Привет!", "channelType": "TELEGRAM_BOT", "channelId": "ch-uuid", "mediaType": null } } ``` | Поле | Тип | Описание | |---|---|---| | `event` | string | Тип события | | `timestamp` | string | Время события, ISO 8601 | | `data` | object | Данные события, состав зависит от типа | ## Проверить подпись Заголовок `X-Webhook-Signature` содержит HMAC-SHA256 подпись сырого тела запроса в hex-формате, ключ подписи: секретный ключ вебхука. Проверяйте подпись до разбора JSON, иначе любой сможет прислать вам поддельное событие. > [!WARNING] > Считайте HMAC от сырого тела запроса (raw body), а не от повторно сериализованного JSON. Сравнивайте строки безопасной функцией: `crypto.timingSafeEqual` в Node.js, `hash_equals` в PHP. **JS / TS** ```javascript const crypto = require('crypto'); const express = require('express'); const app = express(); const WEBHOOK_SECRET = 'your_secret_key'; app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => { const signature = req.headers['x-webhook-signature']; const expected = crypto .createHmac('sha256', WEBHOOK_SECRET) .update(req.body) .digest('hex'); if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) { return res.status(401).send('Invalid signature'); } const { event, data } = JSON.parse(req.body); console.log('Event:', event, data); res.status(200).send('OK'); }); ``` **PHP** ```php { const sig = req.headers['x-webhook-signature']; const expected = crypto.createHmac('sha256', SECRET).update(req.body).digest('hex'); if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) { return res.status(401).send('Invalid signature'); } const { event, timestamp, data } = JSON.parse(req.body); switch (event) { case 'message.inbound': console.log('Новое сообщение:', data.body, 'от', data.dialogId); break; case 'dialog.created': console.log('Новый диалог:', data.dialogId, data.clientName); break; case 'payment.succeeded': console.log('Оплата:', data.paymentId, data.amount); break; default: console.log('Событие:', event, data); } res.status(200).send('OK'); }); app.listen(3000); ``` **PHP** ```php message.inbound: входящее сообщение от клиента ```json { "event": "message.inbound", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "messageId": "msg-550e8400-e29b-41d4-a716-446655440000", "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "body": "Привет! Хочу узнать о статусе заказа", "channelType": "TELEGRAM_BOT", "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "mediaType": null } } ``` #### message.outbound: исходящее сообщение ```json { "event": "message.outbound", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "messageId": "msg-660e8400-e29b-41d4-a716-446655440001", "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "body": "Здравствуйте! Ваш заказ в пути.", "channelType": "TELEGRAM_BOT", "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "mediaType": null } } ``` #### message.status_changed: статус сообщения изменён ```json { "event": "message.status_changed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "messageId": "msg-660e8400-e29b-41d4-a716-446655440001", "status": "COMPLETE", "previousStatus": "PENDING", "channelType": "TELEGRAM_BOT" } } ``` ### Диалоги | Событие | Описание | |---|---| | `dialog.created` | Создан новый диалог | | `dialog.updated` | Диалог обновлён | | `dialog.tag_added` | К диалогу добавлен тег | | `dialog.tag_removed` | Из диалога удалён тег | | `dialog.note_added` | Добавлена заметка | | `dialog.read` | Диалог прочитан оператором | | `dialog.merged` | Диалоги объединены | | `dialog.custom_fields_updated` | Обновлены кастомные поля | #### dialog.created: создан новый диалог ```json { "event": "dialog.created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "clientName": "Иван Петров", "channelType": "TELEGRAM_BOT", "clientIdentifier": "123456789" } } ``` #### dialog.updated: диалог обновлён ```json { "event": "dialog.updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "action": "status_changed", "status": "CLOSED" } } ``` Возможные значения `action`: `closed`, `reopened`, `status_changed`, `phone_updated`, `email_updated`, `telegram_chat_id_updated`. #### dialog.tag_added: добавлен тег ```json { "event": "dialog.tag_added", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "tag": "VIP" } } ``` #### dialog.tag_removed: удалён тег ```json { "event": "dialog.tag_removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "tag": "VIP" } } ``` #### dialog.note_added: добавлена заметка ```json { "event": "dialog.note_added", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "text": "Клиент просил перезвонить завтра в 10:00" } } ``` #### dialog.read: диалог прочитан ```json { "event": "dialog.read", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000" } } ``` #### dialog.merged: диалоги объединены ```json { "event": "dialog.merged", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "targetDialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "sourceDialogId": "dlg-789abcde-f012-3456-7890-abcdef012345" } } ``` #### dialog.custom_fields_updated: обновлены кастомные поля ```json { "event": "dialog.custom_fields_updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "fields": { "order_id": "ORD-12345", "priority": "high" } } } ``` ### Цепочки автоматизации | Событие | Описание | |---|---| | `chain.created` | Создана цепочка | | `chain.updated` | Цепочка обновлена | | `chain.removed` | Цепочка удалена | | `chain.toggled` | Цепочка включена или выключена | | `chain.execution_started` | Запуск цепочки для клиента | | `chain.execution_completed` | Цепочка завершена | | `chain.execution_failed` | Ошибка выполнения цепочки | #### chain.created: создана цепочка ```json { "event": "chain.created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "name": "Приветственная цепочка", "template": null } } ``` Поле `template` содержит ключ шаблона (`"welcome"`, `"support"` и т.д.), если цепочка создана из шаблона, или `null`, если создана с нуля. #### chain.updated: цепочка обновлена ```json { "event": "chain.updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "name": "Приветственная цепочка v2" } } ``` #### chain.removed: цепочка удалена ```json { "event": "chain.removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000" } } ``` #### chain.toggled: цепочка включена или выключена ```json { "event": "chain.toggled", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "isActive": true } } ``` #### chain.execution_started: запуск цепочки ```json { "event": "chain.execution_started", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "chainName": "Приветственная цепочка", "runId": "run-660e8400-e29b-41d4-a716-446655440001", "clientIdentifier": "123456789" } } ``` #### chain.execution_completed: цепочка завершена ```json { "event": "chain.execution_completed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "runId": "run-660e8400-e29b-41d4-a716-446655440001", "clientIdentifier": "123456789" } } ``` #### chain.execution_failed: ошибка выполнения ```json { "event": "chain.execution_failed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "chainId": "chain-550e8400-e29b-41d4-a716-446655440000", "runId": "run-660e8400-e29b-41d4-a716-446655440001", "reason": "block_error", "blockId": "block-abc123", "blockType": "SEND_MESSAGE", "error": "Bot not running or send error" } } ``` Возможные значения `reason`: `block_error` (ошибка в блоке), `max_steps_exceeded` (превышен лимит шагов, защита от бесконечных циклов). ### Каналы | Событие | Описание | |---|---| | `channel.created` | Создан канал | | `channel.removed` | Канал удалён | | `channel.toggled` | Канал включён или выключен | | `channel.config_updated` | Обновлена конфигурация канала | | `channel.error` | Ошибка в работе канала | #### channel.created: создан канал ```json { "event": "channel.created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "type": "TELEGRAM_BOT", "name": "Мой Telegram бот" } } ``` #### channel.removed: канал удалён ```json { "event": "channel.removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "type": "TELEGRAM_BOT", "name": "Мой Telegram бот" } } ``` #### channel.toggled: канал включён или выключен ```json { "event": "channel.toggled", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "type": "TELEGRAM_BOT", "isActive": false } } ``` #### channel.config_updated: конфигурация обновлена ```json { "event": "channel.config_updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "type": "TELEGRAM_BOT" } } ``` #### channel.error: ошибка канала ```json { "event": "channel.error", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "channelType": "TELEGRAM_BOT", "error": "Токен бота недействителен. Проверьте токен или создайте нового бота в @BotFather." } } ``` ### AI | Событие | Описание | |---|---| | `ai.provider_created` | Добавлен AI-провайдер | | `ai.provider_removed` | Удалён AI-провайдер | | `ai.instruction_created` | Создана инструкция | | `ai.instruction_updated` | Инструкция обновлена | | `ai.instruction_removed` | Инструкция удалена | | `ai.assistant_created` | Создан AI-ассистент | | `ai.assistant_updated` | Ассистент обновлён | | `ai.assistant_removed` | Ассистент удалён | | `ai.assistant_toggled` | Ассистент включён или выключен | | `ai.assistant_replied` | Ассистент ответил клиенту | #### ai.provider_created: добавлен AI-провайдер ```json { "event": "ai.provider_created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "providerId": "prov-550e8400-e29b-41d4-a716-446655440000", "type": "OPENAI", "name": "OpenAI Production" } } ``` #### ai.provider_removed: удалён AI-провайдер ```json { "event": "ai.provider_removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "providerId": "prov-550e8400-e29b-41d4-a716-446655440000", "type": "OPENAI" } } ``` #### ai.instruction_created: создана инструкция ```json { "event": "ai.instruction_created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "instructionId": "instr-550e8400-e29b-41d4-a716-446655440000", "name": "Инструкция для поддержки", "mode": "SYSTEM" } } ``` #### ai.instruction_updated: инструкция обновлена ```json { "event": "ai.instruction_updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "instructionId": "instr-550e8400-e29b-41d4-a716-446655440000", "name": "Инструкция для поддержки v2" } } ``` #### ai.instruction_removed: инструкция удалена ```json { "event": "ai.instruction_removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "instructionId": "instr-550e8400-e29b-41d4-a716-446655440000" } } ``` #### ai.assistant_created: создан AI-ассистент ```json { "event": "ai.assistant_created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "assistantId": "asst-550e8400-e29b-41d4-a716-446655440000", "name": "Бот поддержки", "type": "SUPPORT" } } ``` #### ai.assistant_updated: ассистент обновлён ```json { "event": "ai.assistant_updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "assistantId": "asst-550e8400-e29b-41d4-a716-446655440000", "name": "Бот поддержки v2" } } ``` #### ai.assistant_removed: ассистент удалён ```json { "event": "ai.assistant_removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "assistantId": "asst-550e8400-e29b-41d4-a716-446655440000" } } ``` #### ai.assistant_toggled: ассистент включён или выключен ```json { "event": "ai.assistant_toggled", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "assistantId": "asst-550e8400-e29b-41d4-a716-446655440000", "isActive": true } } ``` #### ai.assistant_replied: ассистент ответил ```json { "event": "ai.assistant_replied", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "assistantId": "asst-550e8400-e29b-41d4-a716-446655440000", "dialogId": "dlg-123e4567-e89b-12d3-a456-426614174000", "assistantName": "Бот поддержки" } } ``` ### Платежи и баланс | Событие | Описание | |---|---| | `payment.created` | Создан новый платёж | | `payment.succeeded` | Платёж успешно проведён | | `payment.refunded` | Платёж возвращён | | `balance.changed` | Баланс изменился | | `tier.changed` | Изменён тарифный план | #### payment.created: создан платёж ```json { "event": "payment.created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "paymentId": "pay-550e8400-e29b-41d4-a716-446655440000", "amount": 2990, "currency": "RUB" } } ``` #### payment.succeeded: платёж проведён ```json { "event": "payment.succeeded", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "paymentId": "pay-550e8400-e29b-41d4-a716-446655440000", "amount": 2990 } } ``` #### payment.refunded: платёж возвращён ```json { "event": "payment.refunded", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "paymentId": "pay-550e8400-e29b-41d4-a716-446655440000", "amount": 2990 } } ``` #### balance.changed: баланс изменился ```json { "event": "balance.changed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "amount": 15000, "change": -500, "source": "ai_tokens", "tier": "BUSINESS" } } ``` #### tier.changed: тарифный план изменён ```json { "event": "tier.changed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "oldTier": "FREE", "newTier": "BUSINESS", "billingPeriod": "monthly", "reason": "user_upgrade" } } ``` Возможные значения `reason`: `user_upgrade`, `trial_expired`. ### Календарь | Событие | Описание | |---|---| | `calendar.event_created` | Создано событие календаря | | `calendar.event_updated` | Событие обновлено | | `calendar.event_removed` | Событие удалено | #### calendar.event_created: создано событие ```json { "event": "calendar.event_created", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "eventId": "evt-550e8400-e29b-41d4-a716-446655440000", "title": "Созвон с клиентом", "provider": "GOOGLE_CALENDAR" } } ``` #### calendar.event_updated: событие обновлено ```json { "event": "calendar.event_updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "eventId": "evt-550e8400-e29b-41d4-a716-446655440000", "title": "Созвон с клиентом (перенесён)" } } ``` #### calendar.event_removed: событие удалено ```json { "event": "calendar.event_removed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "eventId": "evt-550e8400-e29b-41d4-a716-446655440000", "title": "Созвон с клиентом" } } ``` ### Интеграции | Событие | Описание | |---|---| | `integration.connected` | Подключена интеграция | | `integration.disconnected` | Интеграция отключена | | `integration.updated` | Интеграция обновлена | #### integration.connected: интеграция подключена ```json { "event": "integration.connected", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "integrationId": "int-550e8400-e29b-41d4-a716-446655440000", "type": "AMOCRM", "name": "AmoCRM Production" } } ``` #### integration.disconnected: интеграция отключена ```json { "event": "integration.disconnected", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "integrationId": "int-550e8400-e29b-41d4-a716-446655440000", "type": "AMOCRM" } } ``` #### integration.updated: интеграция обновлена ```json { "event": "integration.updated", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "integrationId": "int-550e8400-e29b-41d4-a716-446655440000", "type": "AMOCRM", "name": "AmoCRM Production v2" } } ``` ### SMS | Событие | Описание | |---|---| | `sms.sent` | SMS отправлено | | `sms.status_changed` | Изменился статус SMS | | `sms.device_connected` | Подключено SMS-устройство | | `sms.device_disconnected` | SMS-устройство отключено | #### sms.sent: SMS отправлено ```json { "event": "sms.sent", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "requestId": "req-550e8400-e29b-41d4-a716-446655440000", "to": "+79991234567", "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678" } } ``` #### sms.status_changed: статус SMS изменён ```json { "event": "sms.status_changed", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "requestId": "req-550e8400-e29b-41d4-a716-446655440000", "status": "delivered", "to": "+79991234567", "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678" } } ``` #### sms.device_connected: SMS-устройство подключено ```json { "event": "sms.device_connected", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "deviceId": "dev-550e8400-e29b-41d4-a716-446655440000", "channelId": "ch-987fcdeb-51a2-3c4d-b5e6-789012345678", "name": "Samsung Galaxy A54" } } ``` #### sms.device_disconnected: SMS-устройство отключено ```json { "event": "sms.device_disconnected", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "deviceId": "dev-550e8400-e29b-41d4-a716-446655440000", "reason": "manual_removal" } } ``` Возможные значения `reason`: `manual_removal` (удалено пользователем), `invalid_fcm_token` (невалидный FCM-токен, устройство отключено автоматически). ### Файлы | Событие | Описание | |---|---| | `file.uploaded` | Загружен файл | | `file.deleted` | Файл удалён | #### file.uploaded: файл загружен ```json { "event": "file.uploaded", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "fileId": "file-550e8400-e29b-41d4-a716-446655440000", "originalName": "document.pdf", "mimeType": "application/pdf", "size": 245760 } } ``` #### file.deleted: файл удалён ```json { "event": "file.deleted", "timestamp": "2025-06-15T10:30:00.000Z", "data": { "fileId": "file-550e8400-e29b-41d4-a716-446655440000", "filename": "document.pdf" } } ``` ## Ограничения и доставка | Параметр | Значение | |---|---| | Таймаут доставки | 10 секунд | | Повторные попытки | Нет: fire-and-forget, одна попытка на событие | | Автоотключение | После 50 последовательных ошибок вебхук деактивируется | | Сброс счётчика ошибок | При успешной доставке счётчик обнуляется | | Подпись | HMAC-SHA256 тела запроса, заголовок `X-Webhook-Signature`, hex | > [!TIP] > Отвечайте `200` сразу, а тяжёлую обработку выносите в очередь. Ответ дольше 10 секунд засчитывается как ошибка доставки, а 50 таких ошибок подряд выключат вебхук. Чтобы вызывать платформу в обратную сторону (отправить сообщение, прочитать историю), используйте [REST API v1](https://docs.tuk-tuk.online/api/rest). Вебхуки внутри цепочек автоматизации описаны на странице [блока Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook). --- --- title: "Пользователи и права: команда, роли, доступы | tuk-tuk.online" nav_title: "Пользователи и права" url: https://docs.tuk-tuk.online/users markdown: https://docs.tuk-tuk.online/users.md description: "Управление пользователями в tuk-tuk.online: вход по паролю, SMS-коду и WebAuthn, системные и кастомные роли с 95 разрешениями в 16 категориях, приглашение сотрудников, до 3 проектов на аккаунт." keywords: ["управление пользователями", "права доступа", "роли сотрудников", "RBAC", "двухфакторная аутентификация", "мультипроект", "команда", "приглашение сотрудников", "разрешения", "безопасность аккаунта"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Раздел tuk-tuk.online про аккаунты и доступы: вход по паролю, SMS-коду и WebAuthn, роли с 95 разрешениями в 16 категориях, приглашение сотрудников по email и до 3 изолированных проектов на аккаунт. > > - Способы входа: телефон и пароль; 2FA по SMS (6 цифр, 5 минут); WebAuthn (биометрия, USB-ключ). > - Системные роли: Владелец (все 95 прав, не редактируется) и Администратор (все права, настраивается). Кастомные роли: любой набор. > - 95 разрешений в 16 категориях. > - Приглашение сотрудника: Настройки → Команда → «Пригласить», по email с выбором роли. > - До 3 проектов на аккаунт; участие в чужих проектах в лимит не входит. > > Связанные страницы: https://docs.tuk-tuk.online/users/auth, https://docs.tuk-tuk.online/users/roles-permissions, https://docs.tuk-tuk.online/users/team, https://docs.tuk-tuk.online/users/projects # Пользователи и права Раздел про аккаунты, безопасность и доступы команды. Вы решаете, кто видит диалоги, кто отвечает клиентам, кто настраивает интеграции и распоряжается балансом. Всё остальное сотруднику закрыто. Три кирпича: способы входа (пароль, SMS-код, биометрия), роли с набором разрешений и проекты как изолированные рабочие пространства. ## Когда это нужно - Защитить аккаунт: пароль, SMS-код при каждом входе или ключ WebAuthn. - Ограничить доступ: сотрудник видит только то, что разрешено его ролью. - Работать командой: пригласить сотрудников по email и раздать роли. - Вести несколько бизнесов: до 3 проектов с одного аккаунта. ## Разделы | Раздел | Что внутри | |---|---| | [Аутентификация](https://docs.tuk-tuk.online/users/auth) | Регистрация, вход по телефону и паролю, 2FA по SMS, ключи WebAuthn, профиль | | [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions) | 95 разрешений в 16 категориях, системные и кастомные роли, автоблокировка | | [Команда](https://docs.tuk-tuk.online/users/team) | Приглашение по email, статусы участников, статистика, тихие часы, мьюты | | [Несколько проектов](https://docs.tuk-tuk.online/users/projects) | До 3 проектов на аккаунт, изоляция данных, переключение | ## Как это устроено ### Три уровня защиты входа 1. Пароль: базовый вход по номеру телефона и паролю. 2. SMS-код (2FA): дополнительный одноразовый код при каждом входе. 3. Биометрия или ключ (WebAuthn): отпечаток пальца, Face ID, USB-ключ. ### Роли и разрешения Каждый сотрудник получает роль. Роль: набор разрешений, что можно делать в проекте. - 2 системные роли: Владелец (все права, не редактируется) и Администратор (все права, набор настраивается). - Кастомные роли с любым набором разрешений. - 95 разрешений в 16 категориях: дашборд, каналы, диалоги, цепочки, AI, календарь, баланс и другие. ### Несколько проектов Один аккаунт, до 3 проектов. Каждый проект: отдельное пространство со своими каналами, диалогами, AI-ассистентами, ролями и командой. Переключение через меню проектов в один клик. --- --- title: "Аутентификация: вход, 2FA по SMS, ключи WebAuthn | tuk-tuk.online" nav_title: "Аутентификация" url: https://docs.tuk-tuk.online/users/auth markdown: https://docs.tuk-tuk.online/users/auth.md section: "Пользователи и права" description: "Как войти в tuk-tuk.online: регистрация по телефону, пароль, двухфакторная аутентификация по SMS, вход по биометрии и USB-ключам (WebAuthn, Passkeys), настройки профиля." keywords: ["аутентификация", "вход в систему", "двухфакторная аутентификация", "2FA", "WebAuthn", "passkey", "биометрия", "ключ безопасности", "SMS код", "регистрация", "безопасность аккаунта"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Вход в tuk-tuk.online: логин по номеру телефона и паролю, необязательная 2FA по SMS и вход без пароля по WebAuthn (отпечаток, Face ID, USB-ключ). Регистрация даёт 100 рублей и 14 дней тарифа CORP. > > - Страница входа: https://lk.tuk-tuk.online/login. Логин: номер телефона; пароль от 6 символов. > - После регистрации: 100 рублей на баланс и 14 дней тарифа CORP. > - 2FA: код 6 цифр, действует 5 минут, 1 SMS в 5 минут. Включается в Настройки профиля → Безопасность. > - WebAuthn: Настройки → Безопасность → Ключи доступа (Passkeys), кнопка «Добавить ключ»; вход через «Войти с помощью ключа». > - Типы ключей: привязанный к устройству и мультиустройственный (iCloud Keychain, Google Password Manager). > - Профиль: телефон, email, имя, аватар, часовой пояс (по умолчанию UTC+3), тихие часы, статус. > > Связанные страницы: https://docs.tuk-tuk.online/users, https://docs.tuk-tuk.online/users/roles-permissions, https://docs.tuk-tuk.online/users/team, https://docs.tuk-tuk.online/pwa/push # Аутентификация Аутентификация: проверка, что в аккаунт входите именно вы. Платформа поддерживает три метода: пароль, одноразовый SMS-код и ключи WebAuthn (отпечаток, лицо, USB-ключ). ## Регистрация ![Форма регистрации](https://docs.tuk-tuk.online/assets/screens/auth/register.webp "При регистрации нужны имя, email, телефон и пароль от 6 символов.") 1. Укажите номер телефона: он станет логином. 2. Придумайте пароль от 6 символов. 3. Примите политику обработки данных и завершите регистрацию: откроется кабинет. После регистрации на аккаунте: | Бонус | Что даёт | |---|---| | 100 рублей на баланс | Для первых тестов | | 14 дней тарифа CORP | Все функции без ограничений | > [!TIP] Если вас раньше пригласили в чужой проект по email, после регистрации с этим email доступ к проекту появится автоматически. ## Вход по телефону и паролю ![Экран входа в кабинет](https://docs.tuk-tuk.online/assets/screens/auth/login.webp) 1. Телефон в международном формате. 2. Пароль. 3. Кнопка «Войти». 4. Ссылка на регистрацию. 1. Откройте [страницу входа](https://lk.tuk-tuk.online/login). 2. Введите номер телефона и пароль. 3. Нажмите «Войти»: откроется кабинет. Если включена 2FA, сначала появится поле для SMS-кода. ## Двухфакторная аутентификация (2FA) Дополнительный слой защиты: даже зная пароль, без кода из SMS войти нельзя. ### Как работает 1. Введите телефон и пароль. 2. Получите 6-значный код по SMS. 3. Введите код на странице входа: откроется кабинет. | Параметр | Значение | |---|---| | Длина кода | 6 цифр | | Срок действия | 5 минут | | Частота отправки | 1 SMS каждые 5 минут | | Повторная отправка | После истечения таймера | ### Как включить ![Вкладка «Безопасность» в настройках аккаунта](https://docs.tuk-tuk.online/assets/screens/account/security.webp) 1. Уровень защиты: чек-лист (email, телефон, 2FA, passkey) и процент. Каждый пункт ведёт к нужной настройке. 2. Смена пароля: текущий и новый, индикатор надёжности. 3. Двухфакторная защита: SMS-код при входе. Переключатель доступен только после подтверждения телефона по SMS. 4. Ключи доступа (Passkey): вход по биометрии без пароля. 1. Убедитесь, что телефон подтверждён (Настройки аккаунта → Профиль → «Подтвердить по SMS»). После смены номера подтверждение нужно пройти заново. 2. Откройте Настройки аккаунта → Безопасность. 3. Включите переключатель «Двухфакторный вход» и подтвердите в окне: со следующего входа платформа запросит код. > [!WARNING] Телефон должен принимать SMS. Если доступ к номеру потерян, обратитесь в поддержку. ## Вход по биометрии и ключам (WebAuthn) WebAuthn: стандарт FIDO2 для входа без пароля. Используется то, что всегда с вами: отпечаток пальца, лицо или физический ключ. | Способ | Примеры | |---|---| | Отпечаток пальца | Touch ID на Mac, сканер на телефоне | | Распознавание лица | Face ID на iPhone, Windows Hello | | USB-ключ | YubiKey, Titan Security Key | | Bluetooth-ключ | Ключи с поддержкой BLE | ### Как добавить ключ 1. Войдите в аккаунт обычным способом. 2. Откройте Настройки → Безопасность → Ключи доступа (Passkeys). 3. Нажмите «Добавить ключ». 4. Следуйте подсказкам браузера: приложите палец, покажите лицо или вставьте USB-ключ. 5. Дайте ключу понятное имя, например «MacBook Touch ID»: ключ появится в списке. ### Как войти по ключу 1. Откройте [страницу входа](https://lk.tuk-tuk.online/login). 2. Нажмите «Войти с помощью ключа». Кнопка видна, если браузер поддерживает WebAuthn. 3. Подтвердите вход отпечатком, лицом или ключом: откроется кабинет. ### Управление ключами В разделе Настройки → Безопасность можно посмотреть список ключей, переименовать ключ (например, «Рабочий ноутбук») и удалить ненужный. | Тип ключа | Где хранится | |---|---| | Привязанный к устройству | На конкретном устройстве, не копируется (например, USB-ключ) | | Мультиустройственный | Синхронизируется через облако: iCloud Keychain, Google Password Manager | > [!TIP] Добавьте минимум 2 ключа на случай, если один станет недоступен. ## Сравнение методов входа | Метод | Защита | Что нужно | |---|---|---| | Телефон и пароль | Базовая | Помнить пароль | | Телефон, пароль и SMS-код | Выше: нужен доступ к номеру | Телефон под рукой | | WebAuthn / Passkey | Самая высокая: нет пароля, который можно украсть | Устройство с биометрией или USB-ключ | ## Профиль пользователя ![Настройки аккаунта: профиль](https://docs.tuk-tuk.online/assets/screens/account/profile.webp) 1. Шапка: аватар, бейджи подтверждения email и телефона, уровень защиты, время в вашем поясе. 2. Вкладки: Профиль, Уведомления и Безопасность. 3. Часовой пояс: сохраняется сразу при выборе; влияет на расписания, тихие часы и время в календаре. 4. Статус сотрудника: Доступен, Занят, В отпуске, с необязательным автосбросом. | Настройка | Что задаёт | |---|---| | Телефон | Основной логин | | Email | Для приглашений и уведомлений | | Имя | Отображается коллегам | | Аватар | Фото профиля | | Часовой пояс | По умолчанию UTC+3 (Москва) | | Тихие часы | Период без push-уведомлений (вкладка «Уведомления»), шкала показывает диапазон и текущее время | | Заглушённые теги | Диалоги с этими тегами не присылают уведомления | | Письма от TukTuk | Согласие на новости продукта; служебные письма приходят всегда | | Язык интерфейса | Один из 11 языков, запоминается на устройстве | | Статус | Доступен, Занят, В отпуске | Статус «В отпуске» или «Занят» можно поставить до определённой даты: по её наступлении он сбросится сам. --- --- title: "Роли и разрешения: 95 прав в 16 категориях | tuk-tuk.online" nav_title: "Роли и разрешения" url: https://docs.tuk-tuk.online/users/roles-permissions markdown: https://docs.tuk-tuk.online/users/roles-permissions.md section: "Пользователи и права" description: "Ролевая модель tuk-tuk.online: системные роли Владелец и Администратор, кастомные роли, полный список 95 разрешений по 16 категориям, автоблокировка неактивных сотрудников." keywords: ["роли сотрудников", "разрешения", "RBAC", "права доступа", "кастомные роли", "настройка доступа", "гранулярные права", "управление доступом", "ролевая модель", "безопасность команды"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Ролевая модель tuk-tuk.online: сотрудник получает роль, роль содержит набор из 95 разрешений в 16 категориях. Системные роли Владелец и Администратор, кастомные роли с любым набором прав, автоблокировка по дням неактивности. > > - Путь: Настройки → Роли, кнопка «Создать роль». > - Роль: название до 100 символов, описание до 500, набор разрешений, период автоблокировки (0 = выключена). > - Владелец: все 95 прав, набор не меняется, роль не удаляется, назначается создателю проекта. Администратор: все права при создании, набор настраивается, не удаляется. > - Категории: Дашборд 4, Блоки дашборда 6, Каналы 6, Диалоги 11, Цепочки 9, AI-обработка 5, AI-ассистенты 5, Календарь 5, Файлы 3, Баланс 5, Пользователи и роли 6, Интеграции 3, История 2, SMS 2, Чат-виджет 4, Посетители 1, Задачи 4, Настройки 2. > - Воронки используют права цепочек: CHAINS_VIEW, CHAINS_CREATE, CHAINS_EDIT, CHAINS_DELETE, CHAINS_TOGGLE, CHAINS_EXECUTE, CHAINS_LOGS. > > Связанные страницы: https://docs.tuk-tuk.online/users, https://docs.tuk-tuk.online/users/team, https://docs.tuk-tuk.online/users/projects, https://docs.tuk-tuk.online/users/auth # Роли и разрешения Доступ в проекте строится на ролях (RBAC). Сотрудник получает роль, роль определяет, что ему можно: видеть диалоги, отвечать клиентам, править цепочки, пополнять баланс. Всё, что не разрешено, скрыто. ## Что такое роль Роль: именованный набор разрешений. Роль «Менеджер» может включать чтение диалогов и отправку сообщений, но не доступ к настройкам AI или балансу. | Свойство | Значение | |---|---| | Название | До 100 символов, например «Старший менеджер» | | Описание | До 500 символов: для чего роль | | Разрешения | Набор из 95 возможных прав | | Системная | Системные роли нельзя удалить | | Автоблокировка | Через сколько дней неактивности заблокировать сотрудника; 0 означает «не блокировать» | ## Системные роли Создаются автоматически вместе с проектом. | Роль | Права | Что можно менять | |---|---|---| | Владелец | Все 95 разрешений | Ничего: набор прав фиксирован, роль не удаляется. Назначается создателю проекта | | Администратор | Все 95 разрешений при создании | Набор прав: лишние можно убрать. Роль не удаляется | ## Как создать свою роль ![Роли проекта](https://docs.tuk-tuk.online/assets/screens/users/roles.webp) 1. Кнопка «Новая роль». 2. Карточка роли: название, описание и число прав. ![Форма новой роли](https://docs.tuk-tuk.online/assets/screens/users/role-form.webp) 1. Название роли. 2. Описание. 3. Кнопка «Создать». 4. Права по разделам: можно отметить всё сразу или выбрать точечно. 1. Откройте Настройки → Роли: появится список ролей. 2. Нажмите «Создать роль»: откроется форма. 3. Укажите название и описание. 4. Отметьте нужные разрешения. 5. Нажмите «Сохранить»: роль появится в списке и станет доступна при приглашении сотрудников. > [!TIP] Примеры: «Менеджер по продажам» (диалоги и задачи), «Маркетолог» (цепочки и рассылки), «Бухгалтер» (баланс и статистика). ## Полный список разрешений 95 прав в 16 категориях. Каждое разрешение отвечает на вопрос «может ли сотрудник это делать». ### Дашборд (4) | Разрешение | Что позволяет | |---|---| | Просмотр дашборда | Видеть главную панель | | Статистика | Видеть сводную статистику | | Лента активности | Видеть последние события в реальном времени | | Редактирование дашборда | Настраивать виджеты и расположение блоков | ### Блоки дашборда (6) | Разрешение | Что позволяет | |---|---| | Финансовый блок | Видеть данные о финансах | | Расходы на коммуникации | Видеть затраты на SMS, AI и другие каналы | | Блок статистики | Видеть расширенную статистику | | График сообщений | Видеть график отправленных и полученных сообщений | | Счётчики | Видеть числовые счётчики: диалоги, задачи и другие | | Лента активности | Видеть ленту последних действий | ### Каналы (6) | Разрешение | Что позволяет | |---|---| | Просмотр каналов | Видеть список подключённых каналов | | Создание каналов | Подключать новые каналы: Telegram, SMS и другие | | Редактирование | Менять настройки каналов | | Вкл./выкл. каналов | Активировать и деактивировать каналы | | Удаление каналов | Удалять каналы | | Статистика каналов | Видеть статистику по каждому каналу | ### Диалоги (11) | Разрешение | Что позволяет | |---|---| | Просмотр диалогов | Видеть список диалогов и переписку | | Ответ в диалогах | Отправлять сообщения клиентам | | Управление тегами | Добавлять и удалять теги | | Заметки | Оставлять внутренние заметки | | Редактирование контакта | Менять имя, email, телефон клиента | | AI в диалогах | Запускать AI-обработку в диалоге | | Цепочки в диалогах | Запускать цепочки из диалога | | Объединение диалогов | Объединять дубли | | Удаление диалогов | Удалять диалоги | | Отметка «прочитано» | Помечать диалоги прочитанными | | Экспорт диалогов | Выгружать историю переписки | ### Цепочки (9) | Разрешение | Что позволяет | |---|---| | Просмотр цепочек | Видеть список цепочек | | Создание цепочек | Создавать цепочки в конструкторе | | Редактирование | Менять существующие цепочки | | Вкл./выкл. цепочек | Активировать и деактивировать | | Ручной запуск | Запускать цепочку вручную для диалога | | Клонирование | Создавать копии цепочек | | Удаление цепочек | Удалять цепочки | | Логи выполнения | Смотреть историю запусков | | Маркетплейс | Доступ к маркетплейсу шаблонов | ### AI-обработка (5) | Разрешение | Что позволяет | |---|---| | Просмотр AI | Видеть настройки AI | | Провайдеры | Управлять подключёнными AI-провайдерами | | Редактирование инструкций | Создавать и править промпты | | Удаление инструкций | Удалять инструкции | | Сниппеты | Управлять сниппетами для AI | ### AI-ассистенты (5) | Разрешение | Что позволяет | |---|---| | Просмотр ассистентов | Видеть список ассистентов | | Создание ассистентов | Создавать ассистентов | | Редактирование | Настраивать ассистентов | | Вкл./выкл. ассистентов | Активировать и деактивировать | | Удаление ассистентов | Удалять ассистентов | ### Календарь (5) | Разрешение | Что позволяет | |---|---| | Просмотр календаря | Видеть события и записи | | Создание событий | Создавать записи и события | | Редактирование | Менять события | | Удаление событий | Удалять записи | | Синхронизация | Синхронизировать с Google Calendar | ### Файлы (3) | Разрешение | Что позволяет | |---|---| | Просмотр файлов | Видеть загруженные файлы | | Синхронизация | Синхронизировать файловое хранилище | | Удаление файлов | Удалять файлы | ### Баланс (5) | Разрешение | Что позволяет | |---|---| | Просмотр баланса | Видеть текущий баланс | | Пополнение | Пополнять баланс | | Подписка | Управлять тарифом | | История операций | Смотреть историю платежей | | Промокоды | Управлять промокодами | ### Пользователи и роли (6) | Разрешение | Что позволяет | |---|---| | Просмотр пользователей | Видеть список сотрудников | | Полные данные | Видеть email, телефон и детальную статистику | | Приглашение | Приглашать сотрудников | | Смена роли | Менять роль сотрудника | | Удаление | Удалять сотрудников из проекта | | Управление ролями | Создавать и редактировать роли | ### Интеграции (3) | Разрешение | Что позволяет | |---|---| | Просмотр интеграций | Видеть подключённые интеграции | | Подключение | Подключать новые | | Настройка | Менять параметры интеграций | ### История (2) | Разрешение | Что позволяет | |---|---| | Просмотр истории | Смотреть журнал отправленных сообщений | | Повтор отправки | Повторять неудачные отправки | ### SMS (2) | Разрешение | Что позволяет | |---|---| | Просмотр SMS | Видеть историю SMS | | Отправка SMS | Отправлять SMS вручную | ### Чат-виджет (4) | Разрешение | Что позволяет | |---|---| | Просмотр виджетов | Видеть список виджетов | | Создание | Создавать виджеты для сайта | | Редактирование | Настраивать внешний вид и поведение | | Удаление | Удалять виджеты | ### Посетители (1) | Разрешение | Что позволяет | |---|---| | Просмотр посетителей | Видеть информацию о посетителях сайта | ### Задачи (4) | Разрешение | Что позволяет | |---|---| | Просмотр задач | Видеть список задач | | Создание задач | Создавать задачи | | Редактирование | Менять задачи | | Удаление задач | Удалять задачи | ### Настройки (2) | Разрешение | Что позволяет | |---|---| | Просмотр настроек | Видеть страницу настроек | | Редактирование | Менять настройки проекта | ## Автоблокировка неактивных сотрудников У роли можно задать период автоблокировки. Если сотрудник с этой ролью не заходил в кабинет указанное число дней, доступ блокируется автоматически. | Значение | Поведение | |---|---| | 0 (по умолчанию) | Автоблокировка выключена | | 7 | Блокировка через 7 дней бездействия | | 30 | Блокировка через 30 дней бездействия | > [!TIP] Удобно для стажёров и временных сотрудников: поставьте 14 дней, и ушедший стажёр заблокируется сам. --- --- title: "Команда: приглашения, статусы, статистика сотрудников | tuk-tuk.online" nav_title: "Команда" url: https://docs.tuk-tuk.online/users/team markdown: https://docs.tuk-tuk.online/users/team.md section: "Пользователи и права" description: "Управление командой в tuk-tuk.online: приглашение сотрудников по email с ролью, статусы участия и доступности, статистика активности, тихие часы и мьюты уведомлений." keywords: ["управление командой", "приглашение сотрудников", "статистика команды", "статус сотрудника", "активность сотрудников", "онлайн", "команда проекта", "менеджер команды", "приглашение по email"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Команда проекта в tuk-tuk.online: приглашение сотрудников по email с назначением роли, статусы участия (Ожидает, Активен) и доступности (Доступен, Занят, В отпуске), статистика активности, тихие часы и мьюты уведомлений. > > - Путь: Настройки → Команда, кнопка «Пригласить»; поля: email, роль, отображаемое имя. > - Зарегистрированный с этим email получает доступ сразу; незарегистрированный числится «Ожидает» до регистрации с этим email. > - Статусы доступности можно ставить до даты, потом сброс на «Доступен». > - Разрешения: «Просмотр пользователей» (список и статистика), «Смена роли», «Удаление пользователей». > - Статистика: последний вход, время онлайн сегодня, сессий сегодня, сообщений сегодня и всего, дата присоединения. > - Тихие часы: начало, конец, дни; отключают push и звуки, но не доставку сообщений. Мьюты: по диалогу и по тегу. > > Связанные страницы: https://docs.tuk-tuk.online/users, https://docs.tuk-tuk.online/users/roles-permissions, https://docs.tuk-tuk.online/users/projects, https://docs.tuk-tuk.online/dialogs/notifications # Команда Команда: сотрудники проекта, их роли и активность. Здесь приглашают людей по email, назначают роли, видят, кто в сети и сколько сообщений отправил каждый менеджер. ## Как пригласить сотрудника ![Участники проекта](https://docs.tuk-tuk.online/assets/screens/users/members.webp) 1. Пункт «Пользователи» в меню. 2. Вкладки: Участники, Роли, Статистика, Геймификация. 3. Пригласить участника по email. 4. Смена роли участника. 5. Отозвать приглашение или доступ. ![Приглашение участника](https://docs.tuk-tuk.online/assets/screens/users/invite.webp) 1. Email сотрудника. 2. Имя, необязательно. 3. Роль. 4. Кнопка «Пригласить». 1. Откройте Настройки → Команда: появится список участников. 2. Нажмите «Пригласить»: откроется форма. 3. Укажите email сотрудника. 4. Выберите [роль](https://docs.tuk-tuk.online/users/roles-permissions), например «Менеджер». 5. При желании укажите отображаемое имя. 6. Нажмите «Отправить приглашение»: сотрудник появится в списке, на email уйдёт письмо со ссылкой. | Ситуация | Что произойдёт | |---|---| | Сотрудник уже зарегистрирован с этим email | Получает доступ сразу, статус «Активен» | | Сотрудник ещё не зарегистрирован | Статус «Ожидает»; ссылка из письма ведёт на регистрацию, доступ появится после регистрации с этим email | ## Статусы участия | Статус | Значение | |---|---| | Ожидает | Приглашён, но ещё не принял приглашение или не зарегистрировался | | Активен | Приглашение принято, сотрудник работает в проекте | ## Статусы доступности ![Геймификация команды](https://docs.tuk-tuk.online/assets/screens/users/gamification.webp "Вкладка «Геймификация»: место в рейтинге, очки, медали и настройки достижений.") Сотрудник ставит статус сам, чтобы коллеги понимали, можно ли к нему обращаться. | Статус | Когда ставить | |---|---| | Доступен | На рабочем месте, готов к задачам | | Занят | Работает, лучше не отвлекать | | В отпуске | Отсутствует, задачи стоит передать другому | Статус можно поставить до определённой даты. По её наступлении он сам вернётся к «Доступен». ## Действия с сотрудниками | Действие | Что делает | Нужное разрешение | |---|---|---| | Просмотр списка | Видеть всех сотрудников и их роли | Просмотр пользователей | | Смена роли | Назначить другую роль | Смена роли | | Удаление | Убрать сотрудника из проекта | Удаление пользователей | | Статистика | Смотреть детальную активность | Просмотр пользователей | ## Статистика сотрудников ![Статистика участников проекта](https://docs.tuk-tuk.online/assets/screens/users/stats.webp "Последний вход, время онлайн за сегодня, сессии и число сообщений.") | Метрика | Что показывает | |---|---| | Имя и роль | Отображаемое имя и назначенная роль | | Email | Почта сотрудника | | Последний вход | Когда сотрудник был в сети последний раз | | Время онлайн сегодня | Сколько был онлайн за день | | Сессий сегодня | Число входов за день | | Сообщений сегодня | Сколько сообщений отправил за день | | Сообщений всего | Общее число отправленных сообщений | | В команде с | Дата присоединения к проекту | | Текущий статус | Доступен, Занят, В отпуске | > [!TIP] Статистика показывает перекос нагрузки: если один менеджер отправляет 200 сообщений в день, а другой 5, диалоги стоит перераспределить. ## Тихие часы Период, в который сотруднику не приходят уведомления. Настраивается индивидуально. | Настройка | Пример | |---|---| | Начало | 22:00 | | Конец | 08:00 | | Дни | Пн–Пт или все дни недели | Сообщения продолжают поступать в диалоги, отключаются только push-уведомления и звуки. ## Мьюты Если отвлекают уведомления из конкретных диалогов или по определённым тегам: | Тип мьюта | Что отключает | |---|---| | Мьют диалога | Уведомления из конкретного диалога | | Мьют тега | Уведомления по диалогам с определённым тегом | Подробнее о каналах доставки: [Уведомления](https://docs.tuk-tuk.online/dialogs/notifications). --- --- title: "Несколько проектов на одном аккаунте | tuk-tuk.online" nav_title: "Несколько проектов" url: https://docs.tuk-tuk.online/users/projects markdown: https://docs.tuk-tuk.online/users/projects.md section: "Пользователи и права" description: "Мультипроектность в tuk-tuk.online: до 3 изолированных проектов на аккаунт со своими каналами, диалогами, цепочками, AI, командой и балансом. Переключение, создание, участие в чужих проектах." keywords: ["мультипроект", "несколько проектов", "переключение проектов", "рабочее пространство", "несколько бизнесов", "проекты в CRM", "мульти-аккаунт", "workspace"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Один аккаунт tuk-tuk.online ведёт до 3 изолированных проектов, у каждого свои каналы, диалоги, цепочки, AI-ассистенты, команда, роли, календарь, задачи, баланс и дашборд. Переключение через меню проектов. > > - Лимит: 3 собственных проекта на аккаунт; участие в чужих проектах в лимит не входит. > - Личный проект создаётся автоматически при регистрации. > - Создание: меню проектов → «Создать проект» → название. > - Перенос данных между проектами невозможен; удаление проекта необратимо. > - В чужом проекте права задаёт роль, назначенная владельцем; удалять проект и менять глобальные настройки может только владелец. > > Связанные страницы: https://docs.tuk-tuk.online/users, https://docs.tuk-tuk.online/users/team, https://docs.tuk-tuk.online/users/roles-permissions, https://docs.tuk-tuk.online/billing # Несколько проектов Один аккаунт может вести до 3 независимых проектов. Проект: отдельное рабочее пространство со своими каналами, диалогами, командой и настройками. Данные между проектами не пересекаются. ## Когда это нужно - Разные бизнесы: интернет-магазин и салон красоты на одном аккаунте. - Отделы компании: продажи, поддержка и маркетинг в разных проектах. - Тест и продакшн: проверять настройки в тестовом проекте, не трогая рабочий. ## Как устроено | Свойство | Значение | |---|---| | Максимум проектов | 3 на аккаунт | | Переключение | В один клик через меню проектов | | Личный проект | Создаётся автоматически при регистрации | | Изоляция | Каждый проект полностью независим | ## Что у проекта своё | Компонент | Что именно | |---|---| | Каналы | Свои Telegram-боты, SMS-шлюзы, виджеты | | Диалоги | Своя база клиентов и переписок | | Цепочки | Свои сценарии автоматизации | | AI-ассистенты | Свои настройки и промпты | | Команда | Свои сотрудники | | Роли | Свои наборы разрешений | | Календарь | Свои услуги, сотрудники и записи | | Задачи | Своя канбан-доска | | Баланс | Свой баланс и тариф | | Дашборд | Своя конфигурация виджетов | ## Как переключить проект 1. Откройте меню проектов в верхней части интерфейса. 2. Выберите проект из списка: интерфейс переключится, диалоги, каналы, AI и цепочки станут данными выбранного проекта. ## Как создать проект ![Настройки проекта: вкладка «Проект»](https://docs.tuk-tuk.online/assets/screens/settings/project.webp "Во вкладке «Проект» меняется название текущего проекта. Новый проект создаётся кнопкой «Добавить систему» внизу меню.") 1. Откройте меню проектов. 2. Нажмите «Создать проект». 3. Укажите название и подтвердите: пустой проект появится в списке. > [!WARNING] Лимит: 3 проекта на аккаунт. Если нужно больше, обратитесь в поддержку. ## Участие в чужих проектах Если вас пригласили в чужой проект: - он появляется в вашем списке переключения; - ваши права определяет [роль](https://docs.tuk-tuk.online/users/roles-permissions), которую назначил владелец; - удалить проект или менять его глобальные настройки вы не можете: владелец не вы; - чужие проекты не входят в ваш лимит из 3 проектов. ## Частые вопросы ### Можно ли перенести данные между проектами Нет. Проекты изолированы: каналы, диалоги и настройки из одного проекта в другой не переносятся. ### Может ли сотрудник состоять в нескольких проектах Да. Сотрудника можно пригласить в каждый из ваших проектов с разными ролями. ### Что будет при удалении проекта Все данные проекта удаляются без возможности восстановления: каналы, диалоги, цепочки, файлы и настройки. --- --- title: "SMS Gateway: Android-приложение для отправки и приёма SMS" nav_title: "SMS Gateway (Android)" url: https://docs.tuk-tuk.online/sms-gateway markdown: https://docs.tuk-tuk.online/sms-gateway.md description: "Android-приложение tuk-tuk SMS Gateway превращает телефон с SIM-картой в SMS-шлюз: привязка по QR-коду, приём и отправка SMS, Dual-SIM, автозапуск и переподключение." keywords: ["SMS Gateway", "Android SMS приложение", "SMS шлюз", "отправка SMS с телефона", "Android шлюз", "бесплатная отправка SMS", "SMS gateway app", "SMS автоматизация"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Android-приложение tuk-tuk SMS Gateway превращает телефон с SIM-картой в двусторонний SMS-шлюз: исходящие SMS уходят через SIM по команде сервера, входящие попадают в диалоги tuk-tuk.online. Без SMS-агрегатора, по тарифу оператора. > > - Требования: Android 7.0 и выше, интернет (Wi-Fi или мобильные данные), активная SIM-карта, около 30 МБ памяти. > - APK скачивается в разделе «SMS» кабинета (https://lk.tuk-tuk.online/sms), не из Google Play. > - Привязка телефона к аккаунту: QR-код из кабинета, действует 10 минут, одноразовый. > - После привязки создаётся канал типа SMS в разделе «Каналы связи» (https://lk.tuk-tuk.online/channels). > - Команды на отправку приходят на телефон через push (FCM); heartbeat каждые 30 минут (минимум 15). > - Поддерживаются две SIM-карты, фильтры входящих по номеру, история SMS за 30 дней. > > Связанные страницы: https://docs.tuk-tuk.online/sms-gateway/setup, https://docs.tuk-tuk.online/sms-gateway/features, https://docs.tuk-tuk.online/sms-gateway/reliability, https://docs.tuk-tuk.online/sms-gateway/monitoring, https://docs.tuk-tuk.online/channels/sms # SMS Gateway для Android SMS Gateway: Android-приложение, которое превращает телефон с SIM-картой в SMS-шлюз tuk-tuk.online. Телефон отправляет SMS клиентам и принимает ответы, а вы работаете с ними из центра диалогов. Платный SMS-провайдер не нужен: сообщения идут по тарифу вашего оператора. Пример: клиент присылает SMS, телефон передаёт его на сервер, сообщение появляется в диалогах. Оператор отвечает с компьютера, телефон отправляет SMS клиенту. ## Когда это нужно - Принимать и отправлять SMS с обычного номера, без договора с SMS-агрегатором. - Видеть SMS в общем центре диалогов рядом с Telegram, Email и другими каналами. - Отдать ответы на SMS AI-ассистенту. ## Что умеет - Двусторонний обмен: отправка и приём SMS. - Работа в фоне, телефон можно не трогать. - Автозапуск после перезагрузки и переподключение при потере связи. - Бережный расход батареи: heartbeat раз в 30 минут, sticky-уведомление. - Две SIM-карты, фильтры входящих, история за 30 дней. ## Как это работает ```text Компьютер / tuk-tuk.online Android-телефон Клиент ┌──────────────────────┐ ┌──────────────┐ ┌───────┐ │ Нажали «Отправить» │──── push ──→│ Приложение │──── SMS ──→│ Номер │ │ │← статус ────│ tuk-tuk │← ответ ───│ │ └──────────────────────┘ └──────────────┘ └───────┘ ``` Отправка: сервер шлёт push-уведомление, приложение получает его, отправляет SMS через SIM-карту и возвращает серверу статус. Приём: телефон получает SMS, приложение перехватывает его и передаёт на сервер, сообщение появляется в диалоге. ## Требования | Параметр | Значение | |---|---| | ОС | Android 7.0 (Nougat) и выше | | Интернет | Wi-Fi или мобильные данные | | SIM-карта | Активная, с возможностью отправки SMS | | Память | Около 30 МБ свободного места | ## Разделы | Страница | О чём | |---|---| | [Установка и привязка](https://docs.tuk-tuk.online/sms-gateway/setup) | APK, разрешения, QR-код, создание SMS-канала | | [Возможности](https://docs.tuk-tuk.online/sms-gateway/features) | Отправка, приём, Dual-SIM, фильтры, история | | [Надёжность](https://docs.tuk-tuk.online/sms-gateway/reliability) | Батарея, heartbeat, автозапуск, повторы | | [Мониторинг](https://docs.tuk-tuk.online/sms-gateway/monitoring) | Данные устройства, статистика, лимиты, неполадки | Настройка SMS-канала в кабинете: [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms). --- --- title: "Установка SMS Gateway и привязка телефона по QR-коду" nav_title: "Установка и привязка" url: https://docs.tuk-tuk.online/sms-gateway/setup markdown: https://docs.tuk-tuk.online/sms-gateway/setup.md section: "SMS Gateway (Android)" description: "Установка Android-приложения tuk-tuk SMS Gateway из APK, выдача разрешений на SMS, привязка устройства по QR-коду из кабинета и создание SMS-канала." keywords: ["установка SMS Gateway", "привязка телефона", "QR-код SMS", "настройка Android SMS", "разрешения SMS", "APK SMS шлюз", "подключить телефон"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Как поставить Android-приложение SMS Gateway из APK, выдать ему разрешения, привязать телефон к аккаунту tuk-tuk.online по QR-коду и создать SMS-канал. > > - APK: раздел «SMS» кабинета (https://lk.tuk-tuk.online/sms), кнопка «Скачать APK». Нужно разрешить установку из неизвестных источников. > - Разрешения: отправка SMS, чтение SMS, приём SMS, состояние телефона, уведомления (Android 13+). > - QR-код: кнопка «Привязать устройство» в разделе «SMS»; токен 64 символа, действует 10 минут, одноразовый. > - После привязки телефон получает Device ID и API-ключ, шлюз включается автоматически. > - SMS-канал: раздел «Каналы связи» (https://lk.tuk-tuk.online/channels), «Подключить», тип SMS, выбор привязанного устройства. > > Связанные страницы: https://docs.tuk-tuk.online/sms-gateway, https://docs.tuk-tuk.online/sms-gateway/features, https://docs.tuk-tuk.online/sms-gateway/monitoring, https://docs.tuk-tuk.online/channels/sms # Установка и привязка Три действия: установить APK, выдать разрешения, отсканировать QR-код из кабинета. После этого создаётся SMS-канал, и телефон начинает работать как шлюз. ## Установить приложение 1. Откройте раздел [SMS](https://lk.tuk-tuk.online/sms) в кабинете. 2. Нажмите «Скачать APK». 3. Перенесите файл на телефон (или скачайте прямо с телефона) и откройте его. Результат: приложение tuk-tuk установлено. > [!WARNING] Приложение ставится из APK-файла, не из Google Play. Android попросит разрешить установку из неизвестных источников. ### Разрешить установку из неизвестных источников 1. Откройте Настройки → Безопасность (на части телефонов: Приложения). 2. Найдите пункт «Неизвестные источники» или «Установка из неизвестных приложений». 3. Разрешите установку для браузера или файлового менеджера, из которого открываете APK. ## Выдать разрешения При первом запуске приложение запросит разрешения. Без них шлюз не работает. | Разрешение | Зачем | |---|---| | Отправка SMS | Отправлять SMS клиентам | | Чтение SMS | Перехватывать входящие SMS | | Приём SMS | Получать уведомления о новых SMS | | Состояние телефона | Определять SIM-карты и оператора | | Уведомления | Показывать статус работы (Android 13 и новее) | > [!TIP] Проверить и изменить разрешения позже: Настройки → Приложения → tuk-tuk → Разрешения. ## Привязать телефон по QR-коду Привязка соединяет телефон с аккаунтом tuk-tuk.online. Делается один раз. 1. На компьютере откройте [SMS](https://lk.tuk-tuk.online/sms) и нажмите «Привязать устройство». На экране появится QR-код. 2. На телефоне откройте приложение tuk-tuk и нажмите «Сканировать QR-код». 3. Наведите камеру на QR-код на экране компьютера. 4. Дождитесь подтверждения: на экране телефона появится Device ID. ### Что в QR-коде | Параметр | Значение | |---|---| | Токен привязки | Уникальный код из 64 символов | | Срок действия | 10 минут | | Использование | Одноразовое | | Адрес сервера | URL API для подключения | > [!WARNING] QR-код не сканируется: обновите страницу в кабинете. Скорее всего, прошло больше 10 минут и код истёк. ### Что происходит при привязке 1. Телефон отправляет на сервер токен из QR-кода, модель устройства, версию ОС и push-токен. 2. Сервер проверяет токен и привязывает устройство к аккаунту. 3. Телефон получает Device ID и API-ключ и сохраняет их. 4. Шлюз включается автоматически. ## Проверить, что работает После привязки на главном экране приложения: | Элемент | Что показывает | |---|---| | Device ID | Идентификатор устройства, можно скопировать | | API Key | Ключ авторизации, можно скопировать | | Статус шлюза | Главный переключатель Вкл./Выкл. | | Имя устройства | Произвольное название | ## Создать SMS-канал 1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels). 2. Нажмите «Подключить» на карточке SMS. 3. Выберите привязанное устройство из списка. 4. Нажмите «Сохранить». Результат: SMS проходят через канал и появляются в [диалогах](https://lk.tuk-tuk.online/dialogs). Настройки канала описаны на странице [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms). --- --- title: "Возможности SMS Gateway: отправка, приём, Dual-SIM, фильтры, история" nav_title: "Возможности" url: https://docs.tuk-tuk.online/sms-gateway/features markdown: https://docs.tuk-tuk.online/sms-gateway/features.md section: "SMS Gateway (Android)" description: "Как Android-приложение SMS Gateway отправляет и принимает SMS: статусы доставки, две SIM-карты, фильтры входящих по номеру, защита от дублей, история за 30 дней." keywords: ["Dual-SIM SMS", "фильтрация SMS", "история SMS", "SMS отправка", "SMS приём", "SMS дедупликация", "выбор SIM-карты", "SMS фильтры"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Функции Android-приложения SMS Gateway: отправка SMS по push-команде со статусами доставки, приём входящих с защитой от дублей и фильтрами по номеру, выбор SIM-карты, история сообщений. > > - Отправка: push (FCM) от сервера, длинный текст делится по 160–170 символов, статусы: В очереди, Отправлено, Доставлено, Ошибка. Повтор push до 3 раз. > - Приём включается переключателем «Приём SMS» в приложении. > - Дедупликация: MD5 из текста, отправителя и времени, окно 5 секунд. > - Фильтры входящих по номеру: точное совпадение, начинается с, заканчивается на, содержит. Без фильтров передаются все SMS. > - Выбор SIM: слот из задания сервера, затем настройка приложения, затем SIM по умолчанию в Android. > - История в приложении: тип, номер, текст, время, статус; фильтры Все, Исходящие, Входящие; записи старше 30 дней удаляются. > > Связанные страницы: https://docs.tuk-tuk.online/sms-gateway, https://docs.tuk-tuk.online/sms-gateway/setup, https://docs.tuk-tuk.online/sms-gateway/reliability, https://docs.tuk-tuk.online/sms-gateway/monitoring, https://docs.tuk-tuk.online/channels/sms # Возможности приложения Что приложение делает с SMS помимо отправки: принимает входящие, работает с двумя SIM-картами, фильтрует номера, отсекает дубли и хранит историю. ## Отправка SMS Когда оператор или AI-ассистент отправляет SMS через tuk-tuk.online: 1. Сервер отправляет push-уведомление (FCM) на телефон. 2. Приложение получает push и формирует SMS. 3. Длинный текст делится на части по 160–170 символов. 4. Телефон отправляет SMS через SIM-карту как обычное сообщение. 5. Приложение возвращает серверу статус: отправлено, доставлено или ошибка. | Статус | Значение | |---|---| | В очереди | Сообщение ждёт отправки на телефоне | | Отправлено | Телефон отправил SMS | | Доставлено | Оператор связи подтвердил доставку | | Ошибка | Отправка не удалась: баланс SIM, номер, оператор | > [!NOTE] Если push не дошёл, сервер повторяет попытку до 3 раз. ## Приём входящих SMS Приложение перехватывает входящие SMS и передаёт их на сервер. Оттуда они попадают в диалог с клиентом. ### Включить приём 1. Откройте приложение tuk-tuk на телефоне. 2. Включите переключатель «Приём SMS». Результат: следующее входящее SMS появится в диалогах. ### Защита от дублей Android иногда отдаёт одно SMS дважды. Приложение считает MD5-отпечаток из текста, отправителя и времени; если SMS с таким отпечатком уже было в последние 5 секунд, оно игнорируется. ### Фильтры входящих Фильтры проверяют номер отправителя. Если фильтров нет, на сервер уходят все входящие SMS. | Тип | Как работает | Пример | |---|---|---| | Точное совпадение | Номер совпадает целиком | +79001234567 | | Начинается с | Номер начинается с указанной строки | +7900 | | Заканчивается на | Номер заканчивается указанной строкой | 4567 | | Содержит | Номер содержит подстроку | 123 | ## Две SIM-карты Если в телефоне две SIM-карты, приложение выбирает слот для отправки в таком порядке: | Приоритет | Источник | |---|---| | 1 | Задание с сервера, если в нём указан SIM-слот | | 2 | SIM, выбранная в настройках приложения | | 3 | SIM по умолчанию в Android | Выбрать SIM в приложении: раздел «SIM-карта». Закрепить конкретную SIM за каналом: в настройках SMS-канала в кабинете, см. [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms). О каждой SIM приложение передаёт на сервер оператора (МТС, Билайн, Мегафон), страну (RU, BY, KZ), код MCC/MNC (например, 250/01) и слот (SIM 1 или SIM 2). ## История SMS Экран истории в приложении показывает все SMS, прошедшие через шлюз. | Колонка | Содержимое | |---|---| | Тип | Исходящее или входящее | | Номер | Телефон получателя или отправителя | | Текст | Содержание сообщения | | Время | Когда отправлено или получено | | Статус | В очереди, Отправлено, Доставлено, Ошибка | Фильтры: Все, Исходящие, Входящие. Сверху экрана счётчики: Всего, Отправлено, Доставлено, Ошибки, В очереди. > [!NOTE] Записи старше 30 дней удаляются автоматически, чтобы приложение не занимало память. --- --- title: "Надёжность SMS Gateway: батарея, heartbeat, автозапуск, повторы" nav_title: "Надёжность" url: https://docs.tuk-tuk.online/sms-gateway/reliability markdown: https://docs.tuk-tuk.online/sms-gateway/reliability.md section: "SMS Gateway (Android)" description: "Как SMS Gateway работает в фоне круглосуточно: sticky-уведомление, настройки батареи Android, heartbeat каждые 30 минут, push через FCM, автозапуск после перезагрузки, повторы при ошибках." keywords: ["SMS Gateway батарея", "heartbeat", "автозапуск SMS", "push уведомления", "автопереподключение", "фоновая работа Android", "SMS Gateway надёжность", "WorkManager"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Механизмы, которые держат SMS Gateway в работе без присмотра: sticky-уведомление и настройки батареи Android, heartbeat раз в 30 минут, команды через FCM, автозапуск после перезагрузки, повторы при ошибках. > > - Sticky-уведомление включается в настройках приложения и мешает Android выгрузить его; рекомендуется на Xiaomi, Huawei, Samsung. > - На телефоне: отключить оптимизацию батареи (Настройки → Приложения → tuk-tuk → Батарея → «Не ограничивать»), включить автозапуск, закрепить приложение. > - Heartbeat: каждые 30 минут по умолчанию, варианты 15/30/60, минимум 15; передаёт батарею, сеть, память, хранилище, часовой пояс, SIM, push-токен. > - Push (FCM) двух типов: SMS (получатели, текст, SIM-слот) и Heartbeat. Повтор push до 3 раз. > - После перезагрузки BootCompletedReceiver перезапускает heartbeat, отправляет данные и восстанавливает уведомление. > - Загрузка входящего SMS на сервер: до 5 попыток с паузами 10, 20, 40, 80, 160 секунд. > > Связанные страницы: https://docs.tuk-tuk.online/sms-gateway, https://docs.tuk-tuk.online/sms-gateway/features, https://docs.tuk-tuk.online/sms-gateway/monitoring, https://docs.tuk-tuk.online/sms-gateway/setup # Надёжность Шлюз работает круглосуточно без участия человека: держит связь с сервером, переживает перезагрузку телефона и повторяет неудачные операции. Главная угроза: экономия батареи в Android, которая усыпляет фоновые приложения. Ниже описано, как приложение с ней справляется и что настроить на телефоне. ## Фоновая работа ### Sticky-уведомление Постоянное уведомление в шторке Android. Оно: - не даёт системе выгрузить приложение; - показывает, что шлюз работает; - включается и выключается в настройках приложения. > [!TIP] Включите sticky-уведомление. Особенно это важно на Xiaomi, Huawei и Samsung: их прошивки закрывают фоновые приложения чаще других. ### Настройки батареи на телефоне | Действие | Где | |---|---| | Отключить оптимизацию батареи | Настройки → Приложения → tuk-tuk → Батарея → «Не ограничивать» | | Включить автозапуск | Настройки → Приложения → tuk-tuk → Автозапуск | | Закрепить приложение | В списке последних приложений нажать значок замка на tuk-tuk | > [!WARNING] У Xiaomi, Huawei, Samsung и OPPO эти пункты лежат в разных местах. Общее правило: найти tuk-tuk в настройках и снять все ограничения. ## Heartbeat Heartbeat: регулярный сигнал от телефона серверу «я работаю, вот моё состояние». Если сигналы перестали приходить, устройство считается офлайн. ### Как работает 1. Каждые 30 минут (настраивается, минимум 15) приложение просыпается. 2. Собирает данные о состоянии телефона. 3. Отправляет их на сервер. 4. Сервер обновляет карточку устройства в кабинете. ### Что передаётся | Данные | Пример | |---|---| | Уровень батареи | 78% | | Тип сети | Wi-Fi, LTE, 3G | | Свободная память | 2.1 ГБ из 6 ГБ | | Свободное хранилище | 15 ГБ из 64 ГБ | | Часовой пояс | UTC+3 | | SIM-карты | Оператор, страна, слот | | Push-токен | Актуальный токен для FCM | ### Интервал | Интервал | Когда выбирать | |---|---| | 15 минут | Максимальный контроль, чуть выше расход батареи | | 30 минут | По умолчанию | | 60 минут | Экономия батареи, статус обновляется реже | Сервер может запросить heartbeat вне расписания через push, когда нужно актуальное состояние устройства прямо сейчас. ## Push-уведомления (FCM) Команды приходят на телефон через Firebase Cloud Messaging. | Тип | Что делает | |---|---| | SMS | Отправить SMS: получатели, текст, SIM-слот | | Heartbeat | Отправить состояние устройства сейчас | Push доставляется сразу, даже когда приложение спит: Android будит его для обработки. Если push не дошёл, сервер повторяет отправку до 3 раз. ## Автозапуск после перезагрузки После перезагрузки (обновление, разряд, сбой) приложение восстанавливает работу само, открывать его не нужно. | Действие при загрузке | Описание | |---|---| | Heartbeat | Перезапускает расписание | | Обновление данных | Отправляет актуальное состояние телефона | | Уведомление | Восстанавливает sticky-уведомление, если оно было включено | Технически: приложение регистрирует BootCompletedReceiver, Android вызывает его при загрузке, и фоновые задачи запускаются заново. ## Повторы при ошибках | Операция | Правило | |---|---| | Push с командой на SMS | Сервер повторяет до 3 раз | | Загрузка входящего SMS на сервер | До 5 попыток с паузами 10, 20, 40, 80 и 160 секунд, только при наличии интернета | | Heartbeat | Следующая попытка по расписанию, минимальный интервал 15 минут | Если устройство всё же ушло в офлайн, см. [Мониторинг: частые проблемы](https://docs.tuk-tuk.online/sms-gateway/monitoring). --- --- title: "Мониторинг SMS Gateway: статистика, лимиты, вебхуки, неполадки" nav_title: "Мониторинг" url: https://docs.tuk-tuk.online/sms-gateway/monitoring markdown: https://docs.tuk-tuk.online/sms-gateway/monitoring.md section: "SMS Gateway (Android)" description: "Данные устройства и статистика доставки SMS в кабинете, лимиты отправки и фильтры по странам и номерам, события для Event Webhooks, что проверять при неполадках." keywords: ["SMS Gateway мониторинг", "статистика SMS", "лимиты SMS", "SMS ограничения", "SMS диагностика", "SMS устранение неполадок", "SMS Gateway статус", "SMS Gateway настройки"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Что кабинет tuk-tuk.online показывает о привязанном Android-устройстве и SMS-канале, какие лимиты отправки можно задать, какие события уходят в вебхуки и что проверять при сбоях шлюза. > > - Данные устройства (модель, Android, версия приложения, батарея, сеть, память, SIM, последний heartbeat, счётчики SMS): раздел «SMS» (https://lk.tuk-tuk.online/sms). > - Статистика канала: процент доставки, среднее время доставки, разбивка по дням. > - Лимиты на устройство: в день, в месяц, на получателя за период, длина текста (пример 480 символов); разрешённые страны по префиксу и заблокированные номера. Настройка: «SMS» → устройство → «Настройки». > - События вебхуков: SMS_DEVICE_CONNECTED, SMS_DEVICE_DISCONNECTED, SMS_STATUS_CHANGED, SMS_SENT. > - Офлайн: проверить интернет, запуск приложения, заряд, sticky-уведомление, оптимизацию батареи. QR-код живёт 10 минут. > > Связанные страницы: https://docs.tuk-tuk.online/sms-gateway, https://docs.tuk-tuk.online/sms-gateway/reliability, https://docs.tuk-tuk.online/sms-gateway/features, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/channels/sms # Мониторинг и настройки Состояние телефона, статистика доставки и ограничения на отправку видны в кабинете, история сообщений: в приложении. Здесь же собрано, что проверять, когда шлюз не работает. ## Данные устройства В разделе [SMS](https://lk.tuk-tuk.online/sms) для каждого привязанного устройства: | Поле | Что показывает | |---|---| | Модель | Производитель и модель телефона | | Версия Android | Например, Android 14 | | Версия приложения | Текущая версия SMS Gateway | | Батарея | Уровень заряда | | Сеть | Wi-Fi или мобильные данные | | Память | Свободная оперативная память | | Хранилище | Свободное место | | SIM-карты | Оператор, страна, слот | | Последний heartbeat | Когда устройство отчиталось в последний раз | | Отправлено SMS | Счётчик исходящих | | Получено SMS | Счётчик входящих | Как обновляются эти данные: [Надёжность: heartbeat](https://docs.tuk-tuk.online/sms-gateway/reliability). ## Статистика доставки Для каждого SMS-канала: | Метрика | Значение | |---|---| | Процент доставки | Доля доставленных SMS от отправленных | | Среднее время доставки | От отправки до подтверждения оператором | | Разбивка по дням | График отправленных SMS за период | ## Ограничения на отправку Ограничения задаются на устройство и защищают от случайной массовой рассылки. Они проверяются перед каждой отправкой: если лимит исчерпан, SMS не уйдёт, а в логах появится ошибка. ### Лимиты | Ограничение | Что задаёт | Пример | |---|---|---| | Дневной лимит | Максимум SMS в сутки | 100 | | Месячный лимит | Максимум SMS в месяц | 2 000 | | Лимит на получателя | Максимум SMS одному номеру за период | 3 за 60 минут | | Длина сообщения | Максимум символов в тексте | 480 | ### Страны и номера | Ограничение | Что задаёт | Пример | |---|---|---| | Разрешённые страны | Отправка только на номера с указанными префиксами | +7 (Россия), +375 (Беларусь) | | Заблокированные номера | На эти номера SMS не отправляются никогда | +79001234567 | ### Настроить 1. Откройте [SMS](https://lk.tuk-tuk.online/sms) в кабинете. 2. Выберите устройство. 3. Нажмите «Настройки». 4. Задайте ограничения. 5. Нажмите «Сохранить». ## События для вебхуков Шлюз генерирует события, которые можно получать через [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks): | Событие | Когда | |---|---| | `SMS_DEVICE_CONNECTED` | Устройство привязано к аккаунту | | `SMS_DEVICE_DISCONNECTED` | Устройство отвязано или потерян push-токен | | `SMS_STATUS_CHANGED` | Статус SMS изменился, например с «отправлено» на «доставлено» | | `SMS_SENT` | Новое SMS поставлено в очередь на отправку | ## Частые проблемы ### Устройство офлайн Проверьте по порядку: - интернет на телефоне включён и работает; - приложение tuk-tuk запущено; - телефон заряжен; - sticky-уведомление включено в настройках приложения; - приложение исключено из оптимизации батареи, см. [Надёжность](https://docs.tuk-tuk.online/sms-gateway/reliability). ### SMS не отправляются - на SIM-карте есть средства на SMS; - дневной и месячный лимиты не исчерпаны; - номер получателя входит в разрешённые страны; - номер не в списке заблокированных; - оператор не ограничивает массовую отправку SMS. ### Входящие не приходят - переключатель «Приём SMS» в приложении включён; - приложению разрешено читать и получать SMS; - фильтры входящих не отсекают нужный номер, см. [Возможности: фильтры](https://docs.tuk-tuk.online/sms-gateway/features). ### QR-код не сканируется - код действует 10 минут, обновите страницу в кабинете; - приложению разрешён доступ к камере; - на экран падает достаточно света. ## Обновление приложения Приложение само проверяет наличие новой версии и предлагает обновиться. --- --- title: "Приложение tuk-tuk.online (PWA): установка, офлайн, push" nav_title: "Приложение и офлайн" url: https://docs.tuk-tuk.online/pwa markdown: https://docs.tuk-tuk.online/pwa.md description: "Кабинет tuk-tuk.online работает как Progressive Web App: установка на компьютер и телефон без магазина, push-уведомления, работа без интернета, кеш данных и очередь действий." keywords: ["PWA", "Progressive Web App", "офлайн режим", "установка приложения", "push уведомления", "работа без интернета", "кеширование", "мгновенный интерфейс", "оптимистичные ответы"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Кабинет tuk-tuk.online является Progressive Web App: устанавливается из браузера на компьютер, Android и iPhone, присылает push-уведомления, открывается и работает без интернета за счёт Service Worker, кеша данных и очереди действий. > > - Установка: открыть https://lk.tuk-tuk.online и нажать «Установить» в браузере; магазин приложений не нужен. > - Кеш данных на устройстве: до 25 МБ (IndexedDB). Действия без сети копятся в очереди и уходят на сервер после восстановления связи. > - Push-уведомления о новых сообщениях работают в Chrome, Edge, Firefox, на Android и в Safari (iOS 16.4+ только после установки на экран Домой). > - Файлы интерфейса кешируются Service Worker, обновления применяются в фоне при следующем открытии. > > Связанные страницы: https://docs.tuk-tuk.online/pwa/install, https://docs.tuk-tuk.online/pwa/offline, https://docs.tuk-tuk.online/pwa/push, https://docs.tuk-tuk.online/pwa/caching, https://docs.tuk-tuk.online/dialogs/notifications # Приложение и офлайн Кабинет tuk-tuk.online: Progressive Web App. Его можно поставить на компьютер и телефон как обычное приложение, минуя магазин: иконка на рабочем столе, отдельное окно, push-уведомления, работа без интернета. Скачивать ничего не нужно: открываете [https://lk.tuk-tuk.online](https://lk.tuk-tuk.online), нажимаете «Установить». ## Что даёт PWA ![Диалоги на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/dialogs.webp "Список диалогов на экране 390 px.") ![Переписка на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/dialog-open.webp "Открытый диалог: переписка и панель ответа.") | Возможность | Обычный сайт | tuk-tuk как PWA | |---|---|---| | Иконка на рабочем столе | Нет | Да | | Push-уведомления | Нет | Да | | Работа без интернета | Нет | Да | | Загрузка интерфейса | С сервера при каждом открытии | Из кеша, сразу | | Обновление | Не применимо | Автоматически, в фоне | | Установка из магазина | Не применимо | Не нужна | ## Как это устроено ![Задачи на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/tasks.webp "Доска задач на экране 390 px.") ![Календарь на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/calendar.webp "Календарь и запись на телефоне.") ![Каналы связи на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/channels.webp "Подключение каналов работает и с телефона.") ```text ┌──────────────────────────────────────────────────┐ │ Ваш браузер / PWA │ │ │ │ ┌──────────┐ ┌───────────┐ ┌──────────────┐ │ │ │ Интерфейс│ │ Кеш данных│ │ Очередь │ │ │ │ (React) │ │ (25 МБ) │ │ офлайн- │ │ │ │ │ │ │ │ действий │ │ │ └────┬─────┘ └─────┬─────┘ └──────┬───────┘ │ │ │ │ │ │ │ ┌────┴──────────────┴───────────────┴────────┐ │ │ │ Service Worker (фоновый скрипт) │ │ │ └─────────────────────┬──────────────────────┘ │ └────────────────────────┼─────────────────────────┘ │ Интернет (когда есть) │ ┌──────┴──────┐ │ Сервер │ │ tuk-tuk.online│ └─────────────┘ ``` | Компонент | Роль | |---|---| | Интерфейс | То, что вы видите на экране | | Кеш данных | Копия данных на устройстве (диалоги, контакты и другое), до 25 МБ | | Очередь действий | Действия, сделанные без интернета, ждут отправки на сервер | | Service Worker | Фоновый скрипт браузера, управляет кешем и очередью | ## Разделы | Страница | О чём | |---|---| | [Установка](https://docs.tuk-tuk.online/pwa/install) | Как поставить на компьютер, Android и iPhone, как удалить | | [Офлайн-режим](https://docs.tuk-tuk.online/pwa/offline) | Кеш данных, очередь действий, оптимистичные ответы | | [Push-уведомления](https://docs.tuk-tuk.online/pwa/push) | Как включить, что приходит, совместимость | | [Скорость и кеш](https://docs.tuk-tuk.online/pwa/caching) | Стратегии кеширования, обновление, очистка | --- --- title: "Установка tuk-tuk.online как приложения на ПК, Android и iPhone" nav_title: "Установка" url: https://docs.tuk-tuk.online/pwa/install markdown: https://docs.tuk-tuk.online/pwa/install.md section: "Приложение и офлайн" description: "Как установить кабинет tuk-tuk.online как приложение из Chrome, Edge и Safari без магазина: шаги для компьютера, Android и iPhone, проверка и удаление." keywords: ["установка PWA", "добавить на рабочий стол", "PWA install", "установить приложение", "веб-приложение на телефон", "PWA Android", "PWA iPhone"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Инструкция по установке кабинета tuk-tuk.online как PWA на компьютер (Chrome, Edge), Android (Chrome) и iPhone/iPad (Safari), с проверкой результата и удалением. > > - Адрес для установки: https://lk.tuk-tuk.online. > - Компьютер: иконка установки в адресной строке Chrome или Edge, либо меню браузера → «Установить приложение». > - Android: Chrome → меню → «Установить приложение»; на страницах входа и регистрации может быть кнопка «Установить приложение». > - iPhone и iPad: только Safari → «Поделиться» → «На экран Домой» → «Добавить». Другие браузеры iOS PWA не ставят. > - Признаки установки: отдельное окно без адресной строки, иконка, приложение в переключателе задач. > > Связанные страницы: https://docs.tuk-tuk.online/pwa, https://docs.tuk-tuk.online/pwa/offline, https://docs.tuk-tuk.online/pwa/push, https://docs.tuk-tuk.online/pwa/caching # Установка приложения Кабинет ставится на компьютер, Android и iPhone прямо из браузера. Установка даёт отдельное окно без адресной строки, иконку для быстрого запуска и push-уведомления при закрытом браузере. ## Что даёт установка ![Кабинет на телефоне](https://docs.tuk-tuk.online/assets/screens/mobile/home.webp "Кабинет полностью работает на телефоне: тот же дашборд, диалоги и задачи.") | Преимущество | Описание | |---|---| | Отдельное окно | Без адресной строки и вкладок, как обычная программа | | Push-уведомления | Приходят даже при закрытом браузере | | Быстрый запуск | Иконка на рабочем столе, один клик | | Офлайн-доступ | Интерфейс открывается без интернета | | Автообновление | В фоне, без переустановки | ## Компьютер: Chrome или Edge 1. Откройте [https://lk.tuk-tuk.online](https://lk.tuk-tuk.online). 2. Нажмите иконку установки в правой части адресной строки. 3. Подтвердите установку. Результат: на рабочем столе появилась иконка tuk-tuk, приложение открылось в отдельном окне. > [!TIP] Иконки в адресной строке нет: откройте меню браузера (три точки) и выберите «Установить приложение» или «Добавить на рабочий стол». ## Android: Chrome 1. Откройте [https://lk.tuk-tuk.online](https://lk.tuk-tuk.online) в Chrome. 2. Откройте меню (три точки) и нажмите «Установить приложение». 3. Подтвердите. Результат: иконка на главном экране. На странице входа и регистрации может появиться кнопка «Установить приложение»: она запускает ту же установку. ## iPhone и iPad: Safari На iOS установка называется «На экран Домой». 1. Откройте [https://lk.tuk-tuk.online](https://lk.tuk-tuk.online) в Safari. 2. Нажмите «Поделиться» внизу экрана. 3. Прокрутите список и нажмите «На экран Домой». 4. Нажмите «Добавить». Результат: иконка tuk-tuk на экране Домой. > [!WARNING] На iOS установка работает только из Safari. Chrome и другие браузеры на iPhone PWA не устанавливают. ## Проверить, что установлено - Открывается в отдельном окне без адресной строки. - Есть иконка на рабочем столе или в доке. - Появляется в списке приложений системы и в переключателе задач (Alt+Tab, свайп). ## Удалить | Платформа | Как | |---|---| | Windows | Параметры → Приложения → tuk-tuk → Удалить | | macOS | Finder → Программы → Chrome Apps → tuk-tuk → удалить | | Android | Долгое нажатие на иконку → Удалить | | iOS | Долгое нажатие на иконку → Удалить приложение | Что происходит после установки без интернета: [Офлайн-режим](https://docs.tuk-tuk.online/pwa/offline). Уведомления: [Push-уведомления](https://docs.tuk-tuk.online/pwa/push). --- --- title: "Офлайн-режим tuk-tuk.online: кеш данных и очередь действий" nav_title: "Офлайн-режим" url: https://docs.tuk-tuk.online/pwa/offline markdown: https://docs.tuk-tuk.online/pwa/offline.md section: "Приложение и офлайн" description: "Как кабинет tuk-tuk.online работает без интернета: кеш данных 25 МБ в IndexedDB, очередь действий с отправкой после восстановления сети, оптимистичные ответы интерфейса, индикатор соединения." keywords: ["офлайн режим", "работа без интернета", "кеш данных", "очередь мутаций", "оптимистичные ответы", "IndexedDB", "синхронизация данных", "offline mode"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Офлайн-режим кабинета tuk-tuk.online: данные хранятся в IndexedDB (до 25 МБ), действия без сети копятся в очереди и отправляются после восстановления связи, интерфейс обновляется оптимистично, внизу экрана показывается индикатор соединения. > > - Кеш данных: IndexedDB, до 25 МБ, сохранение каждые 500 мс после изменений, восстановление при открытии. > - При открытии сначала показываются сохранённые данные, затем в фоне подтягиваются свежие. > - Очередь действий без ограничения объёма; хранит запрос, данные и время; после восстановления сети действия уходят на сервер по одному, затем очередь очищается. > - Оптимистичные ответы: статус задачи, теги, заметки, перемещение по канбану. > - Сеть считается недоступной по событиям браузера или после 2 и более неудачных запросов подряд; статус-бар «Нет соединения» с кнопкой «Повторить» исчезает через 3 секунды после восстановления. > > Связанные страницы: https://docs.tuk-tuk.online/pwa, https://docs.tuk-tuk.online/pwa/caching, https://docs.tuk-tuk.online/pwa/install, https://docs.tuk-tuk.online/tasks/kanban # Офлайн-режим Без интернета кабинет продолжает показывать данные и принимать действия. Всё сделанное офлайн встаёт в очередь и уходит на сервер, как только связь вернётся. Три механизма: кеш данных на устройстве, очередь действий и оптимистичные ответы интерфейса. ## Из чего состоит | Компонент | Роль | Объём | |---|---|---| | Кеш данных | Копия ваших данных на устройстве | До 25 МБ | | Очередь действий | Действия, сделанные без сети | Без ограничений | | Оптимистичные ответы | Интерфейс обновляется сразу, не дожидаясь сервера | Не применимо | ## Кеш данных Загруженные данные сохраняются на устройстве: список диалогов и контактов, последние сообщения, настройки каналов, задачи, записи календаря и другое. | Параметр | Значение | |---|---| | Хранилище | IndexedDB, встроенная база данных браузера | | Максимальный размер | 25 МБ | | Частота сохранения | Каждые 500 мс после изменений | | Восстановление | Автоматически при открытии приложения | Данные в IndexedDB переживают закрытие вкладки и перезагрузку компьютера. ### При открытии приложения 1. Приложение проверяет, есть ли сохранённые данные. 2. Если есть, показывает их сразу, не дожидаясь сервера. 3. В фоне запрашивает свежие данные. 4. Обновляет экран, если что-то изменилось. Поэтому кабинет открывается быстро даже на медленном интернете. ## Очередь действий Действие без интернета (сменить статус задачи, отправить сообщение) не теряется: оно сохраняется в очередь и ждёт сети. ```text Вы нажали «Выполнить задачу» (без интернета) │ ▼ Приложение проверяет: есть интернет? │ Нет │ ▼ Действие → сохраняется в IndexedDB Интерфейс → обновляется сразу (оптимистичный ответ) │ ... время проходит ... │ Интернет появился │ ▼ Очередь → отправляет все действия на сервер Данные → обновляются с сервера ``` Для каждого отложенного действия хранятся: | Поле | Содержимое | |---|---| | Запрос | Какое действие: создать задачу, изменить статус и так далее | | Данные | Параметры: текст, ID, новые значения | | Время | Когда действие совершено | ### Когда сеть вернулась 1. Браузер сообщает приложению о восстановлении сети. 2. Приложение читает очередь из IndexedDB. 3. Действия отправляются на сервер по одному, в порядке очереди. 4. Активные данные обновляются с сервера. 5. Очередь очищается. ## Оптимистичные ответы Интерфейс показывает результат действия сразу, а запрос уходит на сервер в фоне. Без них: нажали «Задача выполнена», подождали 0.5–2 секунды, экран обновился. С ними: нажали, экран обновился мгновенно, запрос ушёл в фоне. Если сервер вернул другой результат, экран обновится ещё раз. Где используются: - смена статуса задачи; - добавление и удаление тегов; - редактирование заметок; - перемещение задач на канбан-доске; - другие быстрые действия. ## Как приложение понимает, что сети нет | Способ | Как работает | |---|---| | События браузера | Браузер сообщает о потере и восстановлении сети | | Подсчёт ошибок | 2 и более запросов подряд не прошли: сеть считается недоступной | ### Индикатор Когда интернет пропал, внизу экрана появляется статус-бар «Нет соединения» с кнопкой «Повторить». После восстановления сети бар исчезает через 3 секунды. Как кешируются файлы интерфейса: [Скорость и кеш](https://docs.tuk-tuk.online/pwa/caching). --- --- title: "Push-уведомления tuk-tuk.online о новых сообщениях клиентов" nav_title: "Push-уведомления" url: https://docs.tuk-tuk.online/pwa/push markdown: https://docs.tuk-tuk.online/pwa/push.md section: "Приложение и офлайн" description: "Push-уведомления кабинета tuk-tuk.online через Web Push: как включить в браузере, что приходит, куда ведёт клик, тихие часы, шифрование VAPID, поддержка в Chrome, Firefox, Edge и Safari." keywords: ["push уведомления", "Web Push", "уведомления о сообщениях", "push notifications", "оповещения в браузере", "VAPID", "Service Worker push"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Push-уведомления кабинета tuk-tuk.online о новых сообщениях клиентов: доставка через Web Push с VAPID-подписью и шифрованием, включение в браузере, переход в диалог по клику, тихие часы, ограничения на iOS. > > - Включение: открыть https://lk.tuk-tuk.online и нажать «Разрешить» в запросе браузера; если заблокировали, разрешить через замок в адресной строке. > - Уведомление содержит имя отправителя или канал, первые строки сообщения, логотип, ссылку на диалог; клик активирует открытую вкладку или открывает новое окно. > - Защита: VAPID-ключи, шифрование содержимого, подписка привязана к аккаунту и устройству. > - Тихие часы задаются в настройках профиля: время начала и окончания, дни. > - Поддержка: Chrome, Edge, Firefox на ПК, Chrome на Android, Safari на macOS Ventura+; на iOS 16.4+ только после установки PWA из Safari. > > Связанные страницы: https://docs.tuk-tuk.online/pwa, https://docs.tuk-tuk.online/pwa/install, https://docs.tuk-tuk.online/dialogs/notifications, https://docs.tuk-tuk.online/users/team # Push-уведомления Всплывающие уведомления о новых сообщениях клиентов приходят на компьютер и телефон, даже когда кабинет закрыт. Работают через Web Push, встроенный в браузер; устанавливать ничего не нужно. ## Как это работает 1. Клиент пишет в любой канал: Telegram, SMS, виджет и другие. 2. Сервер получает сообщение и формирует уведомление. 3. Уведомление уходит через Web Push API в ваш браузер. 4. На экране появляется всплывающее окно с текстом. ## Как включить 1. Откройте [https://lk.tuk-tuk.online](https://lk.tuk-tuk.online). 2. В запросе браузера «Разрешить уведомления?» нажмите «Разрешить». Результат: следующее сообщение клиента придёт уведомлением. ### Если нажали «Заблокировать» | Браузер | Как разрешить | |---|---| | Chrome | Замок слева от адреса → Уведомления → Разрешить | | Firefox | Замок → Разрешения → Уведомления → Разрешить | | Safari | Настройки Safari → Сайты → Уведомления → tuk-tuk.online → Разрешить | | Edge | Замок → Разрешения сайта → Уведомления → Разрешить | ## Что в уведомлении | Элемент | Содержимое | |---|---| | Заголовок | Имя отправителя или название канала | | Текст | Первые строки сообщения | | Иконка | Логотип tuk-tuk | | Ссылка | По клику открывается нужный диалог | Клик по уведомлению: если кабинет уже открыт во вкладке, она активируется и переходит в диалог. Если закрыт, открывается новое окно. Лишние вкладки не плодятся. ## Безопасность | Технология | Назначение | |---|---| | VAPID | Пара ключей (публичный и приватный) подтверждает, что уведомление отправил сервер tuk-tuk.online | | Шифрование | Содержимое зашифровано от сервера до устройства | | Авторизация | Подписка привязана к вашему аккаунту и устройству | Отправить вам уведомление может только сервер tuk-tuk.online, прочитать его по пути нельзя. ## Управление ### Отключить - В операционной системе, через настройки уведомлений: самый надёжный способ. - В браузере: замок рядом с адресом, выключить уведомления для сайта. ### Тихие часы Чтобы не получать уведомления ночью: 1. Откройте настройки профиля. 2. Задайте время начала (например, 22:00) и окончания (08:00). 3. Выберите дни: все или только рабочие. Подробнее: [Команда: тихие часы](https://docs.tuk-tuk.online/users/team). Уведомления внутри кабинета: [Диалоги: уведомления](https://docs.tuk-tuk.online/dialogs/notifications). ## Совместимость | Платформа | Поддержка | |---|---| | Chrome, Edge, Firefox на ПК | Полная | | Chrome на Android | Полная | | Safari на iOS 16.4 и новее | После установки PWA на экран Домой | | Safari на macOS Ventura и новее | Полная | > [!WARNING] На iPhone push работает только после [установки PWA](https://docs.tuk-tuk.online/pwa/install) через Safari. В обычной вкладке браузера уведомления не приходят. --- --- title: "Скорость и кеш tuk-tuk.online: стратегии Service Worker" nav_title: "Скорость и кеш" url: https://docs.tuk-tuk.online/pwa/caching markdown: https://docs.tuk-tuk.online/pwa/caching.md section: "Приложение и офлайн" description: "Как кабинет tuk-tuk.online кеширует файлы интерфейса, данные и медиа: предзагрузка через Service Worker, стратегии «сеть в приоритете» и «кеш в приоритете», сроки хранения, обновление и очистка." keywords: ["кеширование PWA", "скорость загрузки", "Service Worker кеш", "Workbox стратегии", "предзагрузка", "CacheFirst", "NetworkFirst", "быстрая загрузка"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Кеширование в кабинете tuk-tuk.online: Service Worker предзагружает файлы интерфейса, для API используется стратегия «сеть в приоритете» с таймаутом 3 секунды, для шрифтов, файлов, изображений и медиа «кеш в приоритете»; обновления применяются в фоне. > > - Два уровня: файлы приложения (Service Worker и Cache API) и данные (Apollo Cache и IndexedDB). > - GraphQL и REST API: сеть в приоритете, таймаут 3 с, срок 7 дней, до 200 записей. > - Шрифты: кеш в приоритете, 1 год, 20 записей. Файлы и изображения: 90 дней, 500 записей. Медиа: 30 дней, 100 записей. > - Обновление: новые файлы скачиваются в фоне, применяются при следующем открытии, старые кеши удаляются. > - Ручная очистка: Chrome F12 → Application → Storage → Clear site data; Firefox F12 → Хранилище → Очистить; Safari → Конфиденциальность → Управление данными сайтов. > > Связанные страницы: https://docs.tuk-tuk.online/pwa, https://docs.tuk-tuk.online/pwa/offline, https://docs.tuk-tuk.online/pwa/install, https://docs.tuk-tuk.online/files # Скорость и кеш Кабинет держит файлы интерфейса, данные и медиа на вашем устройстве и не скачивает их заново при каждом открытии. Отсюда быстрая загрузка и работа офлайн. Два независимых уровня: кеш файлов приложения (Service Worker) и кеш данных (Apollo Cache в IndexedDB). ## Два уровня кеша | Уровень | Что хранит | Технология | |---|---|---| | Файлы приложения | HTML, CSS, JavaScript, иконки, шрифты | Service Worker и Cache API | | Данные | Диалоги, контакты, задачи, настройки | Apollo Cache и IndexedDB | Файлы приложения кешируются один раз при первой загрузке, данные обновляются при каждом запросе. Кеш данных описан в [Офлайн-режиме](https://docs.tuk-tuk.online/pwa/offline). ## Предзагрузка При первом посещении Service Worker скачивает и сохраняет основные файлы приложения. Дальше: - интерфейс грузится из кеша, а не с сервера; - при недоступном сервере интерфейс всё равно открывается; - обновления скачиваются в фоне и применяются при следующем открытии. ## Стратегии кеширования | Стратегия | Как работает | Для чего | |---|---|---| | Сеть в приоритете | Запрос к серверу; если ответа нет за 3 секунды, ответ берётся из кеша | Данные, которые должны быть свежими | | Кеш в приоритете | Сначала кеш; если записи нет, запрос к серверу | Файлы, которые редко меняются | | Ресурс | Стратегия | Срок хранения | Лимит записей | |---|---|---|---| | Шрифты (Google Fonts) | Кеш в приоритете | 1 год | 20 | | GraphQL API | Сеть в приоритете, таймаут 3 с | 7 дней | 200 | | REST API | Сеть в приоритете, таймаут 3 с | 7 дней | 200 | | Загруженные файлы | Кеш в приоритете | 90 дней | 500 | | Изображения | Кеш в приоритете | 90 дней | 500 | | Медиа (видео, аудио) | Кеш в приоритете | 30 дней | 100 | ## Обновление приложения 1. Service Worker скачивает новые файлы в фоне. 2. При следующем открытии показывается новая версия. 3. Старые кеши удаляются. От пользователя ничего не требуется. ## Очистка кеша Автоматически: - по лимиту записей: при превышении удаляются самые старые; - по сроку: истёкшие записи удаляются при следующем запросе; - при обновлении: кеши предыдущих версий очищаются. ### Вручную Если нужно начать с чистого листа: | Браузер | Как | |---|---| | Chrome | F12 → Application → Storage → Clear site data | | Firefox | F12 → Хранилище → Очистить | | Safari | Настройки → Конфиденциальность → Управление данными сайтов | > [!WARNING] Очистка данных сайта удаляет и IndexedDB, то есть кеш данных и очередь офлайн-действий. Сначала дождитесь синхронизации при подключённой сети. --- --- title: "Файлы и медиа в tuk-tuk.online: загрузка, сниппеты, лимиты" nav_title: "Файлы и медиа" url: https://docs.tuk-tuk.online/files markdown: https://docs.tuk-tuk.online/files.md description: "Файловый менеджер tuk-tuk.online: загрузка через диалог, цепочки и API, сниппеты для AI-инструкций, лимит 50 МБ на файл и квоты хранилища по тарифам." keywords: ["файловый менеджер чат", "загрузка файлов в мессенджер", "медиа сообщения бот", "отправка изображений через бота", "голосовые сообщения", "файлы через API", "документы в чат-боте", "видео в мессенджере", "сниппеты AI"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Хранилище файлов tuk-tuk.online: изображения, документы, голосовые и видео из диалогов, цепочек и API, плюс текстовые сниппеты для AI-инструкций. Лимит 50 МБ на файл, квота хранилища зависит от тарифа. > > - Список файлов: раздел «Файлы» (https://lk.tuk-tuk.online/files). > - Загрузка: кнопка со скрепкой или drag-and-drop в диалоге; блок «Отправка сообщения» в цепочке; POST https://back.tuk-tuk.online/upload с Bearer-токеном и полем file. > - Максимальный размер файла: 50 МБ на всех тарифах. Хранилище: Free 200 МБ, Business 2 ГБ, Corp 10 ГБ. > - При исчерпании квоты загрузка блокируется до удаления файлов или смены тарифа. > - Сниппеты создаются в разделе «AI-обработка» (https://lk.tuk-tuk.online/ai) и вставляются в инструкцию кнопкой «Вставить файл». > - Голосовые в диалоге воспроизводятся плеером и расшифровываются AI. > > Связанные страницы: https://docs.tuk-tuk.online/dialogs/messages, https://docs.tuk-tuk.online/chains/blocks/send-message, https://docs.tuk-tuk.online/ai/instructions, https://docs.tuk-tuk.online/billing, https://docs.tuk-tuk.online/api/rest # Файлы и медиа Все файлы, которые прошли через платформу (вложения из диалогов, медиа из цепочек, загрузки через API), лежат в одном хранилище проекта. Оттуда их можно посмотреть, удалить или переиспользовать. Отдельный тип файла: сниппет, текстовый фрагмент для AI-инструкций. ## Где смотреть файлы ![Раздел «Файлы»](https://docs.tuk-tuk.online/assets/screens/files/list.webp) 1. Синхронизировать файлы из диалогов. 2. Поиск по имени файла. 3. Фильтр и сортировка. Раздел [Файлы](https://lk.tuk-tuk.online/files) в кабинете показывает всё загруженное. | Тип | Форматы | |---|---| | Изображения | JPG, PNG, GIF, WebP | | Документы | PDF, DOC, XLS, TXT и другие | | Голосовые | OGG, MP3, WAV | | Видео | MP4, MOV | ## Как загрузить ### В диалоге Нажмите кнопку со скрепкой в поле ввода или перетащите файл в окно диалога. ### В цепочке В блоке «Отправка сообщения» прикрепите картинку, голосовое, видео, документ или кружок: перетащите файл или выберите его с устройства. См. [блок «Отправка сообщения»](https://docs.tuk-tuk.online/chains/blocks/send-message). ### Через API ```bash curl -X POST https://back.tuk-tuk.online/upload \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "file=@photo.jpg" ``` Об авторизации запросов: [REST API v1](https://docs.tuk-tuk.online/api/rest). ## Сниппеты для AI-инструкций Сниппет: текстовый файл, который вставляется в системный промпт ассистента. В сниппеты удобно выносить то, что повторяется в разных инструкциях: - описание компании и продуктов; - прайс-лист; - ответы на частые вопросы; - правила общения; - офферы и рекламные тексты. 1. Создайте сниппет в разделе [AI-обработка](https://lk.tuk-tuk.online/ai). 2. Откройте инструкцию на редактирование и нажмите «Вставить файл». 3. Выберите сниппет из списка. Результат: текст сниппета попал в системный промпт. Один сниппет можно вставлять в несколько инструкций, а большую инструкцию делить на части. Подробнее: [Инструкции и промпты](https://docs.tuk-tuk.online/ai/instructions). ## Ограничения | Параметр | Free | Business | Corp | |---|---|---|---| | Размер одного файла | 50 МБ | 50 МБ | 50 МБ | | Объём хранилища | 200 МБ | 2 ГБ | 10 ГБ | | Типы файлов | Все | Все | Все | > [!WARNING] При исчерпании квоты загрузка новых файлов блокируется. Удалите ненужные файлы в разделе «Файлы» или перейдите на тариф выше, см. [Тарифы](https://docs.tuk-tuk.online/billing). ## Как медиа выглядит в диалоге | Тип | Отображение | |---|---| | Фото | Превью, по клику открывается в полном размере | | Документ | Иконка типа файла и размер | | Голосовое | Аудиоплеер в чате и расшифровка AI | | Видео | Встроенный плеер | | Стикеры | Из Telegram | Расшифровка голосовых: [Транскрибация](https://docs.tuk-tuk.online/ai/transcription). Типы сообщений: [Диалоги: типы сообщений](https://docs.tuk-tuk.online/dialogs/messages). --- --- title: "Тарифы tuk-tuk.online: Free, Business, Corp и цены за сообщения" nav_title: "Тарифы и оплата" url: https://docs.tuk-tuk.online/billing markdown: https://docs.tuk-tuk.online/billing.md description: "Сравнение тарифов Free, Business (от 2990 ₽/мес) и Corp: лимиты каналов, сообщений и ассистентов, цена сообщений из цепочек и диалогов, скидка 20% за год, баланс." keywords: ["тарифы tuk-tuk.online", "стоимость чат-бота", "бесплатный чат-бот", "цена омниканальной платформы", "Free план", "Business план", "сколько стоит AI-бот", "тарифы мессенджер-платформы", "подписка на чат-бот сервис"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Тарифы tuk-tuk.online (Free, Business, Corp), их лимиты и цены за сообщения, которые списываются с баланса помимо подписки. > > - Free: 2 канала (виджет и Telegram), 100 сообщений в день, 1 AI-ассистент, 1 инструкция, 1 цепочка, 200 МБ файлов. Business и Corp: без ограничений, 2 ГБ и 10 ГБ файлов. > - Сообщение из цепочки: 1 ₽ / 0.5 ₽ / 0.3 ₽ (Free / Business / Corp). Сообщение оператора из диалога: 0.25 ₽ / 0.10 ₽ / 0.05 ₽. > - Входящее сообщение: 0.10 ₽ на всех тарифах, принимается даже при нулевом балансе. > - Годовая оплата: скидка 20%. > - Баланс, пополнение, история и смена тарифа: раздел «Баланс» (https://lk.tuk-tuk.online/balance). > - Отдельно списываются SMS через шлюз и AI-токены ассистентов. > > Связанные страницы: https://docs.tuk-tuk.online/files, https://docs.tuk-tuk.online/faq, https://docs.tuk-tuk.online/getting-started, https://docs.tuk-tuk.online/ai/providers # Тарифы и оплата Три тарифа: Free для старта, Business для команды без лимитов, Corp с персональным менеджером. Помимо подписки с баланса списывается плата за сообщения: цена зависит от тарифа и от того, кто отправил сообщение, оператор или цепочка. ## Тарифы | Возможность | Free | Business | Corp | |---|---|---|---| | Каналы | 2 (виджет и Telegram) | Без ограничений | Без ограничений | | Сообщения | 100 в день | Без ограничений | Без ограничений | | AI-ассистенты | 1 | Без ограничений | Без ограничений | | Инструкции | 1 | Без ограничений | Без ограничений | | Цепочки | 1 | Без ограничений | Без ограничений | | Нейросети | Все | Все | Все | | Хранилище файлов | 200 МБ | 2 ГБ | 10 ГБ | | Поддержка | Документация | Приоритетная | Персональный менеджер | ## Периоды оплаты | Период | Цена | |---|---| | Ежемесячно | Стандартная | | Ежегодно | Скидка 20% | ## Что списывается с баланса | Расход | Free | Business | Corp | |---|---|---|---| | Сообщение из цепочки (автоматическая отправка) | 1 ₽ | 0.5 ₽ | 0.3 ₽ | | Сообщение из диалога (ответ оператора) | 0.25 ₽ | 0.10 ₽ | 0.05 ₽ | | Входящее сообщение из любого канала | 0.10 ₽ | 0.10 ₽ | 0.10 ₽ | Ещё три статьи расходов: - SMS через шлюз; - AI-токены при работе ассистентов; - подписка: месячная или годовая плата за тариф. > [!NOTE] Входящие сообщения принимаются даже при нулевом балансе: клиент не потеряется, но ответить получится после пополнения. ## Баланс ![Страница баланса и тарифа](https://docs.tuk-tuk.online/assets/screens/billing/balance.webp) 1. Пополнение баланса: сумма и оплата картой. 2. Быстрые суммы пополнения. 3. Кнопка «Пополнить». 4. Промокод: пополняет баланс или продлевает подписку. 5. Расходы за 30 дней. Раздел [Баланс](https://lk.tuk-tuk.online/balance) в кабинете: - текущий баланс, обновляется в реальном времени; - пополнение кнопкой «Пополнить»; - история списаний и зачислений; - смена тарифа. Возврат неиспользованных средств: см. [Вопросы и ответы](https://docs.tuk-tuk.online/faq). Квоты на файлы: [Файлы и медиа](https://docs.tuk-tuk.online/files). --- --- title: "Вопросы и ответы по tuk-tuk.online: каналы, AI, оплата, безопасность" nav_title: "Вопросы и ответы" url: https://docs.tuk-tuk.online/faq markdown: https://docs.tuk-tuk.online/faq.md description: "Ответы на частые вопросы: сколько каналов на тарифе, нужен ли свой API-ключ для AI, как пополнить баланс и вернуть деньги, где хранятся данные, как связаться с поддержкой." keywords: ["FAQ tuk-tuk.online", "вопросы о чат-ботах", "помощь настройка бота", "как подключить Telegram бот", "как настроить AI-ассистента", "проблемы с ботом", "тарифы вопросы", "безопасность мессенджеров", "техподдержка чат-платформа"] lang: ru product: tuk-tuk.online app: https://lk.tuk-tuk.online api_base: https://back.tuk-tuk.online --- > [!AI] Кратко > Ответы на частые вопросы о tuk-tuk.online: установка, лимиты каналов по тарифам, поддерживаемые AI-модели и ключи, пополнение баланса и возврат, хранение данных, удаление аккаунта, контакты поддержки. > > - Кабинет работает в браузере (https://lk.tuk-tuk.online), устанавливать ничего не нужно; Android-приложение есть только для SMS-шлюза. > - Free: 2 канала (виджет и Telegram), 1 AI-ассистент, 1 инструкция, 1 цепочка, 100 сообщений в день. Business и Corp: без ограничений. > - AI-модели: OpenAI (GPT-4, GPT-4o, GPT-3.5), Anthropic (Claude 3.5 Sonnet, Claude 3), Google Gemini, Mistral, DeepSeek. API-ключ провайдера свой. > - Пополнение баланса: раздел «Баланс» (https://lk.tuk-tuk.online/balance), кнопка «Пополнить». Возврат неиспользованных средств: 14 дней. > - Удаление аккаунта: через поддержку. Контакты: чат на tuk-tuk.online, support@tuk-tuk.online. > > Связанные страницы: https://docs.tuk-tuk.online/getting-started, https://docs.tuk-tuk.online/billing, https://docs.tuk-tuk.online/channels/telegram-bot, https://docs.tuk-tuk.online/ai/providers, https://docs.tuk-tuk.online/users/roles-permissions # Вопросы и ответы Короткие ответы на вопросы, которые чаще всего приходят в поддержку. Если своего вопроса не нашли, напишите в чат на [tuk-tuk.online](https://tuk-tuk.online) или на support@tuk-tuk.online. ## Общие ### Что такое tuk-tuk.online Платформа, которая собирает мессенджеры, SMS, email и чат-виджет в один интерфейс и добавляет AI-ассистентов с автоматизацией. Подробнее: [Как это устроено](https://docs.tuk-tuk.online/concept). ### Нужно ли что-то устанавливать Нет. Кабинет работает в браузере: [lk.tuk-tuk.online](https://lk.tuk-tuk.online). При желании его можно [установить как приложение](https://docs.tuk-tuk.online/pwa/install) на компьютер или телефон. ### Есть ли мобильная версия Веб-версия адаптирована под телефон. Отдельное Android-приложение есть только для [SMS-шлюза](https://docs.tuk-tuk.online/sms-gateway). ## Каналы ### Сколько каналов можно подключить На Free: 2 (виджет и Telegram). На Business и Corp: без ограничений. См. [Тарифы](https://docs.tuk-tuk.online/billing). ### Можно ли подключить несколько Telegram-ботов Да. Каждый бот: отдельный канал, а число каналов ограничено тарифом. ### Бот не отвечает, что проверить Три вещи: статус канала в разделе [Каналы связи](https://lk.tuk-tuk.online/channels), правильность токена и что бот не подключён одновременно к другому сервису. Подробнее: [Telegram Bot](https://docs.tuk-tuk.online/channels/telegram-bot). ## AI-ассистенты ### Какие модели поддерживаются OpenAI (GPT-4, GPT-4o, GPT-3.5), Anthropic (Claude 3.5 Sonnet, Claude 3), Google Gemini, Mistral, DeepSeek. Список и настройка: [Провайдеры](https://docs.tuk-tuk.online/ai/providers). ### Нужен ли свой API-ключ Да, вы подключаете собственный ключ провайдера. Расход токенов оплачивается провайдеру по его тарифам. ### Может ли AI отвечать на нескольких языках Да, модели работают со множеством языков. Укажите нужные языки в [инструкции ассистента](https://docs.tuk-tuk.online/ai/instructions). ## Оплата ### Есть ли бесплатный тариф Да. Free даёт 2 канала, 1 AI-ассистента, 1 инструкцию, 1 цепочку и 100 сообщений в день. ### Как пополнить баланс Откройте раздел [Баланс](https://lk.tuk-tuk.online/balance) и нажмите «Пополнить». ### Можно ли вернуть деньги Неиспользованные средства возвращаются в течение 14 дней. Напишите в поддержку. ## Безопасность ### Где хранятся данные На защищённых серверах платформы. Передача данных шифруется по HTTPS. ### Кто видит мои диалоги Только вы и пользователи вашего аккаунта. Сотрудники tuk-tuk.online не имеют доступа к содержимому переписок. Права участников команды: [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions). ### Как удалить аккаунт Напишите в поддержку: аккаунт и все его данные будут удалены. ## Поддержка Чат на [tuk-tuk.online](https://tuk-tuk.online) или письмо на support@tuk-tuk.online. ---