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": 991282477, "body": "Goodbye :)" }
200
Assign a conversation
401
Unauthorized
403
API plan restricted
404
Not found
{ "type": "conversation", "id": "4810", "created_at": 1712223000, "updated_at": 1712223000, "waiting_since": null, "snoozed_until": null, "source": { "type": "conversation", "id": "403920862", "delivered_as": "admin_initiated", "subject": "", "body": "<p>this is the message body</p>", "author": { "type": "admin", "id": "991282477", "name": "Ciaran185 Lee", "email": "admin185@email.com" }, "attachments": [ ], "url": null, "redacted": false }, "contacts": { "type": "contact.list", "contacts": [ { "type": "contact", "id": "660e73186abd01bd27af61aa", "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 }, "conversation_parts": { "type": "conversation_part.list", "conversation_parts": [ { "type": "conversation_part", "id": "1120", "part_type": "close", "body": "<p>Goodbye :)</p>", "created_at": 1712223000, "updated_at": 1712223000, "notified_at": 1712223000, "assigned_to": null, "author": { "id": "991282477", "type": "admin", "name": "Ciaran185 Lee", "email": "admin185@email.com" }, "attachments": [ ], "external_id": null, "redacted": false } ], "total_count": 1 } }