intercom-reference-architecture

# Intercom Reference Architecture ## Overview Production-ready architecture for Intercom integrations with layered separation, type-safe SDK usage, webhook processing, contact sync, and Help Center management. ## Project Structure ``` my-intercom-app/ ├── src/ │ ├── intercom/ │ │ ├── client.ts # Singleton IntercomClient wrapper │ │ ├── types.ts # Extended Intercom types │ │ └── errors.ts # Custom error classes │ ├── services/ │ │ ├── contacts.service.ts # Contact CRUD + search + merge │ │ ├── conversations.service.ts # Conversation lifecycle │ │ ├── articles.service.ts # Help Center article management │ │ └── events.service.ts # Data event tracking │ ├── webhooks/ │ │ ├── router.ts # Topic-based event routing │ │ ├── signature.ts # X-Hub-Signature verification │ │ └── handlers/ │ │ ├── conversation.handler.ts │ │ └── contact.handler.ts │ ├── sync/ │ │ ├── contact-sync.ts # CRM <-> Intercom contact sync │ │ └── company-sync.ts # Company data sync │ ├── api/ │ │ ├── health.ts # Health check endpoint │ │ └── webhooks.ts # Webhook endpoint │ └── cache/ │ └── intercom-cache.ts # LRU + Redis caching layer ├── tests/ │ ├── unit/ │ │ ├── contacts.test.ts │ │ └── webhooks.test.ts │ └── integration/ │ └── intercom.integration.test.ts ├── config/ │ ├── develo...