Integrations / Support

Intercom

Look up contacts and conversations, reply to or close conversations, and trigger workflows from Intercom conversation, contact and ticket events.

9 tools 19 trigger events

Tools

intercom.list_admins

List the workspace's admins (teammates), whose numeric IDs such as 991267466 are needed to reply to or close conversations.

intercom.get_contact

Get a contact (user or lead) by its Intercom ID, e.g. 5ba682d23d7cf92bef87bfd4.

contact_id*

intercom.search_contacts

Search contacts by their attributes, returning contacts with IDs like 5ba682d23d7cf92bef87bfd4.

query*per_pagestarting_after

intercom.search_conversations

Search conversations by their attributes, e.g. open ones assigned to an admin, returning conversations with numeric IDs like 1295.

query*per_pagestarting_after

intercom.get_conversation

Get a conversation by its numeric ID, e.g. 1295, with its messages as plain text.

conversation_id*

intercom.reply_to_conversation writes

Reply to a conversation as an admin, either to the customer or as an internal note.

conversation_id*admin_id*body*message_type

intercom.close_conversation writes

Close a conversation as an admin, optionally leaving a closing message.

conversation_id*admin_id*body

intercom.api_get

Send a GET request to any Intercom API path under https://{api_host} and return the response. For endpoints the named tools don't cover.

path*params

intercom.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Intercom API path under https://{api_host}.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Intercom API path.

Connect

  1. In the Intercom Developer Hub, open your app (or create one for your workspace) and copy the access token from Configure → Authentication.
  2. Paste it as the connection's access token, and pick the region your workspace is hosted in.
  3. To trigger workflows, open Configure → Webhooks in the same app, set the endpoint URL to the request URL shown on the connection page, choose the topics you need, and paste the app's client secret from Basic information on the connection.

Credentials

Access token Client secret

Intercom API docs

Triggers

In the Intercom Developer Hub, open your app, go to Configure → Webhooks, set the endpoint URL to this URL and choose your topics, then paste the client secret from the app's Basic information page on this connection.

Events

conversation.user.createdconversation.user.repliedconversation.admin.repliedconversation.admin.notedconversation.admin.assignedconversation.admin.closedconversation.admin.openedconversation.admin.snoozedconversation.priority.updatedconversation.rating.addedcontact.user.createdcontact.lead.createdcontact.lead.signed_upcontact.user.updatedticket.createdticket.state.updatedticket.admin.assignedticket.contact.repliedticket.closed
 trigger
kind: intercom
connection: intercom
events: [conversation.user.created]
admins: [...]
teams: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us