GitHub Start free

Integration · Customer support

Show subscription status next to each Intercom conversation

The RevenueDot Intercom inbox app is a Canvas Kit app that shows each customer's subscription status, active entitlements, plan, store, renewal or expiry date, billing issue, total spent, customer since, refund requests and open tickets next to the conversation. Intercom calls RevenueDot directly, and RevenueDot checks every request's signature. No API key is involved.

Start free on Cloud Setup guide →

What teams do with it

  • Answer billing questions without switching to a dashboard.
  • See at once whether a customer is subscribed, in a trial or past due.
  • Spot refund requests and open tickets while you reply.
  • Open the customer in RevenueDot with one button.

What RevenueDot sends

  • This app sends no events. Intercom calls POST /v1/support/intercom/{project_id}/canvas and RevenueDot answers with Canvas Kit components.
  • The sidebar table shows status, active entitlements, plan, store, renewal or expiry date, billing issue, total spent, customer since, refund requests and open tickets, with an Open in RevenueDot button.
  • Every request is checked with the hex HMAC-SHA256 in the X-Body-Signature header, computed with your app's client secret. A missing or wrong signature gets a 401.
  • The customer is found by the contact's user id (external_id, which should be your app user id), then by the contact's email against the customers' $email attribute.
  • A project without a connected Intercom inbox answers 404, and a contact with no match shows a message saying so.

Setup

How to connect Intercom inbox to RevenueDot

  1. 01

    Create the Intercom app

    In the Intercom Developer Hub, create an app and open Canvas Kit. For the Inbox, set the initialize URL to https://api.revenuedot.app/v1/support/intercom/{project_id}/canvas, with your project id.

  2. 02

    Copy the client secret

    In the Developer Hub, open Basic information and copy the app's client secret.

  3. 03

    Connect in RevenueDot

    In RevenueDot, open Integrations in the project sidebar, choose Intercom inbox, paste the secret into Intercom app client secret and click Connect Intercom inbox.

  4. 04

    Install the app

    Install the app in your Intercom workspace and add it to the inbox sidebar.

The Intercom inbox integration page in the RevenueDot dashboard, with its settings form
Captured from the RevenueDot dashboard with demo data.

How RevenueDot checks each Intercom request

Intercom signs the raw request body with your app's client secret. RevenueDot computes the same signature with the secret you saved and answers 401 when it is missing or does not match.

The client secret is sealed with AES-256-GCM on the server and is never shown again after you save it. Self-hosted servers use <your server>/v1/support/intercom/{project_id}/canvas as the initialize URL.

FAQ

Intercom inbox and RevenueDot

Does the Intercom inbox integration work with the RevenueCat SDK?

Yes. RevenueDot speaks the RevenueCat SDK protocol, so your app keeps the RevenueCat SDK and only the server address changes. Set $email with the SDK's attribute call so RevenueDot can find customers whose Intercom contact has no user id.

Is this the same as the Intercom events integration?

No. The events integration sends subscription events to contacts and needs an access token. The inbox app shows the customer's subscription in the sidebar and needs only the app's client secret.

Does the inbox app need an API key?

No. Intercom calls RevenueDot directly, and RevenueDot verifies the signature with the client secret. No RevenueDot API key is involved.

What if the contact has no match?

The sidebar says so. RevenueDot looks first for the contact's user id as your app user id, then for the contact's email against the customers' $email attribute.

Sources: Intercom · Intercom Canvas Kit. Intercom inbox is a trademark of its owner, used to describe compatibility. RevenueDot is not affiliated with or endorsed by it.

Get started

Send Intercom inbox every subscription event.

Start free on RevenueDot Cloud, free up to $10,000 a month in tracked revenue. Integrations are included on every plan.

Start free on Cloud Migrate from RevenueCat →

Already have an account? Sign in · Prefer your own servers? Self-host free