Intercom connector for Amazon AppFlow - Amazon AppFlow

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:

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