Ticketix の多くの処理は、1つのスケジュールタスク scripts/cron.php によってバックグラウンドで実行されます。これがないと、メールの取得やキューからの送信が行われず、SLA アラートや遅延ルールも実行されず、スケジュールされたレポートやリマインダーも送信されません。
スケジュールタスクの処理内容
php scripts/cron.php は実行のたびに次の処理を行います。
- メインのメールボックスと、セットアップ → メール → メールボックス で追加したすべてのメールボックスから、IMAP で新着メールを取得する
- 取得したメールをチケットや返信に変換する
- キューにある送信メールを送信し、自動トリアージやチケット分析などキューにある AI 処理を含むバックグラウンドジョブを実行する
- SLA ステータスを更新し、SLA アラートを送信し、非アクティブ時および遅延のワークフロールールを実行する
- 期限が来たスケジュールレポートを実行する
- スケジュールされたナレッジベース記事を公開・アーカイブする
- 新規および変更された記事、コミュニティのトピックと返信を検索インデックスに書き込み、ポータル検索、チケットフォームの候補、Ctrl K で見つかるようにします(バージョン 2.3.1 以降)。
- リマインダー日時が来たスタッフメモのリマインダーを、メモごとに1回送信する
- 週に1回、過去7日間のコンテンツギャップを、管理者が選択したスタッフにメールで送信する(ギャップがない週は送信されません)
- AI 割り当ての品質ゲートを確認する
- レビュー待ち または 回答済み のまま7日間更新がないチケットをクローズする(
config.phpのauto_close_days)。顧客には評価リンク付きの チケットのクローズ メールが届きます - 12時間ごとに ARN で Ticketix の更新を確認する。必須の更新は自動でインストールされます(バージョン 2.0.2 以降)。
各実行はバッチ単位で処理するため、大量の未処理分は複数回の実行で処理されます。バックグラウンドの AI 処理は、1リクエストあたり最大120秒かかる場合があります。
タスクを追加する
アプリケーションフォルダーから PHP コマンドラインインターフェースでスクリプトを実行します。多くのホスティングでは、コントロールパネル(例:cPanel の Cron Jobs)またはサイトユーザーの crontab に追加します。
5分ごとに実行する crontab エントリの例:
*/5 * * * * cd /path/to/ticketix && php scripts/cron.php > /dev/null 2>&1
/path/to/ticketixをアプリケーションフォルダーに置き換えます。- サイト用に選択した PHP バージョン(8.3 以降)の PHP バイナリを使用します。ホスティングによってはフルパスが必要です(例:
/usr/local/bin/php)。 - メールの量に合った間隔を選択してください。メールと SLA アラートは、最後の実行時点の情報までしか反映されません。
scripts フォルダーはウェブからアクセスできません。タスクはウェブアドレスではなく、コマンドラインから実行してください。
実行されていることを確認する
- サーバーのターミナルでコマンドを一度手動で実行します:
cd /path/to/ticketix && php scripts/cron.php。 - スクリプトは
"ok": trueと各ステップの結果(例:imap_fetch、outbound_dispatch、ticket_maintenance)を含む JSON の概要を出力します。 - Ticketix で セットアップ → システム → ツール を開き、ログ パネルで
cronログを選択します。実行ごとに各ステップの行が記録されます。
概要に "ok": false と表示された場合は、失敗したステップにエラー(例:IMAP パスワードの誤り)が含まれています。
ダッシュボードの メール カードにはスケジュールタスクの最終実行日時が表示され、1日実行されていない場合は お知らせ 画面に警告が表示されます(バージョン 2.0.2 以降)。
注意: ライセンスが有効でない間、スケジュールタスクは「Ticketix license activation is required.」と表示して停止します。先にライセンスを有効化してください。Ticketix ライセンスを有効化するをご覧ください。
更新中の動作
お知らせ 画面からの更新では、特に操作は必要ありません。Ticketix が新しいファイルを書き込んでいる間、スケジュールタスクは実行をスキップします。手動で更新する場合はスケジュールタスクを停止し、更新が完了したら再度有効にしてください。Ticketix を更新するをご覧ください。