Question 1

FreeScoutで空の単一行カスタムフィールドを検出できないワークフロー条件を修正する方法

Accepted Answer

Custom Fields Module をバージョン 1.0.53 以上にアップグレードしてください。このバージョンには、workflow conditions が空の single-line custom fields を正しく評価するようにするバグ修正が含まれています。

Question 2

WooCommerce注文サイドバーにおけるFreeScoutの500エラー「Undefined variable $admin_path」の修正方法

Accepted Answer

このエラーは、WooCommerce orders list view をレンダリングする会話を開くときに発生します。WooCommerce Integration Module を v1.0.16 以降にアップグレードしてください。このバージョンでは、不足していた $admin_path 変数が追加されています。すぐにアップグレードできない場合は、modules/WooCommerce/Resources/views/partials/orders_list.blade.php を編集して $admin_path のデフォルト値を設定（例: $admin_path = $admin_path ?? ''）するか、親ビューから渡してください。

Question 3

1.8.239+にアップデートした後、古いFreeScoutの会話で壊れたインライン画像（403エラー）を修正する方法

Accepted Answer

原因: セキュリティ修正 GHSA-89ww-mfww-5vr6(1.8.239 でリリース)により、添付ファイルの URL トークンが `md5(APP_KEY . id . size)` から SHA-256 に変更されました。古い MD5 トークンを含むインライン画像 URL は `threads.body` に直接保存されているため、現在は `OpenController` での検証に失敗し、403 が返されます。修正方法: 1) マイグレーション PR #5734 を適用します。これはアプリの更新時に `threads.body`、`threads.body_original`、`mailboxes.signature`、`saved_replies.text` 内のレガシートークンを書き換えます(テスト済み: 約 10,500 件のリンクを 3 秒で更新)。2) あるいは、issue スレッドにあるコミュニティスクリプト `freescout_bulk_token_repair.php` を実行します。まずデータベースをバックアップし、スクリプトを FreeScout ディレクトリに配置してから、`php freescout_bulk_token_repair.php dry-run`、`php freescout_bulk_token_repair.php test`(最初の 250 スレッド)を実行し、最後に本実行を行います。あるユーザーでは、34,646 スレッドにまたがる 96,039 件の画像参照が修復されました。どちらの方法も MD5 トークンを無効のまま維持するため、セキュリティ修正は保持されます。

Question 4

FreeScoutの自動ワークフローがカスタムフィールドを設定する際に、2回実行されて重複したメールが送信されるのはなぜですか？

Accepted Answer

これは、Custom Fields モジュールと併用した場合の FreeScout Workflows モジュール(v1.0.98 より前)におけるバグです。ワークフローにカスタムフィールドに関する条件(実行時に依然として真)があり、そのアクションの 1 つが「Set custom field」の場合に発生します。このアクションは custom_field.value_updated イベントを発火させ、実行中のワークフローが処理済みとしてマークされる前に、同じ会話に対して runAutomaticForConversation() を再トリガーします。その結果、「Email the customer」を含むすべてのアクションが 2 回実行されます(顧客は同一のメールを 2 通受け取ります)。修正: Workflows モジュールを v1.0.99 以降に更新してください。注意: v1.0.98 では重複実行は修正されましたが、「Stop processing」が機能しなくなるというリグレッションが導入されました(finally 内の return が performActions() の結果を上書きするため)。そのため、両方の問題を解決する v1.0.99+ へ直接アップグレードしてください。

Question 5

FreeScoutの開封追跡URLでSpamAssassinのLONG_HEX_URI警告が原因でメールがスパムとして扱われる問題を修正する方法

Accepted Answer

FreeScout v1.8.219以降、開封追跡URLでは128文字のSHA-512ハッシュが使用されるようになり、SpamAssassinのLONG_HEX_URIルールがトリガーされてメールがスパムに分類される問題（特にGmail）が発生しました。恒久的な修正は次回リリースで提供されます。回避策として、ハッシュを手動で短縮します。app/Thread.phpのgetOpenTrackingHash()でreturn substr(\Helper::hmacHash(...), 0, 16);に変更し、app/Controllers/OpenController.phpのsetThreadAsRead()で、後方互換性を保つために従来の完全長ハッシュと新しい16文字ハッシュの両方を受け付けるよう調整します。例: $valid = hash_equals(substr($computedHash, 0, 16), substr($incomingHash, 0, 16));。これによりエントロピーは64ビットに減少します（列挙を防ぐには十分以上）が、SpamAssassinのしきい値を下回ります。あるいは、この修正を含むリリースを待つこともできます。

FreeScout

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト