Agent skill · marketing growth · jeremylongshore
intercom-core-workflow-b
Manage Intercom conversations: create, reply, close, snooze, assign,
Why this skill is useful
Provides specific API commands and workflows for managing Intercom conversations that the AI wouldn't reliably generate on its own.
What it needs
Requires intercom account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Intercom Conversations & Messaging Overview Manage the full conversation lifecycle: create, reply (as admin or contact), assign to teams, close, snooze, and tag. Conversations contain threaded "parts" including messages, notes, and assignments. This SKILL.md gives you the high-level workflow and the essential skeleton. The complete step-by-step code for all seven operations lives in references/implementation.md; realistic end-to-end scenarios are in references/examples.md. Prerequisites Completed intercom-install-auth setup (provides the INTERCOMACCESSTOKEN) Admin ID (from client.admins.list()) Contact IDs for conversation participants Authentication All calls authenticate with a bearer access token supplied to the SDK client — see intercom-install-auth for how to obtain and store it. Read it from the environment, never hard-code it: The raw runassignmentrules endpoint (Step 3) uses the same token as an Authorization: Bearer header. Instructions The workflow is seven operations against client.conversations.. Reach for the one you need — they are independent once you have a conversation ID. 1. Create — conversations.create({ from, body }) opens a conversation from a contact and returns its conversationId. 2. Reply — conversations.reply(...) adds a part. type: "admin" is customer-visible, type: "note" is internal-only, type: "user" is a contact reply. 3. Assign — conversations.assign(...) routes to an admin (type: "admin") or team (type: "team"); or POST runassignmentrules for auto-routing. 4. Close / snooze / reopen — conversations.close(...), conversations.snooze({ snoozedUntil }) (Unix seconds), and conversations.open(...). 5. Tag — conversations.attachTag(...) / detachTag(...). 6. Retrieve — conversations.find(...) returns state, assignee, and the conversationParts thread. 7. List / search — conversations.list() or conversations.search({ query, pagination, sort }) with AND/OR field filters. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-core-workflow-b