intercom-migration-deep-dive

# Intercom Migration Deep Dive ## Overview Comprehensive guide for migrating to Intercom from other platforms (Zendesk, Freshdesk, HelpScout) or bulk-importing data. Covers contact import, conversation history, Help Center articles, tags, and companies. ## Prerequisites - Intercom workspace with access token - Source system data exported (CSV or API access) - Feature flag infrastructure for gradual cutover - Rollback strategy tested ## Migration Types | Type | Complexity | Duration | Risk | |------|-----------|----------|------| | Contact import | Low | Hours | Low | | Zendesk/Freshdesk migration | Medium | 1-2 weeks | Medium | | Full re-platform (with history) | High | 2-4 weeks | High | | Help Center migration | Medium | Days | Low | ## Instructions ### Step 1: Contact Import ```typescript import { IntercomClient, IntercomError } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN!, }); interface SourceContact { id: string; email: string; name: string; phone?: string; plan?: string; company?: string; created_at: string; custom_fields?: Record<string, any>; } async function importContacts( contacts: SourceContact[] ): Promise<{ created: number; updated: number; failed: number; errors: any[] }> { const stats = { created: 0, updated: 0, failed: 0, errors: [] as any[] }; for (const contact of contacts) { try { // Search for existing contact by external_id or email const existin...