intercom-conversations
by duyeng
CommunicationBrief
Clawhub loads this Node module and calls `default(input)`.
Description
What This Skill Does
Reads Intercom conversations via three actions: list, find by ID, and search with filters. Returns conversation data including pagination cursors for iterating large result sets.
Querying Intercom's API directly avoids exporting CSVs or navigating the UI when you need conversation data programmatically.
When to Use It
- Pull all open conversations assigned to a support agent
- Fetch a specific conversation by ID to summarize it
- Search conversations by customer email or tag
- Page through hundreds of conversations for a weekly report
- Find conversations mentioning a specific product or error message
Example Workflow
User asks: Find all conversations from the last week mentioning 'billing error'
- 1
Call conversations.search with a query filtering on keyword 'billing error'
- 2
Receive paginated results with conversation summaries
- 3
If next_starting_after cursor is present, call search again to fetch next page
- 4
Collect all matching conversations across pages
- 5
Return list of conversation IDs and excerpts to user
A list of conversation IDs and relevant snippets matching 'billing error'
Requirements
- INTERCOM_ACCESS_TOKEN environment variable
Installation
clawhub install duyeng/intercom-conversationsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.