Intercom
Send in-app subscription events from RevenueCat to Intercom
The Intercom integration is available to all users signed up after September '23, the legacy Grow and Pro plans, and Enterprise plans. If you're on a legacy Free or Starter plan and want to access this integration, migrate to our new pricing via your billing settings.
Intercom can be a helpful integration tool in understanding what stage a customer is in and reacting accordingly. You can use Intercom’s comprehensive communication and engagement system to retain customers.
With our Intercom integration, you can:
- Create Intercom filters for users that canceled free trials.
- Allow customer support to communicate with loyal users with access to all the information they need to solve their problem or even grant them a promotional subscription.
- Send an onboarding campaign to a user in a free trial
With accurate and up-to-date subscription data in Intercom, you'll be set to turbocharge your customer support ⚡️
Integration at a Glance
Includes Revenue | Supports Negative Revenue | Sends Sandbox Events | Includes Subscriber Attributes | Sends Transfer Events | Optional Event Types |
---|---|---|---|---|---|
❌ | ❌ | Toggle on in Settings | ❌ | ❌ | non_subscription_purchase_event expiration_event billing_issue_event product_change_event |
Events
The Intercom integration tracks the following events:
Event | Default Event Name | Description | App Store | Play Store | Amazon | Stripe | Promo |
---|---|---|---|---|---|---|---|
Initial Purchase | rc_initial_purchase_event | A new subscription has been purchased. | ✅ | ✅ | ✅ | ✅ | ❌ |
Trial Started | rc_trial_started_event | The start of an auto-renewing subscription product free trial. | ✅ | ✅ | ✅ | ✅ | ❌ |
Trial Converted | rc_trial_converted_event | When an auto-renewing subscription product converts from a free trial to normal paid period. | ✅ | ✅ | ✅ | ✅ | ❌ |
Trial Cancelled | rc_trial_cancelled_event | When a user turns off renewals for an auto-renewing subscription product during a free trial period. | ✅ | ✅ | ✅ | ✅ | ❌ |
Renewal | rc_renewal_event | An existing subscription has been renewed or a lapsed user has resubscribed. | ✅ | ✅ | ✅ | ✅ | ❌ |
Cancellation | rc_cancellation_event | A subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details. | ✅ | ✅ | ✅ | ✅ | ✅ |
Non Subscription Purchase | rc_non_subscription_purchase_event | A customer has made a purchase that will not auto-renew. | ✅ | ✅ | ✅ | ✅ | ✅ |
Expiration | rc_expiration_event | A subscription has expired and access should be removed. If you have Platform Server Notifications configured, this event will occur as soon as we are notified (within seconds to minutes) of the expiration. If you do not have notifications configured, delays may be approximately 1 hour. | ✅ | ✅ | ✅ | ✅ | ✅ |
Billing Issue | rc_billing_issue_event | There has been a problem trying to charge the subscriber. This does not mean the subscription has expired. Can be safely ignored if listening to CANCELLATION event + cancel_reason=BILLING_ERROR. | ✅ | ✅ | ✅ | ✅ | ❌ |
Product Change | rc_product_change_event | rc_product_change_event A subscriber has changed the product of their subscription. This does not mean the new subscription is in effect immediately. See Managing Subscriptions for more details on updates, downgrades, and crossgrades. | ✅ | ✅ | ❌ | ✅ | ❌ |
Setup
1. Connect with Intercom
- Navigate to your project in the RevenueCat dashboard and find the Integrations card in the left menu. Select + New
- Choose Intercom from the Integrations menu
- Click the Connect with Intercom button in your project settings.
2. Set Event Names
Once your account is connected, you can configure the event names that we'll send to Intercom. If you leave any field blank, we'll just use our default names.
You're all set!
That's all there is to it! You'll now be seeing subscription events in Intercom. Woohoo!
Sample Events
Below are sample JSONs that are delivered to Intercom for each event.
{
"product_identifier": "one_week_premium",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "PLAY_STORE",
"latest_entitlement": "pro",
"expires_at": 1663252169
}
},
"event_payload": {
"event_name": "rc_initial_purchase_event",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1662992969,
"metadata": {
"product_identifier": "one_week_premium",
"entitlement": "pro",
"store": "PLAY_STORE",
"expires_at": 1663252169
}
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662992969,
"event_name": "rc_trial_started_event",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663252169,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663252169,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1663021598,
"event_name": "rc_trial_converted_event",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663626398,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663626398,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662993211,
"event_name": "rc_trial_cancelled_event",
"metadata": {
"app_id": "app1234567890",
"cancellation_reason": "UNSUBSCRIBE",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663252169,
"product_identifier": "premium_sub",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "premium_sub",
"user_payload": {
"custom_attributes": {
"expires_at": 1663252169,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1663021649,
"event_name": "rc_renewal_event",
"metadata": {
"app_id": "app1234567890",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663626449,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663626449,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"app_id": "app1234567890",
"event_payload": {
"created_at": 1662993557,
"event_name": "rc_cancellation_event",
"metadata": {
"app_id": "app1234567890",
"cancellation_reason": "UNSUBSCRIBE",
"entitlement": "premium",
"environment": "production",
"expires_at": 1663529651,
"product_identifier": "one_week_premium",
"store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
},
"product_identifier": "one_week_premium",
"user_payload": {
"custom_attributes": {
"expires_at": 1663529651,
"latest_entitlement": "premium",
"latest_store": "APP_STORE"
},
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
}
}
{
"product_identifier": "100_tokens",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "PLAY_STORE",
"latest_entitlement": null,
"expires_at": null
}
},
"event_payload": {
"event_name": "rc_non_subscription_purchase_event",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1607569472,
"metadata": {
"product_identifier": "100_tokens",
"entitlement": null,
"store": "PLAY_STORE",
"expires_at": null,
"environment": "production"
}
}
}
{
"product_identifier": "one_month_pro",
"app_id": "app1234567890",
"user_payload": {
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"custom_attributes": {
"latest_store": "APP_STORE",
"latest_entitlement": "pro",
"expires_at": 1652444925
}
},
"event_payload": {
"event_name": "rc_expiration_event",
"user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
"created_at": 1652444925,
"metadata": {
"product_identifier": "one_month_pro",
"entitlement": "pro",
"store": "APP_STORE",
"expires_at": 1652444925,
"environment": "production",
"expiration_reason": "UNSUBSCRIBE"
}
}
}
Updated 7 days ago