intercom-core-workflow-b

# 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. ## Prerequisites - Completed `intercom-install-auth` setup - Admin ID (from `client.admins.list()`) - Contact IDs for conversation participants ## Instructions ### Step 1: Create a Conversation Conversations are created when a contact sends a message. ```typescript import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN!, }); // Create conversation from a contact const conversation = await client.conversations.create({ from: { type: "user", id: "6657add46abd0167d9419c3a", // Contact ID }, body: "Hi, I'm having trouble with my billing. Can you help?", }); console.log(`Conversation ID: ${conversation.conversationId}`); ``` ### Step 2: Reply to a Conversation ```typescript // Admin reply (visible to customer) await client.conversations.reply({ conversationId: conversation.conversationId, body: "Hi there! I'd be happy to help with billing. What's the issue?", type: "admin", adminId: "12345", // Your admin ID }); // Admin note (internal, not visible to customer) await client.conversations.reply({ conversationId: conversation.conversationId, body: "Customer is on Enterprise plan, checking billing system...", type: "note", ...