chore: Swagger documentation for public APIs (#2417)

swagger/definitions/request/public/contact/create_update_payload.yml

@@ -0,0 +1,21 @@
+
+type: object
+properties:
+  identifier:
+    type: string
+    description: External identifier of the contact
+  identifier_hash:
+    type: string
+    description: Identifier hash prepared for HMAC authentication
+  email:
+    type: string
+    description: Email of the contact
+  name: 
+    type: string
+    description: Name of the contact
+  avatar_url:
+    type: string
+    description: The url to a jpeg, png file for the user avatar
+  custom_attributes:
+    type: object
+    description: Custom attributes of the customer

swagger/definitions/request/public/message/create_payload.yml

@@ -0,0 +1,10 @@
+
+type: object
+properties:
+  content:
+    type: string
+    description: Content for the message
+  echo_id:
+    type: string
+    description: Temporary identifier which will be passed back via websockets
+  

swagger/definitions/request/public/message/update_payload.yml

@@ -0,0 +1,8 @@
+
+type: object
+properties:
+  submitted_values:
+    type: object
+    description: Replies to the Bot Message Types
+
+