View as Markdown
Intercom icon

Intercom ACTION

Reply To Conversation

Reply to an existing Intercom conversation as an admin or on behalf of a contact (POST /conversations/{conversation_id}/reply). Use List Admin ID Options to find a valid Admin ID, and Search Contacts to find a contact's Intercom user ID, email, or external user ID. Example: set Conversation ID to 192783634529321, Reply Type to admin, Message Type to comment, Body to Thanks for reaching out!, and Admin ID to 25 to post that comment as an admin reply. See the documentation.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Intercom account once, then configure and run Reply To Conversation from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "intercom-reply-to-conversation",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    intercom: { authProvisionId: "apn_xxxxxxx" },
    conversationId: "Conversation ID",
    replyType: "Reply Type",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Reply To Conversation inputs
Property Type Description
conversationId Conversation ID string
The Intercom provisioned identifier for the conversation (e.g. 192783634529321). Run List Conversations first to discover one, or reuse the ID from a prior Reply To Conversation, Manage A Conversation, or Retrieve Conversation call's response. If a specific ID isn't known, set this to the literal string last to reply to the most recently updated conversation instead of guessing an ID.
Required
replyType Reply Type string
Who the reply is from. Select user (Contact Reply) to reply on behalf of a contact, or admin (Admin Reply) to reply as an admin.
Required
messageType Message Type string
The type of the message. Use comment for a standard reply (valid for both admin and contact replies). Use note for an internal note (valid only for admin replies). Defaults to comment.
Optional
body Body string
The text body of the reply.
Required
adminId Admin ID string
The ID of the admin sending the reply (required when Reply Type is admin). Run List Admin ID Options first to discover valid admin IDs (e.g. 9876543).
Optional
replyOnBehalfOf Reply On Behalf Of string
When Reply Type is user, selects which contact identifier field to send. Choose intercom_user_id, email, or user_id, then populate the matching prop below. Run Search Contacts first to find a contact's identifiers.
Optional
intercomUserId Intercom User ID string
The Intercom user ID of the contact (used when Reply On Behalf Of is intercom_user_id). Run Search Contacts first to find a contact's id (e.g. 6762f1571bb69f9f2193bbbb).
Optional
email Email string
The email of the contact (used when Reply On Behalf Of is email). Run Search Contacts first to find a contact's email (e.g. jane.doe@example.com).
Optional
userId User ID string
The external user ID of the contact (used when Reply On Behalf Of is user_id). Run Search Contacts first to find a contact's external_id.
Optional
attachmentUrls Attachment URLs string[]
A list of image URLs that will be added as attachments. You can include up to 10 URLs.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
intercom-reply-to-conversation
Version
0.1.1
App
Intercom
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes