Реалтайм и вещание

Настройки → Дополнительно → Реалтайм настраивает слой WebSocket-вещания, обеспечивающий живые обновления в панели администратора LeadHub.

При включённом реалтайме:

• Виджет Живая лента лидов на дашборде обновляется мгновенно при поступлении нового лида
• Значки уведомлений появляются без обновления страницы
• Канбан-доска отражает изменения перетаскивания другими членами команды в реальном времени

При отключённом реалтайме панель переходит на опрос (обновление страницы каждые 30 секунд).

---

Поддерживаемые драйверы

Драйвер	Облачный?	Стоимость	Примечания
Pusher	✅ Облако	Есть бесплатный тариф	Наиболее популярный, простейшая настройка
Laravel Reverb	❌ Самостоятельный	Бесплатно (только расходы на сервер)	Официальный WebSocket-сервер Laravel
Soketi	❌ Самостоятельный	Бесплатно (только расходы на сервер)	Легковесный Pusher-совместимый сервер
Отключён (опрос)	—	Бесплатно	Без WebSocket; панель опрашивает сервер

Виртуальный хостинг: Pusher — самый простой вариант. Самостоятельные Reverb/Soketi требуют VPS с постоянными процессами.

---

Вариант А — Pusher (Облачный)

Шаг 1 — Создание приложения Pusher

1. Зарегистрируйтесь на pusher.com (бесплатный тариф: 200 подключений, 200 тыс. сообщений/день).
2. Перейдите в Channels → Create App.
3. Дайте имя (например, LeadHub) и выберите регион.
4. В разделе App Keys скопируйте:
   • App ID
   • Key
   • Secret
   • Cluster (например, us2, eu)

Шаг 2 — Настройка в LeadHub

1. Перейдите в Настройки → Дополнительно → Реалтайм.

2. Установите Драйвер на Pusher / Soketi / Reverb (Pusher Protocol).

3. Заполните:

   Поле	Значение
   Включить обновления в реальном времени	Включить переключатель
   App ID	Из ключей Pusher
   App Key	Из ключей Pusher
   App Secret	Из ключей Pusher
   Cluster	Ваш кластер Pusher (например, us2)
   Custom Host	Оставьте пустым (облако Pusher)
   Port	443
   Scheme	HTTPS

4. Нажмите Сохранить настройки.

---

Вариант Б — Laravel Reverb (Самостоятельный)

Reverb — официальный WebSocket-сервер Laravel с использованием протокола Pusher.

Шаг 1 — Установка Reverb

На вашем сервере:

php artisan reverb:install

Запуск Reverb через Supervisor:

[program:reverb]
command=php /var/www/leadhub/artisan reverb:start --host=0.0.0.0 --port=8080
autostart=true
autorestart=true
user=www-data

Шаг 2 — Настройка в LeadHub

Заполните поля: App ID, App Key, App Secret (любые строки), Cluster (пусто), Custom Host (имя хоста сервера), Port (8080), Scheme (HTTPS или HTTP).

---

Вариант В — Soketi (Самостоятельный, лёгкий)

npm install -g @soketi/soketi
soketi start --config.port=6001 --config.appManager.driver=array \
  --config.appManager.array.apps.0.id=leadhub \
  --config.appManager.array.apps.0.key=leadhub-key \
  --config.appManager.array.apps.0.secret=leadhub-secret

Заполните в LeadHub: App ID leadhub, App Key leadhub-key, App Secret leadhub-secret, Custom Host (ваш сервер), Port 6001.

---

Вариант Г — Отключить реалтайм (только опрос)

1. Перейдите в Настройки → Дополнительно → Реалтайм.
2. Отключите Включить обновления в реальном времени или установите Драйвер на Отключён (только опрос).
3. Нажмите Сохранить настройки.

---

Устранение неполадок

Проблема	Решение
Живая лента лидов не обновляется	Проверьте совпадение App Key/Secret с конфигурацией Pusher/Reverb/Soketi
Ошибки WebSocket-подключения в консоли браузера	Проверьте настройки Custom Host, Port и Scheme
Reverb/Soketi не подключается	Убедитесь, что процесс запущен и порт доступен (правила брандмауэра)
«Перезапустите воркер очереди после смены драйвера»	После изменения драйвера вещания перезапустите воркер очереди

После изменения настроек реалтайма необходимо жёсткое обновление браузера (Ctrl+Shift+R) для применения новых настроек во фронтенде.