Skill UI

This comprehensive 'Hello World' script provides a hands-on guide for integrating with the Intercom API. It demonstrates the creation, searching, and management of core entities like Contacts, Conversations, and Messages. Ideal for developers starting a new Intercom integration, testing basic functionalities, or understanding the foundational Intercom data model using TypeScript.

A comprehensive runbook for systematically handling Intercom API outages and integration failures. It guides technical teams through rapid triage (checking status codes, rate limits, and service status), implementing mitigation strategies like graceful degradation, and documenting post-incident reports (postmortem). Essential for maintaining service reliability during Intercom service interruptions.

A comprehensive guide for developers to set up and authenticate with the Intercom API. It covers installing the official `intercom-client` SDK and configuring secure credentials using both private Access Tokens and robust OAuth flows, enabling seamless integration into modern applications.

A comprehensive guide to setting up a robust and efficient local development environment for Intercom integrations. This workflow emphasizes test isolation, utilizing mock clients (e.g., vitest) for reliable unit testing, proper environment variable management, and simulating real-world interactions via webhook tunneling (ngrok). It ensures fast iteration cycles when developing SaaS features against the Intercom API.

A comprehensive guide for setting up Intercom across development, staging, and production environments. This method ensures proper environment isolation, manages environment-specific access tokens and webhooks, and implements safety guards to prevent accidental data modification in critical workspaces. Essential for secure CI/CD deployments of SaaS applications.

This skill provides a comprehensive guide to setting up full observability for Intercom integrations. It covers implementing Prometheus metrics (counters, histograms, gauges) to track API request status, latency, and error rates. Furthermore, it demonstrates structured logging using Pino and OpenTelemetry tracing, offering deep, actionable insights into integration health. Ideal for DevOps, backend engineering, and robust system monitoring.

A comprehensive guide for optimizing Intercom API interactions. It covers advanced strategies such as implementing response caching (LRUCache), designing efficient search queries, handling large datasets with cursor-based pagination, managing connection pooling, and executing rate-aware parallel requests. Essential for developers building high-throughput, low-latency Intercom integrations.

A comprehensive checklist for ensuring Intercom integrations are robust and production-ready. It covers critical areas such as authentication, error handling (rate limits, retries), secure webhook validation, data privacy (PII, GDPR), and monitoring setup. Includes sample TypeScript and Bash scripts for pre-flight verification and graceful rollback procedures.

Provides advanced techniques for handling API rate limits, specifically targeting 429 errors. Implementations cover exponential backoff with jitter, queue-based request throttling, and proactive monitoring of rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset). Ideal for optimizing API request throughput and ensuring high reliability when integrating with services like Intercom.

This comprehensive guide provides a production-ready, layered architecture pattern for integrating external systems with Intercom. It covers service management (Contacts, Conversations), webhook processing, contact syncing (CRM), and robust client handling, ensuring type safety and scalability. Use this when designing new, complex Intercom integrations or reviewing existing project structures.

A comprehensive guide to production-ready patterns for the Intercom TypeScript SDK. Learn best practices for implementing type-safe client wrappers, handling cursor-based pagination, managing robust error states (including rate limiting), and implementing resilient retry logic with exponential backoff, ensuring stable and reliable API integrations.

This comprehensive guide outlines essential security best practices for integrating with Intercom. It covers secure token storage, robust webhook signature verification (X-Hub-Signature), implementing Identity Verification, and adhering to least-privilege OAuth scopes. Use this guide when building secure, production-ready applications that interact with Intercom APIs.