DocumentationREST APISamplesSDK ReferenceBlogSuggest an EditGet Help
Sign upLog in

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 RevenueSupports Negative RevenueSends Sandbox EventsIncludes Subscriber AttributesSends Transfer EventsOptional 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:

EventDefault Event NameDescriptionApp StorePlay StoreAmazonStripePromo
Initial Purchaserc_initial_purchase_eventA new subscription has been purchased.✅✅✅✅❌
Trial Startedrc_trial_started_eventThe start of an auto-renewing subscription product free trial.✅✅✅✅❌
Trial Convertedrc_trial_converted_eventWhen an auto-renewing subscription product converts from a free trial to normal paid period.✅✅✅✅❌
Trial Cancelledrc_trial_cancelled_eventWhen a user turns off renewals for an auto-renewing subscription product during a free trial period.✅✅✅✅❌
Renewalrc_renewal_eventAn existing subscription has been renewed or a lapsed user has resubscribed.✅✅✅✅❌
Cancellationrc_cancellation_eventA subscription or non-renewing purchase has been cancelled. See cancellation reasons for more details.✅✅✅✅✅
Non Subscription Purchaserc_non_subscription_purchase_eventA customer has made a purchase that will not auto-renew.✅✅✅✅✅
Expirationrc_expiration_eventA 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 Issuerc_billing_issue_eventThere 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 Changerc_product_change_eventrc_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

  1. Navigate to your project in the RevenueCat dashboard and find the Integrations card in the left menu. Select + New

  1. Choose Intercom from the Integrations menu
  2. 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 about 1 month ago