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.

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.

FAQ

Intercom inbox and RevenueDot

Does the Intercom inbox integration work with the RevenueCat SDK?

Yes. RevenueDot speaks the RevenueCat SDK protocol, so an app on the RevenueCat SDK keeps it and only the server address changes. New apps use the RevenueDot SDK, which is built from it. 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 for free on RevenueDot Cloud. It is free until your app makes $10,000 a month, and every integration is included.

Already have an account? Sign in · Switching from RevenueCat? Change one line