{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"For managing conversations you can:\n- Close a conversation\n- Snooze a conversation to reopen on a future date\n- Open a conversation which is `snoozed` or `closed`\n- Assign a conversation to an admin and/or team.\n\n{% admonition type=\"info\" name=\"Sending messages\" %}\nTo send a comment, note or quick reply, use [Reply to a conversation](/docs/references/rest-api/api.intercom.io/conversations/replyconversation).\n{% /admonition %}\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"conversation_id":{"type":"string","examples":["123"],"description":"The identifier for the conversation as given by Intercom, or the string `last` to use the most recent conversation of a contact. With `last`, also send the contact's `intercom_user_id`, `user_id` or `email` in the request body, whatever type of request you send. A contact that can't be found returns a `404` error, and a contact with no conversations returns a `422` error."}},"required":["conversation_id"],"additionalProperties":false},"body":{"oneOf":[{"$ref":"#/definitions/close_conversation_request"},{"$ref":"#/definitions/snooze_conversation_request"},{"$ref":"#/definitions/open_conversation_request"},{"$ref":"#/definitions/assign_conversation_request"}],"examples":[{"message_type":"close","type":"admin","admin_id":"991267708","body":"Goodbye :)"}]}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"close_conversation_request":{"title":"Close Conversation Request","type":"object","description":"Payload of the request to close a conversation","properties":{"message_type":{"type":"string","enum":["close"],"examples":["close"]},"type":{"type":"string","enum":["admin"],"examples":["admin"]},"admin_id":{"type":"string","description":"The id of the admin who is performing the action.","examples":["12345"]},"body":{"type":"string","description":"Optionally you can leave a message in the conversation to provide additional context to the user and other teammates.","examples":[" This conversation is now closed!"]},"assignee_id":{"type":"string","description":"The `id` of the `admin` or `team` to assign the conversation to when it is closed. Set `0` to unassign it, which clears both the teammate and the team assignee.","examples":["4324241"]},"skip_notifications":{"type":"boolean","description":"Option to disable notifications when closing a conversation. Available from API version 2.15.","examples":[true]}},"required":["message_type","type","admin_id"]},"snooze_conversation_request":{"title":"Snooze Conversation Request","type":"object","description":"Payload of the request to snooze a conversation","properties":{"message_type":{"type":"string","enum":["snoozed"],"examples":["snoozed"]},"admin_id":{"type":"string","description":"The id of the admin who is performing the action.","examples":["5017691"]},"snoozed_until":{"type":"integer","description":"The time you want the conversation to reopen.","examples":[1673609604]}},"required":["message_type","admin_id","snoozed_until"]},"open_conversation_request":{"title":"Open Conversation Request","type":"object","description":"Payload of the request to open a conversation","properties":{"message_type":{"type":"string","enum":["open"],"examples":["open"]},"admin_id":{"type":"string","description":"The id of the admin who is performing the action.","examples":["5017690"]},"assignee_id":{"type":"string","description":"The `id` of the `admin` or `team` to assign the conversation to when it is opened. Set `0` to unassign it, which clears both the teammate and the team assignee.","examples":["4324241"]},"skip_notifications":{"type":"boolean","description":"Option to disable notifications when opening a conversation. Available from API version 2.15.","examples":[true]}},"required":["message_type","admin_id"]},"assign_conversation_request":{"title":"Assign Conversation Request","type":"object","description":"Payload of the request to assign a conversation","properties":{"message_type":{"type":"string","enum":["assignment"],"examples":["assignment"]},"type":{"type":"string","enum":["admin","team"],"examples":["admin"]},"admin_id":{"type":"string","description":"The id of the admin who is performing the action.","examples":["12345"]},"assignee_id":{"type":"string","description":"The `id` of the `admin` or `team` which will be assigned the conversation. A conversation can be assigned both an admin and a team.\\nSet `0` if you want this assign to no admin or team (ie. Unassigned).","examples":["4324241"]},"body":{"type":"string","description":"Optionally you can send a response in the conversation when it is assigned.","examples":["Let me pass you over to one of my colleagues."]},"skip_reopen":{"type":"boolean","default":false,"description":"When true, assigning a closed conversation leaves it closed instead of reopening it. No reopen event is recorded, so the conversation keeps its original close timestamp and the assignment does not count as a new closure in reporting.","examples":[true]},"skip_notifications":{"type":"boolean","description":"Option to disable notifications when assigning a conversation. Available from API version 2.15.","examples":[true]}},"required":["message_type","type","admin_id","assignee_id"]}}},"name":"Manage a conversation","id":"intercom.manageconversation","example":{"path":{"conversation_id":"123"}},"maxRequests":1,"summary":false}}