Intercom

Send in-app subscription events from RevenueCat to Intercom

πŸ‘

The Intercom integration is available on the Pro plan.

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 ⚑️

Events

The Intercom integration tracks the following events:

EventDescription
Initial PurchaseA new subscription has been purchased or a lapsed user has resubscribed.
Trial StartedThe start of an auto-renewing subscription product free trial.
Trial ConvertedWhen an auto-renewing subscription product converts from a free trial to normal paid period.
Trial CancelledWhen a user turns off renewals for an auto-renewing subscription product during a free trial period.
RenewalWhen an existing subscription has been renewed.
CancellationWhen a user turns off renewals for an auto-renewing subscription product during the normal paid period.
Non Subscription PurchaseThe purchase of any product that's not an auto-renewing subscription.
ExpirationA subscription has expired and access should be removed.
Billing IssuesThere has been a problem trying to charge the subscriber.

This does not mean the subscription has expired (in the case of a grace period enabled).
Product ChangeWhen user 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
332
  1. Choose Intercom from the Integrations menu
  2. Click the Connect with Intercom button in your project settings.
899

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.

932

πŸ‘

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": "initial_purchase",
    "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": "trial_started",
    "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": 1662993211,
    "event_name": "trial_cancelled",
    "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": 1663021598,
    "event_name": "trial_converted",
    "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": 1663021649,
    "event_name": "renewal",
    "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": "cancellation",
    "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": "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": "expiration",
    "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"
    }
  }
}
{
  "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": "non_subscription_purchase",
    "user_id": "$RCAnonymousID:87c6049c58069238dce29853916d624c",
    "created_at": 1607569472,
    "metadata": {
      "product_identifier": "100_tokens",
      "entitlement": null,
      "store": "PLAY_STORE",
      "expires_at": null,
      "environment": "production"
    }
  }
}