Link Reply to a conversation and Manage a conversation

The Reply page only lists comment, note and quick_reply for admins, so
readers don't find close, open, snooze or assign. Point each endpoint
at the other in Preview and 2.16.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: NanetteTaylor

descriptions/0/api.intercom.io.yaml

@@ -14518,6 +14518,10 @@ paths:
         - Snooze a conversation to reopen on a future date
         - Open a conversation which is `snoozed` or `closed`
         - Assign a conversation to an admin and/or team.
+
+        {% admonition type="info" name="Sending messages" %}
+        To send a comment, note or quick reply, use [Reply to a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/replyconversation).
+        {% /admonition %}
       responses:
         '200':
           description: Assign a conversation
@@ -28563,7 +28567,10 @@ components:
     admin_reply_conversation_request:
       title: Admin Reply
       type: object
-      description: Payload of the request to reply on behalf of an admin
+      description: |-
+        Payload of the request to reply on behalf of an admin.
+
+        To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/preview/rest-api/api.intercom.io/conversations/manageconversation).
       properties:
         message_type:
           type: string

descriptions/2.16/api.intercom.io.yaml

@@ -12941,6 +12941,10 @@ paths:
         - Snooze a conversation to reopen on a future date
         - Open a conversation which is `snoozed` or `closed`
         - Assign a conversation to an admin and/or team.
+
+        {% admonition type="info" name="Sending messages" %}
+        To send a comment, note or quick reply, use [Reply to a conversation](/docs/references/rest-api/api.intercom.io/conversations/replyconversation).
+        {% /admonition %}
       responses:
         '200':
           description: Assign a conversation
@@ -23588,7 +23592,10 @@ components:
     admin_reply_conversation_request:
       title: Admin Reply
       type: object
-      description: Payload of the request to reply on behalf of an admin
+      description: |-
+        Payload of the request to reply on behalf of an admin.
+
+        To close, open, snooze or assign a conversation, use [Manage a conversation](/docs/references/rest-api/api.intercom.io/conversations/manageconversation).
       properties:
         message_type:
           type: string