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

On this page