intercom-core-workflow-a

# Intercom Contacts & Contact Management ## Overview Primary workflow for managing Intercom contacts. Covers creating users and leads, searching with filters, updating custom attributes, merging leads into users, and managing tags and segments. ## Prerequisites - Completed `intercom-install-auth` setup - Understanding of Intercom contact model (users vs leads) - Valid API credentials with contacts read/write scope ## Instructions ### Step 1: Create Contacts ```typescript import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN!, }); // Create an identified user (has external_id) const user = await client.contacts.create({ role: "user", externalId: "customer-9001", email: "alice@acme.com", name: "Alice Johnson", phone: "+1-555-0100", customAttributes: { plan: "enterprise", company_size: 500, signed_up_at: Math.floor(Date.now() / 1000), }, }); // Response: { type: "contact", id: "6657add46abd...", role: "user", ... } // Create an anonymous lead (no external_id required) const lead = await client.contacts.create({ role: "lead", email: "visitor@example.com", name: "Website Visitor", customAttributes: { landing_page: "/pricing", utm_source: "google", }, }); ``` ### Step 2: Search Contacts POST to `https://api.intercom.io/contacts/search` with query filters. ```typescript // Simple search by email const byEmail = await client.contacts.search({ query: { ...