Skip to content

Commit 5c2b605

Browse files
author
markzegarelli
authored
update intercom collection fields (#4642)
1 parent 72044ea commit 5c2b605

File tree

1 file changed

+22
-24
lines changed
  • src/connections/sources/catalog/cloud-apps/intercom

1 file changed

+22
-24
lines changed

src/connections/sources/catalog/cloud-apps/intercom/index.md

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -18,32 +18,33 @@ Take your company's email analysis to the next level by **adding Intercom as a S
1818
3. OAuth into Intercom
1919
![Screenshot of the Connect to Intercom screen in the Intercom setup flow.](images/intercom_source_qnsoxh.png)
2020

21-
4. We will verify all the required permissions
21+
1. Segment verifies the required permissions
2222
![Screenshot of the Permissions Verified screen in the Intercom setup flow.](images/image_1_Intercom.png)
2323

24-
5. Configure the name for the Intercom schema in your warehouse
24+
1. Configure the name for the Intercom schema in your warehouse
2525
![Screenshot of the SQL Schema Name screen in the Intercom setup flow.](images/image_2_Intercom.png)
2626

27-
6. Add a warehouse or connect Intercom to an already existing warehouse in your workspace
27+
1. Add a warehouse or connect Intercom to an already existing warehouse in your workspace
2828
![Screenshot of the Add Warehouse screen in the Intercom setup flow.](images/image_3_Intercom.png)
2929

30-
Voila! We'll begin syncing your Intercom data into Segment momentarily, and it will be written to your warehouse at your next Warehouse run.
30+
Segment begins to sync your Intercom data into Segment, and writes it to your warehouse at your next Warehouse run.
31+
32+
3133

3234
## Components
3335

3436
### Sync
3537

36-
Our Intercom source has a sync component, which means we'll make requests to [their API](https://developers.intercom.io/docs/) on your behalf on a 3 hour interval to pull the latest data into Segment. In the initial sync, we'll grab all the Intercom objects (and their corresponding properties) according to the collections table below. The objects will be written into a designated schema corresponding to the source instance's schema name you designated upon creation. For example, if you went with `intercom_prod`, the `users` collection will be accessible at `intercom_prod.users` in SQL.
38+
The Intercom source has a sync component, which means Segment make requests to [their API](https://developers.intercom.io/docs/) on your behalf on a 3 hour interval to pull the latest data into Segment. In the initial sync, Segment grabs all the Intercom objects (and their corresponding properties) according to the collections table below. The objects will be written into a designated schema corresponding to the source instance's schema name you designated upon creation. For example, if you went with `intercom_prod`, the `users` collection will be accessible at `intercom_prod.users` in SQL.
3739

38-
Our sync component uses an upsert API, so the data in your warehouse loaded using sync will reflect the latest state of the corresponding resource in Intercom. For example, if the `users.last_seen_ip` will be the latest value upon each sync.
40+
The sync component uses an upsert API, so the data in your warehouse loaded using sync will reflect the latest state of the corresponding resource in Intercom. For example, if the `users.last_seen_ip` will be the latest value upon each sync.
3941

40-
The source syncs and warehouse syncs are independent processes. Source runs pull your data into the Segment Hub, and warehouse runs flush that data to your warehouse. Sources will sync with Segment every 3 hours. Depending on your Warehouses plan, we will push the Source data to your warehouse on the interval associated with your billing plan.
42+
The source syncs and warehouse syncs are independent processes. Source runs pull your data into the Segment Hub, and warehouse runs flush that data to your warehouse. Sources will sync with Segment every 3 hours. Depending on your Warehouses plan, Segment pushes the Source data to your warehouse on the interval associated with your billing plan.
4143

42-
At the moment, we don't support filtering which objects or properties get synced. If you're interested in this feature, [let us know](https://segment.com/help/contact/)!
4344

4445
## Collections
4546

46-
Collections are the groupings of resources we pull from your source. In your warehouse, each collection gets its own table.
47+
Collections are the groupings of resources Segment pulls from your source. In your warehouse, each collection gets its own table.
4748

4849

4950
| Collection | Type | Description |
@@ -102,9 +103,6 @@ Collections are the groupings of resources we pull from your source. In your war
102103
| monthly_spend | How much revenue the company generates for your business |
103104
| user_count | The number of users in the company |
104105
| plan | The name of the plan you have associated with the company |
105-
| size | The number of employees in the company |
106-
| website | The URL for the company website |
107-
| industry | The industry that the company operates in |
108106

109107
## Contacts
110108

@@ -152,7 +150,6 @@ Collections are the groupings of resources we pull from your source. In your war
152150
| created_at | The time the conversation was created |
153151
| updated_at | The last time the conversation was updated |
154152
| message | The message that started the conversation rendered for presentation |
155-
| user | The user the conversation concerns |
156153
| assignee | The admin the conversation is currently assigned to. Note `nobody_admin` indicates the conversation is assigned to Nobody |
157154
| open | Indicates whether a conversation is open (true) or closed (false) |
158155
| read | Indicates whether a conversation has been read |
@@ -162,21 +159,22 @@ Collections are the groupings of resources we pull from your source. In your war
162159

163160
## Admins
164161

165-
| Property Name | Description |
166-
| ------------- | ---------------------------------------------------------------- |
167-
| id | The id of the admin or team |
168-
| name | The name of the admin or team |
169-
| email | The email address of the admin. This attribute is null for teams |
162+
| Property Name | Description |
163+
| ------------- | ----------------------------------------------------------------- |
164+
| id | The id of the admin or team |
165+
| name | The name of the admin or team |
166+
| email | The email address of the admin. This attribute is null for teams. |
167+
| type | A string that represents the object's type. Has the value `Admin` |
170168

171169

172170
## Social Profiles
173171

174-
| Property Name | Description |
175-
| ------------- | ------------------------------------------------- |
176-
| id | Optional. User ID on the service |
177-
| name | The name of the service (e.g., twitter, facebook) |
178-
| url | The user homepage on the service |
179-
| username | User name or handle on the service |
172+
| Property Name | Description |
173+
| ------------- | --------------------------------------------------------- |
174+
| id | Optional. User ID on the service |
175+
| name | The name of the service (for example, twitter, facebook) |
176+
| url | The user homepage on the service |
177+
| username | User name or handle on the service |
180178

181179

182180
## Conversation Parts

0 commit comments

Comments
 (0)