IntercomからのWebhook構成ガイド

この記事では、Intercomデータソースを使用してIntercomアカウントにWebhookを作成し、アクション可能なイベントをTealiumに送信する方法について説明します。

前提条件

Intercomアカウント
EventStream/AudienceStreamアカウント

仕組み

Intercomは、指定したエンドポイントに対して送信リクエストを送るWebhook APIを提供しています。これらのリクエストは、Intercomアカウントで何が起こったかについてEventStreamに通知するようなプッシュ通知のように機能します。Customer Data Hub (CDH)にIntercomデータソースを追加すると、ユニークなエンドポイントが生成されます。このエンドポイントは、IntercomのWebhookを構成するために使用されます。構成が完了すると、トピックに基づいてサブスクリプションを作成し、関連するプッシュ通知を受け取ってユースケースを自動化し、情報を得て、生産性を向上させることができます。

Intercomデータソース

Intercomデータソースは、Intercom構成のHTTP POST URLとして使用するためのユニークなURLを生成します。URLは次の形式で生成されます：

https://collect.tealiumiq.com/integration/event/ACCOUNT/PROFILE/DATA_SOURCE_KEY

Tealium CDHプロファイルにIntercomデータソースを追加する方法については、Data Sourcesを参照してください。データソースを追加し、接続した後は、プロファイルを保存して公開します。

Intercomの構成

データソースエンドポイントを生成した後、以下の手順を使用してIntercomアカウントに移動し、Webhookを作成します。

Intercomアカウントにログインします。
アプリケーションに移動します。
構成したいアプリケーションを選択します。
構成 > Webhooksに移動します。
Intercomデータソースに対して、前のセクションで説明したようにTealiumによって生成されたリクエストエンドポイントURLを指定します。
通知を受け取りたいトピックを選択します。

イベントと属性

すべての受信Intercomイベント属性は自動的にintercom_でプレフィックスされます。例えば、Intercomはdata.item.conversation_message.type属性をTealiumに送信し、それはintercom_data_item_conversation_message_type（すべて小文字）に変換されます。

Intercomによって生成されるWebhookイベントと属性の完全なリストについては、Intercom - Webhook Modelsを参照してください。

イベント属性	タイプ	例
`intercom_type`	文字列	“notification_event”
`intercom_id`	文字列	“notif_4e3504a3-ba3f-46dc-ab48-8e4d5bdfdf4e”
`intercom_created_at`	数値	“1571080403”
`intercom_topic`	文字列	“conversation.admin.closed”
`intercom_data_type`	文字列	“notification_event_data”
`intercom_data_item_type`	文字列	以下のいずれか: “conversation” “user” “contact” “usertag” “ead” “contacttag” “visitor” “event” “ping”
`intercom_data_item_id`	文字列	“24098479713”
`intercom_data_item_user_type`	文字列	“user”
`intercom_data_item_user_email`	文字列	“wz1996@gmail.com”
`intercom_data_item_assignee_type`	文字列	“admin”
`intercom_data_item_assignee_email`	文字列	“weibin.zhong@intercom.io”
`intercom_data_item_conversation_message_subject`	文字列	“Hello”
`intercom_data_item_conversation_message_body`	文字列	“<p>This is a new conversation</p>”
`intercom_data_item_conversation_parts_conversation_parts`	オブジェクトのリスト	“[{“type”:“conversation_part”, “id”: “3928295317”},{“type”: “conversation_part”, “id”: “3928295318”}]”
`intercom_data_item_tags_tags`	オブジェクトのリスト	“{“type”: “tag”, “id”: “2913705”, “name”: “API”}, {“type”: “tag”, “id”: “2914621”, “name”: “Feature request”}]”
`intercom_data_item_id`	文字列	“530370b477ad7120001d”
`intercom_data_item_user_id`	文字列	“25”
`intercom_data_item_email`	文字列	“wash@serenity.io”
`intercom_data_item_phone`	文字列	“+1123456789”
`intercom_data_item_name`	文字列	“Hoban Washburne”
`intercom_data_item_company_id`	文字列	“6”
`intercom_data_item_event_name`	文字列	“invited-friend”

ベンダーのドキュメンテーション

以下のドキュメンテーションを表示するには、Intercomにログインします：

Iterable

Hubspot

このページはお役にたちましたでしょうか？

最終更新日 :: 2024年May月15日