$ curl https://api.intercom.io/conversations/147 \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
HTTP/1.1 200 OK
{
"assignee": {
"id": "814860",
"type": "admin"
},
"conversation_message": {
"attachments": [],
"author": {
"id": "5bc8f7421ae2d96695c18a",
"type": "lead"
},
"body": "<p>Hi</p>",
"delivered_as": "customer_initiated",
"id": "269650473",
"subject": "",
"type": "conversation",
"url": "https://intercom-survey-app.glitch.me/"
},
"conversation_parts": {
"conversation_parts": [
{
"assigned_to": null,
"attachments": [],
"author": {
"id": "815309",
"type": "bot"
},
"body": "<p>Test_App typically replies in a few hours.</p>",
"created_at": 1539897200,
"external_id": null,
"id": "2202737122",
"notified_at": 1539897200,
"part_type": "comment",
"type": "conversation_part",
"updated_at": 1539897200
},
#List of conversation parts...
],
"total_count": 25,
"type": "conversation_part.list"
},
"conversation_rating": {
"created_at": null,
"customer": {
"id": null,
"type": null
},
"rating": null,
"remark": null,
"teammate": {
"id": null,
"type": null
}
},
"created_at": 1539897198,
"customer_first_reply": {
"created_at": 1539897198,
"type": "conversation",
"url": "https://intercom-survey-app.glitch.me/"
},
"customers": [
{
"id": "5bc8f7ae2d96695c18a",
"type": "lead"
}
],
"id": "1911149811",
"open": true,
"read": true,
"sent_at": 1539897198,
"snoozed_until": null,
"state": "open",
"tags": {
"type": "tag.list",
"tags": [
{
"type": "tag",
"id": "1",
"name": "a tag",
"applied_at": 1542820819,
"applied_by": {
"type": "admin",
"id": "54"
}
},
{
"type": "tag",
"id": "1",
"name": "a tag",
"applied_at": 1542969954,
"applied_by": {
"type": "admin",
"id": "54"
}
}
]
},
"type": "conversation",
"updated_at": 1540393270,
"user": {
"id": "5bc8f7421ffae2d96695c18a",
"type": "lead"
},
"waiting_since": 64654125776
}
intercom.conversations.find(:id => '147')
<?php
$intercom->conversations->getConversation("10957850396");
?>
Conversation conversation = Conversation.find("147");
ConversationMessage message =
conversation.getConversationMessage();
ConversationPartCollection parts =
conversation.getConversationPartCollection();
List<ConversationPart> list = parts.getPageItems();
for (ConversationPart part : list) {
String partType = part.getPartType();
Author author = part.getAuthor();
String body = part.getBody();
}
ConversationPart recent =
conversation.getMostRecentConversationPart();
Admin assignee =
conversation.getAssignee();
User user =
conversation.getUser();
Parameters
Specify the id of the conversation you wish to retrieve using the URL https://api.intercom.io/conversations/{id}
URL structure where {id}
is the id
field of the conversation.
Parameter | Required | Description |
---|---|---|
display_as | no | Set to |
Returns
A full Conversation object. This will include a list of tags as Tag objects, with two additional attributes:
Attribute | Type | Description |
---|---|---|
applied_at | UNIX Timestamp | The date and time when the tag was applied to the conversation. |
applied_by | Object | Contains the |
Parts in the conversation_parts
object are ordered by with the most recently created parts appearing at the end of the list.
The maximum number of conversation parts that can be returned via the API is 500. If you have more than that we will return the 500 most recent conversation parts.