From 023cfea059e20dc78d18ecb998b5ea085d8d02f5 Mon Sep 17 00:00:00 2001
From: Hugh Nimmo-Smith <hughns@element.io>
Date: Thu, 19 Sep 2024 11:06:37 +0100
Subject: [PATCH 1/3] Create xxxx-matrixrtc-m-call.md

---
 proposals/xxxx-matrixrtc-m-call.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 proposals/xxxx-matrixrtc-m-call.md

diff --git a/proposals/xxxx-matrixrtc-m-call.md b/proposals/xxxx-matrixrtc-m-call.md
new file mode 100644
index 00000000000..1549ff8f0ec
--- /dev/null
+++ b/proposals/xxxx-matrixrtc-m-call.md
@@ -0,0 +1,13 @@
+# MSC0000: MatrixRTC voice and video conferencing application `m.call`
+
+## Proposal
+
+## Potential issues
+
+## Alternatives
+
+## Security considerations
+
+## Unstable prefix
+
+## Dependencies

From ff42c6179ff9e3fed83b618dc5701b347ceac5d3 Mon Sep 17 00:00:00 2001
From: Hugh Nimmo-Smith <hughns@element.io>
Date: Thu, 19 Sep 2024 11:07:37 +0100
Subject: [PATCH 2/3] Allocated MSC number

---
 .../{xxxx-matrixrtc-m-call.md => 4196-matrixrtc-m-call.md}      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename proposals/{xxxx-matrixrtc-m-call.md => 4196-matrixrtc-m-call.md} (65%)

diff --git a/proposals/xxxx-matrixrtc-m-call.md b/proposals/4196-matrixrtc-m-call.md
similarity index 65%
rename from proposals/xxxx-matrixrtc-m-call.md
rename to proposals/4196-matrixrtc-m-call.md
index 1549ff8f0ec..238be2f9ae7 100644
--- a/proposals/xxxx-matrixrtc-m-call.md
+++ b/proposals/4196-matrixrtc-m-call.md
@@ -1,4 +1,4 @@
-# MSC0000: MatrixRTC voice and video conferencing application `m.call`
+# MSC4196: MatrixRTC voice and video conferencing application `m.call`
 
 ## Proposal
 

From 3623ff0fc55460605ec8e749c543f531ef996c67 Mon Sep 17 00:00:00 2001
From: Hugh Nimmo-Smith <hughns@element.io>
Date: Tue, 17 Dec 2024 07:13:17 +0000
Subject: [PATCH 3/3] Latest

---
 proposals/4196-matrixrtc-m-call.md | 64 ++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/proposals/4196-matrixrtc-m-call.md b/proposals/4196-matrixrtc-m-call.md
index 238be2f9ae7..24aa06ce5bf 100644
--- a/proposals/4196-matrixrtc-m-call.md
+++ b/proposals/4196-matrixrtc-m-call.md
@@ -2,6 +2,65 @@
 
 ## Proposal
 
+We define a MatrixRTC application type of `m.call`.
+
+### `m.rtc.member` state event
+
+A valid `m.rtc.member` state event with application `m.call` has the following fields in addition to the fields defined in [MSC4143](https://github.com/matrix-org/matrix-spec-proposals/pull/4143):
+
+- `session` required object:
+  - `application` required string: `m.call`
+  - `call_id` required string: The call ID of the session. Use `""` for a room level call.
+  - `scope` required string: The scope of the call. One of: `m.room`. More scopes may be added in the future.
+
+For example:
+
+```json5
+// event type: "m.rtc.member"
+// MSC3757 formatted state key: "@user:matrix.domain_xyzABCDEF10123"
+{
+  // standard fields from MSC4143:
+  "member": {
+    "id": "xyzABCDEF10123",
+    "device_id": "DEVICEID",
+    "user_id": "@user:matrix.domain"
+  }
+  "focus_active": { ...focus_1 },
+  "foci_preferred": [
+    { ...focus_1 },
+  ],
+  "session": {
+    "application": "m.call",
+    // additional fields for m.call:
+    "call_id": "",
+    "scope": "m.room"
+  }
+}
+```
+
+### Ringing with the `m.rtc.notify` room event
+
+A valid `m.rtc.notify` event with application `m.call` has the following fields in addition to the fields defined in [MSC4075](https://github.com/matrix-org/matrix-spec-proposals/pull/4075):
+
+- `session` required object: the contents of the `session` from the `m.rtc.member` event.
+
+```json5
+// event type: "m.rtc.notify"
+{
+  "content": {
+    // standard fields from MSC4075:
+    "application": "m.call",
+    "m.mentions": {"user_ids": [], "room": true },
+    "notify_type": "notification",
+    "session": {
+      "application": "m.call",
+      // for application = "m.call":
+      "call_id": ""
+    }
+  }
+}
+```
+
 ## Potential issues
 
 ## Alternatives
@@ -10,4 +69,9 @@
 
 ## Unstable prefix
 
+The `m.call` application type is already within unstable prefixed entries (e.g.
+`org.matrix.msc3401.call.member`) and as such doesn't need its own unstable prefix.
+
 ## Dependencies
+
+This MSC builds on [MSC4143](https://github.com/matrix-org/matrix-spec-proposals/pull/4143) and [MSC4075](https://github.com/matrix-org/matrix-spec-proposals/pull/4075).