# Документация tuk-tuk.online

> tuk-tuk.online: платформа для общения с клиентами в мессенджерах (Telegram, VK, Instagram, Авито, MAX, Email, SMS, чат-виджет) с AI-ассистентами, цепочками автоматизации без кода, CRM-интеграциями и REST API. Кабинет: https://lk.tuk-tuk.online. API: https://back.tuk-tuk.online/api/v1.

Каждая страница документации доступна как чистый Markdown по тому же адресу с суффиксом `.md` (например, https://docs.tuk-tuk.online/api/rest.md). Полный текст всех страниц одним файлом: https://docs.tuk-tuk.online/llms-full.txt.

## Начало

- [Обзор платформы](https://docs.tuk-tuk.online/index.md): Документация платформы tuk-tuk.online: подключение каналов (Telegram, SMS, Email, чат-виджет, amoCRM и другие), AI-ассистенты, цепочки автоматизации, интеграции с CRM, REST API и вебхуки.
- [Как это устроено](https://docs.tuk-tuk.online/concept.md): Обзор архитектуры tuk-tuk.online: каналы принимают сообщения, диалоги хранят переписку с клиентом, действия (AI-ассистенты, цепочки, интеграции) реагируют на сообщения автоматически.
- [Быстрый старт](https://docs.tuk-tuk.online/getting-started.md): Пошаговый сценарий для нового аккаунта tuk-tuk.online: регистрация, Telegram-бот через BotFather, подключение канала, первое сообщение в диалогах, провайдер AI и ассистент, первый автоматический ответ.

## Каналы и общение

- [Каналы связи](https://docs.tuk-tuk.online/channels.md): Раздел «Каналы связи» подключает к tuk-tuk.online 11 источников сообщений: Telegram Bot, Telegram-аккаунт, чат-виджет, SMS-шлюз, Email, VK-сообщество, Instagram DM, Авито, MAX Bot, Webhook и amoCRM. Все сообщения попадают в общий раздел «Диалоги», к каждому каналу подключаются AI-ассистент и цепочки.
  - [Telegram Bot](https://docs.tuk-tuk.online/channels/telegram-bot.md): Канал Telegram Bot принимает сообщения клиентов, написавших боту, в раздел «Диалоги» tuk-tuk.online и отвечает от имени бота. Подходит для поддержки, AI-автоответов и цепочек в Telegram.
  - [Telegram-аккаунт](https://docs.tuk-tuk.online/channels/telegram-account.md): Канал Telegram-аккаунт подключает личный аккаунт Telegram к tuk-tuk.online по MTProto: переписка идёт от вашего имени, можно писать первым и принимать сообщения из групп и каналов.
  - [Чат-виджет для сайта](https://docs.tuk-tuk.online/channels/chat-widget.md): Чат-виджет ставится на сайт одним тегом script и передаёт сообщения посетителей в раздел «Диалоги» tuk-tuk.online. Отвечает оператор или AI-ассистент; есть кнопки быстрых ответов, popup, авто-действия и данные о посетителях.
  - [SMS-шлюз](https://docs.tuk-tuk.online/channels/sms.md): SMS-шлюз отправляет и принимает SMS через Android-телефон с SIM-картой и приложением tuk-tuk. SMS-провайдер не нужен, оплата по тарифу оператора; статусы доставки видны в диалогах.
  - [Email (SMTP/IMAP)](https://docs.tuk-tuk.online/channels/email.md): Email-канал подключает почтовый ящик к tuk-tuk.online по IMAP (приём) и SMTP (отправка): письма становятся диалогами, на них отвечает оператор, AI-ассистент или цепочка. Поддерживаются Gmail, Yandex, Mail.ru и корпоративная почта.
  - [VK-сообщество](https://docs.tuk-tuk.online/channels/vk-community.md): Канал VK Community принимает личные сообщения сообщества ВКонтакте в раздел «Диалоги» tuk-tuk.online и отвечает от имени сообщества. События приходят через Long Poll, ответы подписчикам даёт оператор или AI-ассистент.
  - [Instagram DM](https://docs.tuk-tuk.online/channels/instagram.md): Канал Instagram DM подключает бизнес-аккаунт Instagram к tuk-tuk.online через Facebook Graph API: Direct-сообщения и комментарии приходят в «Диалоги», ответы уходят в Instagram, из платформы публикуются посты и карусели.
  - [amoCRM (Amojo)](https://docs.tuk-tuk.online/channels/amocrm-chat.md): Канал amoCRM Chat синхронизирует текстовые сообщения между чатом сделки в amoCRM и диалогом tuk-tuk.online через Amojo Chat API. Создаётся автоматически вместе с интеграцией amoCRM, вручную не добавляется.
  - [MAX Bot](https://docs.tuk-tuk.online/channels/max-bot.md): Канал MAX Bot подключает бота мессенджера MAX (бывший TamTam) к tuk-tuk.online: сообщения пользователей приходят в «Диалоги», ответы уходят от имени бота, поддерживаются медиа и inline-кнопки.
  - [Авито](https://docs.tuk-tuk.online/channels/avito.md): Канал Авито принимает сообщения покупателей по объявлениям в раздел «Диалоги» tuk-tuk.online и отправляет ответы обратно в чат Авито. Работает через REST API Авито с OAuth2 и polling каждые 5 секунд.
  - [Webhook-канал](https://docs.tuk-tuk.online/channels/webhook.md): Webhook-канал принимает заявки по HTTP от форм, конструкторов сайтов и любых сервисов: каждая заявка становится диалогом с карточкой клиента и запускает назначенную цепочку. Канал односторонний, ответить через него нельзя.
- [Диалоги](https://docs.tuk-tuk.online/dialogs.md): Раздел «Диалоги» объединяет переписки из всех подключённых каналов в один список с чатом и карточкой клиента. Это точка входа к статусам, фильтрам, шаблонам, заметкам, приоритетам, импорту и экспорту.
  - [Интерфейс](https://docs.tuk-tuk.online/dialogs/interface.md): Экран диалогов состоит из трёх областей: список диалогов с поиском и фильтрами слева, переписка с панелью ввода по центру, панель клиента с настраиваемыми блоками справа.
  - [Панель клиента](https://docs.tuk-tuk.online/dialogs/info-panel.md): Правая панель диалога показывает данные клиента в 17 блоках: телефон, email, источник, идентификаторы каналов, приоритет, AI-ассистент, риск потери, AI-анализ, теги, связки, запрет запуска связок, кастомные поля. Порядок и видимость блоков настраиваются и хранятся в localStorage.
  - [Статусы и канбан](https://docs.tuk-tuk.online/dialogs/statuses.md): Диалог проходит четыре статуса: «Новый», «В работе», «Ожидание клиента», «Закрыт». Статус меняется в шапке чата, перетаскиванием на канбан-доске или автоматически, включая автозакрытие по таймеру.
  - [Поиск и фильтры](https://docs.tuk-tuk.online/dialogs/search-and-filters.md): Поиск в левой панели раздела «Диалоги» ищет по имени, идентификатору, телефону, email и тексту последнего сообщения. 12 фильтров под строкой поиска сочетаются по логике «И».
  - [Быстрые ответы](https://docs.tuk-tuk.online/dialogs/templates.md): Шаблоны быстрых ответов: заготовленные тексты с переменными {{name}}, {{phone}}, {{email}}, {{custom_field_XXX}}, которые вставляются в поле ввода из панели сообщения. Хранятся в localStorage браузера, не синхронизируются между устройствами.
  - [Заметки](https://docs.tuk-tuk.online/dialogs/notes.md): Заметки: внутренние записи в ленте диалога, видимые только команде и не отправляемые клиенту. Можно задать срок действия, после которого заметка удаляется сама.
  - [Импорт и экспорт](https://docs.tuk-tuk.online/dialogs/import-export.md): Импорт создаёт диалоги из CSV-файла со списком клиентов, экспорт выгружает историю переписок в CSV по фильтрам и выполняется в фоне. Отдельная кнопка удаляет диалоги с пометкой «Тестовый».
  - [Уведомления](https://docs.tuk-tuk.online/dialogs/notifications.md): Уведомления о новых, пропущенных и системных событиях приходят через push (Web Push), email и звук во вкладке. Каждый тип включается отдельно в настройках, а непрочитанные считаются в заголовке вкладки, левой панели и на карточке диалога.
  - [Приоритеты](https://docs.tuk-tuk.online/dialogs/priorities.md): Приоритет клиента вычисляется автоматически по правилам «условие + вес»: правила проверяются от большего веса к меньшему, первое сработавшее задаёт бейдж. По умолчанию четыре правила: VIP, Горячий, Без ответа, Холодный.
  - [Типы сообщений](https://docs.tuk-tuk.online/dialogs/messages.md): Сообщения в диалоге делятся на входящие (INBOUND), исходящие (OUTBOUND), системные (SYSTEM) и заметки (NOTE). Поддерживаются фото, документы, голосовые с AI-расшифровкой, видео и стикеры Telegram; у исходящих три статуса доставки.
  - [События и комментарии](https://docs.tuk-tuk.online/dialogs/calendar-events.md): Блок календаря в карточке диалога создаёт и редактирует события, добавляет к ним внутренние комментарии для команды и ведёт к связанному событию в Google Calendar.
  - [Дубли и идентификаторы](https://docs.tuk-tuk.online/dialogs/duplicates.md): Платформа хранит идентификатор клиента из каждого канала (Telegram Chat ID, VK Peer ID, Avito Chat ID, MAX Chat ID, AmoCRM Contact ID, email, телефон, Visitor ID) и по ним кладёт входящее в существующий диалог. Блок «Дубли» в панели клиента находит повторные диалоги и объединяет их с переносом всей истории.
- [Задачи](https://docs.tuk-tuk.online/tasks.md): Встроенный менеджер задач tuk-tuk.online: канбан с 5 статусами и 4 приоритетами, назначение на сотрудника, привязка к диалогу, дедлайны с автоматическими действиями, создание задач цепочками и AI.
  - [Канбан и статусы](https://docs.tuk-tuk.online/tasks/kanban.md): Канбан-доска задач tuk-tuk.online: пять колонок по статусам, перетаскивание карточек, форма задачи с приоритетом, исполнителем, дедлайном, цветом и привязкой к диалогу.
  - [Дедлайны и напоминания](https://docs.tuk-tuk.online/tasks/deadlines.md): При наступлении дедлайна задачи tuk-tuk.online автоматически публикует пост в Эфир, оставляет заметку в диалоге, шлёт push исполнителю, отправляет клиенту заданный текст и запускает выбранную цепочку. Каждое действие выполняется один раз.
  - [Автосоздание задач](https://docs.tuk-tuk.online/tasks/automation.md): Задачи в tuk-tuk.online создаются автоматически блоком CREATE_TASK (фиксированные параметры) или AI_TASK (AI подбирает название, приоритет, дедлайн и исполнителя по переписке), а также вручную из блока «Задачи» в панели клиента.
- [Календарь и запись](https://docs.tuk-tuk.online/calendar.md): Встроенный календарь tuk-tuk.online для записи клиентов: каталог услуг, сотрудники с расписанием, события с 4 статусами, три вида отображения, синхронизация с Google Calendar (OAuth 2.0) и Яндекс Календарём (CalDAV), AI-запись из диалога.
  - [Каталог услуг](https://docs.tuk-tuk.online/calendar/services.md): Каталог услуг календаря tuk-tuk.online: карточки услуг и продуктов с длительностью, ценой, цветом и списком сотрудников. При записи услуга подставляет длительность, цену и доступных специалистов.
  - [Сотрудники и расписание](https://docs.tuk-tuk.online/calendar/staff.md): Сотрудники календаря tuk-tuk.online: отдельный справочник специалистов с цветом, признаком активности и расписанием. Пять режимов графика, часы по дням, сменные циклы от даты старта, таймлайн загрузки.
  - [События и запись](https://docs.tuk-tuk.online/calendar/events.md): Событие календаря tuk-tuk.online: запись клиента с датой, сотрудником, услугами, контактами и статусом. Поддерживает синхронизацию с Google Calendar и Яндекс Календарём, комментарии, историю изменений, теги и создание через AI-ассистента.

## Автоматизация

- [Цепочки](https://docs.tuk-tuk.online/chains.md): Цепочки: визуальный конструктор сценариев автоматизации в tuk-tuk.online; цепочка запускается по триггеру и выполняет блоки (сообщения, ожидание, условия, AI, webhook, Python, CRM) без участия оператора.
  - [Шаблоны связок](https://docs.tuk-tuk.online/chains/templates.md): Каталог из 21 готового шаблона связок tuk-tuk.online: приветствие, автоответчик, AI-ассистент, формы сбора данных, воронки и webhook-сценарий; создаются в разделе «Связки» через «+ Новая связка».
  - [Триггеры и условия](https://docs.tuk-tuk.online/chains/triggers.md): Триггер задаёт, когда запускается цепочка tuk-tuk.online: режим запуска, условие по тексту сообщения, расширенные условия (рабочие часы, лимиты, cooldown) и правила автоостановки.
  - [Блоки](https://docs.tuk-tuk.online/chains/blocks.md): Справочник 17 типов блоков конструктора цепочек tuk-tuk.online: что делает каждый блок и на какой странице описаны его настройки.
    - [Отправка сообщения](https://docs.tuk-tuk.online/chains/blocks/send-message.md): Блок SEND_MESSAGE отправляет клиенту текст или один медиа-файл через выбранный канал; поддерживает переменные, каскад резервных каналов и три стратегии выбора канала.
    - [Ожидание ответа](https://docs.tuk-tuk.online/chains/blocks/wait-response.md): Блок WAIT_RESPONSE останавливает цепочку до ответа клиента; ответ попадает в {{lastMessage}}, а по истечении таймаута цепочка уходит по отдельной ветке.
    - [Задержка](https://docs.tuk-tuk.online/chains/blocks/delay.md): Блок DELAY ставит цепочку на паузу на заданное число секунд; используется для напоминаний и капельных рассылок, может быть прерван остановкой цепочки, ответом клиента или стоп-тегом.
    - [AI-обработка](https://docs.tuk-tuk.online/chains/blocks/ai-process.md): Блок AI_PROCESS отправляет выбранный текст нейросети по инструкции или своему промпту и сохраняет ответ в {{aiResult}} для следующих блоков цепочки.
    - [Условие](https://docs.tuk-tuk.online/chains/blocks/condition.md): Блок CONDITION сравнивает выбранное поле (сообщение, имя, тип канала, результат AI, тег, переменная) с заданным значением и направляет цепочку по ветке первого совпавшего условия или по ветке «Иначе».
    - [Рандомайзер](https://docs.tuk-tuk.online/chains/blocks/randomizer.md): Блок RANDOMIZER случайно направляет клиента по одной из веток пропорционально заданным весам; используется для A/B-тестов и распределения клиентов между менеджерами.
    - [Webhook](https://docs.tuk-tuk.online/chains/blocks/webhook.md): Блок WEBHOOK отправляет GET- или POST-запрос на внешний URL с параметрами из переменных цепочки и сохраняет ответ в {{webhookResult}} и {{webhook_N}}.
    - [Вызов цепочки](https://docs.tuk-tuk.online/chains/blocks/call-chain.md): Блок CALL_CHAIN запускает другую цепочку из текущей, передаёт ей переменные и возвращает выбранные переменные обратно; позволяет переиспользовать сценарии как модули.
    - [Python-код](https://docs.tuk-tuk.online/chains/blocks/python-code.md): Блок PYTHON_CODE выполняет Python-скрипт в песочнице с доступом к переменным цепочки; результат возвращается через переменную result и попадает в {{pythonResult}} и {{python_N}}.
    - [Теги и примечания](https://docs.tuk-tuk.online/chains/blocks/tags-and-notes.md): Блоки ADD_TAG, REMOVE_TAG и ADD_NOTE присваивают или снимают тег клиента и добавляют внутреннюю заметку в диалог; ничего не отправляют клиенту и выполняются мгновенно.
    - [Переменные](https://docs.tuk-tuk.online/chains/blocks/set-variable.md): Блок SET_VARIABLE сохраняет текст в {{var_N}} для следующих блоков; страница также содержит справочник всех переменных цепочки tuk-tuk.online.
    - [Генерация изображений](https://docs.tuk-tuk.online/chains/blocks/generate-image.md): Блок GENERATE_IMAGE создаёт картинку по промпту через Kandinsky (FusionBrain) или KIE.AI и сохраняет её URL в {{imageResult}} для отправки клиенту.
    - [Задачи](https://docs.tuk-tuk.online/chains/blocks/tasks.md): Блоки CREATE_TASK и AI_TASK создают задачи из цепочки: первый с заданными вручную полями, второй заполняет название, описание, приоритет и срок через нейросеть по диалогу.
    - [Интеграция с CRM](https://docs.tuk-tuk.online/chains/blocks/integration.md): Блок INTEGRATION выполняет действие в подключённой CRM из цепочки: в AmoCRM создаёт сделку, двигает по воронке, ставит теги и поля; в YClients меняет посещаемость, метки и цвет записи.
- [Воронки историй](https://docs.tuk-tuk.online/funnels.md): Воронки tuk-tuk.online: визуальные сценарии, которые от имени канала публикуют Stories, меняют профиль, генерируют контент через AI и рассылают сообщения. Работают для Telegram-аккаунта, VK-сообщества и Instagram.
  - [Telegram](https://docs.tuk-tuk.online/funnels/tg-funnels.md): Telegram-воронки tuk-tuk.online выполняют действия от имени подключённого Telegram-аккаунта: публикация и удаление Stories, смена имени, био, username и аватара, рассылка по диалогам, AI-генерация текста и изображений.
  - [VK](https://docs.tuk-tuk.online/funnels/vk-funnels.md): VK-воронки tuk-tuk.online выполняют действия от имени VK-сообщества: Stories, название и описание группы, аватар, рассылка подписчикам через личные сообщения, AI-генерация. Набор блоков совпадает с Telegram-воронками.
  - [Instagram](https://docs.tuk-tuk.online/funnels/ig-funnels.md): Instagram-воронки tuk-tuk.online публикуют посты, карусели, Reels и Stories по публичным URL, рассылают сообщения в Direct и генерируют контент через AI. Единственный тип воронок с публикацией в ленту.
  - [Шаблонные переменные](https://docs.tuk-tuk.online/funnels/templates.md): Справочник переменных воронок tuk-tuk.online: контекстные {{aiResult}}, {{imageResult}}, {{storyResult}} (с суффиксом _N), персональные {{name}}, {{phone}}, {{email}} и шаблоны истории диалогов {{dialogs_<период>}} с фильтрами по типу, тегам и лимиту.
- [AI-ассистенты](https://docs.tuk-tuk.online/ai.md): AI-ассистенты tuk-tuk.online обрабатывают входящие сообщения в каналах через модели OpenAI, Anthropic, Google Gemini, Mistral и DeepSeek. Ассистент собирается из провайдера (API-ключ), инструкции (промпт) и привязки к каналам с режимом работы.
  - [Провайдеры](https://docs.tuk-tuk.online/ai/providers.md): Провайдер AI в tuk-tuk.online: подключённый сервис языковых моделей с API-ключом пользователя. Поддерживаются OpenAI, Anthropic, Google Gemini, Mistral и DeepSeek; провайдер выбирается при создании ассистента.
  - [Инструкции и промпты](https://docs.tuk-tuk.online/ai/instructions.md): Инструкция в tuk-tuk.online: системный промпт AI-ассистента (роль, тон, задачи, запреты). Создаётся вручную, через визуальный конструктор или из шаблона; данные компании выносятся в сниппеты.
  - [Настройка ассистента](https://docs.tuk-tuk.online/ai/assistants.md): AI-ассистент в tuk-tuk.online связывает провайдера, инструкцию и каналы. Настраиваются режим (автоответ клиенту или заметка оператору), рабочие часы, приоритет и пауза при ответе оператора; по каждому ассистенту ведётся статистика.
  - [Режимы поведения](https://docs.tuk-tuk.online/ai/modes.md): Режим определяет роль AI-ассистента tuk-tuk.online: 9 готовых ролей (ассистент продаж, запись в календарь, модератор, аналитик, автоответчик, конвертер лидов, транскрибация, генерация изображений, свой режим). Режим выбирается при создании ассистента и подставляет готовый промпт и настройки по умолчанию.
  - [Ассистент продаж](https://docs.tuk-tuk.online/ai/sales-assistant.md): Режим AI-ассистента «Ассистент продаж» анализирует переписку и пишет менеджеру заметку: стадия воронки, возражение, тактика, готовый ответ и следующий шаг. Клиенту ничего не отправляет.
  - [Запись в календарь](https://docs.tuk-tuk.online/ai/calendar-booking.md): Режим AI-ассистента «Запись в календарь» записывает клиента на приём через чат: собирает услугу, дату, время, имя и телефон, предлагает 2–3 слота и подтверждает запись. С интеграциями Google Calendar и YClients опирается на реальное расписание.
  - [Модератор](https://docs.tuk-tuk.online/ai/moderator.md): Режим AI-ассистента «Модератор» классифицирует каждое входящее сообщение по 7 параметрам (спам, токсичность 0–3, мат, тональность, категория, срочность, эскалация) и пишет вердикт оператору заметкой. Клиенту ничего не отправляет.
  - [Аналитик](https://docs.tuk-tuk.online/ai/analyst.md): Режим AI-ассистента «Аналитик» по кнопке «Анализ AI» в диалоге формирует отчёт: резюме, профиль клиента, оценка менеджера по 5 критериям (1–10), вероятность конверсии 0–100%, риск потери, проблемы и до 5 рекомендаций.
  - [Автоответчик](https://docs.tuk-tuk.online/ai/auto-responder.md): Режим AI-ассистента «Автоответчик» отвечает клиентам напрямую от лица компании: классифицирует сообщение, отвечает из контекста или уточняет, жалобы и сложные вопросы передаёт оператору. Нужен для нерабочего времени и пиковой нагрузки.
  - [Конвертер лидов](https://docs.tuk-tuk.online/ai/lead-converter.md): Режим AI-ассистента «Конвертер лидов» общается с клиентом напрямую, квалифицирует заявку по BANT+ (бюджет, полномочия, потребность, сроки, соответствие), делит лиды на холодные, тёплые и горячие и подводит к заявке, звонку или оплате.
  - [Транскрибация](https://docs.tuk-tuk.online/ai/transcription.md): Режим AI-ассистента «Транскрибация» расшифровывает голосовые сообщения и аудиофайлы в текст внутри диалога через OpenAI Whisper (whisper-1) или Google Gemini. Текст видят менеджер и другие AI-ассистенты канала.
  - [Генерация изображений](https://docs.tuk-tuk.online/ai/image-generation.md): Генерация изображений в tuk-tuk.online работает из цепочек через блок AI Process с выходным форматом «изображение». Провайдеры: Kandinsky (FusionBrain) и KIE.AI (17+ моделей: seedream, flux-2, flux-kontext, ideogram, imagen, qwen, grok-imagine, gpt-image, nano-banana).
  - [Извлечение данных](https://docs.tuk-tuk.online/ai/data-extraction.md): Сценарий извлечения данных: AI-ассистент в режиме «Свой» с промптом-шаблоном разбирает свободный текст клиента на поля (имя, телефон, email, тип запроса, номер заказа, товар, дата) и пишет результат заметкой оператору.
  - [База знаний](https://docs.tuk-tuk.online/ai/knowledge-base.md): Сценарий ответов по базе знаний: AI-ассистент отвечает клиентам только по данным из сниппетов (прайс-лист, FAQ, каталог, доставка), промпт собирается из блоков «Текст» и «Сниппет» и пересобирается при каждом сообщении. При отсутствии ответа AI говорит «уточню».
  - [Свой режим](https://docs.tuk-tuk.online/ai/custom.md): Режим AI-ассистента «Свой» запускается с пустым системным промптом: пользователь сам описывает поведение. Типовые применения: извлечение данных, ответы по базе знаний из сниппетов, перевод, теги, резюме диалога.
  - [AI Proxy](https://docs.tuk-tuk.online/ai/ai-proxy.md): AI Proxy: отдельный сервис tuk-tuk.online, через который бэкенд отправляет запросы к OpenAI, Anthropic, Gemini, Mistral и DeepSeek. Авторизация по заголовку x-proxy-secret; без AI_PROXY_URL бэкенд ходит к провайдерам напрямую.

## Интеграции и API

- [Интеграции](https://docs.tuk-tuk.online/integrations.md): Раздел «Интеграции» связывает tuk-tuk.online с amoCRM, YClients, Google Calendar, Битрикс24, GetCourse, RetailCRM, 1С:Предприятие, Notion, Яндекс.Метрикой и произвольными сервисами через вебхуки. Данные читаются и записываются в обе стороны, действия выполняют цепочки и AI-ассистенты.
  - [amoCRM](https://docs.tuk-tuk.online/integrations/amocrm.md): Интеграция amoCRM подключается по OAuth 2.0 в один клик и даёт двустороннюю связь мессенджеров с CRM: автосоздание контактов и сделок, переписка в карточке сделки через Amojo, теги, примечания, кастомные поля, конструктор правил и действия в цепочках.
  - [YClients](https://docs.tuk-tuk.online/integrations/yclients.md): Интеграция YClients подключается через маркетплейс YClients и даёт доступ к записям, мастерам, услугам, клиентам, филиалам и меткам. AI-ассистент записывает клиентов из чата, цепочки меняют статус посещения, метки и цвет записи.
  - [Google Calendar](https://docs.tuk-tuk.online/integrations/google-calendar.md): Интеграция Google Calendar связывает раздел «Календарь» кабинета с основным календарём Google-аккаунта по OAuth 2.0: чтение занятости, создание, изменение и удаление событий, ссылки Google Meet. AI-ассистент записывает клиентов из чата, Яндекс Календарь подключается по CalDAV.
  - [Битрикс24](https://docs.tuk-tuk.online/integrations/bitrix24.md): Интеграция Битрикс24 подключается через входящий вебхук (вставляется URL вебхука целиком) и создаёт из обращений в мессенджерах контакты, лиды и сделки, читает компании и справочники стадий и статусов.
  - [GetCourse](https://docs.tuk-tuk.online/integrations/getcourse.md): Интеграция GetCourse подключается по имени аккаунта и API Secret Key: выгрузка пользователей, сделок и групп обучения, создание пользователей и сделок из мессенджеров и AI-ассистентов.
  - [RetailCRM](https://docs.tuk-tuk.online/integrations/retailcrm.md): Интеграция RetailCRM подключается по адресу инстанса и API-ключу (REST API v5): чтение и создание клиентов и заказов, справочники статусов, типов доставки и магазинов; AI-ассистент отвечает о статусе заказа по телефону клиента.
  - [1С:Предприятие](https://docs.tuk-tuk.online/integrations/onec.md): Интеграция 1С:Предприятие подключается к стандартному OData-интерфейсу базы по логину и паролю (Basic Auth): чтение контрагентов, номенклатуры, заказов покупателей, складов и организаций, создание контрагентов и заказов из мессенджеров.
  - [Notion](https://docs.tuk-tuk.online/integrations/notion.md): Интеграция Notion подключается по токену внутренней интеграции и базе данных с выданным доступом (Connections); задачи и заметки экспортируются страницами Notion с заголовком в title-свойство и текстом абзацами.
  - [Яндекс.Метрика](https://docs.tuk-tuk.online/integrations/yandex-metrika.md): Интеграция Яндекс.Метрики подключается по номеру счётчика и OAuth-токену и отправляет выбранные события кабинета офлайн-конверсиями (multipart CSV, UserId, Unix-время) в цели типа «JavaScript-событие» с идентификаторами dialog.created, message.inbound и другими.
  - [Вебхуки](https://docs.tuk-tuk.online/integrations/webhooks.md): Исходящие вебхуки tuk-tuk.online отправляют HTTP POST с JSON и подписью HMAC-SHA256 на ваш URL при событиях платформы: сообщения, диалоги, цепочки, каналы, AI, платежи, календарь, интеграции, SMS, файлы. Настраиваются в настройках проекта, работают независимо от цепочек.
- [API для разработчиков](https://docs.tuk-tuk.online/api.md): Обзор способов интеграции с tuk-tuk.online для разработчиков: REST API v1 (ваш сервер вызывает платформу), вебхук кодов подтверждения (отправка кода по SMS или Email одним POST) и Event Webhooks (платформа присылает события на ваш сервер).
  - [REST API v1](https://docs.tuk-tuk.online/api/rest.md): REST API v1 tuk-tuk.online для серверных интеграций: список каналов, карточки контактов, история сообщений, ссылки на медиа и отправка сообщений (текст, голосовые, медиа, email) в любой подключённый канал. Авторизация по API-ключу со scopes, ответы в JSON.
  - [Коды подтверждения](https://docs.tuk-tuk.online/api/verification.md): Вебхук верификации tuk-tuk.online: один POST-запрос генерирует 6-значный код и отправляет его клиенту по SMS или Email, код возвращается в ответе для сверки на вашей стороне. Для сервисов, которым нужно подтверждать телефон или почту клиента.
  - [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks.md): Event Webhooks tuk-tuk.online: платформа отправляет HTTP POST с JSON на URL вашего сервера при каждом из 50 типов событий (сообщения, диалоги, цепочки, каналы, AI, платежи, календарь, интеграции, SMS, файлы). Каждый запрос подписан HMAC-SHA256 секретным ключом вебхука.

## Платформа

- [Пользователи и права](https://docs.tuk-tuk.online/users.md): Раздел tuk-tuk.online про аккаунты и доступы: вход по паролю, SMS-коду и WebAuthn, роли с 95 разрешениями в 16 категориях, приглашение сотрудников по email и до 3 изолированных проектов на аккаунт.
  - [Аутентификация](https://docs.tuk-tuk.online/users/auth.md): Вход в tuk-tuk.online: логин по номеру телефона и паролю, необязательная 2FA по SMS и вход без пароля по WebAuthn (отпечаток, Face ID, USB-ключ). Регистрация даёт 100 рублей и 14 дней тарифа CORP.
  - [Роли и разрешения](https://docs.tuk-tuk.online/users/roles-permissions.md): Ролевая модель tuk-tuk.online: сотрудник получает роль, роль содержит набор из 95 разрешений в 16 категориях. Системные роли Владелец и Администратор, кастомные роли с любым набором прав, автоблокировка по дням неактивности.
  - [Команда](https://docs.tuk-tuk.online/users/team.md): Команда проекта в tuk-tuk.online: приглашение сотрудников по email с назначением роли, статусы участия (Ожидает, Активен) и доступности (Доступен, Занят, В отпуске), статистика активности, тихие часы и мьюты уведомлений.
  - [Несколько проектов](https://docs.tuk-tuk.online/users/projects.md): Один аккаунт tuk-tuk.online ведёт до 3 изолированных проектов, у каждого свои каналы, диалоги, цепочки, AI-ассистенты, команда, роли, календарь, задачи, баланс и дашборд. Переключение через меню проектов.
- [SMS Gateway (Android)](https://docs.tuk-tuk.online/sms-gateway.md): Android-приложение tuk-tuk SMS Gateway превращает телефон с SIM-картой в двусторонний SMS-шлюз: исходящие SMS уходят через SIM по команде сервера, входящие попадают в диалоги tuk-tuk.online. Без SMS-агрегатора, по тарифу оператора.
  - [Установка и привязка](https://docs.tuk-tuk.online/sms-gateway/setup.md): Как поставить Android-приложение SMS Gateway из APK, выдать ему разрешения, привязать телефон к аккаунту tuk-tuk.online по QR-коду и создать SMS-канал.
  - [Возможности](https://docs.tuk-tuk.online/sms-gateway/features.md): Функции Android-приложения SMS Gateway: отправка SMS по push-команде со статусами доставки, приём входящих с защитой от дублей и фильтрами по номеру, выбор SIM-карты, история сообщений.
  - [Надёжность](https://docs.tuk-tuk.online/sms-gateway/reliability.md): Механизмы, которые держат SMS Gateway в работе без присмотра: sticky-уведомление и настройки батареи Android, heartbeat раз в 30 минут, команды через FCM, автозапуск после перезагрузки, повторы при ошибках.
  - [Мониторинг](https://docs.tuk-tuk.online/sms-gateway/monitoring.md): Что кабинет tuk-tuk.online показывает о привязанном Android-устройстве и SMS-канале, какие лимиты отправки можно задать, какие события уходят в вебхуки и что проверять при сбоях шлюза.
- [Приложение и офлайн](https://docs.tuk-tuk.online/pwa.md): Кабинет tuk-tuk.online является Progressive Web App: устанавливается из браузера на компьютер, Android и iPhone, присылает push-уведомления, открывается и работает без интернета за счёт Service Worker, кеша данных и очереди действий.
  - [Установка](https://docs.tuk-tuk.online/pwa/install.md): Инструкция по установке кабинета tuk-tuk.online как PWA на компьютер (Chrome, Edge), Android (Chrome) и iPhone/iPad (Safari), с проверкой результата и удалением.
  - [Офлайн-режим](https://docs.tuk-tuk.online/pwa/offline.md): Офлайн-режим кабинета tuk-tuk.online: данные хранятся в IndexedDB (до 25 МБ), действия без сети копятся в очереди и отправляются после восстановления связи, интерфейс обновляется оптимистично, внизу экрана показывается индикатор соединения.
  - [Push-уведомления](https://docs.tuk-tuk.online/pwa/push.md): Push-уведомления кабинета tuk-tuk.online о новых сообщениях клиентов: доставка через Web Push с VAPID-подписью и шифрованием, включение в браузере, переход в диалог по клику, тихие часы, ограничения на iOS.
  - [Скорость и кеш](https://docs.tuk-tuk.online/pwa/caching.md): Кеширование в кабинете tuk-tuk.online: Service Worker предзагружает файлы интерфейса, для API используется стратегия «сеть в приоритете» с таймаутом 3 секунды, для шрифтов, файлов, изображений и медиа «кеш в приоритете»; обновления применяются в фоне.
- [Файлы и медиа](https://docs.tuk-tuk.online/files.md): Хранилище файлов tuk-tuk.online: изображения, документы, голосовые и видео из диалогов, цепочек и API, плюс текстовые сниппеты для AI-инструкций. Лимит 50 МБ на файл, квота хранилища зависит от тарифа.
- [Тарифы и оплата](https://docs.tuk-tuk.online/billing.md): Тарифы tuk-tuk.online (Free, Business, Corp), их лимиты и цены за сообщения, которые списываются с баланса помимо подписки.
- [Вопросы и ответы](https://docs.tuk-tuk.online/faq.md): Ответы на частые вопросы о tuk-tuk.online: установка, лимиты каналов по тарифам, поддерживаемые AI-модели и ключи, пополнение баланса и возврат, хранение данных, удаление аккаунта, контакты поддержки.

## Optional

- [Сайт продукта](https://tuk-tuk.online): лендинг и тарифы
- [Карта сайта](https://docs.tuk-tuk.online/sitemap.xml)