intercom_skill

Overview

This skill provides command-line snippets and patterns for using the Intercom REST API to manage contacts, conversations, messages, companies, tags, events, and help center articles. It focuses on practical curl examples, required headers, and regional endpoints so you can quickly integrate Intercom operations into scripts or automation. Examples assume an INTERCOM_ACCESS_TOKEN environment variable is set and tested.

How this skill works

The skill issues HTTP requests to Intercom’s REST endpoints using curl and standard JSON payload files. It covers listing and searching resources, creating and updating contacts, replying and assigning conversations, tagging, tracking events, and retrieving help center articles. Requests include required headers and versions, and examples use bash -c wrappers where environment variables are piped.

When to use it

• Automating contact creation, updates, and searches from scripts
• Triaging, replying to, assigning, and closing support conversations
• Sending messages, adding notes, or attaching tags to contacts
• Syncing company records and associating contacts with organizations
• Recording custom user events for analytics or segmentation
• Fetching and surfacing help center articles in integrations

Best practices

• Set INTERCOM_ACCESS_TOKEN in your environment and verify with the admins endpoint before running scripts
• Always include Authorization, Accept, and Intercom-Version headers to avoid unexpected changes
• Use bash -c '...' when piping curl output if your environment clears variables across pipes
• Write JSON request payloads to a temp file and pass -d @/tmp/file for readability and reuse
• Respect rate limits and paginate when listing large data sets

Example use cases

• Daily job that imports new signups into Intercom as contacts with custom attributes
• Support automation that searches for open conversations and posts templated replies
• Scripted tagging workflow to label VIP customers and remove old tags
• Webhook consumer that records events to Intercom when purchases occur
• Admins querying help center articles to populate an in-app knowledge widget