chore: Add documentation for automation rule, fix conversation/inbox_members (#4852)

swagger/definitions/resource/automation_rule.yml

@@ -0,0 +1,45 @@
+type: object
+properties:
+  event_name:
+    type: string
+    description: Automation Rule event, on which we call the actions(conversation_created, conversation_updated, message_created)
+    enum:
+      - conversation_created
+      - conversation_updated
+      - message_created
+    example: message_created
+  name:
+    type: string
+    description: The name of the rule
+    example: Add label on message create event
+  description:
+    type: string
+    description: Description to give more context about the rule
+    example: Add label support and sales on message create event if incoming message content contains text help
+  active:
+    type: boolean
+    description: Enable/disable automation rule
+  actions:
+    type: array
+    description: Array of actions which we perform when condition matches
+    items:
+      type: object
+      example:
+        action_name: add_label
+        action_params:
+          - support
+          - sales
+  conditions:
+    type: array
+    description: Array of conditions on which conversation/message filter would work
+    items:
+      type: object
+      example:
+        attribute_key: content
+        filter_operator: contains
+        values:
+          - help
+        query_operator: nil
+  account_id:
+    type: integer
+    description: Account Id

swagger/definitions/resource/contact.yml

@@ -15,6 +15,10 @@ properties:
   additional_attributes:
     type: object
     description: The object containing additional attributes related to the contact
+  custom_attributes:
+    type: object
+    description: The object to save custom attributes for contact, accepts custom attributes key and value
+    example: { attribute_key: attribute_value, signed_up_at: dd/mm/yyyy }
   contact_inboxes:
     type: array
     items:

swagger/definitions/resource/conversation.yml

@@ -30,3 +30,7 @@ properties:
   additional_attributes:
     type: object
     description: The object containing additional attributes related to the conversation
+  custom_attributes:
+    type: object
+    description: The object to save custom attributes for conversation, accepts custom attributes key and value
+    example: { attribute_key: attribute_value, priority_conversation_number: 3 }