add sms messaging support

lib/swagger/swagger.yaml

@@ -1249,10 +1249,13 @@ paths:
                   format: uuid
                 call_hook:
                   $ref: '#/components/schemas/Webhook'
-                  description: authentication webhook for inbound calls from PSTN
+                  description: application webhook to handle inbound voice calls
                 call_status_hook:
                   $ref: '#/components/schemas/Webhook'
-                  description: webhook for call status events
+                  description: webhook to report call status events
+                messaging_hook:
+                  $ref: '#/components/schemas/Webhook'
+                  description: application webhook to handle inbound SMS/MMS messages
                 speech_synthesis_vendor:
                   type: string
                 speech_synthesis_voice:
@@ -1433,9 +1436,9 @@ paths:
             application/json:
               schema:
                 required:
-                  - callSid
+                  - sid
                 properties:
-                  callSid:
+                  sid:
                     type: string
                     format: uuid
                     example: 2531329f-fb09-4ef7-887e-84e648214436
@@ -1465,8 +1468,6 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/GeneralError'
-
-
   /Accounts/{AccountSid}/Calls/{CallSid}:
     parameters:
       - name: AccountSid
@@ -1567,7 +1568,39 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GeneralError'                
+                $ref: '#/components/schemas/GeneralError'
+  /Accounts/{AccountSid}/Messages:
+    post:
+      summary: create an outgoing SMS message
+      operationId: createMessage
+      parameters:
+      - name: AccountSid
+        in: path
+        required: true
+        schema:
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Message'
+      responses:
+        201:
+          description: call successfully created
+          content:
+            application/json:
+              schema:
+                required:
+                  - sid
+                properties:
+                  sid:
+                    type: string
+                    format: uuid
+                    example: 2531329f-fb09-4ef7-887e-84e648214436
+                  providerResponse:
+                    type: string
+        400:
+          description: bad request         
 components:
   securitySchemes:
     bearerAuth:
@@ -1715,10 +1748,13 @@ components:
           format: uuid
         call_hook:
           $ref: '#/components/schemas/Webhook'
-          description: authentication webhook for registration
+          description: application webhook for inbound voice calls
         call_status_hook:
           $ref: '#/components/schemas/Webhook'
-          description: authentication webhook for registration
+          description: webhhok for reporting call status events
+        messaging_hook:
+          $ref: '#/components/schemas/Webhook'
+          description: application webhook for inbound SMS/MMS
         speech_synthesis_vendor:
           type: string
         speech_synthesis_voice:
@@ -1731,8 +1767,6 @@ components:
         - application_sid
         - name
         - account_sid
-        - inbound_hook
-        - inbound_status_hook
     ApiKey:
       type: object
       properties:
@@ -1914,6 +1948,22 @@ components:
       required:
         - type
       example: {"type": "phone", "number": "+16172375080"}
+    Message:
+      properties:
+        provider:
+          type: string
+        from:
+          type: string
+        to:
+          type: string
+        text:
+          type: string
+        media:
+          type: string
+      required:
+        - from
+        - to
+      example: {"from": "13394445678", "to": "16173333456", "text": "please call when you can"}
 
 security:
   - bearerAuth: []