FreeScout 中实现动态设置邮件发件人名称的技术方案

背景介绍

在邮件客服系统FreeScout中，管理员经常需要根据不同场景灵活设置邮件的发件人名称。系统默认情况下，发件人名称是由邮箱设置决定的，这在实际业务中可能无法满足所有需求。例如，客服人员可能希望在某些情况下使用个人姓名作为发件人，而在其他情况下使用团队或公司名称。

技术挑战

FreeScout的核心代码中，发件人名称(From Name)是在ReplyToCustomer.php文件中通过SwiftMailer设置邮件头时确定的。当前系统架构没有提供钩子(hook)或过滤器(filter)来动态修改这一设置，导致无法实现按需调整发件人名称的功能。

解决方案设计

1. 前端界面增强

首先需要在回复编辑器中添加一个选择控件，让客服人员可以方便地选择发件人身份。通过FreeScout现有的conv_editor.editor_toolbar_prepend动作钩子，可以在编辑器工具栏前插入一个下拉选择框：

\Eventy::addAction('conv_editor.editor_toolbar_prepend', function($conversation) {
    $userInfo = auth()->user();
    $mailboxEmail = $conversation->email;
    $userFullName = $userInfo->first_name . ' ' . $userInfo->last_name;
    echo '<div class="btn-group" style="margin-right:8px;">
        <span class="editor-btn-text" style="margin-right:4px;">发件人:</span>
        <select id="fromNameSelect" class="form-control parsley-exclude" style="width:auto;display:inline-block;">
            <option value="user">' . htmlspecialchars($userFullName . ' from ' . Option::getCompanyName()) . '</option>
            <option value="mailbox">' . htmlspecialchars($mailboxEmail) . '</option>
        </select>
    </div>';
});

2. 后端逻辑扩展

核心修改是在ReplyToCustomer.php文件中添加事件过滤器，允许模块在邮件发送前动态修改发件人信息。具体实现是在SwiftMailer设置邮件头的闭包中添加过滤器：

$from_alias_name = \Eventy::filter('email.reply_to_customer.from_name', $from_alias_name, $thread, $mailbox);

3. 完整功能实现

1. 前端交互：通过JavaScript捕获用户在下拉框中的选择，并将选择的值随表单一起提交
2. 数据处理：在后端处理回复请求时，根据用户选择的值确定发件人名称格式
3. 邮件发送：通过新添加的过滤器应用自定义的发件人名称

技术优势

1. 非侵入式修改：通过事件系统扩展功能，无需直接修改核心代码
2. 灵活扩展：过滤器设计允许其他模块进一步修改发件人名称
3. 兼容性强：方案同时适用于回复邮件和新建会话场景
4. 维护性好：遵循FreeScout的插件化架构思想

实现建议

1. 对于企业部署，建议将此功能封装为独立模块
2. 可考虑将发件人选项存储在数据库配置表中，支持更多自定义选项
3. 对于大型团队，可以增加基于权限的发件人名称控制
4. 建议添加日志记录功能，跟踪发件人名称的修改历史

总结

通过在FreeScout中合理利用事件系统添加发件人名称过滤器，可以有效解决邮件发送身份灵活配置的需求。这种实现方式既保持了系统的稳定性，又提供了足够的扩展性，是FreeScout平台功能扩展的典范做法。