メインコンテンツまでスキップ

リアルタイムとブロードキャスティング

設定 → 詳細設定 → リアルタイムでは、LeadHub管理パネルのライブ更新を駆動するWebSocketブロードキャスティングレイヤーを設定します。

リアルタイムが有効な場合：

  • 新しいリードが届くとダッシュボードのライブリードフィードウィジェットが即座に更新される
  • 通知バッジがページを更新せずに表示される
  • カンバンボードが他のチームメンバーによるドラッグアンドドロップの変更をリアルタイムに反映する

リアルタイムが無効な場合、パネルはポーリング（30秒ごとにページを更新）にフォールバックします。

サポートされているドライバー​

ドライバーホスト型？コスト備考
Pusher✅ クラウド無料プランあり最も人気、最も簡単なセットアップ
Laravel Reverb❌ セルフホスト無料（サーバー費用のみ）公式Laravel WebSocketサーバー
Soketi❌ セルフホスト無料（サーバー費用のみ）軽量なPusher互換サーバー
無効（ポーリング）—無料WebSocketなし；パネルが代わりにポーリング

共有ホスティング： Pusherが最も簡単なオプションです。セルフホストのReverb/Soketiには永続プロセスを持つVPSが必要です。

オプションA — Pusher（ホスト型）​

ステップ1 — Pusherアプリの作成​

  1. pusher.comでサインアップします（無料プラン：200接続、20万メッセージ/日）。
  2. Channels → アプリを作成に移動します。
  3. 名前（例：LeadHub）を付けてリージョンを選択します。
  4. アプリキーで以下をコピーします：
    • アプリID
    • キー
    • シークレット
    • クラスター（例：us2、eu）

ステップ2 — LeadHubで設定​

  1. 設定 → 詳細設定 → リアルタイムに移動します。

  2. ドライバーを**Pusher / Soketi / Reverb（Pusherプロトコル）**に設定します。

  3. 以下を入力します：

    フィールド値
    リアルタイム更新を有効化オンに切り替え
    アプリIDPusherアプリキーからKEY
    アプリキーPusherアプリキーからKEY
    アプリシークレットPusherアプリキーからSECRET
    クラスターPusherクラスター（例：us2）
    カスタムホスト空白のまま（Pusherクラウド）
    ポート443
    スキームHTTPS

  4. 設定を保存をクリックします。

オプションB — Laravel Reverb（セルフホスト）​

ReverbはPusherプロトコルを使用する公式LaravelのWebSocketサーバーです。

ステップ1 — Reverbのインストール​

サーバーで：

php artisan reverb:install

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で設定​

  1. 設定 → 詳細設定 → リアルタイムに移動します。

  2. 以下を入力します：

    フィールド値
    アプリID任意の文字列、例：leadhub-reverb
    アプリキー任意の文字列（Reverb設定と一致する必要あり）
    アプリシークレット任意の文字列（Reverb設定と一致する必要あり）
    クラスター空白のまま
    カスタムホストサーバーのホスト名（例：ws.yourdomain.com）
    ポート8080（またはReverbポート）
    スキームHTTPS（SSLプロキシの背後の場合）またはHTTP

オプションC — Soketi（セルフホスト、軽量）​

SoketiはNode.jsの軽量なPusher互換サーバーです。

ステップ1 — 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

ステップ2 — LeadHubで設定​

フィールド値
アプリIDleadhub（SoketiアプリID）
アプリキーleadhub-key
アプリシークレットleadhub-secret
カスタムホストサーバーのホスト名
ポート6001
スキームHTTPSまたはHTTP

オプションD — リアルタイムを無効化（ポーリング）​

  1. 設定 → 詳細設定 → リアルタイムに移動します。
  2. リアルタイム更新を有効化をオフにするか、ドライバーを**無効（ポーリングのみ）**に設定します。
  3. 設定を保存をクリックします。

パネルは30秒ごとに更新されます。ライブ更新はありませんが、全機能は正常に動作します。

トラブルシューティング​

問題解決策
ライブリードフィードが更新されないアプリキー/シークレットがPusher/Reverb/Soketiの設定と一致しているか確認する
ブラウザコンソールでWebSocket接続エラーカスタムホスト、ポート、スキームの設定を確認する
Reverb/Soketiが接続されないプロセスが実行されポートにアクセス可能か確認（ファイアウォールルール）
「ドライバーを変更したらキューワーカーを再起動してください」ブロードキャスティングドライバーを変更した場合、キューワーカープロセスを再起動する

リアルタイム設定を変更した後、フロントエンドで新しい設定を有効にするにはハードブラウザリフレッシュ（Ctrl+Shift+R）が必要です。