intercom-hello-world

# Intercom Hello World ## Overview Minimal working examples covering the Intercom core data model: contacts (users and leads), conversations, messages, and tags. ## Prerequisites - Completed `intercom-install-auth` setup - `intercom-client` package installed - Valid access token in environment ## Instructions ### Step 1: Create a Contact Contacts are the core entity. They have a `role` of either `user` (identified) or `lead` (anonymous). ```typescript import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN!, }); // Create a user contact const user = await client.contacts.create({ role: "user", externalId: "user-12345", email: "jane@example.com", name: "Jane Smith", customAttributes: { plan: "pro", signup_date: Math.floor(Date.now() / 1000), }, }); console.log(`Created contact: ${user.id} (${user.role})`); // Response shape: // { // type: "contact", // id: "6657add46abd0167d9419c3a", // workspace_id: "abc123", // external_id: "user-12345", // role: "user", // email: "jane@example.com", // name: "Jane Smith", // custom_attributes: { plan: "pro", signup_date: 1711100000 }, // created_at: 1711100000, // updated_at: 1711100000, // ... // } ``` ### Step 2: Search for Contacts ```typescript // Search contacts by email const results = await client.contacts.search({ query: { field: "email", operator: "=", value: "jane@example.com", }, }); co...