Intercom connector for Amazon AppFlow

Intercom is a customer engagement solution. It helps organizations learn who is using a website or product so that the organization can engage those users with targeted messages and support. If you're an Intercom user, then your account contains data about your contacts, conversations, customer segments, and more. You can use Amazon AppFlow to transfer data from Intercom to certain AWS services or other supported applications.

Amazon AppFlow support for Intercom

Amazon AppFlow supports Intercom as follows.

Supported as a data source?

Yes. You can use Amazon AppFlow to transfer data from Intercom.

Supported as a data destination?

No. You can't use Amazon AppFlow to transfer data to Intercom.

Before you begin

To use Amazon AppFlow to transfer data from Intercom to supported destinations, you must meet these requirements:

• You have an account with Intercom that contains the data that you want to transfer. For more information about the Intercom data objects that Amazon AppFlow supports, see Supported objects.

• In your Intercom account, you've created an app for Amazon AppFlow. The app provides the credentials that Amazon AppFlow uses to access your data securely when it makes authenticated calls to your account. For the steps to create an app, see How do I create an app? in the Intercom Help Center.

• You've configured the app with a redirect URL for Amazon AppFlow.

  Redirect URLs have the following format:

  https://region.console.aws.amazon.com/appflow/oauth

  In this URL, region is the code for the AWS Region where you use Amazon AppFlow to transfer data from Intercom. For example, the code for the US East (N. Virginia) Region is us-east-1. For that Region, the URL is the following:

  https://us-east-1.console.aws.amazon.com/appflow/oauth

  For the AWS Regions that Amazon AppFlow supports, and their codes, see Amazon AppFlow endpoints and quotas in the AWS General Reference.

Note

You must add your connecting profile region redirect URL (or URLs) to the list of redirect URLs in your Intercom app. If you don’t make this addition, the app defaults to the first redirect URL in the list, and your connection will fail. For more information, see Redirect URLs in the Intercom Developer Platform Help Center.

From the settings for your app, note the client ID and client Secret. You provide these values to Amazon AppFlow when you connect to your Intercom account.

Connecting Amazon AppFlow to your Intercom account

To connect Amazon AppFlow to your Intercom account, provide the client credentials from your Intercom app so that Amazon AppFlow can access your data. If you haven't yet configured your Intercom account for Amazon AppFlow integration, see Before you begin.

To connect to Intercom

1. Sign in to the AWS Management Console and open the Amazon AppFlow console at https://console.aws.amazon.com/appflow/.

2. In the navigation pane on the left, choose Connections.

3. On the Manage connections page, for Connectors, choose Intercom.

4. Choose Create connection.

5. In the Connect to Intercom window, enter the following information:

   • Authorization tokens URL — Choose the URL based on the data host region where you use Intercom (Europe, US, Australia).

   • Authorization code URL — Choose the URL based on the data host region where you use Intercom (Europe, US, Australia).

   • Client ID — The client ID from your Intercom app.

   • Client secret — The client secret from your Intercom app.

   • Instance URL — Choose the URL based on the data host region where you use Intercom (Europe, US, Australia).

6. Optionally, under Data encryption, choose Customize encryption settings (advanced) if you want to encrypt your data with a customer managed key in the AWS Key Management Service (AWS KMS).

   By default, Amazon AppFlow encrypts your data with a KMS key that AWS creates, uses, and manages for you. Choose this option if you want to encrypt your data with your own KMS key instead.

   Amazon AppFlow always encrypts your data during transit and at rest. For more information, see Data protection in Amazon AppFlow.

   If you want to use a KMS key from the current AWS account, select this key under Choose an AWS KMS key. If you want to use a KMS key from a different AWS account, enter the Amazon Resource Name (ARN) for that key.

7. For Connection name, enter a name for your connection.

8. Choose Connect.

9. In the window that appears, sign in to your Intercom account, and grant access to Amazon AppFlow.

On the Manage connections page, your new connection appears in the Connections table. When you create a flow that uses Intercom as the data source, you can select this connection.

Transferring data from Intercom with a flow

To transfer data from Intercom, create an Amazon AppFlow flow, and choose Intercom as the data source. For the steps to create a flow, see Creating flows in Amazon AppFlow.

When you configure the flow, choose the data object that you want to transfer. For the objects that Amazon AppFlow supports for Intercom, see Supported objects.

Also, choose the destination where you want to transfer the data object that you selected. For more information about how to configure your destination, see Supported destinations.

Supported destinations

When you create a flow that uses Intercom as the data source, you can set the destination to any of the following connectors:

• Amazon Honeycode

• Amazon Lookout for Metrics

• Amazon Redshift

• Amazon RDS for PostgreSQL

• Amazon S3

• HubSpot

• Marketo

• Salesforce

• SAP OData

• Snowflake

• Upsolver

• Zendesk

• Zoho CRM

Supported objects

When you create a flow that uses Intercom as the data source, you can transfer any of the following data objects to supported destinations:

Object	Field	Data type	Supported filters
Admin	Avatar	Struct
	Away Mode Enabled	Boolean
	Away Mode Reassign	Boolean
	Email	String
	Has Inbox Seat	Boolean
	Id	String
	Job Title	String
	Name	String
	Team Ids	List
	Type	String
Company	App Id	String
	Company Id	String
	Created At	Date
	Custom Attributes	Struct
	Id	String
	Industry	String
	Last Request At	Date
	Monthly Spend	Integer
	Name	String
	Plan	Struct
	Remote Created At	Date
	Segments	Struct
	Session Count	Integer
	Size	Integer
	Tags	Struct
	Type	String
	Updated At	Date
	User Count	Integer
	Website	String
Contact	Android App Name	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Android App Version	String
	Android Device	String
	Android Last Seen At	Date
	Android Os Version	String
	Android Sdk Version	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Avatar	String
	Browser	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Browser Language	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Browser Version	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	City	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Companies	List
	Country	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Created At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Custom Attributes	Struct
	Email	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	External Id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Has Hard Bounced	Boolean	EQUAL_TO
	Id	String	EQUAL_TO, NOT_EQUAL_TO
	Ios App Name	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Ios App Version	String
	Ios Device	String
	Ios Last Seen At	Date
	Ios Os Version	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Ios Sdk Version	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Language Override	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Last Contacted At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Last Email Clicked At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Last Email Opened At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Last Replied At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Last Seen At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Location	Struct
	Marked Email As Spam	Boolean	EQUAL_TO
	Name	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Notes	List
	Opted Out Subscription Types	Struct
	Os	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Owner Id	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Phone	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Referrer	Struct
	Region	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Role	String	EQUAL_TO, NOT_EQUAL_TO
	SMS Content	Boolean
	Signed Up At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Social Profiles	List
	Tags	List
	Type	String
	Unsubscribed From Emails	Boolean	EQUAL_TO
	Unsubscribed From SMS	Boolean
	Updated At	Date	GREATER_THAN, LESS_THAN, EQUAL_TO
	Utm Campaign	String
	Utm Content	String
	Utm Medium	String
	Utm Source	String
	Utm Term	String
	Workspace Id	String
Conversation	Admin Assignee Id	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Contacts	List
	Conversation Parts	List
	Conversation Rating	Struct
	Count assignments	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Count conversation parts	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Count reopens	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Created At	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Custom Attributes	Struct
	First Contact Reply	Struct
	First admin reply at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	First assignment at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	First close at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	First contact reply at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Id	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Last admin reply at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Last assignment admin reply at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Last assignment at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Last close at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Last closed by Id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Last contact reply at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Median time to reply	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Open	Boolean	EQUAL_TO
	Priority	String	EQUAL_TO, NOT_EQUAL_TO
	Rating admin id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Rating contact id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Rating remark	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Rating requested at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Rating requested at	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Rating score	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Read	Boolean	EQUAL_TO
	Sla Applied	Struct
	Snoozed Until	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Source	Struct
	Source Id	String	EQUAL_TO, NOT_EQUAL_TO
	Source author email	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source author id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source author name	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source author type	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source body	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source delivered as	String	EQUAL_TO, NOT_EQUAL_TO
	Source subject	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Source type	String	EQUAL_TO, NOT_EQUAL_TO
	Source url	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	State	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Statistics	Struct
	Tags	List
	Team Assignee Id	String	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
	Teammates	List
	Time to admin reply	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Time to assignment	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Time to first close	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Time to last close	Integer	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
	Title	String
	Topics	List
	Type	String
	Updated At	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
	Waiting Since	DateTime	GREATER_THAN, LESS_THAN, EQUAL_TO, NOT_EQUAL_TO
Data Attribute	Admin Id	String
	Api Writable	Boolean
	Archived	Boolean
	Created At	Date
	Custom	Boolean
	Data Type	String
	Description	String
	Full Name	String
	Id	Integer
	Label	String
	Model	String
	Name	String
	Options	List
	Type	String
	Ui Writable	Boolean
	Updated At	Date
Segment	Count	Integer
	Created At	Date
	Id	String
	Name	String
	Person Type	String
	Type	String
	Updated At	Date
Tag	Id	String
	Name	String
	Type	String
Team	Admin Ids	List
	Id	String
	Name	String
	Type	String