Adding incoming call events to swagger

specification/eventgrid/data-plane/Microsoft.Communication/stable/2018-01-01/AzureCommunicationServices.json

@@ -7,6 +7,41 @@
   },
   "paths": {},
   "definitions": {
+    "AcsIncomingCallEventData": {
+      "description": "Schema of the Data property of an EventGridEvent for an Microsoft.Communication.IncomingCall event",
+      "properties": {
+        "to": {
+          "description": "The communication identifier of the target user.",
+          "$ref": "../../../../../communication/data-plane/Common/stable/2021-03-07/common.json#/definitions/CommunicationIdentifierModel",
+          "x-ms-client-name": "toCommunicationIdentifier"
+        },
+        "from": {
+          "description": "The communication identifier of the user who initiated the call.",
+          "$ref": "../../../../../communication/data-plane/Common/stable/2021-03-07/common.json#/definitions/CommunicationIdentifierModel",
+          "x-ms-client-name": "fromCommunicationIdentifier"
+        },
+        "serverCallId": {
+          "description": "The Id of the server call",
+          "type": "string"
+        },
+        "callerDisplayName": {
+          "description": "Display name of caller.",
+          "type": "string"
+        },
+        "customContext": {
+          "description": "Custom Context of Incoming Call",
+          "$ref": "#/definitions/AcsIncomingCallCustomContext"
+        },
+        "incomingCallContext": {
+          "description": "Signed incoming call context.",
+          "type": "string"
+        },
+        "correlationId": {
+          "description": "CorrelationId (CallId).",
+          "type": "string"
+        }
+      }
+    },
     "AcsUserDisconnectedEventData": {
       "description": "Schema of the Data property of an EventGridEvent for an Microsoft.Communication.UserDisconnected event.",
       "properties": {
@@ -861,6 +896,30 @@
           "type": "string"
         }
       }
+    },
+    "AcsIncomingCallCustomContext": {
+      "description": "Custom Context of Incoming Call",
+      "type": "object",
+      "properties": {
+        "customHeaders": {
+          "type": "string",
+          "description": "Custom Headers for incoming call"
+        },
+        "sipHeaders": {
+          "type": "object",
+          "description": "Sip Headers for incoming call",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "voipHeaders": {
+          "type": "object",
+          "description": "Voip Headers for incoming call",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      }
     }
   }
 }

specification/eventgrid/data-plane/Microsoft.Communication/stable/2018-01-01/examples/cloud-events-schema/incoming_call.json

@@ -0,0 +1,38 @@
+{
+  "id": "e80026e7-e298-46ba-bc42-dab0eda92581",
+  "source": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/Microsoft.Communication/communicationServices/{communication-services-resource-name}",
+  "subject": "/caller/{caller-id}/recipient/{recipient-id}",
+  "data": {
+    "to": {
+      "kind": "communicationUser",
+      "rawId": "{recipient-id}",
+      "communicationUser": {
+        "id": "{recipient-id}"
+      }
+    },
+    "from": {
+      "kind": "communicationUser",
+      "rawId": "{caller-id}",
+      "communicationUser": {
+        "id": "{caller-id}"
+      }
+    },
+    "serverCallId": "{server-call-id}",
+    "callerDisplayName": "VOIP Caller",
+    "customContext": {
+      "sipHeaders": {
+        "userToUser": "616d617a6f6e5f6368696;encoding=hex",
+        "X-MS-Custom-myheader1": "35567842",
+        "X-MS-Custom-myheader2": "customsipheadervalue"
+      },
+      "voipHeaders": {
+        "customHeader": "customValue"
+      }
+    },
+    "incomingCallContext": "{incoming-call-contextValue}",
+    "correlationId": "correlationId"
+  },
+  "type": "Microsoft.Communication.IncomingCall",
+  "specversion": "1.0",
+  "time": "2023-04-04T17:18:42.5542219Z"
+}

specification/eventgrid/data-plane/Microsoft.Communication/stable/2018-01-01/examples/event-grid-schema/incoming_call.json

@@ -0,0 +1,39 @@
+{
+  "id": "e80026e7-e298-46ba-bc42-dab0eda92581",
+  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/Microsoft.Communication/communicationServices/{communication-services-resource-name}",
+  "subject": "/caller/{caller-id}/recipient/{recipient-id}",
+  "data": {
+    "to": {
+      "kind": "communicationUser",
+      "rawId": "{recipient-id}",
+      "communicationUser": {
+        "id": "{recipient-id}"
+      }
+    },
+    "from": {
+      "kind": "communicationUser",
+      "rawId": "{caller-id}",
+      "communicationUser": {
+        "id": "{caller-id}"
+      }
+    },
+    "serverCallId": "{server-call-id}",
+    "callerDisplayName": "VOIP Caller",
+    "customContext": {
+      "sipHeaders": {
+        "userToUser": "616d617a6f6e5f6368696;encoding=hex",
+        "X-MS-Custom-myheader1": "35567842",
+        "X-MS-Custom-myheader2": "customsipheadervalue"
+      },
+      "voipHeaders": {
+        "customHeader": "customValue"
+      }
+    },
+    "incomingCallContext": "{incoming-call-contextValue}",
+    "correlationId": "correlationId"
+  },
+  "eventType": "Microsoft.Communication.IncomingCall",
+  "dataVersion": "1.0",
+  "metadataVersion": "1",
+  "eventTime": "2023-04-04T17:18:42.5542219Z"
+}