intercom-prod-checklist

name	intercom-prod-checklist
description	Execute Intercom production readiness checklist and rollback procedures. Use when deploying Intercom integrations to production, preparing for launch, or implementing go-live validation. Trigger with phrases like "intercom production", "deploy intercom", "intercom go-live", "intercom launch checklist", "intercom production readiness".
allowed-tools	Read, Bash(curl:*), Grep
version	1.6.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","support","messaging","intercom"]
compatibility	Designed for Claude Code

Intercom Production Checklist

Overview

Complete checklist for deploying Intercom integrations to production, covering authentication, error handling, rate limits, webhooks, and monitoring. Work the pre-deployment checklist below section by section, run the pre-flight script as the go-live gate, and keep the rollback procedure ready before you launch.

Prerequisites

• A production Intercom workspace with an access token issued from the Developer Hub.
• $INTERCOM_ACCESS_TOKEN exported in the environment where you run the checks.
• curl and jq available for the pre-flight and status probes.
• The integration deployed behind a feature flag so it can be disabled without a redeploy.
• (Optional) $WEBHOOK_URL set if the integration receives Intercom webhooks.

Instructions

Work through the checklist in order. Each group gates a distinct failure class — do not skip a group because "it probably works."

Authentication and secrets

• Production access token stored in secret manager (not env files)
• Token has minimal required OAuth scopes
• Token rotation procedure documented and tested
• Separate tokens for dev/staging/production workspaces
• No hardcoded tokens in source code (verified with grep -r "dG9r" .)

API integration quality

• All API calls wrapped in error handling (try/catch with IntercomError)
• 429 rate limit retry with exponential backoff implemented
• 5xx server error retry implemented
• Request timeouts configured (recommended: 30s)
• Pagination handles cursor-based iteration correctly
• Contact search uses compound queries efficiently

Webhook endpoints

• Webhook URL uses HTTPS (Intercom requires it)