1. Преимущества диалоговых форм Typebot v3 и архитектура
Классические статические формы обратной связи в интернет-магазинах и на лендингах стремительно теряют эффективность: длинные простыни полей «Имя», «Телефон», «Email», «Комментарий» вызывают отторжение у мобильных пользователей. По данным отраслевых бенчмарков лидогенерации (Unbounce, Formstack), средняя конверсия классических длинных форм не превышает 2–4%. Совсем иначе работают пошаговые диалоговые интерфейсы (Conversational Forms), где общение строится в формате живого мессенджера: вопрос за вопросом, с подсказками, кнопками быстрого выбора и ветвлением логики в зависимости от ответов клиента.
Мировым стандартом в этой сфере долгое время являлись SaaS-платформы Typeform и Landbot. Однако в 2026 году для отечественного бизнеса использование зарубежных сервисов связано с критическими барьерами: жесткие лимиты на количество диалогов (тарифы Typeform начинаются от $29/мес всего за 100 ответов и $59/мес за 1000 ответов, а Landbot — от €40 до €100+/мес), блокировка оплаты российскими банковскими картами и прямая угроза штрафов по Федеральному закону № 152-ФЗ из-за хранения персональных данных клиентов на зарубежных серверах.
Решением этой проблемы стал Typebot — популярная платформа визуального конструирования диалоговых ботов (более 10 600 звёзд на GitHub). Проект распространяется с открытым исходным кодом под лицензией Fair Source (FSL-1.1-Apache-2.0): вы можете свободно разворачивать его на собственных серверах, модифицировать и использовать для любых внутренних бизнес-процессов компании без ограничений (с ограничением лишь на перепродажу сторонним лицам в виде конкурирующего SaaS-сервиса, при этом каждый релиз автоматически переходит в полностью свободную лицензию Apache 2.0 через 2 года). Развернув Typebot на собственном VDS, вы получаете неограниченное количество ботов, шагов и ответов без ежемесячных платежей, а все конфиденциальные заявки остаются в защищенном контуре вашего сервера.
- Визуальный No-Code конструктор: построение сложных сценариев диалога методом Drag-and-Drop с ветвлением (условия If/Else), переменными и регулярными выражениями.
- Сквозная интеграция с ИИ: встроенные блоки для подключения OpenAI, DeepSeek, Claude или локальных моделей через Ollama для генерации интеллектуальных ответов на вопросы клиентов.
- Универсальная публикация: чат-бот встраивается на любой сайт (Bitrix, WordPress, Tilda, React/Vue) в 1 строчку HTML-кода как popup-виджет, кнопка в углу или встроенный блок (embed), а также запускается как полноценный бот в Telegram.
- Мгновенная лидогенерация: отправка контактов лидов в Telegram-группу менеджеров, вебхуки в CRM-системы (amoCRM, Битрикс24) и экспорт в таблицы.
- 100% соблюдение 152-ФЗ: база данных заявок физически располагается в российском ЦОД без транзита через иностранные шлюзы.
Архитектура Typebot v3: разделение Builder и Viewer
В актуальной мажорной линейке Typebot v3 архитектура разделена на два независимых микросервиса, что гарантирует высокую отказоустойчивость:
typebot-builder(порт 3000 →127.0.0.1:8080): тяжелый интерфейс администратора и студия редактирования на Next.js. Здесь настраиваются сценарии, анализируются воронки прохождения шагов и создаются интеграции. Доступ к билдеру закрывается авторизацией администратора.typebot-viewer(порт 3000 →127.0.0.1:8081): сверхбыстрый и оптимизированный клиентский движок, который исполняет сценарии ботов для посетителей вашего сайта. В простое он потребляет всего 120–200 МБ RAM и обрабатывает входящие сессии через асинхронные HTTP/SSE-соединения без постоянной блокировки серверных потоков.typebot-db(PostgreSQL 16): реляционная база данных для хранения учетных записей, схем диалогов, пользовательских переменных и собранных ответов.typebot-minio(MinIO S3): локальное S3-совместимое объектное хранилище для медиафайлов: аватарок бота, картинок в сценариях и документов, загружаемых клиентами через форму.
2. Системные требования и подготовка VDS-сервера
Согласно замерам утилиты docker stats при непрерывной эксплуатации, базовый стек Typebot v3 в рабочем состоянии потребляет около 600–850 МБ RAM (builder ~200 МБ, viewer ~150 МБ, PostgreSQL 16 ~150–250 МБ, MinIO ~100 МБ). На сервере с 2 ГБ RAM остается более 1 ГБ нераспределенной физической памяти для дискового кэша ОС и обработки пиковых пользовательских сессий, что делает его крайне экономичным решением.
| Параметр VDS | Минимум (Тесты / 1–3 бота) | Рекомендуется (Production / до 100 000 диалогов) |
|---|---|---|
| Процессор (vCPU) | 1–2 ядра (от 2.4 ГГц) | 2–4 ядра (от 3.0 ГГц NVMe) |
| Оперативная память (RAM) | 2 ГБ (+ 4 ГБ Swap обязательно) | 4 ГБ (+ 4 ГБ Swap) |
| Дисковый накопитель | 25 ГБ NVMe | 50–80 ГБ NVMe |
| Операционная система | Ubuntu 24.04 / 22.04 LTS / Debian 12 | Ubuntu 24.04 LTS |
| Сетевой интерфейс | 100 Мбит/с, статический IPv4 | 100–300 Мбит/с, статический IPv4 |
Для предотвращения аварийного завершения контейнеров системным демоном Linux OOM Killer при пиковых всплесках трафика на сервере обязательно настраивается Swap-раздел объемом 4 ГБ.
Создание Swap-файла и оптимизация памяти ядра
# Проверяем текущее состояние подкачки
sudo swapon --show
# Создаем файл подкачки на 4 ГБ, если он отсутствует
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# Сохраняем монтирование файла подкачки в fstab
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# Оптимизируем swappiness (использовать swap только при нехватке физической RAM)
echo 'vm.swappiness=15' | sudo tee -a /etc/sysctl.d/99-sysctl.conf
sudo sysctl -p /etc/sysctl.d/99-sysctl.conf
3. Полный манифест Docker Compose для Typebot v3
Разворачивать стек Typebot v3 мы будем в изолированном каталоге /opt/typebot. Для соответствия стандартам безопасности боевых серверов все внутренние порты (PostgreSQL 5432, S3-хранилище MinIO 9000/9001, локальные порты веб-приложений 8080/8081) привязаны строго к интерфейсу локальной петли 127.0.0.1. Это исключает несанкционированный доступ извне в обход системного фаервола. Проверить закрытие портов после запуска поможет онлайн-сканер портов SysKit.
Генерация мастер-ключей и файла конфигурации .env
Создаем рабочую директорию и файл переменных окружения .env. Для шифрования учетных записей интеграций и паролей в базе данных необходим криптостойкий секрет ENCRYPTION_SECRET. Сгенерировать пароли для базы данных поможет генератор паролей SysKit.
# Создаем изолированную директорию
sudo mkdir -p /opt/typebot
cd /opt/typebot
# Генерируем 32-байтный случайный секрет шифрования
openssl rand -hex 32
# Создаем файл конфигурации .env
nano .env
Заполняем файл .env следующими параметрами (замените yourdomain.ru на ваш реальный рабочий домен):
# /opt/typebot/.env
# Мастер-ключ шифрования (сгенерируйте свой 32-байтный hex-ключ командой: openssl rand -hex 32)
ENCRYPTION_SECRET=СГЕНЕРИРУЙТЕ_СВОЙ_32_БАЙТНЫЙ_HEX_СЕКРЕТ_ЧЕРЕЗ_OPENSSL
# Публичные URL сервисов Typebot
# builder — студия редактирования для администратора
NEXTAUTH_URL=https://builder.yourdomain.ru
# viewer — клиентский движок, исполняющий сценарии для посетителей
NEXT_PUBLIC_VIEWER_URL=https://bot.yourdomain.ru
# Email администратора (для создания первого аккаунта)
ADMIN_EMAIL=admin@yourdomain.ru
# Отключаем регистрацию новых пользователей после создания аккаунта администратора
DISABLE_SIGNUP=false
# Параметры базы данных PostgreSQL (сгенерируйте надежный пароль)
POSTGRES_DB=typebot
POSTGRES_USER=typebot_user
POSTGRES_PASSWORD=СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД
DATABASE_URL=postgresql://typebot_user:СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД@typebot-db:5432/typebot
# Настройки объектного S3-хранилища MinIO для файлов и картинок
# Внутри docker-сети контейнеры обращаются к MinIO по имени сервиса typebot-minio
S3_ACCESS_KEY=minio_typebot_admin
S3_SECRET_KEY=СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_MINIO
S3_BUCKET=typebot
S3_ENDPOINT=typebot-minio
S3_PORT=9000
S3_SSL=false
Манифест docker-compose.yml
Создаем файл /opt/typebot/docker-compose.yml. Все сервисы снабжены жесткими лимитами оперативной памяти (mem_limit) и процессорного времени (cpus) для защиты от OOM:
# /opt/typebot/docker-compose.yml
services:
# Реляционная база данных для схем ботов и ответов
typebot-db:
image: postgres:16-alpine
container_name: typebot_db
restart: always
environment:
POSTGRES_DB: ${POSTGRES_DB}
POSTGRES_USER: ${POSTGRES_USER}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
TZ: UTC
volumes:
- typebot_pg_data:/var/lib/postgresql/data
ports:
- "127.0.0.1:5432:5432"
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 5s
timeout: 5s
retries: 5
mem_limit: 768m
cpus: 1.0
networks:
- typebot_net
# Локальное S3-хранилище медиафайлов и аватаров
typebot-minio:
image: minio/minio:RELEASE.2024-11-07T00-52-20Z
container_name: typebot_minio
restart: always
entrypoint: sh
command: -c 'mkdir -p /data/typebot && minio server --address ":9000" --console-address ":9001" /data'
environment:
MINIO_ROOT_USER: ${S3_ACCESS_KEY}
MINIO_ROOT_PASSWORD: ${S3_SECRET_KEY}
volumes:
- typebot_minio_data:/data
ports:
- "127.0.0.1:9000:9000"
- "127.0.0.1:9001:9001"
healthcheck:
test: ["CMD-SHELL", "curl -f http://127.0.0.1:9000/minio/health/live || exit 1"]
interval: 5s
timeout: 5s
retries: 5
mem_limit: 512m
cpus: 0.5
networks:
- typebot_net
# Визуальная студия-конструктор Typebot Builder
typebot-builder:
image: baptistearno/typebot-builder:3.19.1
container_name: typebot_builder
restart: always
extra_hosts:
- "host.docker.internal:host-gateway"
env_file:
- .env
depends_on:
typebot-db:
condition: service_healthy
typebot-minio:
condition: service_healthy
ports:
- "127.0.0.1:8080:3000"
mem_limit: 1024m
cpus: 1.0
networks:
- typebot_net
# Высокопроизводительный движок исполнения диалогов Typebot Viewer
typebot-viewer:
image: baptistearno/typebot-viewer:3.19.1
container_name: typebot_viewer
restart: always
extra_hosts:
- "host.docker.internal:host-gateway"
env_file:
- .env
depends_on:
typebot-db:
condition: service_healthy
typebot-minio:
condition: service_healthy
ports:
- "127.0.0.1:8081:3000"
mem_limit: 768m
cpus: 1.0
networks:
- typebot_net
volumes:
typebot_pg_data:
driver: local
typebot_minio_data:
driver: local
networks:
typebot_net:
driver: bridge
Запускаем контейнеры в фоновом режиме:
cd /opt/typebot
docker compose up -d
# Проверяем успешный запуск всех 4 контейнеров
docker compose ps
4. Настройка Nginx, Let's Encrypt SSL и проксирование
Для полноценной работы платформы Typebot требуются два поддомена: builder.yourdomain.ru (панель управления сценариями) и bot.yourdomain.ru (клиентский движок отображения). Маршрутизацию запросов и выпуск бесплатных SSL-сертификатов Let's Encrypt обеспечит хостовый веб-сервер Nginx. Если вам требуется сгенерировать конфигурацию под другие службы, воспользуйтесь интерактивным конфигуратором Nginx от SysKit.
Установка Nginx и Certbot
sudo apt-get update
sudo apt-get install -y nginx certbot python3-certbot-nginx
Конфигурация виртуальных хостов Nginx
Создаем конфигурационный файл /etc/nginx/sites-available/typebot.conf:
# 1. Визуальный конструктор (Builder)
server {
listen 80;
server_name builder.yourdomain.ru;
client_max_body_size 30M;
server_tokens off;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
# Проброс заголовков для WebSocket
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
# 2. Клиентский движок диалогов (Viewer)
server {
listen 80;
server_name bot.yourdomain.ru;
client_max_body_size 25M;
server_tokens off;
location / {
proxy_pass http://127.0.0.1:8081;
proxy_http_version 1.1;
# Поддержка Server-Sent Events (SSE) для стриминга ответов LLM без буферизации
proxy_buffering off;
proxy_cache off;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Активируем конфигурацию и выпускаем SSL-сертификаты с автоматическим редиректом на HTTPS:
# Создаем символическую ссылку
sudo ln -sf /etc/nginx/sites-available/typebot.conf /etc/nginx/sites-enabled/
# Проверяем синтаксис Nginx
sudo nginx -t
# Перезагружаем конфигурацию
sudo systemctl reload nginx
# Выпускаем SSL-сертификаты Let's Encrypt для обоих поддоменов
sudo certbot --nginx -d builder.yourdomain.ru -d bot.yourdomain.ru --redirect --non-interactive --agree-tos -m admin@yourdomain.ru
Проверить корректность настройки HTTPS и валидность цепочки сертификатов можно через онлайн-чекер SSL от SysKit.
5. Практическая интеграция: виджет на сайт, Telegram и LLM
После завершения установки откройте в браузере https://builder.yourdomain.ru и зарегистрируйте учетную запись администратора с адресом, указанным в ADMIN_EMAIL. В панели управления перейдите в созданный проект и соберите сценарий диалога с помощью визуальных блоков: «Текст», «Ввод имени», «Ввод телефона», «Выбор услуги», «Условие (If/Else)».
/opt/typebot/.env, установите директиву DISABLE_SIGNUP=true и выполните docker compose up -d. Это заблокирует открытую регистрацию сторонних лиц в вашей студии.
Способ 1: Встраивание виджета на сайт (Tilda, WordPress, Bitrix)
Чтобы добавить плавающую кнопку чата в правый нижний угол сайта или отобразить квиз прямо в теле страницы, вставьте следующий сниппет перед закрывающим тегом </body>:
<!-- Виджет Typebot в углу экрана -->
<script type="module">
import Typebot from 'https://cdn.jsdelivr.net/npm/@typebot.io/js@0/dist/web.js'
Typebot.initBubble({
typebot: "lead-generation-quiz",
apiHost: "https://bot.yourdomain.ru",
theme: {
button: {
backgroundColor: "#2563eb",
iconColor: "#ffffff"
},
chatWindow: {
maxHeight: "650px",
maxWidth: "420px"
}
}
});
</script>
Способ 2: Запуск чат-бота в Telegram
Typebot поддерживает бесшовный запуск любых сценариев прямо в Telegram:
- Создайте нового бота через официального отца ботов
@BotFatherв Telegram и сохраните полученный API-токен вида123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ. - В редакторе Typebot перейдите во вкладку Share → Telegram.
- Вставьте токен бота и нажмите Publish. Typebot автоматически зарегистрирует вебхук на адрес
https://bot.yourdomain.ru, и бот мгновенно начнет отвечать пользователям в Telegram.
Способ 3: Интеграция с моделями ИИ (OpenAI, DeepSeek, Ollama)
Чтобы бот не просто опрашивал клиента по скрипту, но и отвечал на свободные вопросы об услугах компании:
- Добавьте в цепочку блок OpenAI / LLM.
- В поле Base URL можно указать как официальный шлюз OpenAI, так и адрес локального демона
http://host.docker.internal:11434/v1с запущенной моделью Ollama (благодаря директивеextra_hosts: ["host.docker.internal:host-gateway"]в compose-манифесте контейнеры на Linux без проблем обращаются к службам хоста). - В блоке System Prompt передайте контекст компании: «Ты — виртуальный консультант интернет-магазина. Отвечай кратко, доброжелательно. Если клиент готов сделать заказ, запроси его номер телефона».
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Скоростные NVMe VDS
Идеально для микросервисного стека Typebot: высокая частота ядер до 3.3 ГГц для мгновенной генерации веб-интерфейсов и быстрого отклика viewer-движка.
Selectel — Корпоративная инфраструктура Tier III
Максимальная надежность с размещением в ЦОД уровня Tier III в РФ. Идеально для безопасного сбора персональных данных клиентов и соблюдения 152-ФЗ.
Beget — Простота и стабильность
Удобное управление, автоматические ежедневные бэкапы всего сервера и поминутная тарификация для быстрого запуска квизов и ботов.
6. Резервное копирование PostgreSQL и вложений с алертами в Telegram
В базе данных Typebot накапливаются самые ценные активы бизнеса: схемы воронок продаж, логи переписок и прямые контактные данные клиентов (номера телефонов, адреса, детали заказов). Потеря базы из-за сбоя диска или неосторожных действий администратора приведет к остановке приема лидов со всех сайтов. Настроим ежедневное резервное копирование с отправкой уведомлений в Telegram.
Скрипт автоматического бэкапа
Создаем скрипт /opt/typebot/backup_typebot.sh. Скрипт безопасно экспортирует базу данных PostgreSQL и архив директории MinIO, удаляет копии старше 7 дней и отправляет статус операции через Telegram Bot API с флагом --data-urlencode:
#!/usr/bin/env bash
# /opt/typebot/backup_typebot.sh
set -euo pipefail
# Пути и параметры
BACKUP_DIR="/opt/typebot/backups"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
RETENTION_DAYS=7
# Настройки Telegram-оповещений (замените на свои значения)
TG_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
TG_CHAT_ID="987654321"
send_telegram() {
local text="$1"
if [ -n "$TG_BOT_TOKEN" ] && [ -n "$TG_CHAT_ID" ]; then
curl -s -X POST "https://api.telegram.org/bot${TG_BOT_TOKEN}/sendMessage" \
-d "chat_id=${TG_CHAT_ID}" \
--data-urlencode "text=${text}" \
-d "parse_mode=HTML" > /dev/null || true
fi
}
mkdir -p "$BACKUP_DIR"
cd /opt/typebot
# 1. Снятие дампа базы данных PostgreSQL 16
PG_DUMP_FILE="${BACKUP_DIR}/typebot_db_${TIMESTAMP}.sql.gz"
if docker exec typebot_db pg_dump -U typebot_user typebot | gzip > "$PG_DUMP_FILE"; then
DB_SIZE=$(du -h "$PG_DUMP_FILE" | cut -f1)
else
send_telegram "❌ [Typebot VDS] Ошибка снятия дампа PostgreSQL!"
exit 1
fi
# 2. Архивирование директории медиафайлов MinIO
MEDIA_DUMP_FILE="${BACKUP_DIR}/typebot_media_${TIMESTAMP}.tar.gz"
tar -czf "$MEDIA_DUMP_FILE" -C /var/lib/docker/volumes/typebot_typebot_minio_data/_data . 2>/dev/null || true
MEDIA_SIZE=$(du -h "$MEDIA_DUMP_FILE" | cut -f1)
# 3. Ротация старых копий
find "$BACKUP_DIR" -type f -name "typebot_*.gz" -mtime +"$RETENTION_DAYS" -delete
# 4. Успешный отчет в Telegram
MESSAGE="✅ Резервное копирование Typebot успешно!
📅 Дата: ${TIMESTAMP}
💾 База данных: ${DB_SIZE}
📁 Медиавложения: ${MEDIA_SIZE}
⏳ Ротация: старше ${RETENTION_DAYS} дн. удалены"
send_telegram "$MESSAGE"
Выдаем права на исполнение только суперпользователю и добавляем задачу в планировщик cron:
# Ограничиваем доступ к скрипту (только root)
sudo chmod 700 /opt/typebot/backup_typebot.sh
# Настраиваем ежедневный автоматический запуск в 03:00 ночи
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/typebot/backup_typebot.sh >> /var/log/typebot_backup.log 2>&1") | crontab -
7. Безопасность, защита от спама и соответствие 152-ФЗ
Публичные диалоговые формы и квизы неизбежно становятся мишенью для автоматизированных спам-ботов, парсеров и флуд-атак. Кроме того, сбор контактов граждан РФ накладывает строгие требования регуляторов.
- Соблюдение 152-ФЗ: арендуйте VDS у провайдеров с дата-центрами на территории РФ (Timeweb Cloud, Selectel, Beget). Обязательно добавьте в сценарий перед кнопкой отправки контактных данных блок с галочкой «Я согласен на обработку персональных данных» и ссылкой на политику конфиденциальности компании.
- Защита от спам-ботов (Cloudflare Turnstile / reCAPTCHA): Typebot v3 поддерживает блоки умной капчи. Добавьте блок Captcha в начало сценария, чтобы отсекать спам-ботов до создания сессии в базе данных.
- Ограничение частоты запросов в Nginx (Rate Limiting): добавьте в конфигурационный файл Nginx зону
limit_req_zone $binary_remote_addr zone=viewer_limit:10m rate=15r/s;для поддоменаbot.yourdomain.ru, чтобы защитить сервер от DoS-атак. - Шифрование секретов: переменная
ENCRYPTION_SECRETшифрует API-ключи Telegram и сторонних сервисов алгоритмом AES непосредственно в таблицах PostgreSQL.