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/oauthIn 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
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
Sign in to the AWS Management Console and open the Amazon AppFlow console at https://console.aws.amazon.com/appflow/
. -
In the navigation pane on the left, choose Connections.
-
On the Manage connections page, for Connectors, choose Intercom.
-
Choose Create connection.
-
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).
-
-
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.
-
For Connection name, enter a name for your connection.
-
Choose Connect.
-
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:
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 |
||
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 |
||
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 |