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

キューとワーカー

設定 → 詳細設定 → キューとワーカーでは、LeadHubインストールの現在のキュードライバー、接続タイプ、ワーカーステータスを表示します。

キューの役割​

キューはLeadHubの全バックグラウンド処理を行います：

タスクキュー優先度
メール送信（トランザクション、シーケンス）高
リードソースからの受信Webhookの処理高
アウトバウンドインテグレーションAPIの呼び出し（CRM同期、Zapierなど）デフォルト
オートメーションステップの実行（遅延、アクション）デフォルト
レポートとエクスポートの生成低
SMS / WhatsAppメッセージの送信デフォルト

リードが届いたりオートメーションがトリガーされたりすると、アクションは同期実行されずにキューに入れられます。これにより、遅いAPI呼び出しがWebリクエストをブロックすることを防ぎます。

キュードライバー​

ドライバー説明
ファイル（データベース）デフォルト。ジョブはjobsデータベーステーブルに保存されます。Cronジョブによって処理されます。RedisやSupervisorは不要です。
Redisより高速なインメモリキュー。サーバーにRedisとSupervisor（またはHorizon）が必要です。高ボリュームインストールに推奨。
Syncジョブをインプロセスで即座に実行します。テスト環境のみで使用します。本番環境では使用しないでください。

共有ホスティング： LeadHubのデフォルトファイルベースキューはCronジョブを持つ任意の共有ホスティングプランで動作します。Redis、Supervisor、SSHアクセスは不要です。

キューの処理（Cronジョブ）​

キューはサーバーに設定する必要がある単一のCronジョブによって処理されます。

cPanelの共有ホスティング​

  1. cPanelにログイン → Cronジョブ。
  2. スケジュールを毎分（* * * * *）に設定します。
  3. コマンドを以下に設定します： 
    php /home/yourusername/public_html/cron.php >> /dev/null 2>&1
    パスをLeadHubインストールの絶対パスに置き換えてください。

詳細なcPanel手順については共有ホスティングガイドを参照してください。

VPS / 専用サーバー（Linux crontab）​

* * * * * cd /var/www/leadhub && php artisan queue:work --once --max-time=55 >> /dev/null 2>&1

プロセスマネージャー（Supervisor）を使用する場合：

[program:leadhub-worker]
command=php /var/www/leadhub/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data

ワーカーステータスページ​

管理パネルのキューとワーカーページには以下が表示されます：

情報説明
接続現在のキュー接続名（config/queue.phpから）
ドライバー使用中のキュードライバー（database、redis、sync）
HorizonLaravel Horizonがインストールされているか（Redisベースの高度な監視用）

このページは読み取り専用です。キュードライバーを変更するには、.envファイルのQUEUE_CONNECTIONを更新してください。

失敗したジョブ​

キューに入れられたジョブが失敗した場合（例：インテグレーションAPIがエラーを返した場合）、LeadHubは指数バックオフで最大3回再試行します。3回失敗後、ジョブは失敗としてマークされます。

失敗したインテグレーション配信は以下で確認できます：

  • インテグレーション → Webhookログ — アウトバウンドWebhookの失敗
  • インテグレーション → インテグレーション同期ログ — CRM/メールマーケティング同期の失敗

キューの健全性確認​

キューワーカーが正常に動作しているサイン：

  • オートメーションがイベントから数分以内にトリガーされる
  • アウトバウンドインテグレーションがリード到着後すぐに実行される
  • メールシーケンスがスケジュール通りに送信される
  • エクスポートが完了してダウンロード可能になる

キューが動作していないサイン：

  • オートメーションが一切発火しない
  • インテグレーション同期が「保留中」のまま
  • メールが一切送信されない

修正： Cronジョブが設定され実行されているか確認します。cPanel → Cronジョブでエントリが存在し、正しいパスが設定されているか確認します。