Intercom App

Intercom enables you to offer near real-time engagement and support to your current and target customers through a messaging like platform. Using Hevo’s Intercom connector, you can replicate all your Intercom data to your desired Destination database or data warehouse.

For creating Pipelines using this Source, Hevo provides you a fully managed BigQuery data warehouse as a possible Destination. This option remains available till the time you set up your first BigQuery Destination irrespective of any other Destinations that you may have. With the managed warehouse, you are only charged the cost that Hevo incurs for your project in Google BigQuery. The invoice is generated at the end of each month and payment is recovered as per the payment instrument you have set up. You can now create your Pipeline and directly start analyzing your Source data. Read Hevo Managed Google BigQuery.

Source Considerations

  • The Intercom API retrieves only the latest 500 conversation parts belonging to each conversation.

  • The Intercom API indexes timestamp fields for the Contact object, such as created_at and updated_at, as dates. As a result, you can search for contacts based on these timestamps only by day, and not hour, minute or second. For example, if you search for contacts with the updated_at value greater than (the UNIX timestamp for) December 10, 2021 2:30 PM, all contacts updated from 12.00 AM of December 10, 2021 are fetched. This can mean re-ingestion of some Events, which counts towards your Events quota consumption. Read Searching for timestamp fields.

  • It can take a few minutes for a newly created contact to become available for searching. Therefore, the “greater than or equal to <timestamp>” condition may not always be honored, and such contacts may not be retrieved in the API response. Read Search for contacts for more information.

    To avoid this scenario, Hevo uses a buffer of one hour while searching for the contacts.

See Also

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Dec-09-2021 NA - Renamed the Limitations section to Source Considerations.
- Added the Source considerations about supporting only day-based timestamp values for querying the Contacts object and using a time buffer for the search to ensure all eligible Events are ingested.
May-19-2021 1.63 - Updated the section, Data Model to include descriptions of objects.
- Added the section, Limitations.
Last updated on 15 Nov 2022

Tell us what went wrong