Restructure omni services and add Chatwoot research snapshot

research/chatwoot/swagger/paths/public/inboxes/conversations/create.yml

@@ -0,0 +1,25 @@
+tags:
+  - Conversations API
+operationId: create-a-conversation
+summary: Create a conversation
+description: Create a conversation
+security: []
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        $ref: '#/components/schemas/public_conversation_create_payload'
+responses:
+  '200':
+    description: Success
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/public_conversation'
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

research/chatwoot/swagger/paths/public/inboxes/conversations/index.yml

@@ -0,0 +1,22 @@
+tags:
+  - Conversations API
+operationId: list-all-contact-conversations
+summary: List all conversations
+description: List all conversations for the contact
+security: []
+responses:
+  '200':
+    description: Success
+    content:
+      application/json:
+        schema:
+          type: array
+          description: 'Array of conversations'
+          items:
+            $ref: '#/components/schemas/public_conversation'
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

research/chatwoot/swagger/paths/public/inboxes/conversations/show.yml

@@ -0,0 +1,25 @@
+tags:
+  - Conversations API
+operationId: get-single-conversation
+summary: Get a single conversation
+description: Retrieves the details of a specific conversation
+security: []
+responses:
+  '200':
+    description: Success
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/public_conversation'
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
+    description: Conversation not found
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

research/chatwoot/swagger/paths/public/inboxes/conversations/toggle_status.yml

@@ -0,0 +1,25 @@
+tags:
+  - Conversations API
+operationId: resolve-conversation
+summary: Resolve a conversation
+description: Marks a conversation as resolved
+security: []
+responses:
+  '200':
+    description: Conversation resolved successfully
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/public_conversation'
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
+    description: Conversation not found
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

research/chatwoot/swagger/paths/public/inboxes/conversations/toggle_typing.yml

@@ -0,0 +1,40 @@
+tags:
+  - Conversations API
+operationId: toggle-typing-status
+summary: Toggle typing status
+description: Toggles the typing status in a conversation
+security: []
+parameters:
+  - name: typing_status
+    in: query
+    required: true
+    schema:
+      type: string
+    description: Typing status, either 'on' or 'off'
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        type: object
+        properties:
+          typing_status:
+            type: string
+            enum: ['on', 'off']
+            description: The typing status to set
+            example: 'on'
+responses:
+  '200':
+    description: Typing status toggled successfully
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
+    description: Conversation not found
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

research/chatwoot/swagger/paths/public/inboxes/conversations/update_last_seen.yml

@@ -0,0 +1,21 @@
+tags:
+  - Conversations API
+operationId: update-last-seen
+summary: Update last seen
+description: Updates the last seen time of the contact in a conversation
+security: []
+responses:
+  '200':
+    description: Last seen updated successfully
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
+    description: Conversation not found
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'