Intercom

Create contacts, send messages, track events, and fetch conversations in Intercom

Overview

Intercom tools let you create contacts, send messages, track customer events, and retrieve conversations from Intercom.

Key Features

• INTERCOM_CREATE_USER
  • Create or update a contact in Intercom
• INTERCOM_SEND_MESSAGE
  • Create a new conversation or reply to an existing one
• INTERCOM_TRACK_EVENT
  • Track customer events for analytics and automation
• INTERCOM_GET_CONVERSATION
  • Retrieve a conversation by conversation ID

Authentication

For further details, click here.

These tools require an Intercom access token. Some reply flows also require an Intercom admin ID as an input value.

Note: Treat API keys as sensitive information and never commit them to public repositories.

Example: Create User, Send Message, Track Event, and Get Conversation

- id: create_user
  tool: INTERCOM_CREATE_USER
  config:
    - name: access_token
      value: "{{secrets.INTERCOM_ACCESS_TOKEN}}"
  input:
    - name: email
      value: "[e-mail]"
    - name: name
      value: "Intercom Flow Test User"

- id: send_message
  tool: INTERCOM_SEND_MESSAGE
  needs:
    - create_user
  config:
    - name: access_token
      value: "{{secrets.INTERCOM_ACCESS_TOKEN}}"
  input:
    - name: from
      value: '{"type":"admin","id":"{{secrets.INTERCOM_ADMIN_ID}}"}'
    - name: to
      value: '{"type":"user","id":"{{steps.create_user.result.id}}"}'
    - name: body
      value: "Hello from JinbaFlow!"

- id: track_event
  tool: INTERCOM_TRACK_EVENT
  needs:
    - create_user
  config:
    - name: access_token
      value: "{{secrets.INTERCOM_ACCESS_TOKEN}}"
  input:
    - name: event_name
      value: "flow_test_event"
    - name: email
      value: "{{steps.create_user.result.email}}"
    - name: metadata
      value: '{"source":"jinbaflow"}'

- id: get_conversation
  tool: INTERCOM_GET_CONVERSATION
  needs:
    - send_message
  config:
    - name: access_token
      value: "{{secrets.INTERCOM_ACCESS_TOKEN}}"
  input:
    - name: conversation_id
      value: "{{steps.send_message.result.conversation_id}}"