【Salesforce】メールサービスを使用してメール受信時にケースを作成する

1.背景

Salesforceがメールを受信したときに自動的にケースを作成する方法としてはメール-to-ケースを使用するのが多いと思いますが、今回はメールサービスを使用してApexクラスで作成するやり方を記載します。

2.Apexクラスの作成

メール受信時に動かすApexクラスを作成します。

今回は以下のようなクラスをCopilotに作ってもらいました。

public with sharing class EmailToCaseHandler implements Messaging.InboundEmailHandler {
    public Messaging.InboundEmailResult handleInboundEmail(Messaging.InboundEmail email, Messaging.InboundEnvelope envelope) {
        // 結果オブジェクトを初期化
        Messaging.InboundEmailResult result = new Messaging.InboundEmailResult();
        
        try {
            // 新しいケースを作成
            Case newCase = new Case();
            newCase.Subject = email.subject != null ? email.subject : '（無題）';
            newCase.Description = email.plainTextBody;
            newCase.Status = '新規';
            newCase.Origin = 'Email';
            newCase.SuppliedEmail = envelope.fromAddress;
            newCase.SuppliedName = email.fromName;
            
            // ケースを保存
            if (Schema.sObjectType.Case.isCreateable()) {
                insert newCase;
            }else{
                System.debug('ユーザーにはケースを作成する権限がありません。');
            }
            // 添付ファイルを格納するリストを初期化
            List<Attachment> attachmentList = new List<Attachment>();
            
            // 添付ファイルが存在する場合の処理
            if (email.binaryAttachments != null && email.binaryAttachments.size() > 0) {
                // 添付ファイル作成の権限チェック（ループの外で一度だけ実行）
                if (Schema.sObjectType.Attachment.isCreateable()) {
                    for (Messaging.InboundEmail.BinaryAttachment attachment : email.binaryAttachments) {
                        Attachment att = new Attachment();
                        att.ParentId = newCase.Id;
                        att.Name = attachment.fileName;
                        att.Body = attachment.body;
                        // リストに追加
                        attachmentList.add(att);
                    }
                    // ループ外で一括挿入
                    insert attachmentList;
                } else {
                    System.debug('ユーザーには添付ファイルを作成する権限がありません。');
                }
            }
            
            // 処理が成功したことを設定
            result.success = true;
        } catch (Exception e) {
            // エラーログの出力
            System.debug('エラーが発生しました: ' + e.getMessage());
            result.success = false;
            result.message = 'ケース作成中にエラーが発生しました。';
        }
        
        return result;
    }
}