Skip to main content
Humm searches your Intercom conversations, contacts, and companies. Ask how many open conversations an account has, what topics are driving support volume, or pull recent threads for a specific customer.

​
Tools

ToolDescription
INTERCOM_LIST_ALL_COMPANIESList companies with automatic scroll pagination
INTERCOM_SEARCH_CONTACTSSearch contacts using structured query objects
INTERCOM_SEARCH_CONVERSATIONSSearch conversations using structured query objects
INTERCOM_GET_ACCOUNT_CONVERSATIONSGet all conversations for contacts matching an account external ID pattern

​
Query Structure

Intercom search tools (INTERCOM_SEARCH_CONTACTS, INTERCOM_SEARCH_CONVERSATIONS) use a structured query syntax for filtering. Here’s how to build queries:

​
Basic Filter

{
  "field": "field_name",
  "operator": "=",
  "value": "value"
}

​
Available Operators

OperatorDescription
=Equals
!=Not equals
>Greater than or equal
<Less than or equal
INValue is in array (max 15 values)
NINValue is not in array (max 15 values)
~Contains
!~Does not contain
^Starts with
$Ends with

​
Combining Filters

Use AND or OR logical operators to combine multiple filters: 
{
  "operator": "AND",
  "value": [
    {
      "field": "state",
      "operator": "=",
      "value": "open"
    },
    {
      "field": "team_assignee_id",
      "operator": "=",
      "value": "123456"
    }
  ]
}

​
Query Examples

# Open conversations
{"field": "state", "operator": "=", "value": "open"}

# Conversations in multiple states
{"field": "state", "operator": "IN", "value": ["open", "snoozed"]}

# Contacts by email domain
{"field": "email_domain", "operator": "=", "value": "acme.com"}

# Conversations created after a date
{"field": "created_at", "operator": ">", "value": "2024-01-01"}

# Date range filter
{
  "operator": "AND",
  "value": [
    {"field": "created_at", "operator": ">", "value": "2024-01-01"},
    {"field": "created_at", "operator": "<", "value": "2024-02-01"}
  ]
}

​
Query Constraints

  • Maximum 2 levels of nesting
  • Maximum 15 filters per AND/OR group
  • Arrays (IN/NIN) limited to 15 values
  • Empty strings are not allowed as values
  • Timestamp filtering only supports > and < operators

​
Searchable Fields

​
Contacts

FieldType
idString
nameString
emailString
email_domainString
external_idString
owner_idInteger
created_atTimestamp

​
Conversations

FieldType
idString
stateString (open, closed, snoozed)
priorityString
source.typeString
source.subjectString
contact_idsArray of strings
teammate_idsArray of strings
admin_assignee_idString
team_assignee_idString
created_atTimestamp
updated_atTimestamp

​
Account Conversations Tool

The INTERCOM_GET_ACCOUNT_CONVERSATIONS tool simplifies finding conversations for an entire account:
  1. Searches for contacts whose external_id matches a pattern
  2. Automatically batches contact IDs (Intercom limits to 15 per query)
  3. Fetches conversations across all matching contacts
  4. Returns combined results
{
  "external_id_pattern": "ACME_",
  "created_after": "2024-01-01",
  "limit": 500
}
This matches contacts with external IDs like ACME_001, ACME_002, etc.

​
Authentication

OAuth

Connect securely via Intercom OAuth. Authorize Humm to access your Intercom workspace.