Intercom

Intercomは、連絡先、企業、会話、チケット、メッセージとのやり取りを一か所で管理・自動化できる主要な顧客コミュニケーションプラットフォームです。SimのIntercom統合により、エージェントは自動化されたワークフローから顧客関係、サポートリクエスト、会話をプログラムで直接管理できます。

Intercomツールでは、以下のことができます：

連絡先管理： 連絡先の作成、取得、更新、一覧表示、検索、削除—CRMプロセスを自動化し、顧客記録を最新の状態に保ちます。
企業管理： 新しい企業の作成、企業詳細の取得、ユーザーやビジネスクライアントに関連するすべての企業の一覧表示。
会話処理： 会話の取得、一覧表示、返信、検索—エージェントが進行中のサポートスレッドを追跡し、回答を提供し、フォローアップアクションを自動化できます。
チケット管理： プログラムでチケットを作成および取得し、カスタマーサービス、サポート問題の追跡、ワークフローのエスカレーションを自動化します。
メッセージ送信： ワークフロー自動化内からオンボーディング、サポート、マーケティングのためにユーザーやリードにメッセージをトリガーします。

IntercomツールをSimに統合することで、ワークフローがユーザーと直接通信し、カスタマーサポートプロセスを自動化し、リードを管理し、大規模なコミュニケーションを効率化する能力を与えます。新しい連絡先の作成、顧客データの同期、サポートチケットの管理、パーソナライズされたエンゲージメントメッセージの送信など、Intercomツールはインテリジェントな自動化の一部として顧客とのやり取りを管理するための包括的な方法を提供します。

使用手順

Intercomをワークフローに統合します。連絡先の作成、取得、更新、一覧表示、検索、削除；企業の作成、取得、一覧表示；会話の取得、一覧表示、返信、検索；チケットの作成と取得；およびメッセージの作成が可能です。

ツール

`intercom_create_contact`

メール、external_id、または役割を使用してIntercomに新しい連絡先を作成する

入力

パラメータ	型	必須	説明
`role`	string	いいえ	連絡先の役割。「user」または「lead」を指定可能。未指定の場合は「lead」がデフォルト
`email`	string	いいえ	連絡先のメールアドレス
`external_id`	string	いいえ	クライアントが提供する連絡先の一意の識別子
`phone`	string	いいえ	連絡先の電話番号
`name`	string	いいえ	連絡先の名前
`avatar`	string	いいえ	連絡先のアバター画像URL
`signed_up_at`	number	いいえ	ユーザーが登録した時刻(Unixタイムスタンプ)
`last_seen_at`	number	いいえ	ユーザーが最後に確認された時刻(Unixタイムスタンプ)
`owner_id`	string	いいえ	連絡先のアカウント所有権が割り当てられた管理者のID
`unsubscribed_from_emails`	boolean	いいえ	連絡先がメールの配信停止をしているかどうか
`custom_attributes`	string	いいえ	カスタム属性(JSONオブジェクト形式、例：{"attribute_name": "value"})
`company_id`	string	いいえ	作成時に連絡先を関連付ける会社ID

出力

パラメータ	型	説明
`contact`	object	作成された連絡先オブジェクト

`intercom_get_contact`

IDからIntercomの単一の連絡先を取得する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	取得する連絡先ID

出力

パラメータ	型	説明
`contact`	object	連絡先オブジェクト

`intercom_update_contact`

Intercomの既存の連絡先を更新する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	更新する連絡先ID
`role`	string	いいえ	連絡先の役割。「user」または「lead」を指定可能
`external_id`	string	いいえ	クライアントが提供する連絡先の一意の識別子
`email`	string	いいえ	連絡先のメールアドレス
`phone`	string	いいえ	連絡先の電話番号
`name`	string	いいえ	連絡先の名前
`avatar`	string	いいえ	連絡先のアバター画像URL
`signed_up_at`	number	いいえ	ユーザーが登録した時刻(Unixタイムスタンプ)
`last_seen_at`	number	いいえ	ユーザーが最後に確認された時刻(Unixタイムスタンプ)
`owner_id`	string	いいえ	連絡先のアカウント所有権が割り当てられた管理者のID
`unsubscribed_from_emails`	boolean	いいえ	連絡先がメールの配信停止をしているかどうか
`custom_attributes`	string	いいえ	カスタム属性(JSONオブジェクト形式、例：{"attribute_name": "value"})
`company_id`	string	いいえ	連絡先を関連付ける会社ID

出力

パラメータ	型	説明
`contact`	object	更新された連絡先オブジェクト

`intercom_list_contacts`

ページネーションをサポートしてIntercomからすべての連絡先をリストする

入力

パラメータ	型	必須	説明
`per_page`	number	いいえ	ページあたりの結果数（最大：150）
`starting_after`	string	いいえ	ページネーション用カーソル - 開始するIDの後

出力

パラメータ	型	説明
`contacts`	array	連絡先オブジェクトの配列

`intercom_search_contacts`

クエリを使用してIntercomで連絡先を検索する

入力

パラメータ	型	必須	説明
`query`	string	はい	検索クエリ（例：{"field":"email","operator":"=","value":"user@example.com"}）
`per_page`	number	いいえ	ページあたりの結果数（最大：150）
`starting_after`	string	いいえ	ページネーション用カーソル
`sort_field`	string	いいえ	ソート対象のフィールド（例："name"、"created_at"、"last_seen_at"）
`sort_order`	string	いいえ	ソート順："ascending"（昇順）または"descending"（降順）

出力

パラメータ	型	説明
`contacts`	array	一致する連絡先オブジェクトの配列

`intercom_delete_contact`

IDでIntercomから連絡先を削除する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	削除する連絡先ID

出力

パラメータ	型	説明
`id`	string	削除された連絡先のID
`deleted`	boolean	連絡先が削除されたかどうか
`metadata`	object	操作メタデータ

`intercom_create_company`

Intercomで企業を作成または更新する

入力

パラメータ	型	必須	説明
`company_id`	string	はい	企業の一意の識別子
`name`	string	いいえ	企業名
`website`	string	いいえ	企業のウェブサイト
`plan`	string	いいえ	企業のプラン名
`size`	number	いいえ	企業の従業員数
`industry`	string	いいえ	企業が事業を展開する業界
`monthly_spend`	number	いいえ	企業があなたのビジネスに生み出す収益額。注：このフィールドは小数点以下を切り捨てて整数にします（例：155.98は155になります）
`custom_attributes`	string	いいえ	JSONオブジェクトとしてのカスタム属性
`remote_created_at`	number	いいえ	あなたが企業を作成した時刻（Unixタイムスタンプ）

出力

パラメータ	型	説明
`company`	object	作成または更新された企業オブジェクト

`intercom_get_company`

IDによってIntercomから単一の企業を取得する

入力

パラメータ	型	必須	説明
`companyId`	string	はい	取得する企業ID

出力

パラメータ	型	説明
`company`	object	企業オブジェクト

`intercom_list_companies`

ページネーションをサポートしてIntercomからすべての企業を一覧表示します。注：このエンドポイントはページネーションを使用して返すことができる企業数が10,000社に制限されています。10,000社を超えるデータセットの場合は、代わりにスクロールAPIを使用してください。

入力

パラメータ	型	必須	説明
`per_page`	number	いいえ	ページあたりの結果数
`page`	number	いいえ	ページ番号
`starting_after`	string	いいえ	ページネーション用カーソル（ページベースのページネーションより推奨）

出力

パラメータ	型	説明
`companies`	array	企業オブジェクトの配列

`intercom_get_conversation`

IDによりIntercomから単一の会話を取得

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	取得する会話ID
`display_as`	string	いいえ	プレーンテキストでメッセージを取得する場合は「plaintext」に設定
`include_translations`	boolean	いいえ	trueの場合、会話パーツは会話の検出言語に翻訳されます

出力

パラメータ	型	説明
`conversation`	object	会話オブジェクト

`intercom_list_conversations`

ページネーションサポート付きでIntercomからすべての会話を一覧表示

入力

パラメータ	型	必須	説明
`per_page`	number	いいえ	ページあたりの結果数（最大：150）
`starting_after`	string	いいえ	ページネーション用カーソル
`sort`	string	いいえ	ソートするフィールド（例：「waiting_since」、「updated_at」、「created_at」）
`order`	string	いいえ	ソート順：「asc」（昇順）または「desc」（降順）

出力

パラメータ	型	説明
`conversations`	array	会話オブジェクトの配列

`intercom_reply_conversation`

管理者としてIntercomで会話に返信する

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	返信する会話ID
`message_type`	string	はい	メッセージタイプ：「comment」または「note」
`body`	string	はい	返信のテキスト本文
`admin_id`	string	いいえ	返信を作成する管理者のID。指定しない場合、デフォルトの管理者（Operator/Fin）が使用されます。
`attachment_urls`	string	いいえ	カンマ区切りの画像URL一覧（最大10個）
`created_at`	number	いいえ	返信が作成されたときのUnixタイムスタンプ。指定しない場合、現在時刻が使用されます。

出力

パラメータ	型	説明
`conversation`	object	更新された会話オブジェクト

`intercom_search_conversations`

クエリを使用してIntercomで会話を検索する

入力

パラメータ	型	必須	説明
`query`	string	はい	JSONオブジェクトとしての検索クエリ
`per_page`	number	いいえ	ページあたりの結果数（最大：150）
`starting_after`	string	いいえ	ページネーション用カーソル
`sort_field`	string	いいえ	ソートするフィールド（例:「created_at」、「updated_at」）
`sort_order`	string	いいえ	ソート順:「ascending」または「descending」

出力

パラメータ	型	説明
`conversations`	array	一致する会話オブジェクトの配列

`intercom_create_ticket`

Intercomで新しいチケットを作成する

入力

パラメータ	型	必須	説明
`ticket_type_id`	string	はい	チケットタイプのID
`contacts`	string	はい	連絡先識別子のJSON配列（例：[{"id": "contact_id"}]）
`ticket_attributes`	string	はい	_default_title_と_default_description_を含むチケット属性のJSONオブジェクト
`company_id`	string	いいえ	チケットに関連付ける会社ID
`created_at`	number	いいえ	チケットが作成された時間（Unixタイムスタンプ）。提供されない場合、現在時刻が使用されます。
`conversation_to_link_id`	string	いいえ	このチケットにリンクする既存の会話のID
`disable_notifications`	boolean	いいえ	trueの場合、チケット作成時の通知を抑制します

出力

パラメータ	型	説明
`ticket`	object	作成されたチケットオブジェクト

`intercom_get_ticket`

IDによりIntercomから単一のチケットを取得する

入力

パラメータ	型	必須	説明
`ticketId`	string	はい	取得するチケットID

出力

パラメータ	型	説明
`ticket`	object	チケットオブジェクト

`intercom_create_message`

Intercomで管理者が開始した新しいメッセージを作成して送信する

入力

パラメータ	型	必須	説明
`message_type`	string	はい	メッセージタイプ:アプリ内メッセージの場合は「inapp」、メールメッセージの場合は「email」
`template`	string	はい	メッセージテンプレートスタイル:プレーンテキストの場合は「plain」、パーソナライズスタイルの場合は「personal」
`subject`	string	いいえ	メッセージの件名（emailタイプの場合）
`body`	string	はい	メッセージの本文
`from_type`	string	はい	送信者タイプ:「admin」
`from_id`	string	はい	メッセージを送信する管理者のID
`to_type`	string	はい	受信者タイプ:「contact」
`to_id`	string	はい	メッセージを受信する連絡先のID
`created_at`	number	いいえ	メッセージが作成された時間（Unixタイムスタンプ）。提供されない場合、現在時刻が使用されます。

出力

パラメータ	型	説明
`message`	object	作成されたメッセージオブジェクト

メモ

カテゴリー: tools
タイプ: intercom

Intercomで新しい管理者主導のメッセージを作成して送信します。API準拠のフィールドのみを返します。

入力

パラメータ	型	必須	説明
`message_type`	string	はい	メッセージタイプ:アプリ内メッセージの場合は「inapp」、メールメッセージの場合は「email」
`template`	string	はい	メッセージテンプレートスタイル:プレーンテキストの場合は「plain」、パーソナライズスタイルの場合は「personal」
`subject`	string	いいえ	メッセージの件名(メールタイプの場合)
`body`	string	はい	メッセージの本文
`from_type`	string	はい	送信者タイプ:「admin」
`from_id`	string	はい	メッセージを送信する管理者のID
`to_type`	string	はい	受信者タイプ:「contact」
`to_id`	string	はい	メッセージを受信する連絡先のID
`created_at`	number	いいえ	メッセージが作成された時刻(Unixタイムスタンプ)。未指定の場合は現在時刻が使用されます

出力

パラメータ	型	説明
`message`	object	作成されたメッセージオブジェクト
↳ `id`	string	メッセージの一意の識別子
↳ `type`	string	オブジェクトタイプ(message)
↳ `created_at`	number	メッセージが作成された時刻(Unixタイムスタンプ)
↳ `body`	string	メッセージの本文
↳ `message_type`	string	メッセージのタイプ(in_appまたはemail)
↳ `conversation_id`	string	作成された会話のID
↳ `owner`	object	メッセージの所有者
`messageId`	string	作成されたメッセージのID
`success`	boolean	操作の成功ステータス

`intercom_list_admins`

ワークスペースのすべての管理者のリストを取得

入力

パラメータ	型	必須	説明

出力

パラメータ	型	説明
`admins`	array	管理者オブジェクトの配列
↳ `id`	string	管理者の一意の識別子
↳ `type`	string	オブジェクトタイプ(admin)
↳ `name`	string	管理者の名前
↳ `email`	string	管理者のメールアドレス
↳ `job_title`	string	管理者の役職
↳ `away_mode_enabled`	boolean	管理者が離席モードかどうか
↳ `away_mode_reassign`	boolean	離席時に会話を再割り当てするかどうか
↳ `has_inbox_seat`	boolean	管理者が有料の受信トレイシートを持っているかどうか
↳ `team_ids`	array	管理者が所属するチームIDのリスト
↳ `avatar`	object	アバター情報
↳ `email_verified`	boolean	メールアドレスが確認済みかどうか
`type`	string	オブジェクトタイプ(admin.list)

`intercom_close_conversation`

Intercomで会話をクローズする

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	クローズする会話のID
`admin_id`	string	はい	アクションを実行する管理者のID
`body`	string	いいえ	会話に追加するオプションのクローズメッセージ

出力

パラメータ	型	説明
`conversation`	object	クローズされた会話オブジェクト
↳ `id`	string	会話の一意の識別子
↳ `type`	string	オブジェクトタイプ(conversation)
↳ `state`	string	会話の状態(closed)
↳ `open`	boolean	会話がオープンかどうか(false)
↳ `read`	boolean	会話が既読かどうか
↳ `created_at`	number	会話が作成されたUnixタイムスタンプ
↳ `updated_at`	number	会話が最後に更新されたUnixタイムスタンプ
`conversationId`	string	クローズされた会話のID
`state`	string	会話の状態(closed)

`intercom_open_conversation`

Intercomでクローズまたはスヌーズされた会話をオープンする

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	オープンする会話のID
`admin_id`	string	はい	アクションを実行する管理者のID

出力

パラメータ	型	説明
`conversation`	object	オープンされた会話オブジェクト
↳ `id`	string	会話の一意の識別子
↳ `type`	string	オブジェクトタイプ(conversation)
↳ `state`	string	会話の状態(open)
↳ `open`	boolean	会話がオープンかどうか(true)
↳ `read`	boolean	会話が既読かどうか
↳ `created_at`	number	会話が作成されたUnixタイムスタンプ
↳ `updated_at`	number	会話が最後に更新されたUnixタイムスタンプ
`conversationId`	string	オープンされた会話のID
`state`	string	会話の状態(open)

`intercom_snooze_conversation`

会話をスヌーズして将来の時刻に再開する

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	スヌーズする会話のID
`admin_id`	string	はい	アクションを実行する管理者のID
`snoozed_until`	number	はい	会話が再開される時刻のUnixタイムスタンプ

出力

パラメータ	型	説明
`conversation`	object	スヌーズされた会話オブジェクト
↳ `id`	string	会話の一意の識別子
↳ `type`	string	オブジェクトタイプ(conversation)
↳ `state`	string	会話の状態(snoozed)
↳ `open`	boolean	会話が開いているかどうか
↳ `snoozed_until`	number	会話が再開されるUnixタイムスタンプ
↳ `created_at`	number	会話が作成された時刻のUnixタイムスタンプ
↳ `updated_at`	number	会話が最後に更新された時刻のUnixタイムスタンプ
`conversationId`	string	スヌーズされた会話のID
`state`	string	会話の状態(snoozed)
`snoozed_until`	number	会話が再開されるUnixタイムスタンプ

`intercom_assign_conversation`

Intercomで会話を管理者またはチームに割り当てる

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	割り当てる会話のID
`admin_id`	string	はい	割り当てを実行する管理者のID
`assignee_id`	string	はい	会話を割り当てる管理者またはチームのID。割り当てを解除するには「0」を設定
`body`	string	いいえ	割り当て時に追加するオプションのメッセージ(例:「サポートチームに引き継ぎます」)

出力

パラメータ	型	説明
`conversation`	object	割り当てられた会話オブジェクト
↳ `id`	string	会話の一意の識別子
↳ `type`	string	オブジェクトタイプ(conversation)
↳ `state`	string	会話の状態
↳ `open`	boolean	会話がオープンかどうか
↳ `admin_assignee_id`	number	割り当てられた管理者のID
↳ `team_assignee_id`	string	割り当てられたチームのID
↳ `created_at`	number	会話が作成された時刻(Unixタイムスタンプ)
↳ `updated_at`	number	会話が最後に更新された時刻(Unixタイムスタンプ)
`conversationId`	string	割り当てられた会話のID
`admin_assignee_id`	number	割り当てられた管理者のID
`team_assignee_id`	string	割り当てられたチームのID

`intercom_list_tags`

ワークスペース内のすべてのタグのリストを取得する

入力

パラメータ	型	必須	説明

出力

パラメータ	型	説明
`tags`	array	タグオブジェクトの配列
↳ `id`	string	タグの一意の識別子
↳ `type`	string	オブジェクトタイプ(tag)
↳ `name`	string	タグの名前
`type`	string	オブジェクトタイプ(list)

`intercom_create_tag`

新しいタグを作成するか、既存のタグ名を更新する

入力

パラメータ	型	必須	説明
`name`	string	はい	タグの名前。見つからない場合は新しいタグを作成し、IDが指定されている場合は名前を更新します。
`id`	string	いいえ	更新する既存のタグのID。新しいタグを作成する場合は省略します。

出力

パラメータ	型	説明
`id`	string	タグの一意の識別子
`name`	string	タグの名前
`type`	string	オブジェクトタイプ (tag)

`intercom_tag_contact`

特定の連絡先にタグを追加する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	タグを付ける連絡先のID
`tagId`	string	はい	適用するタグのID

出力

パラメータ	型	説明
`id`	string	タグの一意の識別子
`name`	string	タグの名前
`type`	string	オブジェクトタイプ (tag)

`intercom_untag_contact`

特定の連絡先からタグを削除する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	タグを削除する連絡先のID
`tagId`	string	はい	削除するタグのID

出力

パラメータ	型	説明
`id`	string	削除されたタグの一意の識別子
`name`	string	削除されたタグの名前
`type`	string	オブジェクトタイプ（tag）

`intercom_tag_conversation`

特定の会話にタグを追加する

入力

パラメータ	型	必須	説明
`conversationId`	string	はい	タグを付ける会話のID
`tagId`	string	はい	適用するタグのID
`admin_id`	string	はい	タグを適用する管理者のID

出力

パラメータ	型	説明
`id`	string	タグの一意の識別子
`name`	string	タグの名前
`type`	string	オブジェクトタイプ（tag）

`intercom_create_note`

特定の連絡先にメモを追加する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	メモを追加する連絡先のID
`body`	string	はい	メモのテキスト内容
`admin_id`	string	いいえ	メモを作成する管理者のID

出力

パラメータ	型	説明
`id`	string	ノートの一意の識別子
`body`	string	ノートのテキストコンテンツ
`created_at`	number	ノートが作成された時刻(Unixタイムスタンプ)
`type`	string	オブジェクトタイプ(note)
`author`	object	ノートを作成した管理者
↳ `type`	string	作成者タイプ(admin)
↳ `id`	string	作成者ID
↳ `name`	string	作成者名
↳ `email`	string	作成者のメールアドレス
`contact`	object	ノートが作成された連絡先
↳ `type`	string	連絡先タイプ
↳ `id`	string	連絡先ID

`intercom_create_event`

Intercomで連絡先のカスタムイベントを追跡する

入力

パラメータ	型	必須	説明
`event_name`	string	はい	イベントの名前(例:「order-completed」)。可読性のため過去形の動詞-名詞形式を使用してください。
`created_at`	number	いいえ	イベントが発生した時刻のUnixタイムスタンプ。一意性のため強く推奨されます。
`user_id`	string	いいえ	ユーザーの識別子(external_id)
`email`	string	いいえ	ユーザーのメールアドレス。アプリがメールを使用してユーザーを一意に識別する場合のみ使用してください。
`id`	string	いいえ	Intercomの連絡先ID
`metadata`	string	いいえ	イベントに関する最大10個のメタデータキーと値のペアを含むJSONオブジェクト(例:{"order_value": 99.99})

出力

パラメータ	型	説明
`accepted`	boolean	イベントが受け入れられたかどうか(202 Accepted)

`intercom_attach_contact_to_company`

Intercomで連絡先を会社に関連付ける

入力

パラメータ	型	必須	説明
`contactId`	string	はい	会社に関連付ける連絡先のID
`companyId`	string	はい	連絡先を関連付ける会社のID

出力

パラメータ	型	説明
`company`	object	連絡先が関連付けられた会社オブジェクト
↳ `id`	string	会社の一意の識別子
↳ `type`	string	オブジェクトタイプ(company)
↳ `company_id`	string	定義した会社ID
↳ `name`	string	会社名
↳ `created_at`	number	会社が作成されたUnixタイムスタンプ
↳ `updated_at`	number	会社が更新されたUnixタイムスタンプ
↳ `user_count`	number	会社内のユーザー数
↳ `session_count`	number	セッション数
↳ `monthly_spend`	number	月間支出額
↳ `plan`	object	会社のプラン詳細
`companyId`	string	会社のID
`name`	string	会社名

`intercom_detach_contact_from_company`

Intercomで連絡先を企業から削除する

入力

パラメータ	型	必須	説明
`contactId`	string	はい	企業から切り離す連絡先のID
`companyId`	string	はい	連絡先を切り離す企業のID

出力

パラメータ	型	説明
`company`	object	連絡先が切り離された企業オブジェクト
↳ `id`	string	企業の一意の識別子
↳ `type`	string	オブジェクトタイプ(company)
↳ `company_id`	string	定義した企業ID
↳ `name`	string	企業名
`companyId`	string	企業のID
`name`	string	企業名

Intercom

On this page