Get Intercom Conversation Status

Looks up one Intercom conversation by ID and returns its state and priority.

Unverified

What the model is told

Look up an Intercom conversation using the conversation ID the customer gives you. In the response, state is open, closed or snoozed and priority is none, low, medium, high or urgent. Only share the state and general progress with the customer, and never read out the contents of other people's messages or internal notes.

Request

GEThttps://api.intercom.io/conversations/{{conversationId}}?display_as=plaintext&parts_created_after={{createdAfter}}

Headers

AuthorizationBearer YOUR_INTERCOM_ACCESS_TOKEN
Intercom-Version2.17

Parameters

conversationId stringThe Intercom conversation ID.
createdAfter stringOnly include conversation parts created at or after this Unix timestamp in seconds. Use a recent time to keep the reply short.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "f6f801c6-7510-4cd3-92ed-c6e646470d48",
    "type": "HTTP_REQUEST",
    "label": "Get Intercom Conversation Status",
    "name": "get_intercom_conversation_status",
    "customName": false,
    "description": "Look up an Intercom conversation using the conversation ID the customer gives you. In the response, state is open, closed or snoozed and priority is none, low, medium, high or urgent. Only share the state and general progress with the customer, and never read out the contents of other people's messages or internal notes.",
    "parameters": [
      {
        "name": "conversationId",
        "type": "string",
        "description": "The Intercom conversation ID."
      },
      {
        "name": "createdAfter",
        "type": "string",
        "description": "Only include conversation parts created at or after this Unix timestamp in seconds. Use a recent time to keep the reply short."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://api.intercom.io/conversations/{{conversationId}}?display_as=plaintext&parts_created_after={{createdAfter}}"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer YOUR_INTERCOM_ACCESS_TOKEN"
        },
        {
          "name": "Intercom-Version",
          "value": "2.17"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.