README.ja.md

العربية • Deutsch • English • Español • Français • Italiano • 日本語 • 한국어 • Nederlands • Polski • Português (BR) • Русский • Türkçe • 简体中文

Escalated for WordPress

WordPress向けのフル機能ヘルプデスク・チケットシステム。マルチロール対応、SLAトラッキング、エスカレーションルール、受信メール処理、マクロ、REST APIを備えています。外部サービス不要。

escalated.dev — 詳細、デモの閲覧、Cloud vs セルフホストオプションの比較はこちら。

Screenshots

チケット一覧	チケット詳細

部門	SLAポリシー

レポート	設定

自動化	マクロ

スクリーンショットはリリースごとにPlaywrightで自動生成されます。.github/workflows/screenshots.yml を参照してください。

Download

• 最新プラグインパッケージ: escalated.zip
• 全リリース: Releases

機能

• スレッド形式の会話、内部メモ、アクティビティタイムラインを備えたチケット管理。
• カスタムサポートロール: escalated_admin と escalated_agent。
• 部門ベースのルーティングと割り当てワークフロー。
• 初回応答と解決目標を持つSLAポリシー。
• 自動エスカレーションルールとスケジュールされたSLAチェック。
• ショートコードによる顧客向けフロントエンドチケットページ。
• ゲストチケット送信と安全なゲストチケットアクセス。
• Mailgun、Postmark、Amazon SESのWebhookによる受信メール取り込み。
• 定型応答、マクロ、タグ管理。
• トークンごとの権限とレート制限を備えたBearerトークンREST API。
• 設定可能なアップロード制限付きの添付ファイルサポート。
• 満足度評価とレポートビュー。

要件

• WordPress 6.0+
• PHP 8.1+

インストール

1. このプラグインをWordPressのプラグインディレクトリに配置します:
   • wp-content/plugins/escalated
2. WordPressのプラグイン画面から Escalated を有効化します。
3. wp-adminで Escalated に移動し、以下を設定します:
   • 部門
   • SLAポリシー
   • エスカレーションルール
   • 設定

フロントエンドショートコード

WordPressページでこれらのショートコードを使用します:

• [escalated_tickets] - ログイン済みリクエスターのチケット一覧。
• [escalated_create_ticket] - ログイン済みリクエスターの新規チケットフォーム。
• [escalated_view_ticket] - チケット詳細ビュー:
  • ログインユーザー: ?ticket=ESC-123 を期待
  • ゲスト: ?guest_token=<token> を期待
• [escalated_guest_create] - ゲストチケット作成フォーム（設定で有効な場合）。

REST API

• Namespace: /wp-json/escalated/v1
• 認証: Authorization: Bearer <api-token>
• デフォルトレート制限: トークンあたり 60 リクエスト/分（api_rate_limit 設定で変更可能）

主要ルートグループ:

• /auth/validate
• /tickets
• /departments
• /tags
• /canned-responses
• /macros
• /agents
• /dashboard
• /admin/api-tokens

受信メールWebhook

受信ルートパターン:

• POST /wp-json/escalated/v1/inbound/{adapter}

対応アダプター:

• mailgun
• postmark
• ses

スケジュールタスク (WP-Cron)

有効化時に、Escalatedは以下をスケジュールします:

• escalated_check_sla（毎分）
• escalated_evaluate_escalations（5分ごと）
• escalated_auto_close（毎日）
• escalated_purge_activities（毎週）

開発

依存関係のインストール:

composer install

テストの実行（WordPressテストスイートが必要）:

vendor/bin/phpunit -c phpunit.xml.dist

必要に応じて、PHPUnitを実行する前に WP_TESTS_DIR をローカルのWordPressテストライブラリパスに設定してください。

他のフレームワーク向け

• Escalated for Laravel — Laravel Composerパッケージ
• Escalated for Rails — Ruby on Rails Engine
• Escalated for Django — Django再利用可能アプリ
• Escalated for AdonisJS — AdonisJS v6パッケージ
• Escalated for Filament — Filament v3管理パネルプラグイン
• Escalated for WordPress — WordPressプラグイン（現在のページ）
• Shared Frontend — Vue 3 + Inertia.js UIコンポーネント

ライセンス

MIT