Intercom

Intercom is a customer communication platform.

It replicates data using the Intercom API.

See the Schema section for a list of objects available for replication.

進一步查看此連接器，包括實用的連結和支援的功能。

功能	支援詳細資訊
支援的 Qlik Talend Data Integration 專案	僅複寫專案。不支援資料管道專案。
目標更新方法	複寫任務：套用變更儲存變更在資料湖中登陸資料任務：變更資料擷取 (CDC)
管理中繼資料	不需要手動產生中繼資料。
結構描述演進	僅支援變更欄資料類型操作。
LOB 欄 (NCLOB、CLOB 和 BLOB) 複寫	不支援。
已排程 CDC	必填。此為目標與來源的變更保持同步的方式。對於複寫任務，請參閱排程任務對於湖登陸任務，請參閱排程湖登陸任務的 CDC
通知	部分支援設定變更進行時的通知
監控	僅限 CDC，因為此連接器與完整載入無關。監控個別資料任務
自動解除 JSON 欄裝載的巢狀結構	不支援。來源資料集中的 JSON 欄裝載不會在目標上自動解除巢狀結構。

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

確認您使用的帳戶可讀取您要擷取的表格。

To generate your client ID and secret:

Log into your Intercom Developers account.
Select Developer Hub at the top of the page.
Create a new OAuth application.
Navigate to Authentication from the left navigation bar and click Edit.
Make sure OAuth is activated.
Make sure Authorized Redirect URIs is set to https://connector.qlik.com/auth/oauth/v3.htm.
Copy the client ID and client secret that are generated, to use in the connection settings.

Creating the connection

如需詳細資訊，請參閱連線到 SaaS 應用程式。

在您填入所需的連線設定時按一下驗證。
可能會要求您登入來源應用程式。
會顯示一個視窗，其中有驗證代碼。
將代碼複製到剪貼簿並返回連線對話方塊。
在使用來源提供的代碼完成驗證中貼上代碼並按一下驗證。
提示備註您可能需要向下捲動以查看此欄位。
若狀態是已驗證，代表已進行了驗證。
在連線名稱中提供連線名稱。
選取開啟連線中繼資料以在建立後定義連線的中繼資料。

Connection settings
Setting	Description
Data gateway	如您的使用情況有需要，選取資料移動閘道。資訊備註此欄位無法用於 Qlik Talend Cloud 啟動器訂閱，因為不支援資料移動閘道。若您有另一個訂閱層級且不想使用資料移動閘道，選取無。如需關於資料移動閘道福利的資訊以及需要此項的使用案例，請參閱 Qlik 資料閘道 - 資料移動。
Start Date	以 `MM/DD/YYYY` 格式輸入資料必須從來源複寫到目標的日期。
Client ID	Client ID of your Intercom account.
Client Secret	Client secret of your Intercom account.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 2.

Depending on your destination, table and column names may not appear as they are outlined below.

admins

The admins table lists info about the admins in your Intercom account. An admin is a user, or teammate, in your Intercom account.

Replication Method

Full Table

Primary Key

Useful links

Intercom documentation

Intercom API method

admin_ids

ARRAY

avatar

OBJECT

This is a nested data structure:

image_url: STRING

away_mode_enabled

BOOLEAN

away_mode_reassign

BOOLEAN

email

STRING

has_inbox_seat

BOOLEAN

STRING

job_title

STRING

name

STRING

team_ids

ARRAY

type

STRING

companies

The companies table contains info about companies that use your Intercom product.

Custom attributes

If applicable, Stitch will replicate custom fields related to companies in Intercom.

Limitations

Intercom’s API limits the number of simultaneous requests a single Intercom app, or connection, can make to the endpoint. Stitch uses this endpoint to replicate company data. Currently, only one request can occur at a time.

If multiple connections exist and they attempt to use this endpoint at the same time, only the connection who made the request first will succeed.

This means that if Stitch attempts to extract data when another connection is using the endpoint, Extraction will fail and an error will surface in the Extraction Logs.

To prevent or minimize this issue, we recommend limiting the number of connections a single workspace has or scheduling extraction jobs in Stitch around your other connections’ usage.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

company_id

STRING

created_at

DATE-TIME

custom_attributes

OBJECT

STRING

industry

STRING

last_request_at

DATE-TIME

monthly_spend

NUMBER

name

STRING

plan

OBJECT

This is a nested data structure:

id: STRING
name: STRING
type: STRING

remote_created_at

DATE-TIME

segments

ARRAY

This is a nested data structure:

id: STRING

session_count

INTEGER

size

INTEGER

tags

ARRAY

This is a nested data structure:

id: STRING

type

STRING

updated_at

DATE-TIME

user_count

INTEGER

website

STRING

company_attributes

The company_attributes lists data attributes for a specified company in your Intercom account.

Replication Method

Full Table

Primary Key

_sdc_record_hash

Useful links

Intercom documentation

Intercom API method

_sdc_record_hash

STRING

admin_id

STRING

api_writable

BOOLEAN

archived

BOOLEAN

created_at

DATE-TIME

custom

BOOLEAN

data_type

STRING

description

STRING

full_name

STRING

INTEGER

label

STRING

model

STRING

name

STRING

options

ARRAY

type

STRING

ui_writable

BOOLEAN

updated_at

DATE-TIME

company_segments

The company_segments table contains information about company segments in your Intercom account.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

count

INTEGER

created_at

DATE-TIME

STRING

name

STRING

person_type

STRING

type

STRING

updated_at

DATE-TIME

contact_attributes

The contact_attributes table contains information about contact attributes in your Intercom account.

Replication Method

Full Table

Primary Key

_sdc_record_hash

Useful links

Intercom documentation

Intercom API method

_sdc_record_hash

STRING

admin_id

STRING

api_writable

BOOLEAN

archived

BOOLEAN

created_at

DATE-TIME

custom

BOOLEAN

data_type

STRING

description

STRING

full_name

STRING

INTEGER

label

STRING

model

STRING

name

STRING

options

ARRAY

type

STRING

ui_writable

BOOLEAN

updated_at

DATE-TIME

contacts

The contacts table contains info about users and leads in your Intercom account.

Custom attributes

If applicable, Stitch will replicate custom fields related to contacts in Intercom.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

android_app_name

STRING

android_app_version

STRING

android_device

STRING

android_last_seen_at

DATE-TIME

android_os_version

STRING

android_sdk_version

STRING

avatar

STRING

browser

STRING

browser_language

STRING

browser_version

STRING

companies

ARRAY

This is a nested data structure:

id: STRING
type: STRING
url: STRING

created_at

DATE-TIME

custom_attributes

OBJECT

email

STRING

external_id

STRING

has_hard_bounced

BOOLEAN

STRING

ios_app_name

STRING

ios_app_version

STRING

ios_device

STRING

ios_last_seen_at

DATE-TIME

ios_os_version

STRING

ios_sdk_version

STRING

language_override

STRING

last_contacted_at

DATE-TIME

last_email_clicked_at

DATE-TIME

last_email_opened_at

DATE-TIME

last_replied_at

DATE-TIME

last_seen_at

DATE-TIME

location

OBJECT

This is a nested data structure:

city: STRING
continent_code: STRING
country: STRING
country_code: STRING
region: STRING
type: STRING

marked_email_as_spam

BOOLEAN

name

STRING

notes

OBJECT

This is a nested data structure:

data: ARRAY, which is also a nested data structure.
- id: STRING
- type: STRING
- url: STRING
has_more: BOOLEAN
total_count: INTEGER
type: STRING
url: STRING

STRING

owner_id

INTEGER

phone

STRING

role

STRING

signed_up_at

DATE-TIME

social_profiles

OBJECT

This is a nested data structure:

data: ARRAY, which is also a nested data structure.
- name: STRING
- type: STRING
- url: STRING
type: STRING

tags

ARRAY

This is a nested data structure:

id: STRING

type

STRING

unsubscribed_from_emails

BOOLEAN

updated_at

DATE-TIME

workspace_id

STRING

conversation_parts

The conversation_parts table lists the individual parts of conversations in your Intercom account.

Note: When this table is replicated, all conversation parts associated with an updated conversation will be replicated.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

assigned_to

STRING

attachments

ARRAY

This is a nested data structure:

content_type: STRING
filesize: INTEGER
height: INTEGER
name: STRING
type: STRING
url: STRING
width: INTEGER

author

OBJECT

This is a nested data structure:

email: STRING
id: STRING
name: STRING
type: STRING

body

STRING

conversation_created_at

DATE-TIME

conversation_id

STRING

conversation_total_parts

INTEGER

conversation_updated_at

DATE-TIME

created_at

DATE-TIME

external_id

STRING

notified_at

DATE-TIME

part_type

STRING

redacted

BOOLEAN

type

STRING

updated_at

DATE-TIME

conversations

The conversations table contains info about user conversations in your Intercom account.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

admin_assignee_id

INTEGER

contacts

ARRAY

This is a nested data structure:

id: STRING
type: STRING

conversation_message

OBJECT

This is a nested data structure:

attachments: ARRAY, which is also a nested data structure.
- content_type: STRING
- filesize: INTEGER
- height: INTEGER
- name: STRING
- type: STRING
- url: STRING
- width: INTEGER
author: OBJECT, which is also a nested data structure.
- email: STRING
- id: STRING
- name: STRING
- type: STRING
body: STRING
delivered_as: STRING
id: STRING
subject: STRING
type: STRING
url: STRING

conversation_rating

OBJECT

This is a nested data structure:

contact: OBJECT, which is also a nested data structure.
- id: STRING
- type: STRING
created_at: DATE-TIME
customer: OBJECT, which is also a nested data structure.
- id: STRING
- type: STRING
rating: INTEGER
remark: STRING
teammate: OBJECT, which is also a nested data structure.
- id: STRING
- type: STRING

created_at

DATE-TIME

custom_attributes

OBJECT

customer_first_reply

OBJECT

created_at

DATE-TIME

type

STRING

url

STRING

customers

ARRAY

STRING

type

STRING

first_contact_reply

OBJECT

This is a nested data structure:

created_at: DATE-TIME
type: STRING
url: STRING

STRING

open

BOOLEAN

priority

STRING

read

BOOLEAN

sent_at

DATE-TIME

sla_applied

OBJECT

This is a nested data structure:

sla_name: STRING
sla_status: STRING

snoozed_until

DATE-TIME

source

OBJECT

This is a nested data structure:

attachments: ARRAY
author: OBJECT, which is also a nested data structure.
- email: STRING
- id: STRING
- name: STRING
- type: STRING
body: STRING
delivered_as: STRING
id: STRING
redacted: BOOLEAN
subject: STRING
type: STRING
url: STRING

state

STRING

statistics

OBJECT

This is a nested data structure:

count_assignments: INTEGER
count_conversation_parts: INTEGER
count_reopens: INTEGER
first_admin_reply_at: DATE-TIME
first_assignment_at: DATE-TIME
first_close_at: DATE-TIME
first_contact_reply_at: DATE-TIME
last_admin_reply_at: DATE-TIME
last_assignment_admin_reply_at: DATE-TIME
last_assignment_at: DATE-TIME
last_close_at: DATE-TIME
last_closed_by: DATE-TIME, which is also a nested data structure.
- email: STRING
- id: STRING
- name: STRING
- type: STRING
last_closed_by_id: INTEGER
last_contact_reply_at: DATE-TIME
median_time_to_reply: INTEGER
time_to_admin_reply: INTEGER
time_to_assignment: INTEGER
time_to_first_close: INTEGER
time_to_last_close: INTEGER
type: STRING

tags

ARRAY

This is a nested data structure:

applied_at: DATE-TIME
applied_by: OBJECT, which is also a nested data structure.
- id: STRING
- type: STRING
id: STRING
name: STRING
type: STRING

team_assignee_id

INTEGER

teammates

OBJECT

This is a nested data structure:

admins: ARRAY, which is also a nested data structure.
- id: STRING
- type: STRING
type: STRING

title

STRING

type

STRING

updated_at

DATE-TIME

user

OBJECT

This is a nested data structure:

id: STRING
type: STRING

waiting_since

DATE-TIME

segments

The segments table contains information about segments within your Intercom account.

Replication Method	CDC
Primary Key	id
Replication Key	updated_at
Useful links	Intercom documentation Intercom API method

count

INTEGER

created_at

DATE-TIME

STRING

name

STRING

person_type

STRING

type

STRING

updated_at

DATE-TIME

teams

The teams table contains information about teams in your Intercom account.

Replication Method

Full Table

Primary Key

Useful links

Intercom documentation

Intercom API method

admin_ids

ARRAY

STRING

name

STRING

type

STRING

此頁面是否對您有幫助？

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們！

在此留下意見回饋