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 |
文字列 | 以下のいずれか:
|
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にログインします:
最終更新日 :: 2024年March月29日