メインコンテンツへスキップ
GET
イベントインスタンスを取得

Supported products

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

crm.objects.contacts.highly_sensitive.read.v2
crm.schemas.contacts.read
crm.objects.contacts.sensitive.read.v2
crm.objects.contacts.read
crm.objects.companies.highly_sensitive.read.v2
crm.objects.companies.read
crm.schemas.companies.read
crm.objects.companies.sensitive.read.v2
crm.objects.deals.highly_sensitive.read.v2
crm.schemas.deals.read
crm.objects.deals.read
crm.objects.deals.sensitive.read.v2
tickets.sensitive.v2
crm.objects.tickets.sensitive.read
crm.objects.tickets.highly_sensitive.read
tickets.highly_sensitive.v2

パスパラメータ

eventId
string
必須
eventTemplateId
string
必須

レスポンス

successful operation

eventTemplateId
string
必須

イベントテンプレートID。

id
string
必須

イベントのID。アプリやイベントテンプレートに対して固有である必要があります。異なるCRMオブジェクトに同じIDを使用すると、最後に処理したオブジェクトが残り、最初のオブジェクトにはレコードがなくなります。IDの任意の場所で「{{uuid}}」を使用して固有の文字列を生成し、確実に重複させないようにすることもできます。

objectType
string
必須

EventTemplateに関連付けられているObjectType。

tokens
object
必須

テンプレートトークンに関連付けられているトークンキーと値のコレクション。

createdAt
string<date-time>

使用されません。

customObjectTypeId
string
domain
string

イベントドメイン(UTKとペアになることが多い)。

email
string

コンタクト固有のイベントに使用されるEメールアドレス。既存のコンタクトの特定、新規作成、既存のコンタクトのEメールの変更に使用できます(「objectId」とペアになっている場合)。

extraData
object

テンプレートのMarkdownによって解釈可能な追加のイベント固有データ。

objectId
string

CRMオブジェクトID。コンタクト以外のすべてのイベントに必要です(コンタクトの場合は、UTKまたはEメールを使用できます)。

timelineIFrame
object
timestamp
string<date-time>

イベントが発生した日時。渡されなかった場合、現在の時刻であると想定されます。イベントがCRMオブジェクトのタイムラインに表示される場所を決定するために使用されます。

utk
string

「utk」パラメーターを使用して、「usertoken」によってイベントをコンタクトに関連付けます。ユーザーのEメールアドレスは分からないが、Cookieにユーザーを特定するトークンが含まれている場合にお勧めします。

最終更新日 2026年10月6日