migrate-from-intercom

Migrates projects from Intercom to Gleap. Detects Intercom SDK integration (JavaScript, iOS, Android, React Native, Flutter), removes it, installs the Gleap SDK, and replaces all Intercom API calls with Gleap equivalents. Also covers server-side REST API migration. Use when switching from Intercom to Gleap, replacing Intercom, or migrating away from Intercom.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "migrate-from-intercom" with this command: npx skills add gleapsdk/agent-skills/gleapsdk-agent-skills-migrate-from-intercom

Migrate from Intercom to Gleap

Guides users through replacing Intercom with Gleap in their codebase. Covers client-side SDK swap and server-side API migration.

Detect Intercom

Search the codebase for Intercom integration. Use Grep to find:

Package references

  • package.json: @intercom/messenger-js-sdk, intercom-client, @intercom/intercom-react-native
  • Podfile: pod 'Intercom'
  • build.gradle: io.intercom.android:intercom-sdk
  • pubspec.yaml: intercom_flutter
  • composer.json: intercom/intercom-php
  • Gemfile: intercom-rails, intercom-ruby

Code patterns (client-side JavaScript — used by ALL web frameworks)

  • JavaScript: Intercom(, window.intercomSettings, widget.intercom.io, @intercom/messenger-js-sdk
  • iOS: import Intercom, Intercom.setApiKey, Intercom.loginUser
  • Android: import com.intercom, Intercom.initialize, Intercom.client()
  • React Native: import Intercom from '@intercom/intercom-react-native', IntercomModule
  • Flutter: import 'package:intercom_flutter', Intercom.instance
  • Server: intercom-client, intercom-php, intercom-ruby, intercom-go, intercom-java, Intercom.Dotnet

Report all findings to the user before proceeding.

API Key Resolution

Before asking the user for their Gleap API key, check these locations in order:

  1. User provided it in the conversation — use it directly
  2. .env file in the project root — look for GLEAP_API_KEY=...
  3. Environment variable — check if GLEAP_API_KEY is set via echo $GLEAP_API_KEY
  4. Not found — ask the user (available at https://app.gleap.io > Project Settings > Security > API Key)

When a key is found or provided, offer to save it to .env (and add .env to .gitignore if needed).

Workflow

  1. Detect Intercom using the patterns above. Report which platforms and files are affected.
  2. Confirm scope with the user: which parts to migrate (client SDK, server API, or both).
  3. Resolve Gleap API key using the API Key Resolution steps above.
  4. Read the mapping file for the detected platform from this skill's directory.
  5. Remove Intercom SDK: Uninstall packages, remove script tags, delete imports and configuration.
  6. Install Gleap SDK: Follow the installation steps from the mapping file (or reference the gleap-sdk-setup skill if installed).
  7. Replace API calls: Use the mapping tables to convert every Intercom call to its Gleap equivalent. Use the resolved API key in initialization code.
  8. Migrate server-side code if applicable: Replace Intercom REST API calls with Gleap REST API calls. See mapping-server-api.md.
  9. Clean up: Remove Intercom-specific config (API keys, app IDs, intercomSettings, push notification handlers).
  10. Verify: Build and run the project. Search for any remaining intercom references.

Mapping Files

Read the appropriate file based on detected platform:

  • JavaScript / Web: mapping-javascript.md — also applies to all server-side web frameworks (Laravel, Django, Rails, ASP.NET, Spring Boot, Phoenix, etc.) since they all use the JavaScript SDK on the client side
  • iOS (Swift / Objective-C): mapping-ios.md
  • Android (Kotlin / Java): mapping-android.md
  • React Native: mapping-react-native.md
  • Flutter: mapping-flutter.md
  • Server-side REST API: mapping-server-api.md

For projects using multiple platforms, read all relevant files. Common combinations:

  • Web framework + server SDK (e.g., Laravel with intercom-php, Rails with intercom-ruby): Use mapping-javascript.md for client-side and mapping-server-api.md for server-side
  • React Native + server API: Use mapping-react-native.md and mapping-server-api.md

Important Notes

  • Intercom uses app_id + api_key (separate for iOS/Android). Gleap uses a single API key per project from https://app.gleap.io
  • Intercom's boot() combines initialization + user identification. In Gleap, these are separate: initialize() then identify()
  • Intercom's shutdown() = Gleap's clearIdentity()
  • Intercom's update() = Gleap's updateContact()
  • Intercom custom user attributes map to Gleap's customData object (max 35 keys, primitives only)
  • Intercom company data maps to Gleap's companyId + companyName fields in identify
  • Features without direct Gleap equivalent: product tours (startTour), tickets view (showTicket), news items (showNews). Note these to the user as requiring alternative approaches
  • Server-side: Intercom REST API uses Bearer token auth. Gleap uses Api-Token header (legacy) or Bearer + Project headers (v3 API)

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Automation

gleap-sdk-setup

No summary provided by upstream source.

Repository SourceNeeds Review
40-gleapsdk
Automation

vercel-composition-patterns

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

Repository Source
86.8K23Kvercel
Automation

vercel-react-native-skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

Repository Source
60.9K23Kvercel
Automation

supabase-postgres-best-practices

Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.

Repository Source
35.6K1.6Ksupabase