[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M791SCG5VC4WXR9JT2VJWF35":3,"skill-same:01M791SCG5VC4WXR9JT2VJWF35":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M791SCG5VC4WXR9JT2VJWF35","intercom-migration-deep-dive",null,"Execute major Intercom data migrations and re-platforming with the contacts,\nconversations, and articles APIs. Use when migrating from Zendesk\u002FFreshdesk to\nIntercom, bulk-importing contacts, or re-platforming to Intercom.\nTrigger with phrases like \"migrate to intercom\", \"intercom migration\",\n\"import contacts to intercom\", \"switch to intercom\", \"zendesk to intercom\",\n\"intercom data import\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--intercom-pack--intercom-migration-deep-dive\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: intercom-migration-deep-dive\ndescription: |\n  Execute major Intercom data migrations and re-platforming with the contacts,\n  conversations, and articles APIs. Use when migrating from Zendesk\u002FFreshdesk to\n  Intercom, bulk-importing contacts, or re-platforming to Intercom.\n  Trigger with phrases like \"migrate to intercom\", \"intercom migration\",\n  \"import contacts to intercom\", \"switch to intercom\", \"zendesk to intercom\",\n  \"intercom data import\".\nallowed-tools: Read, Write, Edit, Bash(npm:*), Bash(node:*)\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, support, messaging, intercom]\ncompatible-with: claude-code\n---\n\n# Intercom Migration Deep Dive\n\n## Overview\n\nComprehensive 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.\n\n## Prerequisites\n\n- Intercom workspace with access token\n- Source system data exported (CSV or API access)\n- Feature flag infrastructure for gradual cutover\n- Rollback strategy tested\n\n## Migration Types\n\n| Type | Complexity | Duration | Risk |\n|------|-----------|----------|------|\n| Contact import | Low | Hours | Low |\n| Zendesk\u002FFreshdesk migration | Medium | 1-2 weeks | Medium |\n| Full re-platform (with history) | High | 2-4 weeks | High |\n| Help Center migration | Medium | Days | Low |\n\n## Instructions\n\n### Step 1: Contact Import\n\n```typescript\nimport { IntercomClient, IntercomError } from \"intercom-client\";\n\nconst client = new IntercomClient({\n  token: process.env.INTERCOM_ACCESS_TOKEN!,\n});\n\ninterface SourceContact {\n  id: string;\n  email: string;\n  name: string;\n  phone?: string;\n  plan?: string;\n  company?: string;\n  created_at: string;\n  custom_fields?: Record\u003Cstring, any>;\n}\n\nasync function importContacts(\n  contacts: SourceContact[]\n): Promise\u003C{ created: number; updated: number; failed: number; errors: any[] }> {\n  const stats = { created: 0, updated: 0, failed: 0, errors: [] as any[] };\n\n  for (const contact of contacts) {\n    try {\n      \u002F\u002F Search for existing contact by external_id or email\n      const existing = await client.contacts.search({\n        query: {\n          operator: \"OR\",\n          value: [\n            { field: \"external_id\", operator: \"=\", value: contact.id },\n            { field: \"email\", operator: \"=\", value: contact.email },\n          ],\n        },\n      });\n\n      if (existing.data.length > 0) {\n        \u002F\u002F Update existing contact\n        await client.contacts.update({\n          contactId: existing.data[0].id,\n          name: contact.name,\n          phone: contact.phone,\n          customAttributes: {\n            ...contact.custom_fields,\n            plan: contact.plan,\n            migrated_from: \"source_system\",\n            migration_date: new Date().toISOString(),\n          },\n        });\n        stats.updated++;\n      } else {\n        \u002F\u002F Create new contact\n        await client.contacts.create({\n          role: \"user\",\n          externalId: contact.id,\n          email: contact.email,\n          name: contact.name,\n          phone: contact.phone,\n          signedUpAt: Math.floor(new Date(contact.created_at).getTime() \u002F 1000),\n          customAttributes: {\n            ...contact.custom_fields,\n            plan: contact.plan,\n            migrated_from: \"source_system\",\n            migration_date: new Date().toISOString(),\n          },\n        });\n        stats.created++;\n      }\n\n      \u002F\u002F Rate limit: pause every 50 contacts\n      if ((stats.created + stats.updated) % 50 === 0) {\n        console.log(`Progress: ${stats.created} created, ${stats.updated} updated`);\n        await new Promise(r => setTimeout(r, 500));\n      }\n    } catch (err) {\n      stats.failed++;\n      stats.errors.push({\n        contact_id: contact.id,\n        email: contact.email,\n        error: err instanceof IntercomError\n          ? `${err.statusCode}: ${err.message}`\n          : (err as Error).message,\n      });\n    }\n  }\n\n  return stats;\n}\n```\n\n### Step 2: Company Import\n\n```typescript\nasync function importCompanies(\n  companies: Array\u003C{ id: string; name: string; plan?: string; size?: number }>\n): Promise\u003Cvoid> {\n  for (const company of companies) {\n    await client.companies.create({\n      companyId: company.id,\n      name: company.name,\n      plan: company.plan,\n      size: company.size,\n      customAttributes: {\n        migrated_from: \"source_system\",\n      },\n    });\n\n    await new Promise(r => setTimeout(r, 100)); \u002F\u002F Rate limit\n  }\n}\n\n\u002F\u002F Attach contacts to companies\nasync function attachContactToCompany(\n  contactId: string,\n  companyId: string\n): Promise\u003Cvoid> {\n  await client.contacts.attachCompany({\n    contactId,\n    companyId,\n  });\n}\n```\n\n### Step 3: Tag Migration\n\n```typescript\nasync function migrateTags(\n  tagMappings: Array\u003C{ sourceName: string; contactIds: string[] }>\n): Promise\u003Cvoid> {\n  for (const mapping of tagMappings) {\n    \u002F\u002F Create tag if it doesn't exist\n    const tag = await client.tags.create({ name: mapping.sourceName });\n\n    \u002F\u002F Apply tag to contacts\n    for (const contactId of mapping.contactIds) {\n      try {\n        await client.contacts.tag({ contactId, id: tag.id });\n      } catch (err) {\n        if (err instanceof IntercomError && err.statusCode === 404) {\n          console.warn(`Contact ${contactId} not found, skipping tag`);\n          continue;\n        }\n        throw err;\n      }\n    }\n\n    console.log(`Tagged ${mapping.contactIds.length} contacts with \"${mapping.sourceName}\"`);\n  }\n}\n```\n\n### Step 4: Help Center Article Migration\n\n```typescript\nasync function migrateArticles(\n  articles: Array\u003C{\n    title: string;\n    body: string;     \u002F\u002F HTML content\n    category: string;\n    state: \"published\" | \"draft\";\n  }>,\n  authorId: string   \u002F\u002F Admin ID who will be the author\n): Promise\u003Cvoid> {\n  \u002F\u002F Create or find collections for categories\n  const collections = new Map\u003Cstring, string>();\n\n  for (const article of articles) {\n    \u002F\u002F Create collection if needed\n    if (!collections.has(article.category)) {\n      const collection = await client.helpCenter.createCollection({\n        name: article.category,\n      });\n      collections.set(article.category, collection.id);\n    }\n\n    \u002F\u002F Create article in collection\n    await client.articles.create({\n      title: article.title,\n      body: article.body,\n      authorId,\n      parentId: collections.get(article.category),\n      state: article.state,\n    });\n\n    console.log(`Migrated article: ${article.title}`);\n    await new Promise(r => setTimeout(r, 200)); \u002F\u002F Rate limit\n  }\n}\n```\n\n### Step 5: Migration Orchestrator\n\n```typescript\ninterface MigrationPlan {\n  contacts: SourceContact[];\n  companies: Array\u003C{ id: string; name: string; plan?: string }>;\n  tags: Array\u003C{ sourceName: string; contactIds: string[] }>;\n  articles: Array\u003C{ title: string; body: string; category: string; state: \"published\" | \"draft\" }>;\n}\n\nasync function executeMigration(plan: MigrationPlan): Promise\u003Cvoid> {\n  console.log(\"=== Starting Intercom Migration ===\");\n  const startTime = Date.now();\n\n  \u002F\u002F Phase 1: Companies (contacts reference these)\n  console.log(`\\n[Phase 1] Importing ${plan.companies.length} companies...`);\n  await importCompanies(plan.companies);\n\n  \u002F\u002F Phase 2: Contacts\n  console.log(`\\n[Phase 2] Importing ${plan.contacts.length} contacts...`);\n  const contactStats = await importContacts(plan.contacts);\n  console.log(`  Created: ${contactStats.created}, Updated: ${contactStats.updated}, Failed: ${contactStats.failed}`);\n\n  \u002F\u002F Phase 3: Tags\n  console.log(`\\n[Phase 3] Migrating ${plan.tags.length} tags...`);\n  await migrateTags(plan.tags);\n\n  \u002F\u002F Phase 4: Articles\n  const adminList = await client.admins.list();\n  const authorId = adminList.admins[0].id;\n  console.log(`\\n[Phase 4] Migrating ${plan.articles.length} articles...`);\n  await migrateArticles(plan.articles, authorId);\n\n  const duration = ((Date.now() - startTime) \u002F 1000 \u002F 60).toFixed(1);\n  console.log(`\\n=== Migration complete in ${duration} minutes ===`);\n\n  if (contactStats.errors.length > 0) {\n    console.log(`\\nFailed contacts: ${contactStats.errors.length}`);\n    for (const err of contactStats.errors.slice(0, 10)) {\n      console.log(`  ${err.email}: ${err.error}`);\n    }\n  }\n}\n```\n\n### Step 6: Post-Migration Validation\n\n```typescript\nasync function validateMigration(\n  expectedCounts: { contacts: number; companies: number; tags: number; articles: number }\n): Promise\u003C{ passed: boolean; checks: any[] }> {\n  const checks = [];\n\n  \u002F\u002F Check contact count\n  const contacts = await client.contacts.list({ perPage: 1 });\n  checks.push({\n    name: \"Contact count\",\n    expected: expectedCounts.contacts,\n    actual: contacts.totalCount,\n    passed: contacts.totalCount >= expectedCounts.contacts * 0.95, \u002F\u002F 95% threshold\n  });\n\n  \u002F\u002F Check tags exist\n  const tags = await client.tags.list();\n  checks.push({\n    name: \"Tag count\",\n    expected: expectedCounts.tags,\n    actual: tags.data.length,\n    passed: tags.data.length >= expectedCounts.tags,\n  });\n\n  \u002F\u002F Check articles\n  let articleCount = 0;\n  const articles = await client.articles.list();\n  for await (const _ of articles) articleCount++;\n  checks.push({\n    name: \"Article count\",\n    expected: expectedCounts.articles,\n    actual: articleCount,\n    passed: articleCount >= expectedCounts.articles * 0.95,\n  });\n\n  const passed = checks.every(c => c.passed);\n  console.log(`\\nValidation: ${passed ? \"PASSED\" : \"FAILED\"}`);\n  for (const check of checks) {\n    console.log(`  ${check.passed ? \"OK\" : \"FAIL\"} ${check.name}: ${check.actual}\u002F${check.expected}`);\n  }\n\n  return { passed, checks };\n}\n```\n\n## Rollback Procedure\n\n```bash\n# If migration goes wrong:\n# 1. Stop the migration script\n# 2. Tag all migrated contacts for identification\n# 3. Delete migrated contacts if needed:\n#    Search by custom_attributes.migration_date = \"today's date\"\n#    Delete in batches\n\n# Keep source system active during migration\n# Only decommission after validation + 2 weeks of parallel run\n```\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| 409 Conflict | Duplicate external_id\u002Femail | Search before create |\n| 429 Rate Limited | Too fast | Add delays between batches |\n| 422 Validation | Bad email\u002Fdata format | Validate data before import |\n| Partial migration | Script crashed | Use idempotent operations, re-run |\n| Missing conversations | API doesn't support bulk import | Contact Intercom support for import |\n\n## Resources\n\n- [Contacts API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Fcontacts)\n- [Companies API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Fcompanies)\n- [Articles API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Farticles)\n- [Import Contacts Guide](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Fguides\u002Ftickets\u002Fimport-contacts)\n- [Tags API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Ftags)\n","# Intercom Migration Deep Dive\n\n## Overview\n\nComprehensive 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.\n\n## Prerequisites\n\n- Intercom workspace with access token\n- Source system data exported (CSV or API access)\n- Feature flag infrastructure for gradual cutover\n- Rollback strategy tested\n\n## Migration Types\n\n| Type | Complexity | Duration | Risk |\n|------|-----------|----------|------|\n| Contact import | Low | Hours | Low |\n| Zendesk\u002FFreshdesk migration | Medium | 1-2 weeks | Medium |\n| Full re-platform (with history) | High | 2-4 weeks | High |\n| Help Center migration | Medium | Days | Low |\n\n## Instructions\n\n### Step 1: Contact Import\n\n```typescript\nimport { IntercomClient, IntercomError } from \"intercom-client\";\n\nconst client = new IntercomClient({\n  token: process.env.INTERCOM_ACCESS_TOKEN!,\n});\n\ninterface SourceContact {\n  id: string;\n  email: string;\n  name: string;\n  phone?: string;\n  plan?: string;\n  company?: string;\n  created_at: string;\n  custom_fields?: Record\u003Cstring, any>;\n}\n\nasync function importContacts(\n  contacts: SourceContact[]\n): Promise\u003C{ created: number; updated: number; failed: number; errors: any[] }> {\n  const stats = { created: 0, updated: 0, failed: 0, errors: [] as any[] };\n\n  for (const contact of contacts) {\n    try {\n      \u002F\u002F Search for existing contact by external_id or email\n      const existing = await client.contacts.search({\n        query: {\n          operator: \"OR\",\n          value: [\n            { field: \"external_id\", operator: \"=\", value: contact.id },\n            { field: \"email\", operator: \"=\", value: contact.email },\n          ],\n        },\n      });\n\n      if (existing.data.length > 0) {\n        \u002F\u002F Update existing contact\n        await client.contacts.update({\n          contactId: existing.data[0].id,\n          name: contact.name,\n          phone: contact.phone,\n          customAttributes: {\n            ...contact.custom_fields,\n            plan: contact.plan,\n            migrated_from: \"source_system\",\n            migration_date: new Date().toISOString(),\n          },\n        });\n        stats.updated++;\n      } else {\n        \u002F\u002F Create new contact\n        await client.contacts.create({\n          role: \"user\",\n          externalId: contact.id,\n          email: contact.email,\n          name: contact.name,\n          phone: contact.phone,\n          signedUpAt: Math.floor(new Date(contact.created_at).getTime() \u002F 1000),\n          customAttributes: {\n            ...contact.custom_fields,\n            plan: contact.plan,\n            migrated_from: \"source_system\",\n            migration_date: new Date().toISOString(),\n          },\n        });\n        stats.created++;\n      }\n\n      \u002F\u002F Rate limit: pause every 50 contacts\n      if ((stats.created + stats.updated) % 50 === 0) {\n        console.log(`Progress: ${stats.created} created, ${stats.updated} updated`);\n        await new Promise(r => setTimeout(r, 500));\n      }\n    } catch (err) {\n      stats.failed++;\n      stats.errors.push({\n        contact_id: contact.id,\n        email: contact.email,\n        error: err instanceof IntercomError\n          ? `${err.statusCode}: ${err.message}`\n          : (err as Error).message,\n      });\n    }\n  }\n\n  return stats;\n}\n```\n\n### Step 2: Company Import\n\n```typescript\nasync function importCompanies(\n  companies: Array\u003C{ id: string; name: string; plan?: string; size?: number }>\n): Promise\u003Cvoid> {\n  for (const company of companies) {\n    await client.companies.create({\n      companyId: company.id,\n      name: company.name,\n      plan: company.plan,\n      size: company.size,\n      customAttributes: {\n        migrated_from: \"source_system\",\n      },\n    });\n\n    await new Promise(r => setTimeout(r, 100)); \u002F\u002F Rate limit\n  }\n}\n\n\u002F\u002F Attach contacts to companies\nasync function attachContactToCompany(\n  contactId: string,\n  companyId: string\n): Promise\u003Cvoid> {\n  await client.contacts.attachCompany({\n    contactId,\n    companyId,\n  });\n}\n```\n\n### Step 3: Tag Migration\n\n```typescript\nasync function migrateTags(\n  tagMappings: Array\u003C{ sourceName: string; contactIds: string[] }>\n): Promise\u003Cvoid> {\n  for (const mapping of tagMappings) {\n    \u002F\u002F Create tag if it doesn't exist\n    const tag = await client.tags.create({ name: mapping.sourceName });\n\n    \u002F\u002F Apply tag to contacts\n    for (const contactId of mapping.contactIds) {\n      try {\n        await client.contacts.tag({ contactId, id: tag.id });\n      } catch (err) {\n        if (err instanceof IntercomError && err.statusCode === 404) {\n          console.warn(`Contact ${contactId} not found, skipping tag`);\n          continue;\n        }\n        throw err;\n      }\n    }\n\n    console.log(`Tagged ${mapping.contactIds.length} contacts with \"${mapping.sourceName}\"`);\n  }\n}\n```\n\n### Step 4: Help Center Article Migration\n\n```typescript\nasync function migrateArticles(\n  articles: Array\u003C{\n    title: string;\n    body: string;     \u002F\u002F HTML content\n    category: string;\n    state: \"published\" | \"draft\";\n  }>,\n  authorId: string   \u002F\u002F Admin ID who will be the author\n): Promise\u003Cvoid> {\n  \u002F\u002F Create or find collections for categories\n  const collections = new Map\u003Cstring, string>();\n\n  for (const article of articles) {\n    \u002F\u002F Create collection if needed\n    if (!collections.has(article.category)) {\n      const collection = await client.helpCenter.createCollection({\n        name: article.category,\n      });\n      collections.set(article.category, collection.id);\n    }\n\n    \u002F\u002F Create article in collection\n    await client.articles.create({\n      title: article.title,\n      body: article.body,\n      authorId,\n      parentId: collections.get(article.category),\n      state: article.state,\n    });\n\n    console.log(`Migrated article: ${article.title}`);\n    await new Promise(r => setTimeout(r, 200)); \u002F\u002F Rate limit\n  }\n}\n```\n\n### Step 5: Migration Orchestrator\n\n```typescript\ninterface MigrationPlan {\n  contacts: SourceContact[];\n  companies: Array\u003C{ id: string; name: string; plan?: string }>;\n  tags: Array\u003C{ sourceName: string; contactIds: string[] }>;\n  articles: Array\u003C{ title: string; body: string; category: string; state: \"published\" | \"draft\" }>;\n}\n\nasync function executeMigration(plan: MigrationPlan): Promise\u003Cvoid> {\n  console.log(\"=== Starting Intercom Migration ===\");\n  const startTime = Date.now();\n\n  \u002F\u002F Phase 1: Companies (contacts reference these)\n  console.log(`\\n[Phase 1] Importing ${plan.companies.length} companies...`);\n  await importCompanies(plan.companies);\n\n  \u002F\u002F Phase 2: Contacts\n  console.log(`\\n[Phase 2] Importing ${plan.contacts.length} contacts...`);\n  const contactStats = await importContacts(plan.contacts);\n  console.log(`  Created: ${contactStats.created}, Updated: ${contactStats.updated}, Failed: ${contactStats.failed}`);\n\n  \u002F\u002F Phase 3: Tags\n  console.log(`\\n[Phase 3] Migrating ${plan.tags.length} tags...`);\n  await migrateTags(plan.tags);\n\n  \u002F\u002F Phase 4: Articles\n  const adminList = await client.admins.list();\n  const authorId = adminList.admins[0].id;\n  console.log(`\\n[Phase 4] Migrating ${plan.articles.length} articles...`);\n  await migrateArticles(plan.articles, authorId);\n\n  const duration = ((Date.now() - startTime) \u002F 1000 \u002F 60).toFixed(1);\n  console.log(`\\n=== Migration complete in ${duration} minutes ===`);\n\n  if (contactStats.errors.length > 0) {\n    console.log(`\\nFailed contacts: ${contactStats.errors.length}`);\n    for (const err of contactStats.errors.slice(0, 10)) {\n      console.log(`  ${err.email}: ${err.error}`);\n    }\n  }\n}\n```\n\n### Step 6: Post-Migration Validation\n\n```typescript\nasync function validateMigration(\n  expectedCounts: { contacts: number; companies: number; tags: number; articles: number }\n): Promise\u003C{ passed: boolean; checks: any[] }> {\n  const checks = [];\n\n  \u002F\u002F Check contact count\n  const contacts = await client.contacts.list({ perPage: 1 });\n  checks.push({\n    name: \"Contact count\",\n    expected: expectedCounts.contacts,\n    actual: contacts.totalCount,\n    passed: contacts.totalCount >= expectedCounts.contacts * 0.95, \u002F\u002F 95% threshold\n  });\n\n  \u002F\u002F Check tags exist\n  const tags = await client.tags.list();\n  checks.push({\n    name: \"Tag count\",\n    expected: expectedCounts.tags,\n    actual: tags.data.length,\n    passed: tags.data.length >= expectedCounts.tags,\n  });\n\n  \u002F\u002F Check articles\n  let articleCount = 0;\n  const articles = await client.articles.list();\n  for await (const _ of articles) articleCount++;\n  checks.push({\n    name: \"Article count\",\n    expected: expectedCounts.articles,\n    actual: articleCount,\n    passed: articleCount >= expectedCounts.articles * 0.95,\n  });\n\n  const passed = checks.every(c => c.passed);\n  console.log(`\\nValidation: ${passed ? \"PASSED\" : \"FAILED\"}`);\n  for (const check of checks) {\n    console.log(`  ${check.passed ? \"OK\" : \"FAIL\"} ${check.name}: ${check.actual}\u002F${check.expected}`);\n  }\n\n  return { passed, checks };\n}\n```\n\n## Rollback Procedure\n\n```bash\n# If migration goes wrong:\n# 1. Stop the migration script\n# 2. Tag all migrated contacts for identification\n# 3. Delete migrated contacts if needed:\n#    Search by custom_attributes.migration_date = \"today's date\"\n#    Delete in batches\n\n# Keep source system active during migration\n# Only decommission after validation + 2 weeks of parallel run\n```\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| 409 Conflict | Duplicate external_id\u002Femail | Search before create |\n| 429 Rate Limited | Too fast | Add delays between batches |\n| 422 Validation | Bad email\u002Fdata format | Validate data before import |\n| Partial migration | Script crashed | Use idempotent operations, re-run |\n| Missing conversations | API doesn't support bulk import | Contact Intercom support for import |\n\n## Resources\n\n- [Contacts API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Fcontacts)\n- [Companies API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Fcompanies)\n- [Articles API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Farticles)\n- [Import Contacts Guide](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Fguides\u002Ftickets\u002Fimport-contacts)\n- [Tags API](https:\u002F\u002Fdevelopers.intercom.com\u002Fdocs\u002Freferences\u002Frest-api\u002Fapi.intercom.io\u002Ftags)\n",{"name":5,"tags":24,"author":29,"license":15,"version":30,"description":31,"allowed-tools":32,"compatible-with":33},[25,26,27,28],"saas","support","messaging","intercom","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Execute major Intercom data migrations and re-platforming with the contacts,\nconversations, and articles APIs. Use when migrating from Zendesk\u002FFreshdesk to\nIntercom, bulk-importing contacts, or re-platforming to Intercom.\nTrigger with phrases like \"migrate to intercom\", \"intercom migration\",\n\"import contacts to intercom\", \"switch to intercom\", \"zendesk to intercom\",\n\"intercom data import\".\n","Read, Write, Edit, Bash(npm:*), Bash(node:*)","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--intercom-pack--intercom-migration-deep-dive",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill intercom-migration-deep-dive",{"tool":49,"command":50},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill intercom-migration-deep-dive",{"tool":52,"command":53},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill intercom-migration-deep-dive","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--intercom-pack--intercom-migration-deep-dive\u002FSKILL.md",true,[],[58,65,72,79,86,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]