Intercom

Intercom adds the Intercom messenger widget and queues early Intercom(...) calls until the widget bundle loads.

Official Intercom documentation

• Install Intercom Messenger
• Secure your Messenger
• JavaScript API
• Attributes and objects

Integrate with c15t

import { type ReactNode } from 'react';
import { ConsentManagerProvider } from '@c15t/react';
import { intercom } from '@c15t/scripts/intercom';

const scripts = [intercom({ appId: 'abc123' })];

export function ConsentProvider({ children }: { children: ReactNode }) {
  return (
    <ConsentManagerProvider
      options={{
        mode: 'hosted',
        backendURL: 'https://your-instance.c15t.dev',
        scripts,
      }}
    >
      {children}
    </ConsentManagerProvider>
  );
}

How c15t loads it

• Category: functionality (Functional)
• Loads when: functionality consent is granted
• Before load: c15t seeds window.intercomSettings and a queueing Intercom stub
• On revocation: c15t follows the default script loader behavior for non-persistent scripts

Configure the integration

Intercom's default regional API base is https://api-iam.intercom.io. If your workspace uses the EU or Australia data host, pass the matching apiBase.

intercom({
  appId: 'abc123',
  apiBase: 'https://api-iam.eu.intercom.io',
});

Runtime options

Pass additional Intercom settings through settings. The helper always writes the provided appId to app_id and apiBase to api_base.

intercom({
  appId: 'abc123',
  settings: {
    name: 'Ada Lovelace',
    user_id: 'user-123',
    company: {
      company_id: 'company-123',
      name: 'Example Company Inc.',
    },
  },
});

For logged-in users, Intercom recommends securing the Messenger with server-generated identity data. Generate verification tokens on your backend and only pass client-safe values through settings.

Types

IntercomOptions

Script