ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Webhookペイロードリファレンス

Liferay Data Platform 2026年第2四半期以降

このリファレンスでは、Liferay Data Platform (LDP) が Demandbase、HubSpot、および Marketo から受け入れる Webhook ペイロードのフィールドについて説明します。各ソースは、必須項目で更新するプロファイルを識別します。 Demandbaseは独自のスキーマからアカウントデータを送信する一方、HubSpotとMarketoはユーザーが定義したカスタムイベントを送信します。

エンドポイントと配信

各Webhookデータソースは、LDPに追加する際に独自のエンドポイントURLを生成します。 LDPが表示する値をコピーして、自分でURLを構築しないでください。エンドポイントは、 POST リクエストを Content-Type が application/jsonで受け入れ、 Authorization: Bearer <token> ヘッダーで LDP 提供トークンを使用して認証します。

エンドポイント URL とトークンを生成するには、 Demandbase、 HubSpot、または Marketo のセットアップ手順に従ってください。

データソース	エンドポイントパス
デマンドベース	`/api/demandbase_accounts`
HubSpot	`/api/hubspot_webhooks`
Marketoイベントストリーム	`/api/marketo_webhooks`

重要

LDP は応答を検査せずにペイロードを取り込みサービスに転送し、受け入れたすべてのリクエストに対して 200 OK を返します。応答が成功したということは、データが送信されたことを確認するものであり、取り込まれたことを確認するものではありません。そのため、送信前にペイロードの妥当性を検証してください。イベントが着地していることを確認するには、個人またはアカウントの アクティビティ タブを確認してください。

Demandbaseアカウントフィールド

Demandbaseは、Webhookを介してアカウントデータと企業属性データをLDPに送信し、LDPはそれを統合されたアカウントプロファイルにマッピングします。 Demandbaseは、統合の設定時に選択した独自のアカウントスキーマに基づいてペイロードを生成します。 Demandbaseが送信できるアカウント、企業属性、および計算フィールドの全リストについては、Demandbaseアカウントのフィールドドキュメントを参照してください。

項目	API名	目的
ドメイン	`ドメイン___e`	受信したアカウントデータをLDP内の統合アカウントプロファイルと照合します。

重要

ペイロードに domain___e を含めてください。 LDPはドメインを使用して、Demandbaseアカウントデータを適切な統合アカウントプロファイルに照合します。

HubSpotとMarketoのイベントフィールド

LDPはHubSpotとMarketoのイベントをカスタムイベントとして扱うため、事前定義されたイベントスキーマはありません。 JSONペイロードは、HubSpotワークフローのWebhookアクションまたはMarketoイベントストリームのWebhookで送信側で完全に定義でき、必要なフィールドが存在する限り、LDPは送信されたデータをそのまま取り込みます。両方の情報源は同じペイロード契約を使用している。

必須項目

両方のフィールドをリクエストボディの最上位レベルで送信してください。

項目	種類	説明
`メール`	文字列	連絡先または見込み客のメールアドレス。 LDPはこれを利用して、イベントを既存の統合された個人プロファイルと照合します。
`イベント名`	弦	イベント名。一貫性のある分かりやすい識別子を使用してください（例： `emailClicked`、 `formSubmit`、 `formFillOut`、または `webinarAttend`）。

オプション項目

項目	タイプ	説明
`イベント開催日`	弦	イベントが発生した日時。フォーマットは強制されず、LDPは値を文字列として保存します。

その他の物件

送信する他のすべてのトップレベルキーは、保存されたイベントの追加プロパティになります。構築するネストされたオブジェクトはありません。追加のコンテキストを上記のフィールドの横にフラットなトップレベルキーとして送信します（たとえば、キャンペーン名、アセットタイトル、フォームIDなど）。LDP はイベントを表示する際に、それらを プロパティ の下にグループ化します。

ペイロードの例

{
  "メールアドレス": "contact@example.com"、
  "イベント名": "emailClicked"、
  "メールアドレスのタイトル": "マーケティング機会"
}

アクティビティタブのイベント

アクティビティ タブでは、送信するリクエストボディとは異なる形式でイベントが表示されます。 ID の照合には メールアドレス を使用し、イベント名を eventIdとして表示し、追加のプロパティを propertiesの下にグループ化し、ソースに applicationId というラベルを付けます。イベントにeventDateフィールドがある場合、 eventDate フィールドが表示されます。

LDPは、イベントを受信したデータソースから applicationId を設定します。

データソース	`アプリケーションID`
HubSpot	`HubSpot`
Marketoイベントストリーム	`マルケト`

HubSpotのイベントは、タブでは次のように表示されます。

{
  "applicationId": "HubSpot",
  "eventDate": "Wed Jun 10 12:01:33 GMT 2026",
  "eventId": "emailClicked",
  "properties": {
    "emailTitle": "Marketing Opportunity"
  }
}

この図形を使用して、個人またはアカウントの アクティビティ タブのイベントを解釈します。

ベストプラクティス

LDP はイベントをこの名前でグループ化するため、すべての Webhook で eventName の値に一貫した命名規則を使用してください。
HubSpotでは、追跡したいイベントの種類ごとに、個別のワークフローにWebhookを追加します。
LDPで実際に使用する追加プロパティのみを渡してください。未使用のフィールドもペイロードサイズにカウントされます。