お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

以下は、Catalyst SignalsにおけるZoho CRMサービスのLeads Createdイベントのサンプルイベントペイロードです。

サンプルイベントペイロード

Sample Event Payload
copy
{
  "rule_id": "123456789",
  "target_id": "98765432",
  "version": 1,
  "attempt": 1,
  "account": {
    "org_id": "85512289",
    "project": {
      "environment": "DEVELOPMENT",
      "name": "crm",
      "id": "10666000000021013"
    }
  },
  "events": [
    {
      "data": {
        "Owner": {
          "name": "Owner name",
          "id": "9876543210",
          "zuid": "654321"
        },
        "Company": "Company",
        "Email": "test@zoho.com",
        "Lead_Status_Prediction": "value of picklist",
        "Last_Activity_Time": "2024-01-01T12:00:00+00:00",
        "Industry": "value of picklist",
        "Unsubscribed_Mode": "value of picklist",
        "Street": "Street",
        "Zip_Code": "Zip Code",
        "id": 9876543210,
        "Data_Source": "value of picklist",
        "Enrich_Status__s": "value of picklist",
        "Created_Time": "2024-01-01T12:00:00+00:00",
        "Change_Log_Time__s": "2024-01-01T12:00:00+00:00",
        "City": "City",
        "No_of_Employees": 1,
        "Data_Processing_Basis": "value of picklist",
        "Converted__s": true,
        "Converted_Date_Time": "2024-01-01T12:00:00+00:00",
        "Converted_Account": {
          "name": "lookup name",
          "id": "9876543210"
        },
        "State": "State",
        "Country": "Country",
        "Created_By": {
          "name": "Owner name",
          "id": "9876543210",
          "zuid": "654321"
        },
        "Annual_Revenue": 100,
        "Secondary_Email": "test@zoho.com",
        "Description": "Description",
        "Rating": "value of picklist",
        "Website": "https://catalyst.zoho.com",
        "Twitter": "Twitter",
        "Salutation": "value of picklist",
        "First_Name": "First Name",
        "Full_Name": "Full Name",
        "Lead_Status": "value of picklist",
        "Modified_By": {
          "name": "Owner name",
          "id": "9876543210"
        },
        "Lead_Conversion_Time": 1,
        "Skype_ID": "Skype ID",
        "Phone": 9876543210,
        "Email_Opt_Out": true,
        "Designation": "Designation",
        "Modified_Time": "2024-01-01T12:00:00+00:00",
        "Lead_Status_Prediction_Score": 1,
        "Unsubscribed_Time": "2024-01-01T12:00:00+00:00",
        "Converted_Contact": {
          "name": "lookup name",
          "id": "9876543210"
        },
        "Mobile": 9876543210,
        "Last_Name": "Last Name",
        "Locked__s": true,
        "Lead_Source": "value of picklist",
        "Tag": "Tag",
        "Fax": "Fax",
        "Last_Enriched_Time__s": "2024-01-01T12:00:00+00:00"
      },
      "id": "c6b53699-94b1-48a1-86fd-80b8d4778e28",
      "time_in_ms": 1718780819204,
      "source": "publisher_id:10666000000021074/service:zohocrm/account:73756307",
      "event_config": {
        "api_name": "Leads Created",
        "id": "10666000000021075"
      }
    }
  ]
}
View more

このサンプルイベントペイロードを使用して、ターゲットで最もよく使用される2つの変換パターンを説明します。

シナリオ1: シンプルな変換

配列内の特定のインデックスのオブジェクトに対して、新しいキーと値のペアの追加と既存のものの変更という基本的な変換を行います。

新しいペイロード要件

  • イベントID、リードID、メールなど既存のキーを保持する。
  • この**“is_transformed”: true**という新しいキーと値のペアを追加する。
  • リードのフルネームをNameという別のキーで保持する。

期待されるイベントペイロード

Expected Event Payload
copy
{
    "id" : 9876543210,
    "name" : "Full Name",
    "email" : "test@zoho.com",
    "event_id" : "c6b53699-94b1-48a1-86fd-80b8d4778e28",
    "is_transformed" : true
}
View more
  1. JSONオブジェクトを開き、「id」キーを追加して、値の代わりにサンプルイベントペイロード内の対応するキーのJSONパスを提供します。「email」と「event_id」キーについても同じ手順を繰り返します。

Simple transformation of an event body

  1. name」キーには、サンプルイベントペイロード内のFull_NameキーのJSONパスを提供します。最後に、この**“is_transformed”: true**の静的なキーと値のペアを追加して、このペイロードが特定のイベント用に設定されたオーケストレーションに合わせて変換されたことを示します。

Simple transformation of an event body

以下のテンプレートコンパイラをコピーして貼り付け、Zoho CRMサービスのLead Createdイベントのペイロードの即時変換を確認することもできます。

Template Compiler
copy
{
  "id" : $.events[0].data.id,
  "name" : $.events[0].data.Full_Name,
  "email" : $.events[0].data.Email,
  "event_id" : $.events[0].id,
  "is_transformed" : true
}
View more
Note: これはevents配列の最初のインデックスのJSONオブジェクトにのみ適用されます。


シナリオ2: 複雑な変換

上記のシナリオで確認した要件と同じですが、特定のインデックスのオブジェクトではなく、events配列内のすべてのJSONオブジェクトに変換を適用する必要があります。

新しいペイロード要件

  • dataというJSONオブジェクトの配列を持つ。
  • 配列内の各JSONオブジェクトに、前のシナリオで変換したid、name、email、event_idキーを含める。
  • この**“is_transformed”: true**の新しいキーと値のペアを追加する。

期待されるイベントペイロード

Expected Event Payload
copy
{
    "data" : [
        {
            "id" : 9876543210,
            "name" : "Full Name",
            "email" : "test@zoho.com",
            "event_id" : "c6b53699-94b1-48a1-86fd-80b8d4778e28"
        }
    ],
    "is_transformed" : true
}
View more
  1. 配列を作成するには、dataキーでJSONオブジェクトを開きます。サンプルペイロードのevents配列のJSONパスを提供し、値の代わりにこの**forEach((var{n})->{JSON_path_of_desired_key} )**構文をデプロイします。varを変数名に置き換えてください。

Complex transformation of an event body

  1. この配列のオブジェクト内に含めたいキーの名前(id、name、email、event_id)を入力します。値の代わりに、**$**記号なしで特定の配列から対応するキーのJSONパスを提供します。

Complex transformation of an event body

これにより、インデックス0から始まる各オブジェクトを反復処理し、リード名、ID、メールを含むオブジェクトの配列を生成します。

  1. この**“is_transformed”: true**の静的なキーと値のペアを追加して、このペイロードが特定のイベント用に設定されたオーケストレーションに合わせて変換されたことを示します。

Complex transformation of an event body

この変換をステップバイステップで練習するか、以下のテンプレートコンパイラをコピーして貼り付け、Zoho CRMサービスのLead Createdイベントのペイロードの即時変換を確認できます。

Template Compiler
copy
{
    "data" : $.events.forEach((array) ->
        {
            "id" : array.data.id,
           "name" : array.data.Full_Name,
           "email" : array.data.Email,
           "event_id" : array.id
        }
    ),
    "is_transformed" : true
}
View more

最終更新日 2026-03-05 11:43:24 +0530 IST