{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can reply to a ticket with a message from an admin or on behalf of a contact, or with a note for admins.","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"ticket_id":{"title":"Ticket ID","type":"string","description":"The id of the ticket to target.\n{% admonition type=\"info\" name=\"Not the Inbox ticket ID\" %}\nThis is the internal `id` field from the API response, not the `ticket_id` displayed in the Intercom Inbox (e.g., #12345). Use the `id` value from the ticket object returned by the API.\n{% /admonition %}\n","examples":["123"]}},"required":["ticket_id"],"additionalProperties":false},"body":{"oneOf":[{"$ref":"#/definitions/contact_reply_ticket_request"},{"$ref":"#/definitions/admin_reply_ticket_request"}],"properties":{"skip_notifications":{"type":"boolean","description":"Option to disable notifications when replying to a Ticket.","examples":[true]}},"examples":[{"message_type":"comment","type":"admin","admin_id":991267940,"body":"<p>Thanks for reaching out, we're looking into it!</p>"}]}},"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"]},"contact_reply_ticket_request":{"title":"Contact Reply on ticket","oneOf":[{"$ref":"#/definitions/contact_reply_ticket_intercom_user_id_request"},{"$ref":"#/definitions/contact_reply_ticket_user_id_request"},{"$ref":"#/definitions/contact_reply_ticket_email_request"}]},"admin_reply_ticket_request":{"title":"Admin Reply on ticket","type":"object","description":"Payload of the request to reply on behalf of an admin","properties":{"message_type":{"type":"string","description":"The type of reply. Tracker tickets and back-office tickets that are not shared with the customer do not support `comment`; use `note` instead.","enum":["comment","note","quick_reply"],"examples":["comment"]},"type":{"type":"string","enum":["admin"],"examples":["admin"]},"body":{"type":"string","description":"The text body of the reply. Notes accept some HTML formatting. Must be present for comment and note message types.","examples":["Hello there!"]},"admin_id":{"type":"string","description":"The id of the admin who is authoring the comment.","examples":["3156780"]},"created_at":{"type":"integer","description":"The time the reply was created. If not provided, the current time will be used.","examples":[1590000000]},"reply_options":{"title":"Quick Reply Options","type":"array","description":"The quick reply options to display. Must be present for quick_reply message types.","items":{"title":"Quick Reply Option","type":"object","properties":{"text":{"type":"string","description":"The text to display in this quick reply option."},"uuid":{"type":"string","format":"uuid","description":"A unique identifier for this quick reply option. This value will be available within the metadata of the comment ticket part that is created when a user clicks on this reply option."}},"required":["text","uuid"]}},"attachment_urls":{"type":"array","description":"A list of image URLs that will be added as attachments. You can include up to 10 URLs.","items":{"type":"string","format":"uri"},"maxItems":10},"attachment_files":{"type":"array","description":"A list of files that will be added as attachments. You can include up to 10 files. If both attachment_files and attachment_urls are provided, attachment_files takes precedence.","items":{"$ref":"#/definitions/conversation_attachment_files"},"maxItems":10},"cross_post":{"type":"boolean","description":"If set to true, the note will be cross-posted to all linked conversations. Only applicable to note message types on back-office tickets.","examples":[true]}},"required":["message_type","type","admin_id"]},"contact_reply_ticket_intercom_user_id_request":{"title":"Intercom User ID","type":"object","description":"Payload of the request to reply on behalf of a contact using their `intercom_user_id`","allOf":[{"$ref":"#/definitions/contact_reply_base_request"}],"properties":{"intercom_user_id":{"type":"string","description":"The identifier for the contact as given by Intercom."}},"required":["intercom_user_id","body"]},"contact_reply_ticket_user_id_request":{"title":"User ID","type":"object","description":"Payload of the request to reply on behalf of a contact using their `user_id`","allOf":[{"$ref":"#/definitions/contact_reply_base_request"}],"properties":{"user_id":{"type":"string","description":"The external_id you have defined for the contact."}},"required":["user_id","body"]},"contact_reply_ticket_email_request":{"title":"Email","type":"object","description":"Payload of the request to reply on behalf of a contact using their `email`","properties":{"email":{"type":"string","description":"The email you have defined for the user."}},"allOf":[{"$ref":"#/definitions/contact_reply_base_request"}],"required":["email","body"]},"conversation_attachment_files":{"title":"Conversation attachment files","type":"object","description":"Properties of the attachment files in a conversation part","properties":{"content_type":{"type":"string","description":"The content type of the file","examples":["application/json"]},"data":{"type":"string","description":"The base64 encoded file data.","examples":["ewogICJ0ZXN0IjogMQp9"]},"name":{"type":"string","description":"The name of the file.","examples":["test.json"]}}},"contact_reply_base_request":{"title":"Contact Reply Base Object","type":"object","properties":{"message_type":{"type":"string","enum":["comment"]},"type":{"type":"string","enum":["user"]},"body":{"type":"string","description":"The text body of the comment. Required unless the reply includes attachments. Always required when replying to a ticket."},"created_at":{"type":"integer","description":"The time the reply was created. If not provided, the current time will be used.","examples":[1590000000]},"attachment_urls":{"title":"Attachment URLs","type":"array","description":"A list of image URLs that will be added as attachments. You can include up to 10 URLs.","items":{"type":"string","format":"uri"},"maxItems":10},"reply_options":{"title":"Contact Quick Reply","type":"array","description":"The quick reply selection the contact wishes to respond with. These map to buttons displayed in the Messenger UI if sent by a bot, or the reply options sent by an Admin via the API.","items":{"title":"Quick Reply Option","type":"object","properties":{"text":{"type":"string","description":"The text of the chosen reply option."},"uuid":{"type":"string","format":"uuid","description":"The unique identifier for the quick reply option selected."}},"required":["text","uuid"]}}},"required":["message_type","type"]}}},"name":"Reply to a ticket","id":"intercom.replyticket","example":{"path":{"ticket_id":"123"}},"maxRequests":1,"summary":false}}