Create Intercom Articles Feed

User Intent

"How do I sync Intercom Help Center articles? Show me Intercom Articles feed configuration."

Operation

SDK Method: createFeed() with FeedTypes.Intercom Auth: Intercom access token


Code Example (TypeScript)

import { Graphlit } from 'graphlit-client';
import { FeedTypes, FeedServiceTypes } from 'graphlit-client/dist/generated/graphql-types';

const graphlit = new Graphlit();

const feed = await graphlit.createFeed({
  name: 'Help Center',
  type: FeedTypes.Intercom,
  intercom: {
    type: FeedServiceTypes.IntercomArticles,
    accessToken: process.env.INTERCOM_TOKEN!,
    readLimit: 200,
  },
  // Optional: add workflow for content processing
  // workflow: { id: workflow.createWorkflow.id }
});

console.log(`Created Intercom Articles feed: ${feed.createFeed.id}`);

Configuration

type: FeedServiceTypes.IntercomArticles accessToken: Intercom access token readLimit: Number of articles to sync


Intercom Token Setup

  1. Go to Intercom → Settings → Developers → Developer Hub

  2. Create new app or select existing app

  3. Configure OAuth scopes: Read articles

  4. Generate access token

  5. Set INTERCOM_TOKEN environment variable


What Gets Synced

  • Help Center article titles and content

  • Article collections and sections

  • Article metadata (author, status, dates)

  • Article URLs and translations

  • Article statistics (views, reactions)


IntercomArticles vs IntercomTickets

Use IntercomArticles for:

  • Help Center content

  • Knowledge base articles

  • Self-service documentation

  • Product guides

  • FAQ content

Use IntercomTickets for:

  • Customer support conversations

  • Support tickets

  • User inquiries

  • Chat transcripts


Use Cases

Product Documentation:

type: FeedServiceTypes.IntercomArticles

Customer Self-Service:

type: FeedServiceTypes.IntercomArticles,
readLimit: 500  // Large knowledge base

Multi-language Support:

// Intercom automatically includes article translations
type: FeedServiceTypes.IntercomArticles

Intercom API Scopes

Required OAuth scopes:

  • Read articles - Access help center articles

  • Read collections - Access article collections

Optional scopes:

  • Read admins - Get article author info

  • Read teams - Get team assignments


Last updated

Was this helpful?