Пользовательские домены (Custom Domains)

Путь: /dashboard/settings (вкладка Custom Domain) · Разрешение: Модуль Settings

Пользовательские домены позволяют запускать вашего бота по брендированному URL, например https://bot.yourcompany.com, вместо IP-адреса с номером порта. Настройка автоматизирована через панель управления — работа с командной строкой не требуется.

Что дает пользовательский домен

Вместо доступа к боту по адресу https://123.45.67.89:8321, пользовательский домен предоставляет чистый, брендированный URL:

https://bot.yourcompany.com — Профессионально и заслуживает доверия
https://support.yourcompany.com — Отражает назначение
https://ai.yourcompany.com — Современно и запоминаемо

Это по-прежнему ваш частный сервер — пользовательский домен является лишь брендированным адресом, который указывает на него.

Предварительные условия

Перед настройкой пользовательского домена убедитесь в следующем:

Требование	Детали
Управление DNS	Вы можете создавать A-записи для своего домена (через регистратора или Cloudflare)
Порты 80 и 443	Открыты на вашем сервере для HTTP и HTTPS трафика
Владение доменом	Вы владеете или управляете доменом, который хотите использовать

SSL обрабатывается автоматически

SSL-сертификаты выпускаются и обновляются автоматически. Ручная настройка не требуется.

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

Шаг 1: Создайте DNS-запись

Перейдите к вашему регистратору домена или DNS-провайдеру и создайте A-запись:

Тип записи	Имя	Значение
A	`bot.yourdomain.com`	IP-адрес вашего сервера

Замените bot на любой поддомен по вашему выбору (например, support, ai, chat).

Шаг 2: Проверьте DNS

Перейдите в Settings → Custom Domain в панели управления.
Введите ваш домен (например, bot.yourdomain.com).
Нажмите Verify DNS.
Система проверит, указывает ли A-запись на ваш сервер.

Распространение DNS

Изменения DNS могут вступать в силу от 5 до 30 минут. Если проверка не удалась, подождите несколько минут и попробуйте снова.

Шаг 3: Добавьте домен

После подтверждения DNS нажмите Add Domain.
Система автоматически:
- Генерирует файлы конфигурации Nginx
- Запрашивает SSL-сертификат у Let's Encrypt
- Активирует домен

Теперь ваш бот доступен по адресу https://bot.yourdomain.com.

Совместимость с Cloudflare

Если вы используете Cloudflare в качестве DNS/CDN провайдера:

Рекомендуемый режим SSL: Full (Strict)
Система совместима с проксированием Cloudflare (включен "оранжевое облако").
Cloudflare обрабатывает SSL на внешнем уровне (edge), а сервер предоставляет сертификат источника (origin).

Управление доменами

Обновление SSL

SSL-сертификаты от Let's Encrypt истекают каждые 90 дней. Вы можете обновить их из панели управления:

Перейдите в Settings → Custom Domain.
Нажмите Renew SSL.

Автоматическое продление настраивается во время установки, но вы можете запустить обновление вручную в любое время.

Удаление домена

Перейдите в Settings → Custom Domain.
Нажмите Remove.
Конфигурация Nginx и SSL-сертификат будут удалены.
Доступ к боту вернется к формату IP:порт.

Код виджета после настройки домена

Как только ваш пользовательский домен станет активным, обновите код вставки виджета:

<script 
  src="https://bot.yourdomain.com/chatbot-widget/v1/js/loader.js"
  data-bot-id="your-bot-id"
  data-backend-url="https://bot.yourdomain.com"
  async>
</script>

Используйте динамическую страницу вставки

Перейдите в Dashboard → Embed после добавления пользовательского домена — сгенерированный код вставки автоматически будет использовать новый домен. Никаких ручных изменений URL не требуется.

FAQ (Часто задаваемые вопросы)

В: Проверка DNS не удается.

Подождите 5–30 минут для распространения DNS.
Убедитесь, что A-запись указывает на правильный IP-адрес, используя панель управления вашего DNS-провайдера.
Если проблема не решена, свяжитесь с вашим аккаунт-менеджером.

В: HTTPS не работает.

Попробуйте обновить SSL в разделе Settings → Custom Domain.
Если используете Cloudflare, убедитесь, что режим SSL установлен на Full (Strict).
Свяжитесь с вашим аккаунт-менеджером, если проблема сохраняется.

В: Могу ли я использовать несколько пользовательских доменов?

В настоящее время поддерживается один пользовательский домен на сервер. Для использования нескольких доменов свяжитесь с вашим аккаунт-менеджером.

В: Будет ли мой старый URL (IP:порт) работать?

Да. Добавление пользовательского домена не отключает прямой доступ по IP. Оба метода работают одновременно.