For managing conversations you can:
- Close a conversation
- Snooze a conversation to reopen on a future date
- Open a conversation which is
snoozed
orclosed
- Assign a conversation to an admin and/or team.
For managing conversations you can:
snoozed
or closed
id required | string The identifier for the conversation as given by Intercom. Example: 123 |
Payload of the request to close a conversation
{ "message_type": "close", "type": "admin", "admin_id": 991271692, "body": "Goodbye :)" }
200
Assign a conversation
401
Unauthorized
403
API plan restricted
404
Not found
{ "type": "conversation", "id": "1620", "created_at": 1715077895, "updated_at": 1715077895, "waiting_since": null, "snoozed_until": null, "source": { "type": "conversation", "id": "403918938", "delivered_as": "admin_initiated", "subject": "", "body": "<p>this is the message body</p>", "author": { "type": "admin", "id": "991271692", "name": "Ciaran189 Lee", "email": "admin189@email.com" }, "attachments": [ ], "url": null, "redacted": false }, "contacts": { "type": "contact.list", "contacts": [ { "type": "contact", "id": "663a0307262d16a19645ee71", "external_id": "70" } ] }, "first_contact_reply": null, "admin_assignee_id": null, "team_assignee_id": null, "open": false, "state": "closed", "read": false, "tags": { "type": "tag.list", "tags": [ ] }, "priority": "not_priority", "sla_applied": null, "statistics": null, "conversation_rating": null, "teammates": null, "title": null, "custom_attributes": { }, "topics": { }, "ticket": null, "linked_objects": { "type": "list", "data": [ ], "total_count": 0, "has_more": false }, "ai_agent": null, "ai_agent_participated": false, "conversation_parts": { "type": "conversation_part.list", "conversation_parts": [ { "type": "conversation_part", "id": "365", "part_type": "close", "body": "<p>Goodbye :)</p>", "created_at": 1715077895, "updated_at": 1715077895, "notified_at": 1715077895, "assigned_to": null, "author": { "id": "991271692", "type": "admin", "name": "Ciaran189 Lee", "email": "admin189@email.com" }, "attachments": [ ], "external_id": null, "redacted": false } ], "total_count": 1 } }