Add Note to Intercom Conversation

What the model is told

Add an internal note to an existing Intercom conversation, for example to record extra detail the customer has just given. Confirm the conversation ID and wording first. The note is only visible to teammates. The response is the updated conversation.

Request

Headers

• Content-Typeapplication/json
• AuthorizationBearer YOUR_INTERCOM_ACCESS_TOKEN
• Intercom-Version2.17

Body

{
  "message_type": "note",
  "type": "admin",
  "admin_id": "YOUR_INTERCOM_ADMIN_ID",
  "body": "{{note}}"
}

Parameters

• conversationId stringThe Intercom conversation ID.
• note stringThe text of the note.

{
  "source": "VOICE_AI",
  "tool": {
    "id": "0cb65282-fdf4-4fe0-9f0d-a2294aaa05eb",
    "type": "HTTP_REQUEST",
    "label": "Add Note to Intercom Conversation",
    "name": "add_note_to_intercom_conversation",
    "customName": false,
    "description": "Add an internal note to an existing Intercom conversation, for example to record extra detail the customer has just given. Confirm the conversation ID and wording first. The note is only visible to teammates. The response is the updated conversation.",
    "parameters": [
      {
        "name": "conversationId",
        "type": "string",
        "description": "The Intercom conversation ID."
      },
      {
        "name": "note",
        "type": "string",
        "description": "The text of the note."
      }
    ],
    "config": {
      "endpoint": {
        "method": "POST",
        "url": "https://api.intercom.io/conversations/{{conversationId}}/reply"
      },
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        },
        {
          "name": "Authorization",
          "value": "Bearer YOUR_INTERCOM_ACCESS_TOKEN"
        },
        {
          "name": "Intercom-Version",
          "value": "2.17"
        }
      ],
      "body": "{\n  \"message_type\": \"note\",\n  \"type\": \"admin\",\n  \"admin_id\": \"YOUR_INTERCOM_ADMIN_ID\",\n  \"body\": \"{{note}}\"\n}",
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.