本カスタマイズガイドについて

本書に記載している内容は、当社の提供する「autobahn for Salesforce」についてのカスタマイズガイドとなります。 本書を利用することにより、当社の提供する Visualforce ページを利用することなく、配信を行うことが可能となります。

注意事項

• 本書は autobahn for Salesforce の正常な動作を保証するものではありません。また、当社サポート対象外であることもご留意ください。
• 本書は autobahn for Salesforce（autobahn for AppExchange） のバージョン 2.9 を対象とした資料となっています。
• Apexクラスの設定内には、VersionSettingsタブ画面にautobahn for Salesforceのバージョンを指定できる設定欄があり、その設定によってバージョンが固定される場合があるのでご注意ください。古いバージョンで作成されたレコードは、autobahn for Salesforceサーバへ連携する際も古いバージョンでの扱いとなるため、配信がエラーとなることがございます。

配信までの流れについて

接続設定が済んでいることが前提です。

事前に「メール文面設定 Ver2」「抽出条件設定 Ver2」オブジェクトのレコードが必要となります。 上記2点のレコードを用いて、「メール配信設定 Ver2」オブジェクトレコードを作成することにより、配信が行われます。

各オブジェクトの詳細

配信に利用するオブジェクトの内、最低限必要なオブジェクト及び項目についての詳細を記載します。

本書で説明していないオブジェクトや項目については、配信には直接関係しません。 確認したい場合は、オブジェクトマネージャから、プレフィックスが「TRC_ABAE」のオブジェクトを参照してください。

メール文面設定

概要

メール文面を設定するオブジェクトです。

オブジェクト定義

項目定義

• ※1 メールアドレス形式とは、Apex コードでの正規表現「^[-+.!#$%&/'^{}\'~?|=\w]{1,64}@[-a-zA-Z0-9]{1,63}(\.[-a-zA-Z0-9]{1,63})\.[a-zA-Z]{1,63}$`」に合致している文字列であること。
• ※2 差込記号とは、「{{オブジェクトの API 参照名.項目の API 参照名（.項目の API 参照名）}}」といった形式であること。（例：「{{Lead.Owner.Email}}」）

抽出条件設定

概要

配信対象を設定するオブジェクトです。

オブジェクト定義

項目定義

• ※1 オブジェクトの API 参照名とは、「オブジェクトの API 参照名」といった形式であること。（例：「Lead」）
• ※2 項目の API 参照名とは、「オブジェクトの API 参照名.項目の API 参照名（.項目の API 参照名）」といった形式であること。（例：「Lead.Email」）

メール配信設定

概要

配信対象を設定するオブジェクトです。 配信処理開始後に当該レコードの更新は行わないでください。

オブジェクト定義

項目定義

各 JSON オブジェクトの詳細

トラッキング設定オブジェクト

文面（「テキストパート」項目、「HTMLパート」項目）中に存在する URL をトラッキングする場合の設定情報です。 「リアクション設定オブジェクト」の配列である必要があります。 各リアクション設定オブジェクトは、最大で100個までである必要があります。

サンプル

[
    {
        "Url":"<https://www.tricorn.co.jp/>",
        "AddTrackingLog":true,
        "AddHistory":true,
        "UpdateRecord":null
    },
    {
        "Url":"<https://www.tricorn.co.jp/service/>",
        "AddTrackingLog":true,
        "AddHistory":true,
        "UpdateRecord":{
            "Column":"Lead.TrackingCount__c",
            "Value":"+1"
        }
    }
]

リアクション設定オブジェクト

個々のトラッキングや開封履歴の設定情報です。

サンプル

{
    "Url":"<https://www.tricorn.co.jp/service/>",
    "AddTrackingLog":true,
    "AddHistory":true,
    "UpdateRecord":{
        "Column":"Lead.TrackingCount__c",
        "Value":"+1"
    }
}

リアクション設定値の更新オブジェクト

配信対象レコードの項目を更新する場合の設定情報です。

サンプル

{
    "Column":"Lead.TrackingCount__c",
    "Value":"+1"
}

抽出条件設定オブジェクト

詳細画面上で各条件を表示したり、配信対象者リスト画面で件数やリストを出すため設定情報です。 配信処理時の抽出には使われないため、ご注意ください。 「条件設定オブジェクト」の配列である必要があります。 各条件設定オブジェクトの Index 要素はユニークかつ 1 からの連番である必要があります。 各条件設定オブジェクトは、最大で10個までである必要があります。

サンプル

[
    {
        "Index":1,
        "Column":"Lead.Email",
        "Operator":"Contain",
        "Value":"@tricorn.co.jp"
    },
    {
        "Index":2,
        "Column":"Lead.HasOptedOutOfEmail",
        "Operator":"Equal",
        "Value":"false"
    }
]

条件設定オブジェクト

個々の条件の設定情報です。

サンプル

{
    "Index":1,
    "Column":"Lead.Email",
    "Operator":"Contain",
    "Value":"@tricorn.co.jp"
}

APEX Batch からメール配信設定を作成する場合について

基本的には、メール配信設定オブジェクトではレコード登録時にパッケージがautobahn for Salesforceのサーバにコールアウトしますが、APEX Batchの場合は後述の内容を参考にコールアウトを行ってください。

• insert/update を行うたびにコールアウトが必要となります。
  • insert 時に TRC_ABAE__RequestData__c 項目に保存されるデータのコールアウトを行わず、その後の update 時の TRC_ABAE__RequestData__c 項目に保存されるデータのコールアウトを行った場合、レスポンスは 200 を返しますが配信は行われません。
    • ABAE では非同期で配信情報の管理を行っており、insert の配信情報が存在しない状態で update の配信情報を受け取った場合、不正なリクエストとして破棄しています。
  • 配信日時の変更を伴った update 時にコールアウトを行わないと、元の配信日時の時間になった際に配信処理を行いますのでご注意ください。
• TRC_ABAE__RequestData__c 項目に値が入っている場合は TRC_ABAE__RequestData__c 項目の更新が行われないため、insert/update 時に TRC_ABAE__RequestData__c 項目を空にしてください。　insert 時は特に意識する必要はありませんが、update 時には明示的に当該項目の値を空にしてから update をお願いします。

コールアウトに必要な情報が保存されている項目

TRC_ABAE__RequestData__c 項目に保存される JSON の形式

例：

{
    "Endpoint": "<https://webhook.autobahn-app.net/v1/Schedules>",
    "Method": "POST",
    "Headers": [
        {
            "Field": "Content-Type",
            "Value": "application/json; charset=UTF-8"
        },
        {
            "Field": "X-Service-Source",
            "Value": "salesforce"
        },
        {
            "Field": "Authorization",
            "Value": "Bearer aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        }
    ],
    "Body": "{\\"DeliveryType\\":\\"bulk\\",\\"PackageVersion\\":2.9,\\"ScheduleId\\":\\"a00000000000000000\\",\\"Action\\":\\"create\\",\\"IsMergeable\\":false,\\"DeliveryDateTime\\":\\"2022-08-23T12:00:00+0900\\",\\"Owner\\":{\\"Id\\":\\"a00000000000000000\\",\\"Email\\":\\"test@example.com\\",\\"Language\\":\\"ja\\"},\\"Time\\":1661223600000,\\"Verify\\":\\"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\\"}"
}

Header

例：

{
    "Field": "Content-Type",
    "Value": "application/json; charset=UTF-8"
}

APEX コードのサンプル

TRC_ABAE__Schedule__c schedule = [SELECT id, TRC_ABAE__RequestData__c FROM TRC_ABAE__Schedule__c WHERE id = '[record id]'];

Map<String, Object> requestData = (Map<String, Object>)JSON.deserializeUntyped(schedule.TRC_ABAE__RequestData__c);
String endpoint                 =  (String)requestData.get('Endpoint');
String method                   =  (String)requestData.get('Method');
Map<String, String> headers     =  new Map<String, String>();
String body                     =  (String)requestData.get('Body');
for (Object header : (List<Object>)requestData.get('Headers')) {
    Map<String, Object> h = (Map<String, Object>)header;
    headers.put((String)h.get('Field'), (String)h.get('Value'));
}

HttpRequest request = new HttpRequest();
request.setEndpoint(endpoint);
request.setTimeout(10000);
request.setMethod(method);
for (String field : headers.keySet()) {
    request.setHeader(field, headers.get(field));
}
request.setBody(body);

Http http = new Http();
response = http.send(request);
System.debug(response.getStatusCode()); // 200

更新 2026年03月31日 15:00