airbyte/docs/integrations/sources/intercom.md

Intercom

This page contains the setup guide and reference information for the intercom source connector.

Setup guide

Step 1: Set up the intercom connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the intercom connector and select intercom from the Source type dropdown.
4. Click Authenticate your account to sign in with Intercom and authorize your account.
5. Fill in the start date field.
6. You should be ready to sync data.

For Airbyte OSS:

1. Fill in the Access Token.
2. Fill in the start date field.
3. You should be ready to sync data.

Supported sync modes

Feature	Supported?
Full Refresh Sync	Yes
Incremental - Append Sync	Yes
SSL connection	Yes
Namespaces	No

Supported Streams

• Admins (Full table)
• Companies (Incremental)
  • Company Segments (Incremental)
• Conversations (Incremental)
  • Conversation Parts (Incremental)
• Data Attributes (Full table)
  • Customer Attributes (Full table)
  • Company Attributes (Full table)
• Contacts (Incremental)
• Segments (Incremental)
• Tags (Full table)
• Teams (Full table)

Performance considerations

The connector is restricted by normal Intercom requests limitation.

The Intercom connector should not run into Intercom API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.

Changelog

Version	Date	Pull Request	Subject
0.1.19	2022-05-25	13204	Fixed conversation_parts stream schema definition
0.1.18	2022-05-04	12482	Update input configuration copy
0.1.17	2022-04-29	12374	Fixed filtering of conversation_parts
0.1.16	2022-03-23	11206	Added conversation_id field to conversation_part records
0.1.15	2022-03-22	11176	Correct check_connection URL
0.1.14	2022-03-16	11208	Improve 'conversations' incremental sync speed
0.1.13	2022-01-14	9513	Added handling of scroll param when it expired
0.1.12	2021-12-14	8429	Updated fields and descriptions
0.1.11	2021-12-13	8685	Remove time.sleep for rate limit
0.1.10	2021-12-10	8637	Fix 'conversations' order and sorting. Correction of the companies stream
0.1.9	2021-12-03	8395	Fix backoff of 'companies' stream
0.1.8	2021-11-09	7060	Added oauth support
0.1.7	2021-11-08	7499	Remove base-python dependencies
0.1.6	2021-10-07	6879	Corrected pagination for contacts
0.1.5	2021-09-28	6082	Corrected android_last_seen_at field data type in schemas
0.1.4	2021-09-20	6087	Corrected updated_at field data type in schemas
0.1.3	2021-09-08	5908	Corrected timestamp and arrays in schemas
0.1.2	2021-08-19	5531	Corrected pagination
0.1.1	2021-07-31	5123	Corrected rate limit
0.1.0	2021-07-19	4676	Release Intercom CDK Connector