The JSON format for vCon - Conversation Data Container

Internet-Draft	JSON vCon	October 2026
Petrie	Expires 4 May 2027	[Page]

Abstract

vCon is a standardized framework for the exchange of conversational data. Conversations, which may involve one or more participants, occur across a wide variety of modes and application platforms. This document defines a JSON format for representing conversational data, encompassing metadata, conversation media, related documents, and analysis. The goal of this standard is to provide an abstracted, platform-independent data format for conversations, regardless of the mode or application platform. By doing so, it facilitates the integration and seamless exchange of conversational data across application platforms, enterprises, and trust boundaries.¶

4. Unsigned Form of vCon Object

The unsigned form of the top level vCon object is necessary as in many cases, a vCon will be partially constructed and in process as conversation data is collected. This may change while the conversation is in progress or on-going. The vCon may start with only meta data and party information, then progress to contain dialog information. It may then get analysis added or it could be passed to another security domain for analysis. A vCon in the unsigned form SHOULD contain at least one of the parties, dialog, analysis or attachments parameters.¶

A vCon may be constructed across several security domains. When a vCon is to be exported from one security domain to another, it SHOULD be signed or encrypted by the domain that constructed it. The subsequent domain may have need to redact or amend data to the vCon. Alternatively the originating domain may want to redact the vCon before providing it to another domain. The second or subsequent domain, MAY modify the prior vCon instance version and when complete or exporting to another security domain, it SHOULD sign or encrypt the new vCon instance version. The new vCon instance version SHOULD refer to the prior vCon instance version via the redacted_from (Section 4.1.8) or amended_from (Section 4.1.9) parameters - see Redaction Techniques (Section 5).¶

4.1. vCon JSON Object Keys and Values

The keys and values for the top level vCon JSON object are defined in the following subsections.¶

4.1.1. vcon

The "vcon" parameter is DEPRECATED as of the publication of this document as an RFC. The "vcon" parameter was used to differentiate schema changes to the vCon core container when incompatibilities were created in Internet-Draft versions. The extension mechanism replaces the need for schema versioning. The vcon parameter was used to contain the syntactic version of the JSON format used in the vCon. (see Non-Upward Compatible Changes to the vCon Container (Appendix A))¶

vcon: "String"¶

For syntax defined in this document, the string MUST have the value: "0.5.0"¶

4.1.2. uuid

The [UUID] for the vCon is used to refer to it when privacy or security may not allow for inclusion or URL reference to a vCon. The UUID value MUST be globally unique. All vCon documents MUST have the uuid parameter and value set.¶

uuid: "String"¶

The value of the string SHOULD be generated using the version 8 UUID defined in [UUID] which is generated identically to a version 7 UUID with the exception that:¶

rand_b/custom_c is generated from the high 62 bits of the SHA-1 hash of the FQHN string¶
the variant and version fields are set as described for version 8 UUID¶

The DNS name string used in generating the uuid value SHOULD be the same FQHN, or a subdomain to allow for more distributed generation of UUIDs, as would used in the signing certificate as they are the same domains of uniqueness.¶

4.1.3. extensions

The vCon schema can be extended through the definition of new extensions. The extensions parameter MUST contain the list of names of all vCon extensions which define any parameters, Objects or parameter values used in the vCon that are not defined in this core vCon schema document. Each extension name listed in the critical parameter MUST also be listed in the extensions parameter (see Section 4.1.4).¶

extensions: "String[]" (optional, MUST be present if any vCon extension is used)¶

4.1.4. critical

Implementations that include extensions which are incompatible with the core vCon schema MUST list the names of those extensions in the critical parameter. A vCon that includes a critical parameter indicates that correct interpretation of the vCon requires explicit support for the listed extensions. An implementation that does not recognize or support the extensions listed in the critical parameter MUST NOT attempt to process or operate on the vCon, except to reject it or report unsupported content.¶

critical: "String[]" (optional, MUST be present if any Incompatible vCon extension is used)¶

4.1.5. created_at

The created_at parameter provides the creation time of this vcon, which MUST be present, and should not change once the vcon object is created.¶

created_at: "Date"¶

4.1.6. updated_at

The updated_at parameter provides the last modified time of this vcon, which MAY be present. For unsigned forms, the updated_at of the vcon object SHOULD be updated as it is modified. For signed forms of the vCon object, the updated_at contains the time when this vcon was last signed. Future updates MUST first set the updated_at to the new signing time as the vcon object is signed again.¶

updated_at: "Date"¶

4.1.7. subject

The subject or the topic of the conversation is provided in the subject parameter. This parameter is optional as not all conversations have a defined subject. Email threads and prescheduled calls and video conferences typically have a subject which can be captured here. The subject may also be derived from analysis of the dialog.¶

subject: "String" (optional)¶

The string value of the subject parameter is a free formed JSON string with no constrained syntax.¶

4.1.8. redacted_from

A redacted vCon SHOULD provide a reference to the unredacted or prior, less redacted, vCon instance version of itself. The purpose of the Redacted_from Object (Section 4.1.8.1) is to provide the reference to the unredacted or less redacted version of the vCon from which this vCon was derived. For privacy reasons, it may be necessary to redact a vCon to construct another vCon without the PII. This allows the non-PII portion of the vCon to still be analyzed or used in a broader scope. The Redacted_from Object (Section 4.1.8.1) SHOULD contain the uuid parameter and MAY include the url, content_hash parameters (see Externally Referenced Files (Section 2.4)). If a reference to the unredacted vCon is provided in the url parameter, the access to that URL MUST be restricted to only those who should be allowed to see the identity or PII for the redacted vCon.¶

Redaction techniques are discussed in more detail in Redaction Techniques (Section 5). The assurance of the accuracy of the redaction is made by the entity that creates the redaction which SHOULD sign the redacted version of the vCon.¶

redacted_from: "Redacted_from" (optional, mutually exclusive with amended_from parameter)¶

4.1.8.1. Redacted_from Object

A Redacted_from Object contains the following parameters:¶

uuid: "String"¶

The value contains the uuid string value (Section 4.1.2) of the unredacted/prior vCon instance version. The absence of a value for uuid indicates that the less redacted version of this vCon is not available or does not exist.¶

type: "String"¶

The value of the redacted type parameter is used to indicate the type of redaction that was performed on this vCon relative to the less redacted version referenced by the redacted uuid parameter. This should indicate the type of information that was redacted, and has the same set of values defined for the type field of the redacted_string object.¶

The the location of the referenced vCon MAY be provided as defined in Externally Referenced Files (Section 2.4) by including url and content_hash. content_hash MUST be included if url is provided.¶

url: "String"¶
content_hash: "ContentHash" | "ContentHash[]"¶

The following diagram illustrates an example partial JSON object tree for a redacted vCon. The top level object is a JWS signed vCon which contains a vCon in the unsigned form in the payload parameter. The second level object is the redacted vcon which refers to the encrypted unredacted vCon in it's redacted_from parameter. Note that the redacted vCon references the JWE encrypted vCon by UUID and may reference it by URL. The JWE encrypted unredacted vCon contains the signed version of the unredacted vCon in the ciphertext parameter. The signed unredacted vCon contains the unredacted vCon in the unsigned form in it's payload parameter.¶

                --------------
Signed          | JWS   uuid-|-- redacted vCon uuid in header
redacted vCon:  |            |
                |    payload-|-- unsigned redacted vCon in
                -------------- / payload parameter
                              /
            ----------------    /
vCon which  |vCon          |<---
has been    |              |
redacted:   |redacted_from-|-- Redacted Object
            ---------------- / refers to JWE
                            /  encrypted unredacted vCon
                           /
                          /
                         /
                        /
                       /
                      /
                     /
                    / ---------------   signed unredacted vCon
                    ->| JWE    uuid-|-- uuid in unprotected
Encrypted signed      |             |
unredacted vCon:      |  cyphertext-|--- JWS signed
                      ---------------  / unredacted vCon
                                      / in cyphertext
                 /-------------------/ parameter
                /
               /  -------------
Signed         -> |JWS   uuid-|-- unredacted vCon uuid in header
unredacted vcon:  |           |
                  |   payload-|-- unsigned unredacted vCon
                  -------------  \ in payload
                                  \   ----------
                                   -->| vCon   |
Unsigned unredacted vCon:             |        |
                                      ----------

Figure 1: redacted vCon object tree

4.1.9. amended_from

A signed or encrypted vCon cannot be modified without invalidating it. In these cases, to allow for adding of additional information a new vCon instance version MUST be created. The prior vCon instance version is referenced by the Amended_from Object (Section 4.1.9.1). The vCon with amended data contains all of the data that is in the referenced vCon with the exception of data that is amended. That is to say that the newer version of the vCon is a deep copy of the prior version with the amended and additional data added to it.¶

The prior vCon instance version SHOULD be referenced via the uuid of the prior vCon instance version, and MAY include the url and content_hash parameters (see Externally Referenced Files (Section 2.4)).¶

amended_from: "Amended_from" (optional, mutually exclusive with redacted_from parameter)¶

4.1.9.1. Amended_from Object

The Amended_from Object contains the following parameters:¶

uuid: "String" (optional if external reference provided)¶

The value contains the uuid string value (Section 4.1.2) of the prior vCon instance version, to which this vCon's amendments were applied. The prior vCon instance version may be the original vCon, a redacted vCon, or a previously amended vCon.¶

The location of the referenced vCon MAY be provided, as defined in Externally Referenced Files (Section 2.4) by including url and content_hash. content_hash MUST be provided if url is provided.¶

url: "String"¶
content_hash: "ContentHash" | "ContentHash[]"¶

The following figure illustrates an example partial JSON object tree for an amended vCon. The top level object is the JWS signed amended vCon which contains the unsigned form of the vCon in its payload parameter. The second level object is the amended vCon with additional conversational data (e.g. analysis data). It refers to the prior vCon instance version in its amended parameter. Note: the amended_from parameter may refer to the prior vCon instance version via URL. The amended vCon in this figure refers to the JWS signed version of the vCon, which in turn contains the original vCon in unsigned form in its payload parameter.¶

                --------------
Signed          | JWS   uuid-|-- amended vCon uuid in header
amended vCon:   |            |
                |    payload-|-- payload parameter
                -------------- / contains unsigned
                              / amended vCon
            ---------------  /
vCon with   |vCon         |<-
amended     |             |
data:       |amended_from-|--- amended_from parameter
            |    analysis-|  / refers to JWS
            --------------- / signed original vCon
                           / along with additional
                          / conversational data
                         / (e.g. analysis)
                        /
                       /
                      /
                     /
                    / ------------
                    ->| JWS uuid-|-- original vCon uuid in header
signed                |          |
original vCon:        |  payload-|--- payload parameter
                      ------------  / contains unsigned
                                   / original vCon
                  -------------   /
Original vCon:    |vCon       |<--
                  |           |
                  |   parties |
                  |   dialog  |
                  -------------

Figure 2: amended vCon object tree

4.1.10. sessions Objects Array

A vCon can contain a single conversation, several conversations, sub-conversations or side bar conversations. The Session Object is used to group dialog Objects into sets of dialog to represent those conversations. A Session Object can "contain" other Session Objects by reference. A simple conversation has only 1 Session Object for all of the Dialogs. At least one Session Object MUST exist if the Events array or the Dialog array contain objects.¶

TODO: Session Object required if Attachments is not empty too?¶

sessions: "Session[]" (optional)¶

The value of the sessions parameter is an array of Session Objects (Section 4.2).¶

Examples of where multiple Session Objects are used to show the topology of the conversation and dialog include:¶

4.1.10.1. Call Transfer

A customer calls into a contact center, which results in a call to a bot, that call gets transferred to an agent, the agent has a consultation with a supervisor, the customer gets transferred to the supervisor. From the customer's perspective this was one call. In reality it was 3 different calls.¶

This may be represented as Session Object which references 3 other Session Object:¶

The original call with the bot¶
the call between the agent and the supervisor¶
The call resulting from the transfer of the customer to the supervisor¶

4.1.10.2. Dialog per Stream

Some call recorders create a separate single channel recording for each leg or stream in the call, each resulting in a Dialog Object. To show that those Dialog Objects are all in the same call or conversation, we create a Session Object which refers to all of the Dialog Objects that were a part of it.¶

4.1.10.3. Dialog per Talk Spurt

Some call recorders create separate single channel recordings for each contiguous talk spurt for a Party or stream. This may result in several Dialogs for some of the parties in the call. In this case we need the Session Object to indicate which Dialogs compose the call or conversation. We also need the Session Object to declare the start and duration of the call, as each Dialog Object only defines the start and duration of its talk spurt.¶

4.1.10.4. Agent Coaching

In contact centers, an agent talking to a customer may be monitored by a supervisor. In this scenario, the customer and the agent can hear each other, the agent and the supervisor can hear each other, but the customer cannot hear the supervisor, the supervisor can hear both the customer and the agent. In the simple case, we have 3 Dialog Objects and 2 Session Objects.¶

Dialog Objects containing:¶

The customer talking¶
The agent talking¶
The supervisor talking¶

Session Objects referencing Session and Dialog Objects:¶

The top level Session Object which references the following Session Objects¶
The customer Session which references the customer and agent dialog recordings¶
The supervisor Session which references the customer, the agent and supervisor dialog recordings¶

4.1.10.5. AI Agent

A conversation may occur between an AI agent and a human. That AI agent in turn may converse with other AI agents, to fulfill a response to the human. This can recurse such that the second tier AI agents talk to 3rd tier AI agents or even other humans and so on. The top level Session object might represent the conversation between the human and the top level AI agent. That top level Session Object would refer to other Session Objects for the second tier AI agent conversations. Those Session Objects may refer to Session Objects for the 3rd tier AI agent conversations and so on. This example describes how both human to AI agent as well as AI agent to AI agent conversations can be captured in a vCon.¶

4.1.11. parties Objects Array

The name, identity or contact information of all of the parties involved with the conversation are included in the parties object array. Whether the parties were observers, passive or active participants in the conversation, they each are included as a Party Object in the parties array.¶

parties: "Party[]" (optional)¶

The value of the parties parameter is an array of Party Objects (Section 4.4).¶

4.1.12. events Objects Array

All events which occur related to this vCon are included in this array of Event Objects. Event Objects MAY appear in any order in the events array and are not required to be in chronological order. Events may be in non-chronological order because of network or consolidation delays. The time parameter of each Event Object is used to determine the sequence in which the events occurred.¶

events: "Event[]" (optional)¶

The value of the events parameter is an array of Event Objects (Section 4.3).¶

4.1.13. dialog Objects Array

The actual conversation which occurred over text, audio or video that was captured, is contained in the dialog Objects Array.¶

dialog: "Dialog[]" (optional)¶

The value of the dialog parameter is an array of Dialog Objects (Section 4.5). It should be noted that the Dialog Objects may not be sorted in chronological order. They are in the order that they were added. It is the applications responsibility to sort dialog and transcriptions if they are needed in chronological order.¶

4.1.14. analysis Objects Array

Analysis, which is performed on the conversational data, is stored in the analysis Objects array.¶

analysis: "Analysis[]" (optional)¶

The value of the analysis parameter is an array of Analysis Objects (Section 4.7).¶

4.1.15. attachments Objects Array

Ancillary documents, discussed, presented, referenced or related to the conversation may be stored in the attachments array. It should be noted that the Attachment Objects may not be sorted in chronological order. They are in the order that they were added.¶

attachments: "Attachment[]" (optional)¶

The value of the attachments parameter is an array of Attachment Objects (Section 4.6).¶

4.1.16. redacted_strings Objects Array

A vCon can contain sensitive information in string values in many places. A text dialog containing chat messages or emails might contain a person's first name, or a street address, or an account number. Events, like a tool call made by an AI agent - can contain an account ID or social security number.¶

The vCon format provides a general purpose solution for redacting sensitive information from any string in the object. Any string which has a substring containing sensitive information can be replaced by "_REDACTED_REF#", where the value of # is a positive integer which uniquely identifies the substring that was replaced. Within the redacted_strings array there will be a member that contains a matching reference, along with meta-data about the redaction, such as the type of information that was redacted.¶

The redacted_strings array is defined as:¶

redacted_strings: "Redacted_string[]" (optional)¶

Where the Redacted_string object is defined in Redacted_string Object (Section 4.8).¶

As an example, consider the following simplified event, which contains a tool call that has an account ID in it. Several mandatory parameters have been omitted for ease of understanding:¶

{
  "events" : [
    {
      "type" : "tool-call",
      "tool_name" : "close_account_by_id",
      "input-params" : [
        {
          "input-name" : "account_id",
          "input-value" : "293827344"
        }
      ]
    }
  ]
}

You can see that this contains a sensitive account ID. Here is a version that is now redacted.¶

{
  "events" : [
    {
      "type" : "tool-call",
      "tool_name" : "close_account_by_id",
      "input-params" : [
        {
          "input-name" : "account_id",
          "input-value" : "__REDACTED_REF_1"
        }
      ]
    }
  ]
}

There will then be an entry in the redacted_strings array like this:¶

  "redacted_strings" : [
    {
      "ref" : 1,
      "type" : "FIN_ID_NUM"
    }
  ]

Implementations created a vCon that perform this kind of string redaction MUST include an entry in the redacted_strings array for every unique substring value they redact. A single vCon MUST NOT have more than 99999 such substrings redacted, to provide an upper bound on the integer value and to allow bounded regex parsing.¶

Furthermore, a processor of the VCON MUST validate that - for each instance of the regular expression "_REDACTED_REF\d{1,5}$" it finds in the vCon, there is a corresponding entry in the redacted_strings array whose ref value matches the reference digit sequence. If there is no match, then it means the substring was not actually redacted, and the literal substring value is actually whatever matched "_REDACTED_REF\d{1,5}$" for that reference ID. This can happen if a user were to literally type a chat message or email like, "Yeah I'm going to try to break vcon by typing __REDACTED_REF_3 hah hah hah!".¶

This redaction technique allows vCon to have a way of redacting information from strings anywhere, including future extensions to vCon. This means, unless an extension might convey sensitive information in a way for which string redaction is insufficient, it will not need any specific redaction capability defined.¶

4.2. Session Object

The Session Object is used to show the scope for conversational dialog and events. It provides the ability to group dialog and events into sub-conversation. A Session Object can contain by reference other Session Objects to create a nesting or tree relationship with child session(s). It can also support peer relationships to group in logical sequences of evolution of a conversation. For example a conference may split into break out sessions and then merge back together as one conference again.¶

4.2.1. start

The start parameter indicates when this session was started. The start parameter SHOULD be present. The start of the session may be before or after the start of the Dialog and Event Objects which are part of this session (see Section 4.2.2). For example it could be the scheduled start time for a conference where everyone shows up late.¶

start: "Date"¶

The value of the start parameter is the date and time at which the session started.¶

4.2.2. duration

The duration parameter contains the duration in seconds of the session. The start and duration parameters together define the time period of the session, which includes its start and end. The time period of the session need not include the entire time period of the Dialog and Event Objects that are part of this session. Dialog Content of a Dialog Object which is outside of the time period of the session SHOULD be considered to not be part of that session. Whether or how an application renders Dialog Content outside of the time period of the session is an application choice.¶

This allows a session to be scoped to part of a recording without having to split the recording into separate Dialog Objects. For example, a Session Object may be added to a vCon to mark up the portion of a conversation which is of interest, saving a consumer of the vCon from having to listen to or review the whole conversation. Such a Session Object may be a child or a peer of the Session Object for the whole conversation (see Section 4.2.8.2). Dialog Objects referenced by the session may also be entirely outside of the time period of the session. For example, a recording Dialog Object of the opening of a call may be entirely before the time period of a session which marks up a later portion of that call.¶

A "text" type Dialog Object is part of the session in its entirety if any part of the time period given by its start and duration is within the time period of the session. This is because the Dialog Content of a "text" type Dialog Object has no time stamps by which it could be divided. A vCon extension may define a form of text Dialog Content with time stamps at a finer granularity, such as per word, along with how it is scoped by the time period of a session. An "incomplete" type Dialog Object is likewise part of the session in its entirety if any part of the time period given by its start and duration is within the time period of the session.¶

Event Objects which are part of this session are part of the session even if they are outside of the time period of the session. For example, it may be important to know that a party dropped out of the conversation before the start of the session.¶

If the duration parameter is not present, the time period of the session has no end. In this case, all of the Dialog Content of the Dialog Objects referenced by the session which is at or after the start of the session is part of the session.¶

duration: "UnsignedInt" | "UnsignedFloat" (optional)¶

The value MUST be the session duration in seconds.¶

4.2.3. parties

The Session Object parties parameter references the Party Objects from the parties Array that are the receivers of the dialog in this session. The parties parameter SHOULD be present. A party is a receiver if they potentially received any part of the dialog that was exchanged in this session. This is not a guarantee that they received any part of the dialog, only that some part of any dialog in this session was sent to them. The contributors to the dialog in this session are indicated in the Dialog Object parties parameter (Section 4.5.4) of each of the Dialog Objects that are part of this session. A contributor is not necessarily a receiver. For example, an automated announcement or prompt player contributes to the dialog, but does not receive any of it. A contributor that did not potentially receive any part of the dialog in this session SHOULD NOT be included in the Session Object parties parameter. The originator of the session MAY be included in the Session Object parties parameter even if it is not a receiver (see Section 4.2.4). To determine what part(s) of the dialog that a party potentially heard or received, the Event Objects may provide data as to when a party joined, dropped out, went on or off hold.¶

parties: "UnsignedInt[]"¶

The value of the parties parameter is an array of the indices into the parties Object array to the Party Objects that are the receivers of the dialog in the session.¶

4.2.4. originator

The originator party for this session. For email and text, this is the sender of the first message. For audio and video calls, this is the calling party. For a scheduled meeting or conference, this is the organizer, the party that scheduled or created the meeting. The organizer may be a party that never joins the conference; such a party may still be included in the parties array. The organizer is distinct from the party acting as host or controller of the conference at any point during the meeting; identifying the host or controller is out of scope for this document. It is implied that the first party in the Session Object parties list is the originator of the session. If the originator is not known, an empty Party Object (see Party Object (Section 4.4)) may be used as the first party or as the party referenced by the originator parameter. The originator parameter is only provided if the first party of the Session Object parties list is NOT the originator.¶

originator: "UnsignedInt" (optional)¶

The originator value is the index into the parties Objects Array, to the party that originated the session.¶

4.2.5. session_id

The [SESSION-ID] MAY be included for the session if it applies to all of the Dialog Objects in the session.¶

session_id: "SessionId" (optional)¶

The value of the session_id parameter is a single SessionId Object (see Section 4.5.9). A [SESSION-ID] which applies to only some of the parties or Dialog Objects in the session is captured in the session_id parameter of the Dialog Object.¶

4.2.6. sessions

A Session Object may refer to other Session Objects in one of several different relationships using the Session_Reference Object (Section 4.2.8).¶

sessions: "Session_Reference[]" (optional)¶

The sessions parameter is an array of Session Reference Objects. The sessions parameter can be used to create a tree or graph of session. A Session Reference Object also labels the relationship between this Session Object and the reference one. Event Objects are not inherited through these relationships; an Event Object applies only to the Session Objects listed in its sessions parameter (see Section 4.3.3).¶

4.2.7. dialog

All Dialog Objects (Section 4.1.13) SHOULD be referenced by at least one of the Session Objects in a vCon. The dialog parameter in the Session Object is an array of Dialog Object indices to the dialog Object array (Section 4.1.13).¶

dialog: "UnsignedInt[]" (optional)¶

The value of the Session Object dialog parameter is an array of indices to the dialog in the Dialog Object array which are part of this session.¶

4.2.8. Session_Reference Object

A Session Reference Object specifies the relationship from one Session Object to another.¶

4.2.8.1. session

The session parameter is used to define a relationship from one session to another.¶

session: "UnsignedInt"¶

The session parameter value is an index into the sessions Object Array (Section 4.1.10) for the session that is referenced. The session parameter MUST be provided.¶

4.2.8.2. type

The type parameter specifies a specific type of relationship to the reference session.¶

type: "String"¶

The string MUST have the value of one of the following tokens or a value defined in a vCon extension:¶

"child" - a session contained within this session¶
"peer" - a session that occurred in parallel or overlapping this session¶
"precursor" - a session that occurred before and leading up to this session¶
"breakout" - a separate session that included some subset of the parties in this session and typically overlapping with this session¶

The handling of a Session_Reference Object with a type which is not recognized is described in Section 2.5.¶

TODO: other types?¶

4.2.8.3. description

The description parameter is used to better describe the relationship to the referenced Session Object.¶

description: "String" (optional)¶

The value of the description parameter is a free form text description of the relationship.¶

TODO: alternative name: relation?¶

The description parameter is an open text String.¶

4.3. Event Object

Events occur during a conversation which are important to capture in a vCon, but which are not part of the content of the conversation. An Event Object captures one such occurrence. An event is a point in time occurrence, unlike a Dialog Object which captures the actual conversation over some duration. A period of time, such as the time that a party was on hold, is captured by a pair of Event Objects and not by a duration.¶

Every Event Object has a type and the time at which the event occurred. Depending upon its type, an Event Object also references the session(s) in which it occurred, the party to which it relates, or the Dialog Object to which it relates. Each Event Object occurs within the scope of one or more Session Objects, referenced either directly by its sessions parameter, or through the Dialog Object referenced by its dialog parameter.¶

The following types of events are defined in this document:¶

party event types - a change in the participation of a party in a session (see Section 4.3.1.1)¶
key event types - a key or button was pressed or released (see Section 4.3.1.2)¶
transfer event types - a transfer operation and the relationship between the sessions involved (see Section 4.3.1.3)¶
channel contributors event type - a change in the party(s) contributing to a channel of a recording (see Section 4.3.1.4)¶

Additional event types may be defined in a vCon extension (see Section 2.5).¶

The parameters which are present in an Event Object depend upon the type of the event. The event types are described first in the subsections of the type parameter (see Section 4.3.1). The parameters which apply to each event type are summarized in Section 4.3.1.5. The parameters which are specific to an event type are defined in the subsections which follow.¶

4.3.1. type

The type parameter indicates the type of event that occurred.¶

type: "String"¶

The string token for the event MUST be one of the tokens defined in the following subsections or in a vCon extension. The handling of an Event Object with a type which is not recognized is described in Section 2.5.¶

4.3.1.1. Party Event Types

Participants in a session may not all join and leave at the same time. The party event types support the capturing of the information when parties join, drop, go on hold or mute and unmute. Party events may also be used to determine which parties were present or potentially received dialog from other parties in the conversation. The party parameter references the party that joined, dropped, was put on or taken off hold or was muted or unmuted.¶

The following party event types are defined:¶

"join" - when the party joins the session¶
"drop" - when the party drops out of the session¶
"hold" - when the party is put on hold¶
"unhold" - when the party is taken off hold¶
"mute" - when the party is muted¶
"unmute" - when the party is taken off mute¶

4.3.1.2. Key Event Types

The key event types capture when a party presses or releases a DTMF or application key or button. The party parameter references the party that pressed or released the key or button. The key or button is identified in the button parameter (see Section 4.3.8).¶

The following key event types are defined:¶

"keydown" - when a DTMF or application key/button was pressed¶
"keyup" - when a DTMF or application key/button was released¶

4.3.1.3. Transfer Event Types

The transfer event types document the roles of three parties and the relationship between two or three sessions. In a transfer operation, the roles of the three parties to a transfer are defined in [SIP-XFER] as:¶

Transferee¶
Transferor¶
Transfer Target¶

There are two or three calls in which the parties are connected:¶

original call¶
consultative call (optional as this call may not get created)¶
target call¶

Each of these calls is represented by a Session Object.¶

The following transfer event types are defined:¶

"consultation-start" - when the Transferor starts a consultative call with the Transfer Target¶
"blind-transfer" - when the Transferor transfers the Transferee to the Transfer Target without a consultative call¶
"consultative-transfer" - when the Transferor transfers the Transferee to the Transfer Target following a consultative call¶
"transfer-abandoned" - when the Transferor abandons an attempt to transfer the Transferee without completing the transfer¶

The "blind-transfer" and "consultative-transfer" type Event Objects do not indicate that the target call succeeded. The following table summarizes the transfer cases, the Event Objects which capture each case and the results.¶

Table 1
Case	Event Objects	Results
Consultative call fails or is not answered	consultation-start, transfer-abandoned	consultation Session Object references an "incomplete" type Dialog Object
Consultative call succeeds, Transferor does not transfer	consultation-start, transfer-abandoned	Transferee is not transferred in this attempt
Consultative call succeeds, Transferor transfers, target call succeeds	consultation-start, consultative-transfer	target Session Object references the Dialog Objects for the target call
Consultative call succeeds, Transferor transfers, target call fails or is not answered	consultation-start, consultative-transfer	target Session Object references an "incomplete" type Dialog Object
Blind transfer, target call succeeds	blind-transfer	target Session Object references the Dialog Objects for the target call
Blind transfer, target call fails or is not answered	blind-transfer	target Session Object references an "incomplete" type Dialog Object
Transferor abandons before a consultative call or transfer	transfer-abandoned	Transferee is not transferred in this attempt

A "consultative-transfer" or "transfer-abandoned" type Event Object which follows a consultation references the same Session Object in the consultation parameter as the "consultation-start" type Event Object.¶

It is also possible for there to be more than one consultation. This may occur for a number of reasons. Call attempts may fail. The caller may decide the consultation with a party is not the desired transfer target. When a transfer attempt fails or is abandoned, the Transferor may attempt the transfer again. Depending upon the system, a subsequent "consultative-transfer" type Event Object may reference the same consultation Session Object if the consultative call still exists. Alternatively, the Transferor may start another consultative call, which is captured in a new "consultation-start" type Event Object, or may perform a blind transfer. If the target call fails and the Transferor does not attempt the transfer again, no further transfer Event Object is created.¶

More than one transfer may occur in a vCon. After a transfer has completed or failed, additional transfers may be attempted. Each transfer is captured in its own transfer Event Objects. A Session Object may be referenced in more than one transfer event when multiple transfers occur. For example, the Session Object for the target call of one transfer may be the Session Object for the original call of a subsequent transfer.¶

The following figure illustrates the transfer event types and the calls to which they relate.¶

   transfer-abandoned
      +-------+
      |       |
      v       |
+------------------+                          +--------------------+
|  Original call   |----consultation-start--->|    Consultation    |
|    (session)     |<---transfer-abandoned----|   (consultation)   |
+------------------+                          +--------------------+
   ^        |                                   |                ^
   :        |             consultative-transfer |    target call :
   :        | blind-transfer                    |    fails       :
   :        |                                   |                :
   :        |                                   v                :
   :        |                                 +--------------------+
   :        +-------------------------------->|    Target call     |
   :..........................................|  (target_session)  |
     target call fails                        +--------------------+
                                                        :
                                                        : target
                                                        : call
                                                        v succeeds
                                              +--------------------+
                                              |    Transferred     |
                                              +--------------------+

----  Event Object
....  result determined from the target Session Object

Figure 3: transfer event states

In the transfer event types, the sessions parameter references the Session Object for the original call and the party parameter references the Transferor. The transferee and transfer_target parameters reference the other two parties to the transfer (see Section 4.3.9 and Section 4.3.10). The consultation and target_session parameters reference the Session Objects for the consultative call and the target call (see Section 4.3.11 and Section 4.3.12).¶

There are scenarios where we know that a transfer has occurred, but we have no information for one or two of the consultation, target or original calls. In this case a placeholder Session Object is created and its index is used for the consultation, target_session or sessions parameter. A placeholder Session Object may contain no parameters or may reference a placeholder Dialog Object. A unique Session Object SHOULD be referenced for each role in the transfer.¶

The transfer event types only capture the roles, operations and events of the parties and the session setup. They do not capture the purpose or reason for the transfer as that is analysis to be captured in the analysis section of the vCon after the conversation has occurred.¶

4.3.1.4. Channel Contributors Event Type

The channel contributors event type indicates the time at which the party(s) contributing to a channel of a recording Dialog Object change. This supports the channel contributor changes recording topology (see Section 4.5.1.1). For example, a conference bridge may create a recording with fewer channels than there are parties in the conference, and select the party(s) captured on each channel based upon which parties it detects as talking. At times a channel may capture no party at all.¶

The dialog parameter references the recording Dialog Object and the channel parameter identifies the channel in that recording (see Section 4.3.5 and Section 4.3.6). The contributors parameter indicates the party(s) contributing to that channel, starting at the time of the event (see Section 4.3.7). These parties contribute to the channel until the time of the next channel-contributors Event Object for the same Dialog Object and channel, or until the end of the recording. The contributors at the start of the recording are indicated in the parties parameter of the Dialog Object (see Section 4.5.4). The time parameter of a channel-contributors Event Object SHOULD be within the time period given by the start and duration parameters of the referenced Dialog Object. Each channel-contributors Event Object applies to exactly one channel. If the contributors to more than one channel change at the same time, a separate channel-contributors Event Object is used for each channel, each with the same time parameter value.¶

The channel-contributors Event Object MAY be used with a recording Dialog Object in any of the recording topologies (see Section 4.5.1.1), although it may not be useful in some of them, such as talk spurt. It indicates which parties are captured on a channel; it does not indicate that a party joined or dropped from the session. A party may be in the session, but not captured on any channel of the recording. The sessions and party parameters MUST NOT be present in the channel-contributors Event Object (see Section 4.3.3 and Section 4.3.4).¶

The following channel contributors event type is defined:¶

"channel-contributors" - when the party(s) contributing to a channel of a recording change¶

4.3.1.5. Event Object Parameter Applicability by Type

The following tables summarize which Event Object parameters apply to each Event Object type. The parameter definitions in the subsections of this document are definitive; these tables are provided as a summary. The symbols used in the tables are: M the parameter MUST be present, O the parameter is optional, SN the parameter SHOULD NOT be present, X the parameter MUST NOT be present.¶

The following table applies to the party and key event types.¶

Table 2
Parameter	join, drop, hold, unhold, mute, unmute	keydown, keyup
type	M	M
time	M	M
sessions	M	M
party	M	M
dialog	SN	SN
channel	X	X
contributors	X	X
button	X	M
transferee	X	X
transfer_target	X	X
consultation	X	X
target_session	X	X

The following table applies to the transfer event types.¶

Table 3
Parameter	consultation-start	blind-transfer	consultative-transfer	transfer-abandoned
type	M	M	M	M
time	M	M	M	M
sessions	M (1)	M (1)	M (1)	M (1)
party	M (2)	M (2)	M (2)	M (2)
dialog	SN	SN	SN	SN
channel	X	X	X	X
contributors	X	X	X	X
button	X	X	X	X
transferee	M	M	M	M
transfer_target	M	M	M	O
consultation	M	X	M	O
target_session	X	M	M	X

(1) A single index which references the Session Object for the original call.¶

(2) References the Transferor.¶

The following table applies to the channel contributors event type.¶

Table 4
Parameter	channel-contributors
type	M
time	M
sessions	X
party	X
dialog	M
channel	M
contributors	O (3)
button	X
transferee	X
transfer_target	X
consultation	X
target_session	X

(3) A null value or the absence of the contributors parameter indicates that no party contributes to the channel.¶

4.3.2. time

The time parameter indicates the time at which this event occurred.¶

time: "Date"¶

The time parameter MUST be provided as it is used to determine the sequence in which events occurred.¶

4.3.3. sessions

The sessions parameter indicates the session(s) in which this event occurred.¶

sessions: "UnsignedInt" | "UnsignedInt[]" (not used in channel-contributors events)¶

The value of the sessions parameter is the index, or an array of indices, into the sessions Object array to the Session Object(s) in which this event occurred. The sessions parameter MUST be present in all of the Event Object types defined in this document, except "channel-contributors" type Event Objects, in which it MUST NOT be present. An Event Object applies only to the Session Objects listed in its sessions parameter. An Event Object does not apply to the child or parent Session Objects of the Session Objects listed in its sessions parameter, unless they are also listed (see Section 4.2.6). If an Event Object applies to more than one Session Object, each of those Session Objects MUST be listed in its sessions parameter. The session(s) in which a "channel-contributors" type Event Object occurred are the Session Object(s) which reference the Dialog Object referenced by its dialog parameter (see Section 4.3.5). For the transfer event types, the value of the sessions parameter MUST be a single index, which references the Session Object for the original call between the Transferee and the Transferor.¶

4.3.4. party

The party parameter indicates the party for this event.¶

party: "UnsignedInt" (not used in channel-contributors events)¶

The value of the party parameter is the index into the parties Object array to the party for this event. The party parameter MUST be present in all of the Event Object types defined in this document, except "channel-contributors" type Event Objects, in which it MUST NOT be present. The parties contributing to a channel are indicated in the contributors parameter of the "channel-contributors" type Event Object (see Section 4.3.7). For the transfer event types, the party parameter references the party that played the role of the Transferor.¶

4.3.5. dialog

The dialog parameter indicates the Dialog Object to which this event relates.¶

dialog: "UnsignedInt" (required for channel-contributors events)¶

The value of the dialog parameter is the index into the dialog Object array to the Dialog Object to which this event relates. The dialog parameter MUST be present in "channel-contributors" type Event Objects and SHOULD NOT be present in the other Event Object types defined in this document. The Dialog Object referenced by a "channel-contributors" type Event Object MUST be of type "recording". Event Object types defined in a vCon extension may use the dialog parameter, and may allow its value to be an array of indices to Dialog Objects. An implementation SHOULD NOT treat an array value for the dialog parameter as an error in an Event Object type defined in a vCon extension.¶

4.3.6. channel

The channel parameter indicates the channel of the recording to which this event relates.¶

channel: "UnsignedInt" (required for channel-contributors events)¶

The value of the channel parameter is the index of the channel in the recording of the Dialog Object referenced by the dialog parameter, where 0 is the first channel. The channel index corresponds to the index of the channel in the parties parameter of that Dialog Object (see Section 4.5.4). The value MUST be less than the number of channels in the recording. For a single channel recording, the value MUST be 0. The channel parameter MUST be present in "channel-contributors" type Event Objects and MUST NOT be present in the other Event Object types defined in this document.¶

4.3.7. contributors

The contributors parameter indicates the party(s) contributing to the channel, starting at the time of this event.¶

contributors: "UnsignedInt" | "UnsignedInt[]" | null (optional)¶

The value of the contributors parameter is the index, or an array of indices, into the parties Object array to the Party Objects which contribute to the channel, starting at the time of this event. A null value, or the absence of the contributors parameter, in a "channel-contributors" type Event Object indicates that no party contributes to the channel, starting at the time of this event. The contributors parameter MUST NOT be present in the other Event Object types defined in this document.¶

4.3.8. button

The button parameter indicates the key or button that was pressed or released.¶

button: "String" (required for keydown and keyup events)¶

The button parameter value is the String value of the DTMF digit, character or string label for the button that was pressed or released. The button parameter MUST be present in "keydown" and "keyup" type Event Objects and MUST NOT be present in other Event Object types.¶

4.3.9. transferee

The transferee parameter indicates the Transferee in the transfer event types.¶

transferee: "UnsignedInt" (required for transfer event types)¶

The value of the transferee parameter is the index into the parties Object array to the party that played the role of the Transferee. The transferee parameter MUST be present in the transfer event types and MUST NOT be present in other Event Object types. If the Transferee is not known, an empty Party Object (see Party Object (Section 4.4)) is referenced.¶

4.3.10. transfer_target

The transfer_target parameter indicates the Transfer Target in the transfer event types. Other parties may be part of the Session Object for the target call; the transfer_target parameter identifies the party that was the target of the transfer operation.¶

transfer_target: "UnsignedInt" (required for consultation-start, blind-transfer and consultative-transfer events, optional for transfer-abandoned events)¶

The value of the transfer_target parameter is the index into the parties Object array to the party that played the role of the Transfer Target. The transfer_target parameter MUST be present in "consultation-start", "blind-transfer" and "consultative-transfer" type Event Objects. If the Transfer Target is not known, an empty Party Object (see Party Object (Section 4.4)) is referenced. The transfer_target is optional in "transfer-abandoned" type Event Objects in the case where the transfer is abandoned before the target was identified. The transfer_target parameter MUST NOT be present in Event Object types other than the transfer event types.¶

4.3.11. consultation

The consultation parameter indicates the session for the consultative call in the transfer event types.¶

consultation: "UnsignedInt" (required for consultation-start and consultative-transfer events, optional for transfer-abandoned events)¶

The value of the consultation parameter is the index into the sessions Object array to the Session Object for the consultative call between the Transferor and the Transfer Target. The consultation parameter MUST be present in "consultation-start" and "consultative-transfer" type Event Objects. The consultation parameter is optional in "transfer-abandoned" type Event Objects in the case where the transfer is abandoned without a consultative call. The consultation parameter MUST NOT be present in "blind-transfer" type Event Objects or in Event Object types other than the transfer event types.¶

4.3.12. target_session

The target_session parameter indicates the session for the target call in the transfer event types.¶

target_session: "UnsignedInt" (required for blind-transfer and consultative-transfer events)¶

The value of the target_session parameter is the index into the sessions Object array to the Session Object¶

4.4. Party Object

A Party Object contains information about a specific party or participant in the conversation. The information that is available about the party varies with the context, the communication mode and platform. There are times when no information is available for a party either initially or over the entire life of the vCon. In such situations, it is possible to have a Party Object with no parameters in it. A Party Object SHOULD be created for each participant. This may result in more than one empty Party Object. They are distinct by the order or index in the Party Object array.¶

4.4.1. tel

If the tel URL for the party is known, it can be included in the tel parameter.¶

tel: "String" (optional)¶

The value of the tel parameter SHOULD be a valid [TEL] URL. The URL scheme prefix (i.e. "tel:") is optional.¶

4.4.2. sip

The [SIP] URL for the party can be provided in the sip parameter.¶

sip: "String" (optional)¶

The value of the sip parameter is the addr-spec as defined in section 25.1 of [SIP].¶

4.4.3. stir

If the STIR [PASSporT] was provided to identify the party, the PASSporT can be included in the stir parameter for the party.¶

stir: "String" (optional)¶

The string value of the stir parameter contains the [PASSporT] in the JWS Compact Serialization form.¶

4.4.4. mailto

If the mailto URL is known for the party, it can be included in the mailto parameter.¶

mailto: "String" (optional)¶

The value of the mailto parameter is a string containing an email address for the party. It MAY be provided in any common form, such as a bare address or a [MAILTO] URL; when a [MAILTO] URL is used, the "mailto:" scheme prefix is optional.¶

4.4.5. name

If the party's name is known, it can be included in the name parameter.¶

name: "String" (optional)¶

The string value of the name parameter is a free form JSON string in which part or all of the party's name can be included. It may be necessary, for privacy reasons, to not identify any information about the party. This MAY be indicated by creating a Party Object with only the name parameter and setting its value to "anonymous". A Party Object SHOULD be create for each anonymous party in the conversation. This is necessary to capture the number of parties and distinction between which party contributed what data or dialog in the conversation. Hence it is possible to have multiple anonymous Party Objects in the vCon. They are distinct by the order or index in the Party Object array.¶

4.4.6. did

If a Decentralized Identifier [DID] is known for the party, it can be included in the did parameter.¶

did: "String" (optional)¶

The value of the did parameter MUST be a valid DID URI that enables verifiable, decentralized digital identity for the party. DIDs are designed to be decoupled from centralized registries and identity providers, allowing the controller of the DID to prove control without requiring permission from other parties. The DID can refer to any subject (person, organization, thing, etc.) as determined by the controller of the DID.¶

4.4.7. validation

Proof of authorization of the communication channel through STIR, login or possession of a device, is often not sufficient proof of the identity of the person at the other end of the communications channel. It is common in call centers to validate the identity of the person on the communication channel through verification of some sort of personal identification information. The methods used, often varies with the situation and is business practices specific. The purpose of the validation parameter, is to allow the validator to save a label or token which identifies the method of identity validation used to identify the person at the other end of the communication channel. For confidentially reasons, it SHOULD NOT contain the data used to validate the name. However it MAY name the data used to validate the name (e.g. "SSN", "DOB", "user ID and password"). It is up to the domain creating the vCon to define the set of tokens or values to be used for the validation parameter.¶

validation: "String" (SHOULD be provided if name parameter is provided)¶

The value of the validation string MAY be "none" or enterprise or domain defined token or string values.¶

4.4.8. gmlpos

If the geolocation of the party is known, it can be added in the gmlpos parameter. The gmlpos parameter contains the latitude and longitude of the location of the party at the time of the conversation start.¶

gmlpos: "String" (optional)¶

The gmlpos parameter value contains a string of the same format as the gml:pos element defined in section 3.2 of the [PIDF-LO] PIDF.¶

4.4.9. civicaddress

The the civicaddress parameter value contains a Civicaddress Object which is optional and contains civic address information about the location for the party.¶

civicaddress: "Civicaddress" (optional)¶

The Civicaddress Object MAY contain any or all of the following parameters: country, a1, a2, a3, a4, a5, a6, prd, pod, sts, hno, hns, lmk, loc, flr, nam, pc as defined in section 2.2.1 of [GEOPRIV]. The values of all of these parameters are of type String. Note that the parameter names MUST be in lower case when contained in the Civicaddress Object even though they are in upper case in [GEOPRIV].¶

country: "String" (optional)¶
a1: "String" (optional)¶
a2: "String" (optional)¶
a3: "String" (optional)¶
a4: "String" (optional)¶
a5: "String" (optional)¶
a6: "String" (optional)¶
prd: "String" (optional)¶
pod: "String" (optional)¶
sts: "String" (optional)¶
hno: "String" (optional)¶
hns: "String" (optional)¶
lmk: "String" (optional)¶
loc: "String" (optional)¶
flr: "String" (optional)¶
nam: "String" (optional)¶
pc: "String" (optional)¶

4.4.10. uuid

The uuid is a unique identifier for the participant. In a contact center, this is particularly important for the call agent participant, and must be static across interactions to allow correlation with the actual agent configuration provisioned into the systems. The value of the uuid parameter is a free form unique identifier string for the participant. The value is not constrained to the syntax defined in [UUID]. Operators often have existing methods of generating unique participant identifiers and MAY use any unique string value.¶

uuid: "String" (optional)¶

4.4.11. type

There are different types of parties that participate in or contribute information to a conversation. The type parameter may be used to indicate the type of participant represented by the Party Object.¶

type: "String" (optional)¶

The value of the type parameter SHOULD be one of the following: "person", "bot", "organization"¶

4.4.12. org

The party may belong to or be an organization. The org parameter is a free form text string for containing the organization identifier.¶

org: "String" (optional)¶

4.4.13. dept

The party may belong to a department with in an organization. The dept parameter is a free form text string for containing the party's department identifier.¶

dept: "String" (optional)¶

4.5. Dialog Object

The Dialog object references or contains text, audio or video captured from the conversation. Currently five types of dialog objects are defined in this document:¶

Text based media communications¶
Audio or Video recorded media communications¶
Metadata for failed or incompleted communications¶

Media captured in a media-based Dialog Object (type text and recording) SHOULD satisfy two constraints: the media is part of the conversation itself, and the media is transcribable. Media is part of the conversation when it is the communication exchanged between the parties, as opposed to a document or item that is referenced, discussed or presented within the conversation. Media that is transcribable can be converted into a textual representation of sequential communication between parties. Text media is already in textual form and is therefore always transcribable. While images such as sunsets, cows, photographs of documents, or application forms may be describable, they are not transcribable in a concise manner and SHOULD NOT be included as Dialog Objects. They SHOULD be included as Attachment Objects.¶

Text and audio may be subject to interpretation, but they are transcribable to a precise dialog representation. Although transcriptions may not always be accurate, there exists a single correct transcription for any given content.¶

Media that is not transcribable SHOULD be included in the vCon as Attachment Objects rather than Dialog Objects.¶

Whether a fax or photograph of a text-based letter belongs in a Dialog Object depends upon its role in the conversation. A letter faxed to the other party as the communication itself, such as a letter faxed to a doctor, is both transcribable and part of the conversation and MAY be included as a Dialog Object. The same letter shared or discussed within some other conversation is referenced material rather than the conversation itself and SHOULD be included as an Attachment Object, even though it is transcribable. Most other faxes and photographs SHOULD be included as Attachment Objects and SHOULD NOT be included as Dialog Objects. Similarly, a musical recording, even if it is in MP3 audio format, SHOULD be included as an Attachment and SHOULD NOT be included as a Dialog Object.¶

It may not always be known at the time of vCon construction whether an image or recording is transcribable.¶

This distinction is important for interoperability. If it is ambiguous as to what belongs in a Dialog Object versus an Attachment Object, interoperability cannot be achieved, as vCon constructors will not be able to consistently determine where content should be placed and users of vCons will not know where content can be found within the vCon.¶

There are situations when little or no information is available for a dialog either initially or over the entire life of the vCon and yet it is known that the dialog occurred. For example this may occur in some call transfer cases where there is nothing known about the consultative call. In such situations, it is possible to have a placeholder Dialog Object which contains only the type parameter and, for the "incomplete" type, the required disposition parameter. As the consultative call is a call, a placeholder Dialog Object for it MUST be of type "recording" if the call was set up, or of type "incomplete" if it was not. There may be more than one placeholder Dialog Object in the vCon. They are distinct by the order or index in the Dialog Object array.¶

4.5.1. type

type: "String" (required, unless the Dialog Object is empty)¶

The string MUST have the value of either "recording", "text" or "incomplete", or a value defined in a vCon extension. The handling of a Dialog Object with a type which is not recognized is described in Section 2.5. The type parameter MUST be present in all Dialog Objects, unless the Dialog Object is completely empty. An empty Dialog Object ({}) contains no parameters and has no meaning. An empty Dialog Object may be used to hold a position in the dialog array, such that the indices of the other Dialog Objects, and the references to them, do not change. For example, an empty Dialog Object may be inserted as a placeholder for a Dialog Object that is to be filled in later, or may replace a Dialog Object that is removed when a vCon is redacted (see Redaction Techniques (Section 5)) or edited. The semantics of each Dialog Object type are described in the following subsections. The applicability of each of the Dialog Object parameters to each of the types is summarized in Section 4.5.1.4.¶

4.5.1.1. recording

A dialog of type "recording" has Dialog Content that either contains a body or refers to via url, which is a recording of the video and/or audio of a segment of the conversation.¶

A recording of a conversation may be captured using one of a number of topologies. The following recording topologies are supported by the recording Dialog Object:¶

single channel - a single recording Dialog Object with one channel, into which the audio of all of the parties is mixed¶
multi-channel - a single recording Dialog Object with a separate channel for each party or set of parties¶
per party - a separate single channel recording Dialog Object for each party, which starts when the party joins and ends when the party drops¶
talk spurt - a separate recording Dialog Object for each party and each contiguous period in which that party talks, with the silence trimmed out¶
channel contributor changes - a recording Dialog Object in which the party(s) contributing to a channel change over the duration of the recording, for example a conference bridge which records only the parties that it detects as talking (see Section 4.3.1.4)¶
segmented - any of the other topologies, in which a recording is stopped and a new recording Dialog Object is started for the same party(s), for example when the recording reaches a maximum duration, such that the recording is a sequence of consecutive recording Dialog Objects¶

The per party, talk spurt and segmented topologies use more than one recording Dialog Object, which collectively represent the call or session. In these topologies, the Session Object is important in defining which Dialog Objects are part of a conversation, side bar conversation or call segment (see Section 4.2.7). This allows a single vCon to contain multiple, clearly defined conversations, side bar conversations or call segments (see Section 4.1.10).¶

4.5.1.2. text

A dialog of type "text" has Dialog Content that either contains a body or refers to via url, which contains a single message from one of the parties.¶

4.5.1.3. incomplete

A dialog of type "incomplete" captures a call or conversation that failed to be setup to the point of exchanging any conversation. As no conversation was exchanged, an incomplete Dialog Object does not have Dialog Content (see Section 4.5.7). An incomplete Dialog Object has a required disposition parameter which indicates why the call or conversation failed (see Section 4.5.8).¶

4.5.1.4. Dialog Object Parameter Applicability by Type

The following table summarizes which Dialog Object parameters apply to each Dialog Object type. The parameter definitions in the subsections of this document are definitive; this table is provided as a summary.¶

The symbols used in the table are defined as follows.¶

M: The parameter MUST be present.¶
S: The parameter SHOULD be present.¶
O: The parameter is optional.¶
SN: The parameter SHOULD NOT be present.¶
X: The parameter MUST NOT be present.¶

Table 5
Parameter	recording	text	incomplete
type	M	M	M
start	S	S	S
duration	O	O	O
parties	S	S	O
mediatype	M (1)	M (1)	X
filename	O	O	X
body	S (2)	S (2)	X
encoding	S (3)	S (3)	X
url	S (2)	S (2)	X
content_hash	S (4)	S (4)	X
disposition	SN	SN	M
session_id	O	O	O
application	O	O	O
message_id	O	O	X
redacted_segments	O	SN	X

(1) MUST be present for inline Dialog Content; optional for externally referenced Dialog Content when the media type is provided in the [HTTPS] Content-Type header; not required when Dialog Content is absent, such as in a placeholder Dialog Object or a redacted vCon.¶

(2) body or url MAY be absent in a redacted vCon.¶

(3) MUST be present when the body parameter is present and is not an empty string (see Inline Files (Section 2.3)).¶

(4) MUST be present when the url parameter is present (see Section 2.4.2).¶

4.5.2. start

The start parameter contains the date and time for the beginning of the captured piece of dialog. The start parameter SHOULD be present unless it is not known. For text it is the time that the party started typing or if not available, then it is the time the text was sent. For audio and video recordings, it is the time which corresponds to the beginning of the recording. It should be noted that Dialog Objects may not be ordered by the value of the start parameter. Dialog Objects in the dialog array are in order that they were added to the vCon and cannot be reordered with out correcting the dialog indices which occur in other Objects in the vCon.¶

start: "Date"¶

4.5.3. duration

The duration parameter contains the duration in seconds of the referenced or included piece of dialog. For text, if known, it is the time duration from when the party started typing to when they completed typing and the text was sent. For recordings, it is the duration of the recording. For an "incomplete" type Dialog Object, the duration parameter may capture the time from the attempt to setup the call or conversation until it failed.¶

duration: "UnsignedInt" | "UnsignedFloat" (optional)¶

The value MUST be the dialog duration in seconds.¶

4.5.4. parties

The party(s) which generated the text or recording for this piece of dialog are indicated in the parties parameter. These parties are the contributors to the Dialog Object. The receivers of the dialog are indicated in the parties parameter of the Session Object which references this Dialog Object (see Section 4.2.3). The parties parameter SHOULD be present in "recording" and "text" type Dialog Objects. The parties parameter is optional for "incomplete" type Dialog Objects, where it indicates the party that attempted to set up the call or conversation (i.e. the caller or originator). The party(s) to which the call or conversation setup was attempted are indicated in the parties parameter of the Session Object which references the "incomplete" type Dialog Object.¶

parties: "UnsignedInt" | "UnsignedInt[]" | ("UnsignedInt" | "UnsignedInt[]" | null)[]¶

Single channel recordings should have a parties value of the form: "UnsignedInt" or "UnsignedInt[]" where the integer value or array of integer values are the indices to the Party Object(s) in the parties array that contributed to the mix for the single channel recording. The index for the Party Object SHOULD be included even if the indicated party was silent the entire piece of dialog.¶

Multi-channel recordings MUST have a parties value that is an array of the same size as the number of channels in the recording. The values in that array are either an integer or an array of integers which are the indices to the parties that contributed to the mix for the associated channel of the recording. The index for Party Objects SHOULD be included even if the party was silent the entire conversation. If not all channels are used in a recording, such that no parties are recorded on one or more channels, a null placeholder MUST be inserted into the parties array for the corresponding channel.¶

By default, the party(s) indicated in the parties parameter for a channel are the contributors to that channel for the entire duration of the recording. The contributors to a channel may change over the duration of the recording (see the channel contributor changes recording topology in Section 4.5.1.1). Such changes are indicated by channel-contributors Event Objects which reference the Dialog Object and the channel (see Section 4.3.1.4). When one or more channel-contributors Event Objects exist for a channel, the parties parameter for that channel indicates the contributors at the start of the recording. In that case, a null value for the channel indicates that no party contributes to the channel at the start of the recording. If the contributors to a channel change, but the times at which they change are not known, the parties parameter for that channel SHOULD contain all of the parties which contributed to that channel over the duration of the recording, and no channel-contributors Event Object is provided for that channel.¶

Some recording systems represent a single call or session using multiple recording Dialog Objects. This may occur when recordings are periodically segmented or when separate recordings are created for each party and talk spurt. In these cases, a single recording Dialog Object identifies only the parties captured, or potentially captured, in that recording. Other participants are identified only in the recording Dialog Objects in which they are captured or potentially captured. As a result, no single recording Dialog Object necessarily identifies all parties participating in the conversation. The parties parameter of a Dialog Object only references the parties that contributed, or potentially contributed, to the Dialog Content of that Dialog Object. The complete call or session is represented by a Session Object which references the Dialog Objects that are part of it (see Section 4.2). The parties parameter of the Session Object identifies the receivers of the dialog in the call or session (see Section 4.2.3). The start and duration parameters of the Session Object identify the time period of the call or session, which may differ from the time periods of the Dialog Objects which it references (see Section 4.2.1 and Section 4.2.2).¶

The originator of the call or session is indicated in the Session Object (see Section 4.2.4). In some cases, there may be a separate recording file for each party in a conversation, where only one party is recorded per file. It should be noted that the recordings may be shorter than the collective conference when there is a separate recording per speaker/party. For example the recording(s) of the individual speaker may be trimmed to only the parts where they are actually speaking.¶

In the email context, [SMTP] messages have the headers From, To, Cc and Bcc. The party in the From header is the sender of the message and the contributor to the text Dialog Object. The From header party SHOULD be the only party in the parties parameter for the text Dialog Object. The parties listed in the To, Cc and Bcc [SMTP] headers (if present) are the receivers of the message. The sender is also a receiver of the message, as the sender retains a copy of the message that they sent. The sender and the other receivers SHOULD be included in the parties parameter of the Session Object which references the text Dialog Object (see Section 4.2.3). The Bcc parties are private to the sender. The sender SHOULD be allowed to set a policy, through out of band means, as to whether the Bcc parties are included in the vCon. In the absence of such a policy, the Bcc parties MAY be included in a vCon which is for the use of the sender, and SHOULD NOT be included in a vCon which is for broader use. When the Bcc parties are not included in the vCon, they SHOULD NOT be referenced in the Session Object parties parameter. A Party Object SHOULD NOT be included for a Bcc party, unless that party is also the sender or a To or Cc receiver of another message in the vCon. The Bcc header SHOULD also be removed from the Dialog Content, and the Session Objects SHOULD be constructed as if the Bcc parties were not receivers of that message. A vCon which includes the Bcc parties may be redacted to remove them for broader use (see Redaction Techniques (Section 5)). A text Dialog Object should only contain a single [SMTP] message. Each message in an email thread may have a different set of receivers. The set of receivers of a message includes its sender. If all of the messages in the thread have the same set of receivers, a single Session Object which references all of the text Dialog Objects for the thread is sufficient. Otherwise, the thread is represented by a parent Session Object which references a child Session Object for each set of receivers (see Section 4.2.6). Each time the set of receivers changes from one message to the next, a new Session Object is created as a child of the Session Object for the email thread. That child Session Object references the text Dialog Object(s) for the message(s) sent to that set of receivers. The parties parameter of each child Session Object contains the receivers of the messages referenced by that child Session Object. The parties parameter of the parent Session Object contains the receivers of all of the messages in the thread.¶

4.5.5. mediatype

The media type for the piece of dialog included or referenced is provided in the mediatype parameter. The mediatype parameter MUST be provided for inline dialog files and MUST be provided if the Content-Type header in the [HTTPS] response for the externally referenced URL is not provided. The mediatype parameter is not required when the Dialog Content is absent, such as in a placeholder Dialog Object or when the body and url have been redacted. The mediatype parameter MUST NOT be present in "incomplete" type Dialog Objects as they do not have Dialog Content.¶

mediatype: "Mediatype" (optional for externally referenced files, if absent, this is provided in the [HTTPS] Content-Type header)¶

The media types SHOULD be one of the following strings:¶

"text/plain"¶
"audio/x-wav"¶
"audio/x-mp3"¶
"audio/x-mp4"¶
"audio/ogg"¶
"video/x-mp4"¶
"video/ogg"¶
"multipart/mixed"¶

Note: multi-part will also likely include the boundary parameter¶

4.5.6. filename

It is sometimes useful to preserve the name of the file which originally contained this piece of dialog. This can be done in the filename parameter. The filename parameter MUST NOT be present in "incomplete" type Dialog Objects as they do not have Dialog Content.¶

filename: "String" (optional)¶

4.5.7. Dialog Content

The Dialog Object SHOULD contain the body and encoding parameters or the url and content_hash parameters for all dialog types other than "incomplete" (see Inline Files (Section 2.3) and Externally Referenced Files (Section 2.4)). These parameters MUST NOT be present for the "incomplete" dialog type. The exception to this is that the body or url MAY be absent if it is redacted.¶

For inline included dialog:¶

body: "*" (optional in a redacted vCon)¶
encoding: "String"¶

Alternatively, for externally referenced dialog:¶

url: "String" (optional in a redacted vCon)¶
content_hash: "ContentHash" | "ContentHash[]"¶

4.5.8. disposition

If the dialog type is "incomplete", it MUST have a disposition parameter. If the reason that the call or conversation failed is not known, such as in a placeholder Dialog Object, the disposition value "failed" SHOULD be used. The value of the disposition parameter provides the reason that the "call control" failed. The term: "call control" is used in a loose sense, as there in not always a call involved, to differentiate from a call disposition that an agent may assign to a call to indicate the reason, issue addressed or outcome of a conversation. This latter definition of call disposition is not dialog, but analysis of the conversation and is not included in the dialog portion.¶

disposition: "String" (required for incomplete type Dialog Objects, SHOULD NOT be present for other dialog types)¶

The value of the disposition parameter MUST be one of the following strings or a value defined in a vCon extension:¶

"no-answer" - a call or connection was attempted, but no one answered or accepted the connection¶
"congestion" - a call or connection was attempted, but was unable to be completed due to system load¶
"failed" - a call or connection was attempted, but failed¶
"busy" - a call or connection was attempted, but the party was busy with another conversation¶
"hung-up" - a call or connection was made, but the party hung-up before any conversation occurred¶
"voicemail-no-message" - a call or connection was made, the voicemail system answered, but no message was left¶

Note: if a message was left with the voicemail system this is no longer an "incomplete" type dialog, it is a "recording" type and the conversation SHOULD be included in the Dialog Content.¶

The handling of a Dialog Object with a disposition which is not recognized is described in Section 2.5.¶

4.5.9. session_id

The [SESSION-ID] MAY be included for the dialog. If the same [SESSION-ID] applies to all the parties in a dialog, than a single instance of the SessionId Object is provided as the value of session_id. If some parties have a different or no associated [SESSION-ID] for this Dialog Object, then the array structure of the session_id objects MUST correlate to the array structure of the Dialog Object's parties index array. Parties which do not have a [SESSION-ID] associated with this dialog, MUST have an empty object ({}) for the SessionId Object. That an empty Object and not an Object with two "nil UUIDs" as defined in section 7 of [SESSION-ID]. It is also possible that the SessionId Object will not have values for both the local and remote parameters in some conferencing situations (See [SESSION-ID]). In the case that one end of the [SESSION-ID] does not have a UUID, the "nil UUID" String value SHOULD be used as defined in section 7 of [SESSION-ID]. When a call or session is represented by multiple Dialog Objects, each may capture only a leg or subset of the parties of the call or session; the session_id values on those Dialog Objects follow the party correlation rules above. The Session Object is the appropriate place to capture a session identifier that applies to the call or session as a whole (see Section 4.2.5).¶

session_id: "SessionId" | "SessionId[]" | ("SessionId" | "SessionId[]")[] (optional)¶

4.5.10. application

The application parameter is used to capture the application, communication channel or context over which the conversation was held. The conversation mode can be identified by looking at the dialog type. However that does not different between different communication platform service providers or hosting service. For example, the application parameter can be used to identify the web conference hosting service.¶

application: "String" (optional)¶

4.5.11. message_id

Some messaging systems assign a unique message identifier to each message. The message_id parameter is applicable to "recording" and "text" type Dialog Objects and MUST NOT be present in "incomplete" type Dialog Objects. The message_id parameter may be used to label the message for either cross referencing back to the messaging system or to prevent the addition of duplicate messages to the vCon. For example SMTP [SMTP] messages have a message-id in the SMTP header. In the SMTP case a message may exist in multiple mailboxes or tags. When exporting these SMTP messages, the message_id parameter may be used to avoid adding the same message, to the vCon containing the email thread, more than once.¶

message_id: "String" (optional)¶

4.5.12. redacted_segments

One of the ways to perform redaction on audio content is to substitute the segments containing the information with a "beep" sound for audio. For video, specific parts of the video can be blurred out, or the video can be blackened entirely. When this happens, a human can easily discern that redaction has occurred. However, it is not easy for software systems to determine this. There are many cases where we want a piece of software processing a VCON to know that such redaction has happened, where it happened, and which parties content was redacted. For example, a troubleshooting tool might want to call out these segments to a user whose role is to confirm that redaction is working well.¶

The redacted_segments field contains an array of one or more Redacted_segments Objects (Section 4.5.12.1). This field is optional, but SHOULD be included in a redacted vCon.¶

redacted_segments: "Redacted_segments[]" (optional)¶

4.5.12.1. Redacted_segments Object

The object contains the following parameters:¶

start: "Date" (required)¶

The start time of the audiovisual redaction.¶

end: "Date" (required)¶

The end time of the audiovisual redaction.¶

TODO: should use duration instead of end?¶

parties: "UnsignedInt[]" (optional)¶

An array of indices into the parties Object array to the parties whose content has been redacted. This is useful when the dialog contains a blend of multiple contributors, and it is desired to indicate which one has been redacted.¶

4.6. Attachment Object

Ancillary documents to the conversation are included or referenced in the Attachment Object. There is no constraint on the types files which can be included or referenced. As most modes of communication, that allow the exchange of files, do not constrain the file type, any file type may be included here.¶

4.6.1. purpose

The purpose parameter may be used to provide a text base description of the purpose or point of the attachment. There is no restricted set of values for this description.¶

purpose: "String" (optional)¶

4.6.2. start

The start parameter contains the date and time that the Attachment Object was sent/exchanged. It should be noted that Attachment Objects may not be ordered by the value of the start parameter. Attachment Objects in the attachments array are in order that they were added to the vCon and cannot be reordered with out correcting the attachment indices which may occur in other Objects in the vCon.¶

start: "Date"¶

4.6.3. party

In most conversations, ancillary documents originate from one of the parties involved in the conversation. This party is not necessarily the document's author, but rather the party that distributed the document. The distributing party is identified by the party parameter in the Attachment Object. To provide provenance for the attachment, the party index MUST be specified. The identified party need not be a participant in the conversation itself. For example, an organization that processes or constructs the vCon may add attachments containing information about the conversation. The organization or entity that adds the attachment SHOULD be represented as a Party Object.¶

party: "UnsignedInt"¶

The value of the party parameter is the index into the Party Object array to the party that contributed the attachment.¶

4.6.4. dialog

Attachments are added as data related to a dialog or a session. The dialog parameter is used to identify the dialog that the attachment is part of.¶

dialog: "UnsignedInt" (optional)¶

The value of the dialog parameter is the index into the dialog Object array to the Dialog Object to which this Attachment Object relates. At least one of the dialog or session parameters MUST be present (see Section 4.6.5).¶

4.6.5. session

Attachments may be related to one or more sessions as opposed to a specific dialog. The session parameter is used to identify the sessions that the attachment is part of.¶

session: "UnsignedInt" | "UnsignedInt[]" (optional)¶

The value of the session parameter is the index to the session or array of indices to the Session Object array to which this Attachment Object relates. The requirement for the dialog or session parameter to be present is defined in Section 4.6.4.¶

4.6.6. mediatype

The media type for the included or referenced attachment file is provided in the mediatype parameter. The mediatype parameter MUST be provided for inline attachment files and MUST be provided if the Content-Type header in the [HTTPS] response for the externally referenced URL is not provided. The mediatype parameter is not required when the Attachment Content is absent, such as when the body and url have been redacted.¶

mediatype: "Mediatype" (optional for externally referenced files, if absent, this is provided in the [HTTPS] Content-Type header)¶

The mediatype string contains the media type or [MIME] type of the attached file.¶

4.6.7. filename

It is sometimes useful to preserve the name of the file which originally contained this attachment file. This can be done in the filename parameter.¶

filename: "String" (optional)¶

The file name string contains an optional name for the attachment file referenced in this Attachment Object.¶

4.6.8. Attachment Content

The Attachment Object SHOULD contain the body and encoding parameters or the url and content_hash parameters (see Inline Files (Section 2.3) and Externally Referenced Files (Section 2.4)). The exception to this is that the body or url MAY be absent if it is redacted.¶

For inline included attachments:¶

body: "*"¶
encoding: "String"¶

Alternatively, for externally referenced attachments:¶

url: "String"¶
content_hash: "ContentHash" | "ContentHash[]"¶

4.7. Analysis Object

Analysis is a broad and in some cases developing field. This document does not attempt to suggest a SHOULD support list of types. Nor are formats for analysis data defined in this document. That is for research and specification outside the scope of this document. For this reason the Analysis Object provides multiple ways to define the media type of the analysis file. If a well known media type is defined, it SHOULD be used. For analysis data or files types for which a media type is not defined, the vendor and schema parameters SHOULD be used.¶

4.7.1. type

The type parameter is used to label the semantic type of analysis data.¶

type: "String"¶

The string value SHOULD be one of the following:¶

"report"¶
"sentiment"¶
"summary"¶
"transcript"¶
"translation"¶
"tts"¶

4.7.2. dialog

Analysis typically pertains to one or more of the Dialog Objects in the dialog array. The dialog parameter is used to indicate which Dialog Objects this analysis was based upon.¶

dialog: "UnsignedInt" | "UnsignedInt[]" (optional)¶

The value of the dialog parameter is the index to the dialog or array of indices to the Dialog Object array to which this Analysis Object corresponds. At least one of the dialog, sessions, attachment or analysis parameters SHOULD be present to indicate the scope of what was input to the analysis (see Section 4.7.3, Section 4.7.4 and Section 4.7.5). Analysis may also be based upon data which is not contained in the vCon, in which case none of these parameters may apply.¶

4.7.3. sessions

Analysis may pertain to one or more sessions as a whole, as opposed to specific Dialog Objects. The sessions parameter is used to indicate which Session Objects this analysis was based upon.¶

sessions: "UnsignedInt" | "UnsignedInt[]" (optional)¶

The value of the sessions parameter is the index to the session or array of indices to the Session Object array to which this Analysis Object corresponds.¶

4.7.4. attachment

The analysis may pertain to one or more of the Attachment Objects in the attachment array. The attachment parameter is used to indicate which Attachment Objects this analysis was based upon.¶

attachment: "UnsignedInt" | "UnsignedInt[]" (optional)¶

The value of the attachment parameter is the index to the attachment or array of indices to the Attachment Object array to which this analysis object corresponds.¶

4.7.5. analysis

The analysis may be derived from one or more of the other Analysis Objects in the analysis array. The analysis parameter is used to indicate which Analysis Objects this analysis was based upon.¶

analysis: "UnsignedInt" | "UnsignedInt[]" (optional)¶

The value of the analysis parameter is the index to the analysis or array of indices to the Analysis Object array to which this Analysis Object corresponds. An Analysis Object MUST NOT reference itself in the analysis parameter.¶

4.7.6. mediatype

The media type for the included or referenced analysis file is provided in the mediatype parameter. The mediatype parameter SHOULD be provided for inline analysis files and for externally referenced analysis files when the Content-Type header in the [HTTPS] response is not provided. A media type may not be defined for the format of the analysis data; in this case the vendor, product and schema parameters SHOULD be used to identify the data format instead.¶

mediatype: "Mediatype" (optional)¶

The mediatype string contains the media type or [MIME] type of the analysis file.¶

4.7.7. filename

It is sometimes useful to preserve the name of the file which originally contained this analysis data. This can be done in the filename parameter.¶

filename: "String" (optional)¶

The file name string contains an optional name for the analysis data file referenced in this Analysis Object.¶

4.7.8. vendor

There may not be a IANA registered media type for the file format containing the analysis data. Even if a media type is defined, it is often useful to keep a record of the vendor that produced the software that produced the analysis. Different implementations perform differently and knowing the implementation can be useful in interpreting the analysis. For this reason, the vendor or product name is provided in the vendor parameter. The vendor parameter is provided even when the mediatype parameter fully identifies the data format, as a record of the implementation that generated or provided the analysis.¶

vendor: "String"¶

The vendor string value contains the vendor or product name of the software which generated this analysis.¶

4.7.9. product

As the vendor may have more than one product, the product parameter may be used to differentiate it from other products which may have different schemas of analysis data.¶

product: "String" (optional)¶

4.7.10. schema

The same vendor or software product may produce different formats or data for the same analysis. The schema parameter allows the data format, schema or configuration used to generate the analysis to be saved with the included or referenced analysis data.¶

schema: "String" (optional)¶

The schema string contains a token or label for the data format or schema for the analysis data. As the vendor name may not be specific enough to identify the format of the analysis, the schema value is provide to differentiate from potentially multiple data formats for analysis provided by the same vendor or software.¶

4.7.11. Analysis Content

The Analysis Object SHOULD contain the body and encoding parameters or the url and content_hash parameters (see Inline Files (Section 2.3) and Externally Referenced Files (Section 2.4)). The exception to this is that the body or url MAY be absent if it is redacted. If the Analysis Object contains or references content, sufficient information to interpret the format of that content SHOULD be provided in the Analysis Object. The mediatype parameter identifies the syntax of the content. Some media types, such as "text/vtt", fully identify the data format. Generic media types, such as "application/json" or "text/csv", identify only the syntax and not the schema of the data within it. When the mediatype parameter is absent or does not fully identify the data format, the schema parameter, together with the vendor and product parameters, SHOULD identify the data format. For externally referenced content, the media type may also be provided by the Content-Type header in the [HTTPS] response (see Section 4.7.6).¶

For inline included analysis:¶

body: "*"¶
encoding: "String"¶

Alternatively, for externally referenced analysis:¶

url: "String"¶
content_hash: "ContentHash" | "ContentHash[]"¶

4.8. Redacted_string Object

The redacted string object provides information about a string which was redacted from the vCon.¶

4.8.1. Ref

ref: "UnsignedInt" (required)¶

The reference to the string which was redacted, which will be present elsewhere in the document. This is always between 1 and 99999.¶

4.8.2. Type

type: "String" (optional)¶

The type of string information which was redacted. This is an extensible string enumeration. The following values are defined, representing the most common forms of sensitive information redacted from conversations:¶

GOVT_ID_NUM: A government issued identifier, such as a social security number, passport number, drivers license number, taxpayer ID, and o on.¶
FIN_ID_NUM: A financial institution identifier, such as a bank account number, a routing number, a wire number, PIN codes, and so on.¶
MED_ID_NUM: A medical identifier, such as a patient ID¶
BIOMETRIC: A string containing biometric data, typically in some encoded form for representation. Examples would include a fingerprint, retina scan, or face geometry.¶
AUTH_DATA: Data used for a user to authenticate themselves, such as a password, digital certificate, or security questions or answers.¶
CONTACT_INFO: Full name, email, physical mailing address, phone numbers, and so on.¶
LOC_INFO: Zip code, GPS location data, IP addresses, MAC addresses¶
EMPL_INFO: Work information, such as a job title, job code, salary, and so on.¶
BELIEF_INFO: Religious preference, political party or preference, sexual orientation¶
UNSPECIFIED: Used when the type is not known, not specified, or not able to be determined.¶

TODO: add IANA registry.¶

Other values can be used, in which case an implementation not familiar with the value treats it as UNSPECIFIED. Absence of this field is also the same as UNSPECIFIED.¶

4.8.3. Orig

orig: "String" (optional)¶

The original, unredacted value of the string. This is useful in applications of vCons where the desired property is not data redaction, but data identification. This may allow downstream vCon processors to perform the redaction (which is as simple as removing the "orig" field), or to allow redaction in the user interface (for example, a first name in a transcript is not shown to the user unless they right-click and elect to reveal the information). It is also useful for downstream data processing applications which generate analytics and create aggregates off of this information.¶

7. IANA Considerations

This section includes the information required for IANA to register the application/vcon media type per [MEDIATYPE].¶

7.1. JSON Format vCon Mediatype

The JSON format for vCon is mandatory to implement.¶

Type name: application¶
Subtype name: vcon¶
Required parameters: N/A¶
Optional parameters: N/A; unrecognized parameters should be ignored.¶
Encoding considerations: 8bit¶
Additional information: [JSON] format¶
Security considerations: See Security Considerations section of this document.¶
Interoperability considerations: The vCon schema is defined in RFC XXXX. The schema may be extended through extensions as defined there.¶
Published specification: This document: RFC XXXX¶
Applications that use this media type:¶
Fragment identifier considerations: N/A¶
Additional Information:¶
- Deprecated alias names for this type: N/A¶
- Magic number(s): N/A¶
- File extension(s): "vcon"¶
- Macintosh file type code(s): N/A¶
- Windows Clipboard Name: VCON¶
Author: See the Author's Addresses section of this document.¶
Change controller: IETF¶

7.2. gzip Format vCon Mediatype

A gzip format vCon is a JSON format vCon that has been compressed using the gzip [GZIP] compression algorithm. The gzip format is used to reduce the size of potentially very large vCons containing audio or video media in dialog objects. Applications SHOULD support the receiving of gzip format vCons, but do not need to use the gzip format when sending.¶

Type name: application¶
Subtype name: vcon+gzip¶
Required parameters: N/A¶
Optional parameters: N/A; unrecognized parameters should be ignored.¶
Encoding considerations: binary¶
Additional information: [GZIP] compression of [JSON] format¶
Security considerations: See Security Considerations section of this document.¶
Interoperability considerations: The vCon schema is defined in RFC XXXX. The schema may be extended through extensions as defined there.¶
Published specification: This document: RFC XXXX¶
Applications that use this media type:¶
Fragment identifier considerations: N/A¶
Additional Information:¶
- Deprecated alias names for this type: N/A¶
- Magic number(s): N/A¶
- File extension(s): "vcon"¶
- Macintosh file type code(s): N/A¶
- Windows Clipboard Name: VCON¶
Author: See the Author's Addresses section of this document.¶
Change controller: IETF¶

7.3. vCon JSON Registry

This document defines a number of new IANA registries for the JSON vCon schema. Each Object (i.e. dict, map, dictionary) has its own registry of parameter names. All of those registries have the same registry template which is defined in the following subsection. When registering new entries, the following template should be used. The registration policy for these registries is Specification Required as defined in [RFC8126]. The Designated Experts are expected to verify that the specification is publicly available, that the name follows the naming conventions of this document and that the registration does not duplicate the semantics of an existing registered entry.¶

A registry created for a new Object defined in a vCon extension (see Section 2.5) is named in the same form as the registries defined in this document, for example "Party Object Parameter Names Registry". It is created within the vCon JSON Registry group and uses the same registry template and registration policy as the registries defined in this document.¶

7.3.1. Object Registry Template

Parameter Name:¶

The string name of a parameter to be used within the Object. The name is case sensitive. Names may not match other registered names in a case-insensitive manner unless the Designated Experts state that there is a compelling reason to allow an exception.¶

Parameter Description:¶

Brief description of the parameter¶

Change Controller:¶

For Standards Track RFCs, list the "IESG". For others, give the name of the responsible party. Other details (e.g., postal address, email address, home page URI) may also be included.¶

Specification Document(s):¶

Reference to the document or documents that specify the parameter, preferably including URIs that can be used to retrieve copies of the documents. An indication of the relevant sections may also be included but is not required.¶

7.3.2. vCon Object Parameter Names Registry

The following defines the initial values for the vCon Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 6
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
vcon	Schema version number	IESG	Section 4.1.1 RFC XXXX
uuid	vCon instance UUID	IESG	Section 4.1.2 RFC XXXX
extensions	list of extensions used	IESG	Section 4.1.3 RFC XXXX
critical	list of incompatible extensions used	IESG	Section 4.1.4 RFC XXXX
created_at	creation date	IESG	Section 4.1.5 RFC XXXX
updated_at	modification date	IESG	Section 4.1.6 RFC XXXX
subject	conversation subject	IESG	Section 4.1.7 RFC XXXX
redacted_from	Redacted Object	IESG	Section 4.1.8 RFC XXXX
amended_from	Amended Object	IESG	Section 4.1.9 RFC XXXX
group	reserved for future extension	IESG	RFC XXXX
sessions	Session Objects array	IESG	Section 4.1.10 RFC XXXX
events	Event Objects array	IESG	Section 4.1.12 RFC XXXX
parties	Party Objects array	IESG	Section 4.1.11 RFC XXXX
dialog	Dialog Objects array	IESG	Section 4.1.13 RFC XXXX
analysis	Analysis Objects array	IESG	Section 4.1.14 RFC XXXX
attachments	Attachment Objects array	IESG	Section 4.1.15 RFC XXXX
redacted_strings	Redacted Strings array	IESG	Section 4.8

7.3.3. Party Object Parameter Names Registry

The following defines the initial values for the Party Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 7
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
tel	tel URL	IESG	Section 4.4.1 RFC XXXX
sip	SIP URL	IESG	Section 4.4.1 RFC XXXX
stir	STIR token	IESG	Section 4.4.3 RFC XXXX
mailto	mailto URL	IESG	Section 4.4.4 RFC XXXX
name	participant name	IESG	Section 4.4.5 RFC XXXX
validation	validation method	IESG	Section 4.4.7 RFC XXXX
gmlpos	participant geolocation	IESG	Section 4.4.8 RFC XXXX
civicaddress	civic address	IESG	Section 4.4.9 RFC XXXX
uuid	participant unique identifier	IESG	Section 4.4.10 RFC XXXX
type	participant type	IESG	Section 4.4.11 RFC XXXX
org	participant organization	IESG	Section 4.4.12 RFC XXXX
dept	participant department	IESG	Section 4.4.13 RFC XXXX
did	decentralized identifier	IESG	Section 4.4.6 RFC XXXX

7.3.4. Dialog Object Parameter Names Registry

The following defines the initial values for the Dialog Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 8
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
type	dialog type name	IESG	Section 4.5.1 RFC XXXX
start	dialog start time	IESG	Section 4.5.2 RFC XXXX
duration	dialog duration period	IESG	Section 4.5.3 RFC XXXX
parties	dialog parties list	IESG	Section 4.5.4 RFC XXXX
mediatype	dialog content media type	IESG	Section 4.5.5 RFC XXXX
filename	dialog content filename	IESG	Section 4.5.6 RFC XXXX
body	dialog inline content	IESG	Section 4.5.7 RFC XXXX
encoding	dialog inline content encoding	IESG	Section 4.5.7 RFC XXXX
url	dialog referenced content URL	IESG	Section 4.5.7 RFC XXXX
content_hash	dialog content hash	IESG	Section 4.5.7 RFC XXXX
disposition	dialog disposition	IESG	Section 4.5.8 RFC XXXX
session_id	RFC7989 session ID	IESG	Section 4.5.9 RFC XXXX
application	dialog source application	IESG	Section 4.5.10 RFC XXXX
message_id	dialog message id	IESG	Section 4.5.11 RFC XXXX
redacted_segments	redacted segments	IESG	Section 4.5.12 RFC XXXX

7.3.4.1. Dialog Type Name Registry

This document defines a new registry for the token name values that are permitted as values to the dialog type (Section 4.5.1) parameter.¶

7.3.4.1.1. Dialog Type Name Registration Template

Dialog Type Name:¶

The string token name of a Dialog Object Type The name is case sensitive. Names may not match other registered names in a case-insensitive manner unless the Designated Experts state that there is a compelling reason to allow an exception.¶

Dialog Type Description:¶

Brief description of the Dialog Object type¶

Change Controller:¶

For Standards Track RFCs, list the "IESG". For others, give the name of the responsible party. Other details (e.g., postal address, email address, home page URI) may also be included.¶

Specification Document(s):¶

7.3.4.1.2. Dialog Type Name Registration Initial Values

The following table defines the initial values for the Dialog Object Types Registry.¶

Table 9
Dialog Type Name	Dialog Type Description	Change Controller	Specification Document(s)
text	text dialog	IESG	Section 4.5.1 RFC XXXX
recording	recording dialog	IESG	Section 4.5.1 RFC XXXX
incomplete	incomplete dialog	IESG	Section 4.5.1 RFC XXXX

7.3.5. Session Object Parameter Names Registry

The following defines the initial values for the Session Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 10
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
start	session start time	IESG	Section 4.2.1 RFC XXXX
duration	session duration period	IESG	Section 4.2.2 RFC XXXX
parties	session parties list	IESG	Section 4.2.3 RFC XXXX
originator	session originator party	IESG	Section 4.2.4 RFC XXXX
session_id	RFC7989 session ID	IESG	Section 4.2.5 RFC XXXX
sessions	Session_Reference Objects array	IESG	Section 4.2.6 RFC XXXX
dialog	session dialog index list	IESG	Section 4.2.7 RFC XXXX

7.3.6. Session_Reference Object Parameter Names Registry

The following defines the initial values for the Session_Reference Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 11
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
session	referenced session index	IESG	Section 4.2.8.1 RFC XXXX
type	session relationship type	IESG	Section 4.2.8.2 RFC XXXX
description	session relationship description	IESG	Section 4.2.8.3 RFC XXXX

7.3.6.1. Session_Reference Type Name Registry

This document defines a new registry for the token name values that are permitted as values to the Session_Reference Object type (Section 4.2.8.2) parameter.¶

7.3.6.1.1. Session_Reference Type Name Registration Template

Session_Reference Type Name:¶

The string token name of a Session_Reference Object type. The name is case sensitive. Names may not match other registered names in a case-insensitive manner unless the Designated Experts state that there is a compelling reason to allow an exception.¶

Session_Reference Type Description:¶

Brief description of the Session_Reference Object type¶

Change Controller:¶

For Standards Track RFCs, list the "IESG". For others, give the name of the responsible party. Other details (e.g., postal address, email address, home page URI) may also be included.¶

Specification Document(s):¶

7.3.6.1.2. Session_Reference Type Name Registration Initial Values

The following table defines the initial values for the Session_Reference Type Name Registry.¶

Table 12
Session_Reference Type Name	Session_Reference Type Description	Change Controller	Specification Document(s)
child	contained session	IESG	Section 4.2.8.2 RFC XXXX
peer	parallel or overlapping session	IESG	Section 4.2.8.2 RFC XXXX
precursor	preceding session	IESG	Section 4.2.8.2 RFC XXXX
breakout	breakout session with a subset of the parties	IESG	Section 4.2.8.2 RFC XXXX

7.3.7. Event Object Parameter Names Registry

The initial values for the Event Object Parameter Names Registry are listed in the following table. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 13
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
type	event type name	IESG	Section 4.3.1 RFC XXXX
time	time event occurred	IESG	Section 4.3.2 RFC XXXX
sessions	event session indices	IESG	Section 4.3.3 RFC XXXX
party	event party index	IESG	Section 4.3.4 RFC XXXX
dialog	event dialog index	IESG	Section 4.3.5 RFC XXXX
channel	recording channel index	IESG	Section 4.3.6 RFC XXXX
contributors	recording channel contributor party indices	IESG	Section 4.3.7 RFC XXXX
button	button label character or string	IESG	Section 4.3.8 RFC XXXX
transferee	transferee party index	IESG	Section 4.3.9 RFC XXXX
transfer_target	transfer target party index	IESG	Section 4.3.10 RFC XXXX
consultation	consultation session index	IESG	Section 4.3.11 RFC XXXX
target_session	target session index	IESG	Section 4.3.12 RFC XXXX

7.3.7.1. Event Type Name Registry

This document defines a new registry for the token name values that are permitted as values to the Event Object type (Section 4.3.1) parameter.¶

7.3.7.1.1. Event Type Name Registration Template

Event Type Name:¶

The string token name of an Event Object type. The name is case sensitive. Names may not match other registered names in a case-insensitive manner unless the Designated Experts state that there is a compelling reason to allow an exception.¶

Event Type Description:¶

Brief description of the Event Object type¶

Change Controller:¶

For Standards Track RFCs, list the "IESG". For others, give the name of the responsible party. Other details (e.g., postal address, email address, home page URI) may also be included.¶

Specification Document(s):¶

7.3.7.1.2. Event Type Name Registration Initial Values

The following table defines the initial values for the Event Type Name Registry.¶

Table 14
Event Type Name	Event Type Description	Change Controller	Specification Document(s)
join	party join event	IESG	Section 4.3.1.1 RFC XXXX
drop	party drop event	IESG	Section 4.3.1.1 RFC XXXX
hold	party on hold event	IESG	Section 4.3.1.1 RFC XXXX
unhold	party off hold event	IESG	Section 4.3.1.1 RFC XXXX
mute	party on mute event	IESG	Section 4.3.1.1 RFC XXXX
unmute	party off mute event	IESG	Section 4.3.1.1 RFC XXXX
keydown	DTMF/app key/button press event	IESG	Section 4.3.1.2 RFC XXXX
keyup	DTMF/app key/button release event	IESG	Section 4.3.1.2 RFC XXXX
consultation-start	transfer consultation start event	IESG	Section 4.3.1.3 RFC XXXX
blind-transfer	blind transfer event	IESG	Section 4.3.1.3 RFC XXXX
consultative-transfer	consultative transfer event	IESG	Section 4.3.1.3 RFC XXXX
transfer-abandoned	transfer abandoned event	IESG	Section 4.3.1.3 RFC XXXX
channel-contributors	recording channel contributors change event	IESG	Section 4.3.1.4 RFC XXXX

7.3.8. Attachment Object Parameter Names Registry

The following defines the initial values for the Attachment Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 15
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
purpose	attachment object purpose description	IESG	Section 4.6.1 RFC XXXX
start	attachment start time	IESG	Section 4.6.2 RFC XXXX
party	sending party index	IESG	Section 4.6.3 RFC XXXX
dialog	associated dialog index	IESG	Section 4.6.4 RFC XXXX
session	associated session index	IESG	Section 4.6.5 RFC XXXX
mediatype	attachment body media type	IESG	Section 4.6.6 RFC XXXX
filename	attachment content filename	IESG	Section 4.6.7 RFC XXXX
body	attachment inline content	IESG	Section 4.6.8 RFC XXXX
encoding	attachment inline content encoding	IESG	Section 4.6.8 RFC XXXX
url	attachment referenced content URL	IESG	Section 4.6.8 RFC XXXX
content_hash	attachment content hash	IESG	Section 4.6.8 RFC XXXX

7.3.9. Analysis Object Parameter Names Registry

The following defines the initial values for the Analysis Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 16
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
type	analysis type	IESG	Section 4.7.1 RFC XXXX
dialog	associated dialog index	IESG	Section 4.7.2 RFC XXXX
sessions	associated session indices	IESG	Section 4.7.3 RFC XXXX
attachment	associated attachment index	IESG	Section 4.7.4 RFC XXXX
analysis	associated analysis index	IESG	Section 4.7.5 RFC XXXX
mediatype	analysis body media type	IESG	Section 4.7.6 RFC XXXX
filename	analysis content filename	IESG	Section 4.7.7 RFC XXXX
vendor	vendor producing content	IESG	Section 4.7.8 RFC XXXX
product	vendor product producing content	IESG	Section 4.7.9 RFC XXXX
schema	product schema of content	IESG	Section 4.7.10 RFC XXXX
body	analysis inline content	IESG	Section 4.7.11 RFC XXXX
encoding	analysis inline content encoding	IESG	Section 4.7.11 RFC XXXX
url	analysis referenced content URL	IESG	Section 4.7.11 RFC XXXX
content_hash	analysis content hash	IESG	Section 4.7.11 RFC XXXX

7.3.10. Redacted_from Object Parameter Names Registry

The following defines the initial values for the Redacted_from Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 17
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
uuid	less redacted vCon UUID	IESG	_#redacted_from_-object RFC XXXX
type	redaction type or reason	IESG	Section 4.1.8.1 RFC XXXX
url	referenced less redacted vCon URL	IESG	Section 4.1.8.1 RFC XXXX
content_hash	less redacted vCon hash	IESG	Section 4.1.8.1 RFC XXXX

7.3.11. Amended_from Object Parameter Names Registry

The following defines the initial values for the Amended_from Object Parameter Names Registry. Use the template in Object Registry Template (Section 7.3.1) when registering additional entries to this table.¶

Table 18
Parameter Name	Parameter Description	Change Controller	Specification Document(s)
uuid	prior vCon version UUID	IESG	Section 4.1.9.1 RFC XXXX
url	referenced prior version vCon URL	IESG	Section 4.1.9.1 RFC XXXX
content_hash	prior version vCon hash	IESG	Section 4.1.9.1 RFC XXXX

7.4. vCon Extensions Names Registry

This document defines and new registry for the token name values that are permitted as values to the Section 4.1.3 parameter. However it does not define any values for this registry. Values for this registry are to be defined in subsequent documents which define extensions to the vCon schema. The registration policy for this registry is Specification Required as defined in [RFC8126].¶

7.4.1. Extensions Registration Template

Extension Name:¶

The string token name of an extension to the vCon JSON schema. The name is case sensitive. Names may not match other registered names in a case-insensitive manner unless the Designated Experts state that there is a compelling reason to allow an exception.¶

Extension Description:¶

Brief description of the vCon extension¶

Change Controller:¶

For Standards Track RFCs, list the "IESG". For others, give the name of the responsible party. Other details (e.g., postal address, email address, home page URI) may also be included.¶

Specification Document(s):¶

7.5. JSON Web Signature and Encryption Header Parameters

This document registers the following new parameter in the [JWS] JSON Web Signature and Encryption Header Parameters registry.¶

Header Parameter Name: "uuid"¶
Header Parameter Description: UUID of the signed object¶
Header Parameter Usage Location(s): JWS, JWE¶
Change Controller: IESG¶
Specification Document(s): Header Object (Section 6.2.2), Unprotected Object (Section 6.3.1) of RFC XXXX¶

Appendix B. Example vCons

This appendix contains example vCons in the unsigned, signed and encrypted form. The JSON has been indented for readability. The vCons have been formatted such that long text lines have been wrapped with a left hand white space indent for readability purposes. Links for unformatted versions of the vCons are provided for each of the examples. The example vCons in this document were generated using the [PY-VCON] command line interface.¶

B.1. Two Party Call vCon With Inline Recording

This example vCon is for a simple 2 party PSTN call. It has a single Dialog Object which contains a single channel wav format recording with the two parties audio mixed into the single channel.¶

The unformatted version of the following example can be downloaded from: https://raw.githubusercontent.com/ietf-wg-vcon/draft-ietf-vcon-vcon-core/refs/heads/main/examples/ab_call_int_rec.vcon¶

Note to the RFC Editor: This example, and its unformatted version at the URL above, contain the vcon parameter (see Section 4.1.1), which is included in the Internet-Draft versions of this document to indicate the version of the schema upon which the example is based. The vcon parameter is to be removed from the example and its unformatted version before publication as an RFC. Please remove this note before publication.¶

{
  "vcon": "0.5.0",
  "created_at": "2022-06-21T13:53:00-04:00",
  "parties": [
    {
      "tel": "+12345678901",
      "name": "Alice"
    },
    {
      "tel": "+19876543210",
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "recording",
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 4.72,
      "parties": [
        0,
        1
      ],
      "mediatype": "audio/x-wav",
      "filename": "ab_call.wav",
      "encoding": "base64url",
      "body": "UklGRioeAABXQVZFZm10IBQAAAAxAAEAQB8AAFkGAABBAAAAAg
        BAAWZhY3QEAAAAgJMAAGRhdGH2HQAAoxjXHYXCRekuye4gK4Tsiv4wZeN
        htuvu3RMkgyPXme4NeahQLG0yeLayx5HCIiRWK7psbQrQTFm57NwQJvIb
        q1aNxk6VpMYAXSm5Bb1rgStIStvEzmCaOIabxs2gjReJ02Rk0BQtOxHkh
        UTIZd4VGKoq1KuoCGhrZTx1vRZICuZEcgkGjdH2jiCU1a0NMW6BE8lVHN
        -OYFPHcZspr0CSl1aeo2hOWUx3CbovpGqKsApWteunk8gMPMOdynRVFWR
        5o0l2BvaQDcWugGRHrQa9NcEbG1LWQq_AWLpsXKdMQefGrZu4ZE2ZSDIR
        GJLTKpIzDybqSyZishQmjuVGztMKNlcyt2vW546JsutgllyppQWroAtHb
        kyrrGAx3bIiX81g1sR-oVaBbtkobA08fpJYscQSlHHcGm7hDriuWTRm8A
        6GKQ1Fbcn10M30DcHctnEchwaAI7dxI2knYCQ5biNHB2Djxm3bFmyU5TA
        3ALZt3DaSeABIkiRJcm0AxpEkSZI7AEiSJEmSwUYZ1mQLYNu2bdumPWDb
        tm3b9gOAJEmSJFkFgCRJkiQZbHRhTccDtm3btm0qAEaOJEmSPABIkiRJk
        jAASJIkSZLBRhfW9CKAJEmS49gCgCRJkiQ5P2Dbtm3bZgSAJEmSJClkcm
        VNLgBIkiRJkm8ASJIkSZIvAkiSJEmOswM2btu2bcMVmd3kIoDkyJEkySO
        AJEmS3AgGgCRJkhypC2DjuG3j9mxOWQiyEUQ1DAtyvQJS9aTWWc4KuFqL
        O9F4CCJX4yeFkMaSUWSLYMkYinzGa4HzyrEi6-pgHVdXe6mugKzW7VqHY
        OzcDDsXWnJkeVXHFKpuLDZSrAroZOQohtASpE4dyZSRxozJQC6hJE2OLG
        iNYLM1ruIWzsCcRhEW6c3AJhq6bmp9cZ0IvAy2a5xJVcUMNE8Qq3G0CEJ
        y30SNxwrUqUy5NczWkI3S7UCk4iyrBM3AzCvJqkisQPQkcekWjYDoJk4D
        pWiPmUzXCtKFMkuy1g7MtWnrqLwMSqpjR8vXDipSKzk1D-bOjdLzgNQol
        lapqqCUmjChmctA6jRmYPOLYJtHbatocTAZCfAQ3LHs6O2zDuCC_LyStA
        gkklFHZesUspXsSr0S5lCRYg-hXc2tKqMsgeqYkNzSVmLc9mk08zbhzUK
        O3fhkzJQsvBTCcNk2s-oUxO5zpatkETyFn-xtrxRaTR0hZk3WDo5ELiFW
        Oq7hmMxgKjdcY0SO4Fk7cijHC6EYNXEZI6oDUQz2EeJMMh1orxSOup04u
        UUjOtyjwVQ3HdhpuSRyJv0WzpRTo-so7pMpdgKWUk0jlEwjiqBJAwcuw5
        lca39VznGdMLAg6o-EEenbKEQxgkeS0xxEteISQcQUNPm8KxaV1xKKIq-
        BFEpsm_bjIFPLiJwpRoEoSZEuqWuBJLuu1oxZC8ksQB0Wkt_IqrwaSMq8
        p4mzEPrFksdx9i9KZVv36AvGkMmyKsHI864U2eThk-iNKRsvgRsqL1vMT
        UHbPK2ZqVwNHW3oEIay3EaN7xJGgV4mmK8Q1k0O4jHPCFpRzHYxBtbOEZ
        FMQeMoOVQ2F8GTOXvh9-qARmvOaH9MYaOpdTIFaS-ZJO4OGmZOvo3fEig
        5M8lQvwxinfXKhc4QrPGM0pIJthKKkixBYjvlZJlNwXTljSW8VWFex6ts
        hg7BUiVuU8VoDtlMwRBEkqXknPYWWNFMRtW_FMhsVIpV4RDESZlqtFXHV
        I3GSmHZyNFMV24h48qsHAdLYeumkSKhTYG1Qp0LpWhr1UitEmaJ1DxuXw
        gGEe62VbkIUKKbdkv2CFhIZMdnkebSjRKzoCG7Uc32ywDkqkauEsuAzOq
        K1vnNoKFOtloMaa5YBWwbZI_aPtKzFMpyqx7WNBXEqt43TasSiiaAKW8U
        2NSFxMuA6htzZ8ougZAbtgLVamHcwpHZgq6B40DSETuvriVpKyFIUpxog
        TQvwrBFaY5MScRRE6GFMFGqYp5L26r4Eo2kooM941UsSSRC6NVuXVFmol
        1pueTN7sLdPY-uiHbuECmzJFAvywh-KivWrRRtmK4u4p1Va666LNhrFMt
        F3tZKlTDvgdOFlqN-zUGbWLWajishIrY5DTNLYovSDJJ2co6MCCwrxmmd
        6u0wU-CtiptRtUQohlesWT1X0I4kR-NrCEmIIFRGelq51TpDpN2jnuxFr
        UWfaop44QqkpsixOkeSsFwpyiIoHV4IN-NAtFJboRbtIqoILbeS0SJe1i
        2_tl8Xi4xizaGMTbVg3w4C6biZ8LrTot8bmqK5TWIKQWqUWloIyQhHJaA
        MTQaq4SQWNzTeTaoc5MHEkWrWHEY8moxcmLeQkQStoV9lsiM7S6HlKE6n
        LKfAJK3GVq0WQeK8fmKNcascCXElWJJd9iwvNSi9mNvGsRwsvvxyHsw0O
        qqptnxsWafZojyKIykTLXobrtrgcAoryw9tNE7TVstKaCBBmEJ2LMUsXJ
        KCCBk1kWpsul1ZnZRgWoSnleyJ9njK9VrZXCrYFojg6ofqqAam-jOFbEv
        QIIcLJF9f-quNDsQiS9ac_ljMEE30OjQXKrmVeCxG7iE3UmIcLO4g0zVP
        FXAN5biakMaMydRuQRlJ2NuaTOEqKabgJg8hc8KNG6PLgDxn1fDGZAzRL
        OsMhnEGF6--CEZJU6ly4hJmqiXpha4Wumlis26U5hAVtMxgmpVUIzPOoF
        gpsVVLLOHiSOrKysoBq0Zx4xZZTVFJOwqozvXM7WEQtpmkq7GqF-ZKnqo
        2YBGysVvsSJPm0I1kDMHOdHEkN09hm8NtJWnmgA1HDhVoL2ENW6odeXkN
        2SjJCmjxotduUws-l3OyDu8KtGUMMc7ICrJu6XpMSsdQkSTuwEC3ddtk1
        sBUQyktmMqA8Ti6G-crYSsVVlmFXE5VLeQOtC5kuFCrCEaqTeuJWQu662
        W5sr4KQGcrRVjLFlHVdK1AV8Wt23ivgJmLsuU8TcEjG_ZdREvB1iiaHKh
        cz1xJMxPOah1FhvcK8lOaK1nSFjSPk8iRxghUySuliw230olEzwCfOKfz
        Wq1gbFMH82iPYAk3rlNhzICdTIYblWwvYSnWDliN3TRvLwcmQhMcPlYJ2
        G0NuYpJD0KtVEqpSuaU1fJLgdp0aRyn1kAzM6_jW-6Ab1vxovqtwJTZzm
        Z3YM0gTVgRVm-zNm61DvaQaqVr1A4IUsQ8LLkMJpXarHRIxlLSNK3Akqh
        uGv2uQA6pcuSkrmCpllETvY4g4sgt3IZgbhUtSQ3orOouknUJ1taUPXRI
        Dbq5EVeuvgzEsQQ5jgvmTk10zaCg2G2Tm9ZAzCJO3ZSLwN3M9XWerUD9y
        motaWDvHEm_DMyQrMou9w7OsB05t1MLNLZrvBlRCyiKjkSNicYUzuazIJ
        WzclQ3ziAtZVVs5a6Azhg6GYPKYGHFPaTKYO5ULdIIuIVksabFDJrRRdw
        9tAxEiUvZpcIOmrAj69TTtpaJsMpgneyUu9ZtweRYk6l2zKDS5JJsq0xh
        JBfulMtcL5kscBlAcSNHUsIK9qirs87yELpvrLnOzBCklpo5lYvGlJFUj
        IBTKTkkcU2BGheP1KqrgF1TrSljrYDcpm5KK2RSYU1nAERu3LaNXQDIce
        RIjmMASHIjSZI0AkiS5EiSgUcX1gQDgCRJkiR5B2Akx5EkqQOAJEmSJJk
        FgOQ4kiQZcJQhMbwENm7bxnHnBLZx3MaRbwBIkiTJcTcAOHIkSZLBNhvW
        xiSAJEmS5DgFYBxJkiRpB4AkSZIkeTxg27Zt28ZoLB1FqA84qpop2DMPx
        B3yyHWxCEq-fmsS1w4YUjo9rZTHlFH0q2AdUZIptdIgy0RuGddqgdyotU
        Kb6kDbE4ukV4FunQyxDEpOHKgiUSHekezIka8Kys0TR3PlCFqPHrR10te
        OkYSnQKOlepQdzQALJTqbhIqAomiNxIiNQFTXZWWneXHhSPESVm4lyc1O
        EahpnMKFsBQojionS9MISIq9u9dX59iNgu2gpbd5mlatoGmpjpyqjmBt5
        mp0Za5gpVZzpUR17lgp0gqgLVIIdvMIpMbktErBDJqS65hy7ApUjiOjsZ
        jXVtnitEDxJq5aG66ApGvxHWmugByp0ds4LmGdNmmEymntVCmzCtSY5M1
        qUBO8kizbWc8NqLsw9nW0Gs7tY1vtFaiWTVDsoGVNdfvy7EFD0zJMJMuh
        I8etAzstQSK9TqvpdEzdBMUeNm5USi3YDuxszZiSWgyyWeoovtoMyHWWq
        2ZV91RVoMpgpZpQ1zgMgaS7rZxLzEDtpK2trKygm6OGJjhtTtkkxQyorh
        vXclcNUm6s1VLtDlhq1joy3Qo2RpWU-ZK3zs1CNSH1RJqjWGsho6Zx2oS
        sgGJIcZs6ziDMOLLqmo20XU34CDxWFAlOzAwIclQXst8MptWj3tLfCOz1
        7dx5VMYMkhLXgCU1Tg1GjMAbNW7bZkNg47Zt2-bugBtDMS63bTCdKbESG
        k7cNHK5EMBNJbmW4hLKcq0pfkQL4lCtJpZcZ5lRYExhk0XS7spt4ROnLe
        TaHEJbJykFmkoBhLVwfG1lDRkpRBIW0aM6dXgKONwlc6IpD-5YTcW9ySC
        6cTwpkhfWUFbUi2AfdLNotAyhFTuqiuqzQF43RreH1EHc2G2famXv3GQz
        EbaFWyWKvA54ay1HF-0WaJMjq906C-JtlpSGDtaOkSItYVtKktMmrGCT1
        qEbaSxh1DZOJObUoCBLiW2dhTBZSboKOn4bOVnLCsim9Vyu6wioklaqLM
        wMRpELrXJT15RJUHWB4zRiZbPWgFzGEW1m7GCjCpoi6w7ArGdeWR1xUdV
        E4AhQkiPNbtYLqG2e6JS1CkRf_tqZwgo4U6xWhpT3lokwzIBRsy3tVIsg
        WTSNDUusYBTn6eN4rWCcrBCVxGDNVEXBCm6R5sZ2KBO2buNHk98WyK7DX
        HWwCsQ1pNVVy-YUSnKsYVypCiTXrkDsqC4TR61A2aJ02vjOIJ2ujquiZO
        -cSL4MSpGOSs3HCiZxVDdx8hbGiZS5qekUStXiHI5P1o5N0sqA6vpMc_u
        tIDWYcuJI7GB2uf5jpa2A1k7O2hJ1S50MvwjebFu4sckMmFXwNDJdC2gP
        GbeqYB24bSA5bg7XWI0ky2DTiDPkIu6A4WapZRrtoJu8rhnJy4CktZkdm
        2QuWUj0CnjWs1anShG4kiTXnKkQFnggS42-DhS-8spVTOYSjjIvgZtOSi
        QV7IC9NHYYg8yAy-Sq4mduYeU4rsSaXE-dSdsI1MmiVVS8ErZp3kBO5wj
        EUZ4litUKhlYLm5QIFtPFgkxBVCWnInXNoIVYldbH66DrRk768I6gWceU
        HbhsbZ1MuBLKqaPWZtUSumrm0pKsEkSW8bZx9gzKVdvYjBkIn41UzoBFK
        3LyJsuA6kZz3MUuQeU0DhvnbYEcW5bdqWANoUQrDbibYg2RxwykcQtFxu
        oKIuEcw871DDhunD4tzhWRiZKuwORIrt6cHWGatkIUN7RA5GRSnbytgA2
        mUh5lce5QSPAOVI1y5IjtErKQGbd1vwxM0p1FrtcMZJIdtTLS1s6NgKxA
        tkKwi3lMgWQ3umtJ7EAdaSMlRayAXbdarDp5LxEpxAgMd4zJkKwMhp4iu
        TKzDKaQSkOh3w7Gkde4udP2zowSzGDUzMPuSMvAJUlVLASPgOSocix9s4
        DzYFbqOmlN2Si5CDBPTUeN3AyiSASTj_gKQrGctqdxE0QupVatDbeMTdK
        KQCOVhgu562BiGc8kqZSgbmtJFpWswNs2N6N8cTEdLcAIqLKKN2nHDKay
        FL-VSAtmrgY5caoKppCbxnRPxkzJ4IxAzLamG0dPweK2jp0WzCAUF4lmu
        GuB5PqpZGWxi-Tdu83IkRu58bvpIpTjyo49xVau11BOPq_Mb1I30pTKhu
        LbE-qCppVr1bMoG5MWofRNaO9FTtUULKkcxK1se60u4PnCSpYeriVaxor
        WtSTbT3ZK-p8kPe3OUiL2Y0mSV6vGnamuo-xkacV8jGIsCdadKA_ipsBK
        XQamggPJeduCoXCctcQSaILpxDhsIvSya1mXrwzUEtw0g9UKyjCDNMmYF
        xWa1G6BBUWGlK_WoJooLVmiBGHikq3TOO9AEUt8yriBEt1F5gjCrW17ll
        gN6E7bRoi2FDau7PaxcRMsVt5Wr9go19VEzaBf2C4UUY5gmjI1SF2MQJU
        7ZWVKrUDpFujiln1R4UivHsaQmzSNxgpGtiM9t9kSpn4bzbHvCnaKZmWq
        2AfTjebrYBCpdao7zaCoRVZr8-pgwzgwjVDtAJ0mjdKkiRBhRbsKSrXlN
        KtbD-aKFDROcw1Ehiq5jtAIKHooV3bV9lCVdKsge8N14oiuIJm0ccukra
        AjR32iF89grKzNdamJcSEltQ7aTZpjxc0KIillx5XHCHysPSmv5gx4W2O
        7Nxf4EFLybMEchVUcy81g-kryZoEsoRzLTe5Iz2DuuJGTo4TWsS7EEqZq
        ZPWVzwm8cSfnTlMNZnTdRBWqLFRO0FhyCwrNsgWL4WWmlaQNfAKyp7a_o
        iJiLDOWg3KsAU5ZdmQWsYhsm3Ua6JUbian3EvyU9yIn9BBIfVv4gU81SF
        F9pZFK-RRuGcuho3tJyUIEIdS4jUsJZ2ElNbAWKI9ApOJ10yWFL91xwha
        ia6MmSbQUVIm9V4avEEx1c5up0g7a8M1AJlYnF9pUb4H7NrZay2vBJrc2
        k2XXIB0rbxGVbEHSTPLkdHVP3SiyFkrSfMuqxxSoUywTl7IK1nkqWR3qF
        NigHFmJWfeOTZKu4OsYU5RWNWLaxG3QKsxAH0Xr5MYsgRRlrRxdeTFZKP
        QOWKXeYsHHFFSVOiuy4xLmktxOiccSTLEdt06UeF2KVM1gajRx2oivgNS
        oT9Uo1WEamTIm9CohXLeNQMbUdBiaxp2WflvGlTgayFeymZpJEhaXJbvJ
        bhY-6rEiNo1q35r2NWEeGLEiFZUh7qBmzS6rAtsoEfP2qgIqN07jV62KJ
        L5mJ8xvQMXyuSqOmKTZmr0gILnRjZnWLNy3E6apVcqEmXur4e1Ezc0Mhk
        FCmGVjYezBbFiQqsRKoZqj4hX5pCtSP8sQhnUaqW1RJSqSNgF3q6VIkts
        6gbI6OvI3h4nQmlz1ozQkau0juIS0Qiw7auE3tEEvYXRsZuaB2jJr6uOY
        LyWaxR4Y1iR7T2sS6u4Z3ULmGNjN21tO7hS4nJs8rxUoT9HUi6Ds6-5mx
        y1BJLdNZmZPgc7IbpV61UCqx7FkV4FwUSi1CpI5kpRt8Agwbx1liMIIYg
        vVuNbBCKTsXsSQmQeVyYQ0IV2XedKKrSAvabkyS-5gMV0WNe3twGuVgdy
        kiZNZTb8MQkvFX_GvDiqZ7Jqx6Qy4kc0YieoUxlCMptKYB1WRQO_AZunS
        7XqsYBZOkdyUruCy6A2gRc6A21apH0mB9Slu2wbkbbohLvQWuEnhBE2qF
        qZQlXpJsBRaRZ4qzkyZ5SIjVEHMJknKsq1BI7RtG_eKABbHbKrC7kCkWI
        dGQ4GyoUnzCjItYBipvAq8yFbt7WcMKI5j6s3iDkRSmwxGV-cOlub0oNv
        Y0poFzYBrV5kx60thYpm17IgtARLGrKsJfdFYkcIUJrr1mHrzCMLzKzV9
        xgy6Vh1Hpe0SuDYd125Nm9hzUw-hHjlS3JiNQJ1Ijdu2fWbj2CcZ14pk8
        msp48awbTU3Vhr-TrTvKFIcJPojF333KkjyGUaSZTV6aQ3L1U5roOuwHE
        eaE3BkySIiTaBS7LYsgZnfdoSZBqHdpK1LJ6nQXJpwFchNZ-vv8xp4cqv
        Lqa0cGpWl9XayEpCRW4nNE_pKXYuXQZRLUfXLKmFox06kAmxhaUUlY2rP
        QBndZc5KgVBZVccIYtqqta31CDpUHcdw6hTWRcLIlSsKUoKsXoqS1xKRs
        q3AEDV1YXdNQVsLcavky2BUuV3TLK2A5BI-god9seFE9A6yU9tW2-oKUq
        Z0RZLgCjw5p0l25BC4kZnYadDW1I1grKALt9LbprSAbMalGvUuQSahbhP
        JagGlRHEktWixXCXhDOQRDBlSVh0mU7LYCU0RTgM_Q7Y6EtCuUUuyS_aO
        ldRNYTI30c12jsDe9orzdy2Bs1qyYl1X4TtVsuuqWM4YTasUyMbarHYtE
        byJ3Bo12BWYivAUrq0sGlIcSajNGBOaV83iXSaO2orMgR1LTvvmbqIkV1
        bqhycBO6edpup4cqVNsBKorPfKk-kQVj4uOb2vFDR71CiSzRK2yQu9bRk
        2U5GA74Bmmc-a3Duh2wt71OqKId1YaORWTKF70pIrx4lS3SjKDFAtoq5N
        RBOoUKRmaXYWRJGeyNbGFNphZDhQSOeQyWBtYUOViaKmq4Ds5tTbOi1hV
        D-ObJWqoF3EMeuQZM0kSbIUxka8to7uDEI22iqLLA1GVqU1kdkKUm7juL
        HMxtBJwoygoxXHHceqgNI0coPGksAkukX7kCphGrtuXkWBENVIzxI-MSU
        nUrAIukf69lHJDDYvE0teUQ1Y1V9IUo3mzkVUz6AUtQccy8pgLSQ5BXnL
        IBYzmirr7WBhyUVr9WjuHE0rCwhyWueNtw5IbfpWqrgUNnoiaXLDCiy50
        lvsjtdQkWKLAKNekZZirKCnaDVvVu3gHNlVYX3MQLIoSq6KgTCdRPIO0I
        2jusa2CmbG5uautQ5Ipl3WT64IOLVbW9PQKNcZZ8-A7Dp3pswbQdQ6PYG
        NK6HaxUDiVs2AZRnOzRaRUJ1Z6RRI0iTHyfYKRI4cOjrxEqgqospuKyO4
        VZK_1lMokw2JQ2EolrXkqIzAI9wynWjn4FHvUqacrIC0RnZac4WPmUzNE
        CZOpSgqWw2qbCREedIMNFu0NS7rDCQRm5iOledUzULLgCLLkIOJzyDaI6
        6hO--g3DQi01zLYCJHtJ2biVHhKPYMtKkxqW7hDEp1K9Uh1g6aTE04qTY
        AYJ3fXApcCBWS5MWA3OSpIoePwJXFTVo2rGAVRlHst8tgbmeSpDZxUJUk
        sA6kcd4lkuUIso2UtZG9ClrW79RZ6QpmbuLiclb31E2k7CAqw45ki60A4
        6rW27Yq4D2fkhOizUDkok4SxYkyWSmyCFauWgc2xgT6dKJu7dAIqpENKQ
        bnCDROpEfX1vfUiXK1YHY3fvRXzGD8yJUhCY0A3TJtU4XvgNpMip1KbQ-
        VLPQMwoxUJ1rIDDQuKyN5qg5Ek_28smIPSHotx9XY9lJF5MxAqi4uJffq
        QLS4qSZr12BVG3lb7q1gmRdtnJiNcF0kyAqGNkw5KuoOyG3XXJbpCMxxZ
        zuZ9A7IjBzXzRQHk4Xi66Ciak0sa9ZAk7uQJJmtIBrDQhIZDCCisukrYW
        2QWUj1CrhUGrmp9grYb-oYUuwMOGlkzJLUCMht7lzQHpubADSzYJ1ftv4
        KrIGVNW4YtUphGyv65IpeYkaXigzfwRxbJK4eULOsuofVTeKhI0V7rVx6
        syVN58RFipMWLcXb7HWa0ool1tVSbRerw1U13_R970Yst2rTUDSHiqJEk
        dDB3u8tLXXEZRi3iLuKOJJsq89gTZ4TTUs9wXJSZIUvXR-7sZUYe8uDt1
        KkJhPJMc6uUfVsadMGMupEzmqFtXHdstEeH4X3qL6u60iO3kZOOfwyo_K
        eppGj8RXzk2zV00dWW80n0QTMxLbTfSB8jmdFp02aKlNlK1l97XheSYTX
        kOLGwR4faduDnqHCOE2_ZLbx6rq35oJe0p26lepuXOWTt7Ie_DmLNi4ID
        SZom4YzSEtD47tmVUra4GERBpUJACE0Uua5njuKvpK2ddy599W22r4k_U
        2rbBguUz2dY6tWrvTZuZr9sdZE7-olvZu1lUrIGj9QIfauaCtaeXRZr4k
        fW5Hlxb0fr3U2lWqt6sOSaYEyZJEIdkWdSu89fZvqdnrVNRmum_xp2jTn
        h2ISAYJiKwN0oNFtnSyD5Eiyw3dPBAY5diql0b9ecXVDBo2Rs63nWNr6t
        fuyXTmu8nIabShdNojSNGobq52IxMKBgybmG60GIeX0pUNWh0AA9KxbRY
        yBJnluZH2Jc4hI2iigbuXGkTgINqqeKLVUDKTR2dQt6gpWMhzXTRd4B2B
        ULCDiSHXDgy8AnTuMqiROgCsJsYs4tGAjt1WcVdE2SATnCLSKbNhtyAJQ
        ciPHaL0Eyo0bWcX0DiZu29hwFntXxIIy4KuVckrtDCD4tGYSHctAFDmNz
        VbPQCvDauJGqTgafrcINDGcNGnZR7Zt3PoALxSCUqY0wbyrSHmTIZc"
    }
  ],
  "analysis": [],
  "attachments": [],
  "sessions": [
    {
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 4.72,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0
      ]
    }
  ],
  "uuid": "01a16b86-9a63-8346-b9a2-279e0d16bc46",
  "events": [
    {
      "type": "join",
      "time": "2022-06-21T17:53:26.000+00:00",
      "sessions": 0,
      "party": 0
    },
    {
      "type": "join",
      "time": "2022-06-21T17:53:26.000+00:00",
      "sessions": 0,
      "party": 1
    },
    {
      "type": "drop",
      "time": "2022-06-21T17:53:30.720+00:00",
      "sessions": 0,
      "party": 0
    },
    {
      "type": "drop",
      "time": "2022-06-21T17:53:30.720+00:00",
      "sessions": 0,
      "party": 1
    }
  ]
}

B.2. Email Thread Multipart vCon

The following is an unsigned form of an vCon for a 2 message email thread between 2 parties. The email messages are multipart MIME message bodies.¶

The unformatted version of the following example can be downloaded from: https://raw.githubusercontent.com/ietf-wg-vcon/draft-ietf-vcon-vcon-core/refs/heads/main/examples/ab_email_acct_prob_thread.vcon¶

{
  "vcon": "0.5.0",
  "parties": [
    {
      "mailto": "b@example.com",
      "name": "Bob"
    },
    {
      "mailto": "a@example.com",
      "name": "Alice"
    }
  ],
  "dialog": [
    {
      "type": "text",
      "start": "2022-09-23T21:44:25.000+00:00",
      "duration": 0,
      "parties": [
        0
      ],
      "mediatype": "multipart/mixed; boundary=\"----=_Part_388314
        _1108189513.1663969465698\"",
      "encoding": "none",
      "body": "------=_Part_388314_1108189513.1663969465698\r\nCo
        ntent-Type: multipart/alternative;\r\n\tboundary=\"----=_
        Part_388313_805631480.1663969465697\"\r\n\r\n------=_Part
        _388313_805631480.1663969465697\r\nContent-Type: text/pla
        in; charset=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\n\
        r\nAlice:Please find the image attached.\r\n\r\nRegards,B
        ob\r\n\r\n------=_Part_388313_805631480.1663969465697\r\n
        Content-Type: text/html; charset=UTF-8\r\nContent-Transfe
        r-Encoding: 7bit\r\n\r\n<html><head></head><body><div cla
        ss=\"yahoo-style-wrap\" style=\"font-family:Helvetica Neu
        e, Helvetica, Arial, sans-serif;font-size:16px;\"><div di
        r=\"ltr\" data-setdir=\"false\"><div><div dir=\"ltr\" sty
        le=\"font-family: &quot;Helvetica Neue&quot;, Helvetica,
        Arial, sans-serif; font-size: 16px;\">Alice:</div><div di
        r=\"ltr\" style=\"font-family: &quot;Helvetica Neue&quot;
        , Helvetica, Arial, sans-serif; font-size: 16px;\">Please
         find the image attached.<br></div><div dir=\"ltr\" style
        =\"font-family: &quot;Helvetica Neue&quot;, Helvetica, Ar
        ial, sans-serif; font-size: 16px;\"><br></div><div dir=\"
        ltr\" style=\"font-family: &quot;Helvetica Neue&quot;, He
        lvetica, Arial, sans-serif; font-size: 16px;\">Regards,</
        div><div dir=\"ltr\" style=\"font-family: &quot;Helvetica
         Neue&quot;, Helvetica, Arial, sans-serif; font-size: 16p
        x;\">Bob</div></div><br></div></div></body></html>\r\n---
        ---=_Part_388313_805631480.1663969465697--\r\n\r\n------=
        _Part_388314_1108189513.1663969465698\r\nContent-Type: im
        age/png\r\nContent-Transfer-Encoding: base64\r\nContent-D
        isposition: attachment; filename=\"=?UTF-8?b?c2NyZWVuc2hv
        dC5wbmc=?=\"\r\nContent-ID: <c4c28087-6fa1-395e-e50f-dcef
        d3d6bf96@yahoo.com>\r\n\r\niVBORw0KGgoAAAANSUhEUgAAACYAAA
        AeCAIAAADPdvs5AAAAA3NCSVQICAjb4U/gAAAAGXRFWHRT\r\nb2Z0d2F
        yZQBnbm9tZS1zY3JlZW5zaG907wO/PgAAALpJREFUSInl1t0NgzAMBOC7
        qPvP1gW6Qjdo\r\nj4f0J4qAJI6NROvniE8+mwCvtzv6imTnyf1K/UclH
        UFWjIvaIL3CHCABSPKKtJckWfY6zw+sj5dq\r\nISdVIzmj2klzTZG2Rm
        e7NKgOwY6qPrMcUs+2PqchL14P+oyz+fHx77K5Sv8xyxAyZ0uBaxn/Spc
        U\r\n8NxcosAut1Y3NtjVX7UjZlmpgWTSFyvVQPKB16tSqW53bFnKtyyZ
        vYT3rSsAWADWAlOjseYFfwAA\r\nAABJRU5ErkJggg==\r\n\r\n-----
        -=_Part_388314_1108189513.1663969465698--\r\n",
      "message_id": "<1126698042.388315.1663969465698@mail.yahoo.
        com>"
    },
    {
      "type": "text",
      "start": "2022-09-23T21:44:59.000+00:00",
      "duration": 0,
      "parties": [
        1
      ],
      "mediatype": "multipart/alternative; boundary=\"----=_Part_
        390234_811845464.1663969499935\"",
      "encoding": "none",
      "body": "------=_Part_390234_811845464.1663969499935\r\nCon
        tent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-
        Encoding: 7bit\r\n\r\n Hi Bob:Got it. Thanks.\r\n\r\n
        On Friday, September 23, 2022, 9:44:40 PM UTC, Bob <b@exa
        mple.com> wrote:  \r\n \r\n Alice:Please find the image a
        ttached.\r\n\r\nRegards,Bob\r\n  \r\n------=_Part_390234_
        811845464.1663969499935\r\nContent-Type: text/html; chars
        et=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\n\r\n<html>
        <head></head><body><div class=\"ydp89e479a0yahoo-style-wr
        ap\" style=\"font-family:Helvetica Neue, Helvetica, Arial
        , sans-serif;font-size:16px;\"><div></div>\r\n        <di
        v><div><div dir=\"ltr\" style=\"font-family: Helvetica Ne
        ue, Helvetica, Arial, sans-serif; font-size: 16px;\">Hi B
        ob:</div><div dir=\"ltr\" style=\"font-family: Helvetica
        Neue, Helvetica, Arial, sans-serif; font-size: 16px;\">Go
        t it. Thanks.</div></div><br></div><div><br></div>\r\n
             \r\n        </div><div id=\"ydpdc5150a3yahoo_quoted_
        4829810715\" class=\"ydpdc5150a3yahoo_quoted\">\r\n
              <div style=\"font-family:'Helvetica Neue', Helvetic
        a, Arial, sans-serif;font-size:13px;color:#26282a;\">\r\n
                        \r\n                <div>\r\n
                On Friday, September 23, 2022, 9:44:40 PM UTC, Bo
        b &lt;b@example.com&gt; wrote:\r\n                </div>\
        r\n                <div><br></div>\r\n                <di
        v><br></div>\r\n                <div><div id=\"ydpdc5150a
        3yiv4578005613\"><div><div style=\"font-family:Helvetica
        Neue, Helvetica, Arial, sans-serif;font-size:16px;\" clas
        s=\"ydpdc5150a3yiv4578005613yahoo-style-wrap\"><div dir=\
        "ltr\"><div><div dir=\"ltr\" style=\"font-family:Helvetic
        a, Arial, sans-serif;font-size:16px;\">Alice:</div><div d
        ir=\"ltr\" style=\"font-family:Helvetica, Arial, sans-ser
        if;font-size:16px;\">Please find the image attached.<br><
        /div><div dir=\"ltr\" style=\"font-family:Helvetica, Aria
        l, sans-serif;font-size:16px;\"><br></div><div dir=\"ltr\
        " style=\"font-family:Helvetica, Arial, sans-serif;font-s
        ize:16px;\">Regards,</div><div dir=\"ltr\" style=\"font-f
        amily:Helvetica, Arial, sans-serif;font-size:16px;\">Bob<
        /div></div><br></div></div></div></div></div>\r\n
            </div>\r\n        </div></body></html>\r\n------=_Par
        t_390234_811845464.1663969499935--\r\n",
      "message_id": "<2031327240.390235.1663969499936@mail.yahoo.
        com>"
    }
  ],
  "analysis": [],
  "attachments": [],
  "created_at": "2026-10-24T01:29:10.590+00:00",
  "subject": "Account problem",
  "sessions": [
    {
      "start": "2022-09-23T21:44:25.000+00:00",
      "duration": 34,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0,
        1
      ]
    }
  ],
  "uuid": "01a16b86-acc8-8c6d-b9a2-279e0d16bc46"
}

B.3. Email Thread Text vCon

The following is an unsigned form of an vCon for a 3 message email thread between 2 parties. The email messages are plain text message bodies.¶

{
  "vcon": "0.5.0",
  "parties": [
    {
      "mailto": "a@example.com",
      "name": "Alice"
    },
    {
      "mailto": "b@example.com",
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "text",
      "start": "2022-09-23T23:24:59.000+00:00",
      "duration": 0,
      "parties": [
        0
      ],
      "mediatype": "text/plain",
      "encoding": "none",
      "body": "Hi Bob:\nI just wanted to follow up to see that yo
        ur account is ok now.\n\nRegards,\nAlice\n\n",
      "message_id": "<1402576211.401234.1663975499936@mail.yahoo.
        com>"
    },
    {
      "type": "text",
      "start": "2022-09-23T23:34:32.000+00:00",
      "duration": 0,
      "parties": [
        1
      ],
      "mediatype": "text/plain; charset=UTF-8",
      "encoding": "none",
      "body": "Hi Alice:\nAll is fine. Thanks.\n\n    On Friday,
        September 23, 2022, 23:24:59 PM UTC, Alice <a@example.com
        > wrote:  \n \n  Hi Bob:\n  I just wanted to follow up to
         see that your account is ok now.\n  \n  Regards,\n  Alic
        e\n",
      "message_id": "<1879233410.402112.1663976072118@mail.yahoo.
        com>"
    },
    {
      "type": "text",
      "start": "2022-09-23T23:38:12.000+00:00",
      "duration": 0,
      "parties": [
        0
      ],
      "mediatype": "text/plain",
      "encoding": "none",
      "body": "Awesome!\n\n    On Friday, September 23, 2022, 23:
        34: PM UTC, Bob <b@example.com> wrote:  \n\n  Hi Alice:\n
          All is fine. Thanks.\n  \n      On Friday, September 23
        , 2022, 23:24:59 PM UTC, Alice <a@example.com> wrote:  \n
           \n    Hi Bob:\n    I just wanted to follow up to see t
        hat your account is ok now.\n    \n    Regards,\n    Alic
        e\n",
      "message_id": "<1535873320.402417.1663976292034@mail.yahoo.
        com>"
    }
  ],
  "analysis": [],
  "attachments": [],
  "created_at": "2026-10-24T01:29:12.007+00:00",
  "subject": "Account issue followup",
  "sessions": [
    {
      "start": "2022-09-23T23:24:59.000+00:00",
      "duration": 793,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0,
        1,
        2
      ]
    }
  ],
  "uuid": "01a16b86-b24d-8057-b9a2-279e0d16bc46"
}

B.4. Two Party Call vCon With Externally Referenced Recording

This example vCon is for a simple 2 party PSTN call. It has a single Dialog Object which reference a single channel wav format recording with the two parties audio mixed into the single channel.¶

The unformatted version of the following example can be downloaded from: https://raw.githubusercontent.com/ietf-wg-vcon/draft-ietf-vcon-vcon-core/refs/heads/main/examples/ab_call_ext_rec.vcon¶

{
  "vcon": "0.5.0",
  "created_at": "2022-06-21T13:53:00-04:00",
  "parties": [
    {
      "tel": "+12345678901",
      "name": "Alice"
    },
    {
      "tel": "+19876543210",
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "recording",
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "url": "https://github.com/ietf-wg-vcon/draft-ietf-vcon-vco
        n-core/raw/refs/heads/main/examples/ab_call_2ch.ogg",
      "mediatype": "audio/ogg",
      "filename": "ab_call_2ch.ogg",
      "content_hash": "sha512-Y-Q9eclT6b5hFyIfLtnFAAXgqFzN5_Cjr3J
        Q3DMmcnpXHkGMgtvaxrLW2R2OhFTzR-DinyrngBG2w9lTZXr1EQ"
    }
  ],
  "analysis": [],
  "attachments": [],
  "sessions": [
    {
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0
      ]
    }
  ],
  "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46"
}

B.5. Two Party Call vCon with Analysis

{
  "vcon": "0.5.0",
  "created_at": "2022-06-21T13:53:00-04:00",
  "parties": [
    {
      "tel": "+12345678901",
      "name": "Alice"
    },
    {
      "tel": "+19876543210",
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "recording",
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "url": "https://github.com/ietf-wg-vcon/draft-ietf-vcon-vco
        n-core/raw/refs/heads/main/examples/ab_call_2ch.ogg",
      "mediatype": "audio/ogg",
      "filename": "ab_call_2ch.ogg",
      "content_hash": "sha512-Y-Q9eclT6b5hFyIfLtnFAAXgqFzN5_Cjr3J
        Q3DMmcnpXHkGMgtvaxrLW2R2OhFTzR-DinyrngBG2w9lTZXr1EQ"
    }
  ],
  "analysis": [
    {
      "type": "transcript",
      "dialog": 0,
      "body": {
        "metadata": {
          "transaction_key": "deprecated",
          "request_id": "01a16b9c-30a8-7941-9b74-a9c73124938a",
          "sha256": "460145629244a6c72d4f0b94707ec3ca4e92da1ae11f
            e1d04a3fc88143795c63",
          "created": "2026-10-24T01:52:40.996Z",
          "duration": 32.925938,
          "channels": 2,
          "models": [
            "2187e11a-3532-4498-b076-81fa530bdd49"
          ],
          "model_info": {
            "2187e11a-3532-4498-b076-81fa530bdd49": {
              "name": "general-nova-3",
              "version": "2025-07-31.0",
              "arch": "nova-3"
            }
          },
          "diarize_info": {
            "model_uuid": "a9f85c2b-5afb-4b9d-b49b-492c43a01cfb",
            "arch": "v1"
          }
        },
        "results": {
          "channels": [
            {
              "alternatives": [
                {
                  "transcript": "Hi. I'd like to add Foo to my se
                    rvice. My name is Alice and my number is 1234
                    567890. No. Thank you. Goodbye.",
                  "confidence": 0.99609375,
                  "words": [
                    {
                      "word": "hi",
                      "start": 5.52,
                      "end": 6.16,
                      "confidence": 0.8781738,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "Hi."
                    },
                    {
                      "word": "i'd",
                      "start": 6.24,
                      "end": 6.56,
                      "confidence": 0.9951172,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "I'd"
                    },
                    {
                      "word": "like",
                      "start": 6.56,
                      "end": 6.72,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "like"
                    },
                    {
                      "word": "to",
                      "start": 6.72,
                      "end": 6.7999997,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "to"
                    },
                    {
                      "word": "add",
                      "start": 6.7999997,
                      "end": 7.12,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "add"
                    },
                    {
                      "word": "foo",
                      "start": 7.12,
                      "end": 7.52,
                      "confidence": 0.6496582,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "Foo"
                    },
                    {
                      "word": "to",
                      "start": 7.52,
                      "end": 7.8399997,
                      "confidence": 0.9902344,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "to"
                    },
                    {
                      "word": "my",
                      "start": 7.8399997,
                      "end": 8,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "my"
                    },
                    {
                      "word": "service",
                      "start": 8,
                      "end": 8.4,
                      "confidence": 0.99560547,
                      "speaker": 0,
                      "speaker_confidence": 0.93691725,
                      "punctuated_word": "service."
                    },
                    {
                      "word": "my",
                      "start": 13.695001,
                      "end": 13.935,
                      "confidence": 0.99609375,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "My"
                    },
                    {
                      "word": "name",
                      "start": 13.935,
                      "end": 14.175,
                      "confidence": 0.9980469,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "name"
                    },
                    {
                      "word": "is",
                      "start": 14.175,
                      "end": 14.255,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "is"
                    },
                    {
                      "word": "alice",
                      "start": 14.255,
                      "end": 14.815001,
                      "confidence": 0.9902344,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "Alice"
                    },
                    {
                      "word": "and",
                      "start": 14.815001,
                      "end": 15.215,
                      "confidence": 0.7080078,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "and"
                    },
                    {
                      "word": "my",
                      "start": 15.215,
                      "end": 15.455,
                      "confidence": 0.99609375,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "my"
                    },
                    {
                      "word": "number",
                      "start": 15.455,
                      "end": 15.695,
                      "confidence": 0.9970703,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "number"
                    },
                    {
                      "word": "is",
                      "start": 15.695,
                      "end": 16.335,
                      "confidence": 0.9970703,
                      "speaker": 0,
                      "speaker_confidence": 0.9877569,
                      "punctuated_word": "is"
                    },
                    {
                      "word": "1234567890",
                      "start": 16.335,
                      "end": 20.255001,
                      "confidence": 0.9845703,
                      "speaker": 0,
                      "speaker_confidence": 0.98775685,
                      "punctuated_word": "1234567890."
                    },
                    {
                      "word": "no",
                      "start": 27.820936,
                      "end": 28.380938,
                      "confidence": 0.8015137,
                      "speaker": 0,
                      "speaker_confidence": 0.89424765,
                      "punctuated_word": "No."
                    },
                    {
                      "word": "thank",
                      "start": 28.380938,
                      "end": 28.700937,
                      "confidence": 0.9941406,
                      "speaker": 0,
                      "speaker_confidence": 0.89424765,
                      "punctuated_word": "Thank"
                    },
                    {
                      "word": "you",
                      "start": 28.700937,
                      "end": 29.180937,
                      "confidence": 0.98657227,
                      "speaker": 0,
                      "speaker_confidence": 0.89424765,
                      "punctuated_word": "you."
                    },
                    {
                      "word": "goodbye",
                      "start": 29.180937,
                      "end": 29.500937,
                      "confidence": 0.85009766,
                      "speaker": 0,
                      "speaker_confidence": 0.89424765,
                      "punctuated_word": "Goodbye."
                    }
                  ],
                  "paragraphs": {
                    "transcript": "\nSpeaker 0: Hi. I'd like to a
                      dd Foo to my service. My name is Alice and
                      my number is 1234567890. No. Thank you.\n\n
                      Goodbye.",
                    "paragraphs": [
                      {
                        "sentences": [
                          {
                            "text": "Hi.",
                            "start": 5.52,
                            "end": 6.16
                          },
                          {
                            "text": "I'd like to add Foo to my se
                              rvice.",
                            "start": 6.24,
                            "end": 8.4
                          },
                          {
                            "text": "My name is Alice and my numb
                              er is 1234567890.",
                            "start": 13.695001,
                            "end": 20.255001
                          },
                          {
                            "text": "No.",
                            "start": 27.820936,
                            "end": 28.380938
                          },
                          {
                            "text": "Thank you.",
                            "start": 28.380938,
                            "end": 29.180937
                          }
                        ],
                        "speaker": 0,
                        "num_words": 21,
                        "start": 5.52,
                        "end": 29.180937
                      },
                      {
                        "sentences": [
                          {
                            "text": "Goodbye.",
                            "start": 29.180937,
                            "end": 29.500937
                          }
                        ],
                        "speaker": 0,
                        "num_words": 1,
                        "start": 29.180937,
                        "end": 29.500937
                      }
                    ]
                  }
                }
              ]
            },
            {
              "alternatives": [
                {
                  "transcript": "Hello. This is example.com. My n
                    ame is Bob. How can I help you? Okay. Can you
                     give me your name and phone number so I can
                    look up your account? Thank you. Okay. I've a
                    dded food to your service. Is there anything
                    else I can help you with? Goodbye. Have a nic
                    e day.",
                  "confidence": 1,
                  "words": [
                    {
                      "word": "hello",
                      "start": 1.12,
                      "end": 1.68,
                      "confidence": 0.9790039,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "Hello."
                    },
                    {
                      "word": "this",
                      "start": 1.68,
                      "end": 2.08,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "This"
                    },
                    {
                      "word": "is",
                      "start": 2.08,
                      "end": 2.24,
                      "confidence": 0.9951172,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "is"
                    },
                    {
                      "word": "example.com",
                      "start": 2.24,
                      "end": 3.28,
                      "confidence": 0.939209,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "example.com."
                    },
                    {
                      "word": "my",
                      "start": 3.28,
                      "end": 3.4399998,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "My"
                    },
                    {
                      "word": "name",
                      "start": 3.4399998,
                      "end": 3.6,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "name"
                    },
                    {
                      "word": "is",
                      "start": 3.6,
                      "end": 3.6799998,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "is"
                    },
                    {
                      "word": "bob",
                      "start": 3.6799998,
                      "end": 4.16,
                      "confidence": 0.99853516,
                      "speaker": 0,
                      "speaker_confidence": 0.5035404,
                      "punctuated_word": "Bob."
                    },
                    {
                      "word": "how",
                      "start": 4.16,
                      "end": 4.4,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.24978054,
                      "punctuated_word": "How"
                    },
                    {
                      "word": "can",
                      "start": 4.4,
                      "end": 4.56,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.24978054,
                      "punctuated_word": "can"
                    },
                    {
                      "word": "i",
                      "start": 4.56,
                      "end": 4.64,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.24978054,
                      "punctuated_word": "I"
                    },
                    {
                      "word": "help",
                      "start": 4.64,
                      "end": 4.88,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.24978054,
                      "punctuated_word": "help"
                    },
                    {
                      "word": "you",
                      "start": 4.88,
                      "end": 5.36,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.24978054,
                      "punctuated_word": "you?"
                    },
                    {
                      "word": "okay",
                      "start": 9.04,
                      "end": 9.759999,
                      "confidence": 0.99853516,
                      "speaker": 0,
                      "speaker_confidence": 0.42573488,
                      "punctuated_word": "Okay."
                    },
                    {
                      "word": "can",
                      "start": 10.08,
                      "end": 10.32,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.42573488,
                      "punctuated_word": "Can"
                    },
                    {
                      "word": "you",
                      "start": 10.32,
                      "end": 10.4,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.42573488,
                      "punctuated_word": "you"
                    },
                    {
                      "word": "give",
                      "start": 10.4,
                      "end": 10.559999,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.42573488,
                      "punctuated_word": "give"
                    },
                    {
                      "word": "me",
                      "start": 10.559999,
                      "end": 10.719999,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.42573488,
                      "punctuated_word": "me"
                    },
                    {
                      "word": "your",
                      "start": 10.719999,
                      "end": 10.88,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "your"
                    },
                    {
                      "word": "name",
                      "start": 10.88,
                      "end": 11.12,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "name"
                    },
                    {
                      "word": "and",
                      "start": 11.12,
                      "end": 11.28,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "and"
                    },
                    {
                      "word": "phone",
                      "start": 11.28,
                      "end": 11.5199995,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "phone"
                    },
                    {
                      "word": "number",
                      "start": 11.5199995,
                      "end": 11.679999,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "number"
                    },
                    {
                      "word": "so",
                      "start": 11.679999,
                      "end": 11.92,
                      "confidence": 0.9350586,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "so"
                    },
                    {
                      "word": "i",
                      "start": 11.92,
                      "end": 12.08,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.49732846,
                      "punctuated_word": "I"
                    },
                    {
                      "word": "can",
                      "start": 12.08,
                      "end": 12.16,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.2417295,
                      "punctuated_word": "can"
                    },
                    {
                      "word": "look",
                      "start": 12.16,
                      "end": 12.32,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.2417295,
                      "punctuated_word": "look"
                    },
                    {
                      "word": "up",
                      "start": 12.32,
                      "end": 12.48,
                      "confidence": 0.9921875,
                      "speaker": 0,
                      "speaker_confidence": 0.2417295,
                      "punctuated_word": "up"
                    },
                    {
                      "word": "your",
                      "start": 12.48,
                      "end": 12.639999,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.2417295,
                      "punctuated_word": "your"
                    },
                    {
                      "word": "account",
                      "start": 12.639999,
                      "end": 13.04,
                      "confidence": 0.9980469,
                      "speaker": 0,
                      "speaker_confidence": 0.2417295,
                      "punctuated_word": "account?"
                    },
                    {
                      "word": "thank",
                      "start": 20.635,
                      "end": 20.955,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "Thank"
                    },
                    {
                      "word": "you",
                      "start": 20.955,
                      "end": 21.435,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "you."
                    },
                    {
                      "word": "okay",
                      "start": 22.795,
                      "end": 23.515,
                      "confidence": 0.9995117,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "Okay."
                    },
                    {
                      "word": "i've",
                      "start": 23.994999,
                      "end": 24.395,
                      "confidence": 0.99853516,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "I've"
                    },
                    {
                      "word": "added",
                      "start": 24.395,
                      "end": 24.715,
                      "confidence": 0.99902344,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "added"
                    },
                    {
                      "word": "food",
                      "start": 24.715,
                      "end": 24.955,
                      "confidence": 0.9580078,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "food"
                    },
                    {
                      "word": "to",
                      "start": 24.955,
                      "end": 25.115,
                      "confidence": 0.96435547,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "to"
                    },
                    {
                      "word": "your",
                      "start": 25.115,
                      "end": 25.275,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "your"
                    },
                    {
                      "word": "service",
                      "start": 25.275,
                      "end": 25.595001,
                      "confidence": 0.99560547,
                      "speaker": 0,
                      "speaker_confidence": 0.492307,
                      "punctuated_word": "service."
                    },
                    {
                      "word": "is",
                      "start": 25.595001,
                      "end": 25.755001,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "Is"
                    },
                    {
                      "word": "there",
                      "start": 25.755001,
                      "end": 25.915,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "there"
                    },
                    {
                      "word": "anything",
                      "start": 25.915,
                      "end": 26.154999,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "anything"
                    },
                    {
                      "word": "else",
                      "start": 26.154999,
                      "end": 26.395,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "else"
                    },
                    {
                      "word": "i",
                      "start": 26.395,
                      "end": 26.635,
                      "confidence": 0.97314453,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "I"
                    },
                    {
                      "word": "can",
                      "start": 26.635,
                      "end": 26.795,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "can"
                    },
                    {
                      "word": "help",
                      "start": 26.795,
                      "end": 26.955,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "help"
                    },
                    {
                      "word": "you",
                      "start": 26.955,
                      "end": 27.035,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "you"
                    },
                    {
                      "word": "with",
                      "start": 27.035,
                      "end": 27.275,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.49394125,
                      "punctuated_word": "with?"
                    },
                    {
                      "word": "goodbye",
                      "start": 30.320875,
                      "end": 30.960875,
                      "confidence": 0.99121094,
                      "speaker": 0,
                      "speaker_confidence": 0.21964735,
                      "punctuated_word": "Goodbye."
                    },
                    {
                      "word": "have",
                      "start": 30.960875,
                      "end": 31.200874,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.21964735,
                      "punctuated_word": "Have"
                    },
                    {
                      "word": "a",
                      "start": 31.200874,
                      "end": 31.360876,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.21964735,
                      "punctuated_word": "a"
                    },
                    {
                      "word": "nice",
                      "start": 31.360876,
                      "end": 31.520876,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0.21964735,
                      "punctuated_word": "nice"
                    },
                    {
                      "word": "day",
                      "start": 31.520876,
                      "end": 31.760876,
                      "confidence": 1,
                      "speaker": 0,
                      "speaker_confidence": 0,
                      "punctuated_word": "day."
                    }
                  ],
                  "paragraphs": {
                    "transcript": "\nSpeaker 0: Hello. This is ex
                      ample.com. My name is Bob. How can I help y
                      ou? Okay.\n\nCan you give me your name and
                      phone number so I can look up your account?
                       Thank you. Okay. I've added food to your s
                      ervice. Is there anything else I can help y
                      ou with?\n\nGoodbye. Have a nice day.",
                    "paragraphs": [
                      {
                        "sentences": [
                          {
                            "text": "Hello.",
                            "start": 1.12,
                            "end": 1.68
                          },
                          {
                            "text": "This is example.com.",
                            "start": 1.68,
                            "end": 3.28
                          },
                          {
                            "text": "My name is Bob.",
                            "start": 3.28,
                            "end": 4.16
                          },
                          {
                            "text": "How can I help you?",
                            "start": 4.16,
                            "end": 5.36
                          },
                          {
                            "text": "Okay.",
                            "start": 9.04,
                            "end": 9.759999
                          }
                        ],
                        "speaker": 0,
                        "num_words": 14,
                        "start": 1.12,
                        "end": 9.759999
                      },
                      {
                        "sentences": [
                          {
                            "text": "Can you give me your name an
                              d phone number so I can look up you
                              r account?",
                            "start": 10.08,
                            "end": 13.04
                          },
                          {
                            "text": "Thank you.",
                            "start": 20.635,
                            "end": 21.435
                          },
                          {
                            "text": "Okay.",
                            "start": 22.795,
                            "end": 23.515
                          },
                          {
                            "text": "I've added food to your serv
                              ice.",
                            "start": 23.994999,
                            "end": 25.595001
                          },
                          {
                            "text": "Is there anything else I can
                               help you with?",
                            "start": 25.595001,
                            "end": 27.275
                          }
                        ],
                        "speaker": 0,
                        "num_words": 34,
                        "start": 10.08,
                        "end": 27.275
                      },
                      {
                        "sentences": [
                          {
                            "text": "Goodbye.",
                            "start": 30.320875,
                            "end": 30.960875
                          },
                          {
                            "text": "Have a nice day.",
                            "start": 30.960875,
                            "end": 31.760876
                          }
                        ],
                        "speaker": 0,
                        "num_words": 5,
                        "start": 30.320875,
                        "end": 31.760876
                      }
                    ]
                  }
                }
              ]
            }
          ],
          "paragraphs": {
            "transcript": "\nChannel 1: Speaker 0: Hello. This is
               example.com. My name is Bob. How can I help you?\n
              \nChannel 0: Hi. I'd like to add Foo to my service.
              \n\nChannel 1: Okay. Can you give me your name and
              phone number so I can look up your account?\n\nChan
              nel 0: My name is Alice and my number is 1234567890
              .\n\nChannel 1: Thank you. Okay. I've added food to
               your service. Is there anything else I can help yo
              u with?\n\nChannel 0: No. Thank you. Goodbye.\n\nCh
              annel 1: Goodbye. Have a nice day.",
            "paragraphs": [
              {
                "sentences": [
                  {
                    "text": "Hello.",
                    "start": 1.12,
                    "end": 1.68
                  },
                  {
                    "text": "This is example.com.",
                    "start": 1.68,
                    "end": 3.28
                  },
                  {
                    "text": "My name is Bob.",
                    "start": 3.28,
                    "end": 4.16
                  },
                  {
                    "text": "How can I help you?",
                    "start": 4.16,
                    "end": 5.36
                  }
                ],
                "speaker": 0,
                "channel": 1,
                "num_words": 13,
                "start": 1.12,
                "end": 5.36
              },
              {
                "sentences": [
                  {
                    "text": "Hi.",
                    "start": 5.52,
                    "end": 6.16
                  },
                  {
                    "text": "I'd like to add Foo to my service.",
                    "start": 6.24,
                    "end": 8.4
                  }
                ],
                "speaker": 0,
                "channel": 0,
                "num_words": 9,
                "start": 5.52,
                "end": 8.4
              },
              {
                "sentences": [
                  {
                    "text": "Okay.",
                    "start": 9.04,
                    "end": 9.759999
                  },
                  {
                    "text": "Can you give me your name and phone
                      number so I can look up your account?",
                    "start": 10.08,
                    "end": 13.04
                  }
                ],
                "speaker": 0,
                "channel": 1,
                "num_words": 17,
                "start": 9.04,
                "end": 13.04
              },
              {
                "sentences": [
                  {
                    "text": "My name is Alice and my number is 12
                      34567890.",
                    "start": 13.695001,
                    "end": 20.255001
                  }
                ],
                "speaker": 0,
                "channel": 0,
                "num_words": 9,
                "start": 13.695001,
                "end": 20.255001
              },
              {
                "sentences": [
                  {
                    "text": "Thank you.",
                    "start": 20.635,
                    "end": 21.435
                  },
                  {
                    "text": "Okay.",
                    "start": 22.795,
                    "end": 23.515
                  },
                  {
                    "text": "I've added food to your service.",
                    "start": 23.994999,
                    "end": 25.595001
                  },
                  {
                    "text": "Is there anything else I can help yo
                      u with?",
                    "start": 25.595001,
                    "end": 27.275
                  }
                ],
                "speaker": 0,
                "channel": 1,
                "num_words": 18,
                "start": 20.635,
                "end": 27.275
              },
              {
                "sentences": [
                  {
                    "text": "No.",
                    "start": 27.820936,
                    "end": 28.380938
                  },
                  {
                    "text": "Thank you.",
                    "start": 28.380938,
                    "end": 29.180937
                  },
                  {
                    "text": "Goodbye.",
                    "start": 29.180937,
                    "end": 29.500937
                  }
                ],
                "speaker": 0,
                "channel": 0,
                "num_words": 4,
                "start": 27.820936,
                "end": 29.500937
              },
              {
                "sentences": [
                  {
                    "text": "Goodbye.",
                    "start": 30.320875,
                    "end": 30.960875
                  },
                  {
                    "text": "Have a nice day.",
                    "start": 30.960875,
                    "end": 31.760876
                  }
                ],
                "speaker": 0,
                "channel": 1,
                "num_words": 5,
                "start": 30.320875,
                "end": 31.760876
              }
            ]
          }
        }
      },
      "encoding": "json",
      "vendor": "deepgram",
      "schema": "deepgram_prerecorded",
      "product": "transcription"
    }
  ],
  "attachments": [],
  "sessions": [
    {
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0
      ]
    }
  ],
  "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46"
}

B.6. Signed vCon

This example vCon is the signed form of the Two Party Call vCon With Externally Referenced Recording (Appendix B.4) example. The private key used to sign this can be found at:¶

https://raw.githubusercontent.com/vcon-dev/vcon/main/certs/fake_grp.key

The certificate chain is included in the x5c parameter of the header Object.¶

{
  "payload": "eyJ2Y29uIjoiMC41LjAiLCJjcmVhdGVkX2F0IjoiMjAyMi0wNi0
    yMVQxMzo1MzowMC0wNDowMCIsInBhcnRpZXMiOlt7InRlbCI6IisxMjM0NTY3
    ODkwMSIsIm5hbWUiOiJBbGljZSJ9LHsidGVsIjoiKzE5ODc2NTQzMjEwIiwib
    mFtZSI6IkJvYiJ9XSwiZGlhbG9nIjpbeyJ0eXBlIjoicmVjb3JkaW5nIiwic3
    RhcnQiOiIyMDIyLTA2LTIxVDE3OjUzOjI2LjAwMCswMDowMCIsImR1cmF0aW9
    uIjozMi45MzIzOTYsInBhcnRpZXMiOlswLDFdLCJ1cmwiOiJodHRwczovL2dp
    dGh1Yi5jb20vaWV0Zi13Zy12Y29uL2RyYWZ0LWlldGYtdmNvbi12Y29uLWNvc
    mUvcmF3L3JlZnMvaGVhZHMvbWFpbi9leGFtcGxlcy9hYl9jYWxsXzJjaC5vZ2
    ciLCJtZWRpYXR5cGUiOiJhdWRpby9vZ2ciLCJmaWxlbmFtZSI6ImFiX2NhbGx
    fMmNoLm9nZyIsImNvbnRlbnRfaGFzaCI6InNoYTUxMi1ZLVE5ZWNsVDZiNWhG
    eUlmTHRuRkFBWGdxRnpONV9DanIzSlEzRE1tY25wWEhrR01ndHZheHJMVzJSM
    k9oRlR6Ui1EaW55cm5nQkcydzlsVFpYcjFFUSJ9XSwiYW5hbHlzaXMiOltdLC
    JhdHRhY2htZW50cyI6W10sInNlc3Npb25zIjpbeyJzdGFydCI6IjIwMjItMDY
    tMjFUMTc6NTM6MjYuMDAwKzAwOjAwIiwiZHVyYXRpb24iOjMyLjkzMjM5Niwi
    cGFydGllcyI6WzAsMV0sImRpYWxvZyI6WzBdfV0sInV1aWQiOiIwMWExNmI4N
    i05NmU3LTgwYTgtYjlhMi0yNzllMGQxNmJjNDYifQ",
  "signatures": [
    {
      "header": {
        "x5c": [
          "MIID0TCCArkCAQEwDQYJKoZIhvcNAQELBQAwgasxCzAJBgNVBAYTAl
            VTMQswCQYDVQQIDAJNQTERMA8GA1UEBwwIRmFrZXRvd24xETAPBgN
            VBAoMCEZha2VWY29uMREwDwYDVQQLDAhEaXZpc2lvbjEYMBYGA1UE
            AwwPZGl2LmZha2V2Y29uLmlvMSEwHwYJKoZIhvcNAQkBFhJhZG1pb
            kBmYWtldmNvbi5vcmcxGTAXBgNVHREMEGRpdi5mYWtldmNvbi5vcm
            cwHhcNMjIwNjA0MDE0MzI1WhcNMzIwNjAxMDE0MzI1WjCBsDELMAk
            GA1UEBhMCVVMxCzAJBgNVBAgMAk1BMREwDwYDVQQHDAhGYWtldG93
            bjERMA8GA1UECgwIRmFrZVZjb24xDjAMBgNVBAsMBUdyb3VwMRwwG
            gYDVQQDDBNncnAuZGl2LmZha2V2Y29uLmlvMSEwHwYJKoZIhvcNAQ
            kBFhJhZG1pbkBmYWtldmNvbi5vcmcxHTAbBgNVHREMFGdycC5kaXY
            uZmFrZXZjb24ub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
            CgKCAQEAtMtTCxeIROb1FmWIexe7Op95qYIVNEqn+fDghxWqoYm6T
            75BGsl4rB9txFQeef3Q5SJIzeqffJDssXDsyREuwQ2iTcOrZaZxs8
            h1NX9NjVD6MMAwx7tw0Cgmu8rj6+/Kjs0KI8OzCuDXZGTGf/bH6EQ
            W85qYh9IF0Pvijf3uq+HCke6WApusx76LpUp36IzvYEuTbWBFeoLo
            +dyUdWmXpj0ghHiWZtT5zxJn9VrUhJX5KlaI0palWd0fOnr7mkdq7
            9sFsKjEOcr1lanceAicCpD3/zRW+7AS8atGKAMfe2CcXEABucI7Dt
            tLMXcDIJM6EOkyW7n4due1RXGuNgnjeQIDAQABMA0GCSqGSIb3DQE
            BCwUAA4IBAQAQLjhKomSx1OqThhcO+aK0rzX6RjKh0eM0X7O7pPC8
            1HxZKCDLhDvnUO9++17U6ba0bTnznKYKKG7HnDcB4dKBbH8XP2u3E
            nDskyoMrKpYRsRKwwJa8+RwOS7JEg+OtXYCRbWZvPjAC/z6o6OZK+
            QPTyK5Grw2Px2mTr6BAdBQv7XsYWBRwOZyvSGnKyK60jcPlYUnu6Q
            t0fYXiYp6qF5l956fuT0d2UyDkM7S/Z7K+OC9+aIBNKH32B3nfXqZ
            PuP8WuiTOxcMwnefPwjxaqndFUkyk2Y+i6nXU8oN/DGUOTfY4xbm3
            s3q7Dq5QPtq5kljB9yYkvcOULCSAmWBZl+G",
          "MIIEyTCCArECAQEwDQYJKoZIhvcNAQELBQAwgagxCzAJBgNVBAYTAl
            VTMQswCQYDVQQIDAJNQTERMA8GA1UEBwwIRmFrZXRvd24xFTATBgN
            VBAoMDEZha2VWY29uIEluYzESMBAGA1UECwwJQ29ycG9yYXRlMRQw
            EgYDVQQDDAtmYWtldmNvbi5pbzEhMB8GCSqGSIb3DQEJARYSYWRta
            W5AZmFrZXZjb24ub3JnMRUwEwYDVR0RDAxmYWtldmNvbi5vcmcwHh
            cNMjIwNTI5MjEzOTMxWhcNMzIwNTI2MjEzOTMxWjCBqzELMAkGA1U
            EBhMCVVMxCzAJBgNVBAgMAk1BMREwDwYDVQQHDAhGYWtldG93bjER
            MA8GA1UECgwIRmFrZVZjb24xETAPBgNVBAsMCERpdmlzaW9uMRgwF
            gYDVQQDDA9kaXYuZmFrZXZjb24uaW8xITAfBgkqhkiG9w0BCQEWEm
            FkbWluQGZha2V2Y29uLm9yZzEZMBcGA1UdEQwQZGl2LmZha2V2Y29
            uLm9yZzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAM81
            SKie1S78VAOBDc3LflYNSL9phecmjQs/9P+iqDXSVm3xpoqszGoLn
            7w21aUAxl++F9Z80Tc70URn2qqUcVTYcx3SmgHuYgspEmJsMRor/m
            n3HpHr2ajh+26RKgDGPBrtebeH1si8mX15a/ICzHxrUaE2Y/6DZ/2
            wGTXrAE4bYAOUaYft5GGSZl6yP6dXg3EJy2bK2cUTdMIZG/Y7Ny1D
            3N4V7MBirDd5FU7k6pMbyr3d/xoi8VL8F1mRCf6zxfFOjaMFT0atE
            iTp3M0rw6iS08hy0cDFsPJzIcPgXEitUgGPo/NLgeb8ZmL1kg9B2v
            MgaanbuZB6il79A4GgDIUCAwEAATANBgkqhkiG9w0BAQsFAAOCAgE
            AWOJJlvSQDsDROQZNdX3kMkAH3HYyAlE7LHNtIYHVhyt7I7WuqS6Z
            GvSoxSfkT0GdAN7cV+jchdZpAnpCXGX+yHuSvrw4oSqigdSLeSUMx
            2zaSv4wLAvydC/zDkHIRObyuDEKyy/pa4Na0aunPU3E1Bg0V+JqQ3
            RUJIy1v6AGLrliwaEIgP3Clzi/u640dWBHabOEjxFj9bX73+FRWhi
            t4EzOJYKvti1EXlmRjMbj3SmsrcbGMrpu4WipEG5S05VlMhXXSyQq
            9IScFho5CFtamDgI3jL49lyrx0+CcjDkw0nW9fXdAtB3BhSYEXdLu
            JAvLRQixUQFwH23doumPi1uW8euEhHTRo1pEFWQ5U59NOTUA5Ghuu
            po0aM2CnDD5Re8uO3ChilCUb0FlwgMD/7ABSd1LChU8iluhKy9CEB
            R2zc8uTqW43Gcv/psBaejgOKJlxZuusGVvuV1nTHRa4hmFYxxPel7
            ogeZzGQqFjBlb35CE+BcGYY0ViaHefy+fmi/fN6NrrN6pBOPjVZbp
            CFn+wFTUyrMU5Vq/FaPe0us7i3paQcwIz9wyide5OztpxebY8UnXm
            y22X+6PkHB0jnL35Qe8xl7Z0nMZNdy4xkzGgaa6talRDPhKkY1lId
            w+KdCXJuUc7rkLKa5po9SPdvVLhEPu26SHkI0I+d5hz+gMp8=",
          "MIIGMzCCBBugAwIBAgIUHk/6QbzjDZ9AONAFvwYJqB/jbvowDQYJKo
            ZIhvcNAQELBQAwgagxCzAJBgNVBAYTAlVTMQswCQYDVQQIDAJNQTE
            RMA8GA1UEBwwIRmFrZXRvd24xFTATBgNVBAoMDEZha2VWY29uIElu
            YzESMBAGA1UECwwJQ29ycG9yYXRlMRQwEgYDVQQDDAtmYWtldmNvb
            i5pbzEhMB8GCSqGSIb3DQEJARYSYWRtaW5AZmFrZXZjb24ub3JnMR
            UwEwYDVR0RDAxmYWtldmNvbi5vcmcwHhcNMjIwNTI5MjEzOTMxWhc
            NMzIwNTI2MjEzOTMxWjCBqDELMAkGA1UEBhMCVVMxCzAJBgNVBAgM
            Ak1BMREwDwYDVQQHDAhGYWtldG93bjEVMBMGA1UECgwMRmFrZVZjb
            24gSW5jMRIwEAYDVQQLDAlDb3Jwb3JhdGUxFDASBgNVBAMMC2Zha2
            V2Y29uLmlvMSEwHwYJKoZIhvcNAQkBFhJhZG1pbkBmYWtldmNvbi5
            vcmcxFTATBgNVHREMDGZha2V2Y29uLm9yZzCCAiIwDQYJKoZIhvcN
            AQEBBQADggIPADCCAgoCggIBAMIeaqkm8pn6mwUzWBgnQiY9Jr3Vy
            VamxBc9/duT8eCN9mmANGzX5zGj86KtGjlDcoAzANrtsr2Dpz4zra
            29HWbwbOa1ZTOOaR93QgifkS802zp+zHGGRaKlq3euDqDVzyXinhs
            vXOVlEwkOrAvV6kUcTIzcxVibrFfHttzv/hXUNxjCouAE7MIG6wO8
            y+E2bBkg7R5ydfeU4Q9npBefwtiQ8oWf0C46mDYFQ8l31goae17Vp
            iyS3t4h5HL+1yqdYJSWms5Qh0vp9req5AjwuHIDBxNLpO2gY1SQmS
            dO03oLcZwBglGKlpQSwYgr9J5uo2B+NV9aYKEO51bySinSF8T4D/o
            4cq6oyJLXBwmSsLbjjVIQBoSdRBmWh8zE2ZzFNaaBlYO9ikIaWXwb
            tkbsE+4QpOaOj/kUIHLFI9iOhOidsInaOfgYzw12FtGE1Wq5x5Xsz
            wWpPWU8NQw8gzTzFzVObxrfcsXrs0s6feuTCDMt5Zht2HCWFr9TmY
            DFAfOB05kFWTi5sE5KYaP54iJvjAFmuTDjlif7Z8ZWVal9XB+g3sM
            yQ8DVEj/0dXS+nRVuJQlUH4ql9SUIwK63RKdedALYC6X1j2lgK9aT
            uL+cyNJ5SbuNA95CxNgvWtBrcO6HxlbmIDxKrAAo5aj4hnlQcY4RR
            bNwppCAjK+zcASlpyvRAgMBAAGjUzBRMB0GA1UdDgQWBBSSDtfqU6
            +DEyYPCar08yVnnZSFzTAfBgNVHSMEGDAWgBSSDtfqU6+DEyYPCar
            08yVnnZSFzTAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBCwUA
            A4ICAQC8JDxTdmc86YFdKElWQnWxoPMsPeRyDYQoVTC2wydZsdJ5d
            GbkAhYlPPxK+zypP18fGry5PHAHl9mZYz+FdGjNTwllcfN9/G0Sdo
            y4kU9eN9KfC9OUIkBIq8D0r7ANT3l3XmGbnIxWJEtb0SyTcqk3dwW
            cNTqGguhQ03jUKW5yUpVoQjN4TtmHyweoYTNi+HKsCUvEXGdA9wdh
            4jVOqYeepmsax5eTUJsKuCKqQ3+xB7JONw85imfVotySCXsoMe7lu
            SRYuldn8SBIpKYUGJlpWIi6Gr0mLwHarrYoi9bwtcKAxRNXZiGQgh
            iUw2Zsw+jmgBrEtI4Iarg8wWqJ5Mov7MsTVpnoZ5Xywr0GznDlgcN
            tyqMibOULeM8yLPQrHn/tQjSiP3eUPz6+Zb9FqzQJCCi2UiauD4mO
            gzBSCCbew9PDYb2QeMZqNZmN3eVNMV4hh7t9jTc0zqPF5jluddVmp
            dHxLx/T9XZuSV21p8clNprJNQxprtHpxDxjhNMIrcV39rzi9tNikw
            mzRMf0r40f/JWnaV668sekDXtvIj8pZwyE4FNuaiJwojkQxDfjqk6
            7Qs5NUQsFcaIwMes8It74ASHm8DUKEhDT2ASgMtUDwKWrOBefrSPq
            jY7+EMh2yVZnQhMwpx4s7CH0za32Yq+KC8GotHdI6jisDEom7aHgl
            g=="
        ],
        "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46"
      },
      "signature": "HJA8mITP_gPp5FjIA2qw982rnUP44vDSeJRYGNXCxZhWm
        1c5dGRTlpbssDFBweCE_eOHpi8O2GhIulx9XBod3NgColJu2FDBC6mmk7
        5ke37A2AmSBuIl6AhQpEkfs6FRunG9OQ3I-r6dok9WHYI7JmgqcZY-2GH
        vzCIMW3LgaJZ1Vdt7TK3vqMR_Nn8Cpo3jkodtwMAuXivUtHWz4oldkScz
        uVqUMKtawLIU0GvPMfShR1C7ayuWgXkg7f1yiU9cKNtQM-biEyvIfGe_3
        tSPl6G09IToJRo-17Ji1qmm1eTaMwudG4hWvFmlvWnQCq-QRFi30gfBYV
        EYyrAJj7p_Bg",
      "protected": "eyJhbGciOiJSUzI1NiJ9"
    }
  ]
}

B.7. Encrypted vCon

This example vCon is the encrypted form of the Signed vCon (Appendix B.6) example. The private key to decrypt it can be found at:¶

https://raw.githubusercontent.com/vcon-dev/vcon/main/certs/fake_grp.key

{
  "protected": "eyJhbGciOiJSU0EtT0FFUCIsImVuYyI6IkEyNTZDQkMtSFM1M
    TIifQ",
  "iv": "2LXY42Qg-9NPezg9KrThkQ",
  "ciphertext": "tntDlZelgX_ECWMNDZ_gV14bCDhEPlBJS84xDDN_7P2jpyi0
    EzWZWIQyhomCGVI-doUnVEbWRi3dfkF3t_uOOZIZ4F5-2ebiE94E6_JgJKHj0
    ow92cO_l5jGcnt_U8nNWJU2m1gm0E_TyAkbGvoGWeBcvfunof5YbnQFVC0WZ9
    Jns-JnY3mEKF18Z_ZKUyDrd9Q-b_MDDfrgfnVbCToGAupX7t26cgTFcEBudRX
    xeDbe-YJ2BaIN5GEPXT2Jeu4Aamq82hIdog8woW_QPpWGr6R44TjKLxz7n0AB
    ny2mHy6vNbpyzG3_EpTqGWbfsDlM11ObJR2sViKVb18u1-bEGFbRQgL9NlLkt
    B3QsK-j8j9Lc4hNqlCLLYE5cfSqkATPQJWevOdNuvri1FUZSlwo165_Gqu812
    Fl94UcL0YHDStPZILL0b-G2CxAq-mcwoQXW6-ZlSj5aFIJAQuMl5KlEPSzIno
    kHr7Uuzr1sQofGIKfsw6nLCnP4N1Ijr6ulxNmKVn6TXa2koWYhUoTFx8iPMeV
    iXoIIAwkljQytXSVOOw8cGh3SrKEVSIsoKwFQpL0S5N_MWVBcZhhUmHF0BfOI
    M0pxevJYdA7T2rAiKgCDer-ofPe1l3bS21joWsHrRcxhNEHYddZL4FwgZV14X
    6Nf9IglGLjo-iihenziSoE9njdBGwoctcGNosH_PvEmP1snfUjAZ81cdC9khw
    JIevVR6YU8liub7QOrI6vgFhoYDJVIO-d8fCNAL5Bx7Yh_--pPP2uTd6USTY4
    KGJhncbmT0YOqmY2ccwvrU4C395Lj-ZncDjbs0GKF8FawIGiP7KYT_ndsje_5
    _HdMCgkatrudRiNw8NGwQyt1idwF8aY5jVkI_RTg5i5tBs_PV3CT3-2oHCaKz
    fSvMvuwKR1cWJava7sh6G4EFNWo8FAjAhsUVNLkXySh0o6TI96MEFJPsspXeA
    nf9rtZmQ1o2CCbYrXlmtr7eB4G2BhRzmxENFWA7EGBK6WG8KwxvQ3WRsXkmt4
    cybNAFVIe9Juhw3IpMLXhwSWQFWfqzU53bz856b6pC5IBMcdZ2AcwW3wjfEWA
    XvI56V4rTLtqF2rcHxoO2D_goTL2G6r4zuPHn2anJd7j-WlEBdpBTGYLwdlB3
    42xAu49G1J04i2pqnkp1MGL43C6-RqFhyg5V1iYDySTRJIR057zku7ch4Fn7U
    T_GOVnXxLZHjFZHNLwEvbicj8s6UaQWrsCoL3_KwB8hoZYM7SEXp37KApRI2b
    4BqnIs3OEDnXRmv3Mr5IDXqBTMq7i7WCW1vikF5YvwPljhDZO05wC7t647435
    FVz8-bssvSJRPz973HD2u7aJc8Cm_i0HXz3iIto7xx10c9QNXtHs_QPeQ8omQ
    C8PpGDW09F6vgJY6VV6LkunFtRxmEpnA72F0oK4n7QxwRBe8I5a_wUot0RyQD
    z5j6PpdWe-vv9dfzm7uskZbTQCugM_NOqq3AqLndtDcUYUVUIAN9bienC--dM
    DuevNHyeMCUuF01X_EoLglcD6UMKyrZsPOIU9OpOyd1t_xNIRObQKk6Crahzl
    Md-Wa5bBJ6PT4eZtIT-3S8r9ucF6ZM2IeSZBPRxxLiGnTygKtVVfI5nwDSloR
    l1PFzR4A9YHY4mQcWB796eyP9l62cMtdRKveM5sh4CzPNdoIjgI-V-_YdV27L
    UJW3UMO5VXXEBF0mHmCvHZ_dJvxvTrXtqyG7uFICvfm6Pq_fjJ5pJUQwicLgJ
    JhJrPZldyvMIinh_nJgbDTeg_QM0xsxoavVGggaqktlQDOOJTLwODugi_9T87
    pUNUGR2LKW8XQVbXZIk_3G--AA6fvFh5rNZk5h5R589SDTodDI6URlt0KSKKX
    xI7KO2NIXRIHzSOsTdENv2p4O4D8faWREYs8P8QYSvnKcHMpYTr3jVYOIEDuP
    Ypi3p25dmc7mUfDR_GzybN1APK9WbjLQ67u46ie8jUEBpSqMBNw5JW_UJn-ju
    29mw8NCfJIl1I-BIb4x-CvYGKK1oNqVsymXy68mNcqSajHUnI3-fD_WbMYlmY
    mG35RxA8Z_IiueuOiM_MY6NkpSVClp6_e0ho7UbgcOfb4X4pngNHhDR6MyqP7
    j5Li6anHVGODh3n6-EKxr4jDsGdZzw740uGoKQeqI0PcuOMO4nUQUXyUWwAQU
    RtJ4_zfz2DIYET4Hi8VuQCp6NH6Gzt-mjYwKxKuRvjYUOCnJQWqeb66J5acuY
    zfUjCil4sLgQoalAFwN0x8jgB0QOQsFEE1YW-KHdkBNN7TKntz9jY-awL6-ue
    UBMs6w2LmuRzx1Mxb-Sxi8dZMhHC2F6FgEeHU1No2CGGTg3ab1tjCQaTBGuFg
    -YVlsWee_GLDPivX8YXD5fFu59mtS7e_ybpn2nq0OKgktzFuV2f9P8Mr62z9M
    yDYEXm9222-146-Z_z9CI3SzfL5oh_pF4UCKigHCrtEhiogrCe_1GcDYstUdN
    gY3ynQ6NGovi3KfkepQH9EkOkTS4sumUayT5X2Umy3jIPsKeyDL3vNzvaMJ6h
    dJRLTbEs8n2l8KHslXm22pFRqRTx-04vw49KANvikMStuCT3Mb8GodSs7f9xr
    nST0wjlVs1w3EHxcN3y5WJzj5LgeliPxQcDTbnnGY8AM-KET3qQ2jBv4uMwCk
    fh6TZxhTeIqizj7ER04qFfCITmZoYykSOpcZpO47O9hehRfgtqJDgi_nPZGUe
    C2xNiDT5QMJP6JOUaYW6W5-0Zl-KbtMKRc_Dtl_lKL2gflUPq63ABPYZO0EEi
    pzyq3boaULteaX65tv9v6fnE-o8exnRmlUbwbZCRl3b4OvAe90krnKttS8GC1
    mUBn_PFQdbZeI0iFWcNIUnfpq7QLMNnx_j0V33wHlA8qYeAP9uEUuswtdot7m
    bKumZ_2T23_QuKFO-VbBxUQ8Uu1hiyPwEzDPVg8ZjLlFKYiYSST5pEIA202Kn
    rLbRZzWV5d43o-5nBJP9PIVh6bz7nbYYhTMffSZRdZsj2kehIhE3M2rvVBVDk
    OVXESX0g1rEmT4teL7sNKjfO4i9h3AM-uwQm5TJW5-0UMYn_t5kdDOy02PSeX
    06vgKOIeUanwtdmLfFFM77JSielGHrrCGrjWPHEqO8s5yQMZxxEtr7exk2Zxq
    BCfCdgpJf-uNsLScYhHmixXOtc9XdWXXC9Uy6nVIBIbetrHmySUWYM4Vomxcn
    ywu6pCIfQqadB3LKNHnreN4WcMf9qoh1GRzQci_H7B8mpQj7QG8kgHNSLzqZd
    qQjlVZUxwTAPikhRoGoFlDDBZQPdjt7iNHJtm1JCVtKBK6ix3M8vn86KJ0koR
    M2uysbBKIIwYRL7Y1tyB10zEuT4qVi6p50w1h7qEmRC7rdnGc523n5aQN07wm
    JyhhgilJ6B4XkXf-dwEHGjczgztS1FWS6uD8C7TCWKQn9EUOz2ZvD4NyEolWO
    HtzmjWi2Wxozaf-ucZ7dyc_cPNT_UF761lhsgtbmoodAZqZoGSrtMX6EpKTgn
    DEDlMThw2xnuGFZXwFoCJqGytwOyFCyYNyC4AibyPz86n6Hdg_wli-_Bt5ipq
    oARee0inWXiun4gjXc8vUmFKzvQiM4b_6MoloJ4XX984Nc3i-N9NPzwZ2WSZw
    x0RTYH6hb9a7fG_NYw_08-P56BRQXv9X325RLIjwSbjSIogHANafLLUtm8rjj
    cGlBwNwlRy-HMj1bcR_axhfTXLVXwMKLKovPHTP1YRoGFVHKHoypaZrP0gd_p
    d8WLzHzmhG5rsB0utWP4PK6JSIlMd9Ua_32Ujf1dSg_FD6qFPKF-TDqgd9hTE
    k7oP2KP90piE1bHobxE3-HwXUlyBcnYJOKEwTlUpnCW_QkV4qiKwmJEt8tsMB
    effisR4tTablF0ReE-EsDEm7OVRYig6IGKYsPmqHyytSyjSTLnWNkflMfDARa
    -vykTWUXI4mVJCSWn4dRstPYLOL87YOol6VKA_R6PjSBguPb_xbYDadKOfpWO
    Rm2FshHaYkC8MJyaAAn679Ae-CDQosQKEjmk1N63te2kx628mvFhpxUVv9orB
    Zw65ldjL5UGHvIuamQVAFSL0lcUABLxq-mNAwwuIGNEW31keGZm9J41SvmO_P
    uoa3aJsipiq2xPrDFiODEjUceWyFzMnynByVO6cid8cksYIpG0DkePfJVfJ2A
    VsW1f34XbICw5YDCo8kNYynMS354E7fLSAq1dxQjbE1UgNF3pyq15zUcuJhMf
    ldtOZVOO5lL8be1bRiPwF7UrCmcD-_92DE10VJ3lfkvHRSSwMz0-a0jcMjALr
    hV_qYTJqtNiFDhiWCaklJSJ78LbHnm6khf0stb3HbvpwqL4tkfjWl_p2Sba7I
    6WJqAbHtPnd0OZE_eD4R8tHWe_tgU4CVM_mbFhnSJkiAMEgGRSH7zRFymwCUL
    zoO5w-cAi6HJoL4atY_KmsVAnt2tAeuzlQ7ONOrHvhGa3oGFK01wERTHbdqI_
    XVun7c8cWA1m-fyKke7lgp_BTj9Qu93KmyFUYai_doFxnxXqvihuC7nT2mm1t
    D4IK0pRB1fkM4xjwMJps-eWupL_-xCP_5HTlHd2fPtNpTlMaRqyN7DjG1pdCs
    MASWIxo22RKZRcW5WjB7D7c7hnEFPb1JxPZuUjn1yFBUKtKXzl85nXm0_wnW3
    bp2NwO05wJDAzLJG1OIy0w2tOkWhySBv0s8hIDaixQpdcQOEPGw5gcHwCFOP4
    0hsPnjtvaIUC80uhS1lhm38oAT90qs2s6JtqEVHE0PF2hoMWbKLMGUXRUdL4d
    4w_HxD0pY2IywQhFy1SpGNAs5uvhxIySFcRv4DUQU02aF3G8bwHEcWBcrOzbw
    mUE0ugaqllknpiN_lu-Dk94FudPJUAL4Ckzd0xi0IOv8Y5bWfiggPBt4K20CF
    kMpCMROTSnTcX_rsHxUp1pMrbp2QsbOfealVIq-jzaLXs7Q8Fr8TlTkIQj7Is
    WzS4cVt9o6id9CvfaD_ykERw1cc2zkAf3RwGYdS--9TiQL8xsw2nhqCqEEkN8
    G2ZWsbu-jt8LcQ3BZFUHjfgZeO5o5oYhPLV5-j8--XQeXoY6BY___eX8Ur0iB
    G3Q4Ev9GhwNtDqrJCFvcq8YXNrN0cJRM9PlJgHQAWreZBKegq9uVR4ZTIufqX
    gheiVGS4VmYBCgUam4McC20qOVAltqdc154BzwoJgiWHgqu2MJ24yt1_1r_ay
    LI8aX6UIqBcGAFZKDkjLnzlvlWDhD7ZL5hd_3hu24mF5QM6XG8fZupwSS0kY7
    XYeqAuOOoRvV52k3ajYtxtghWXhxwKwZ8Luf03B-N5Jopd7wMZC3zhMXYUBv2
    yjn3adGIvRqFtm-GY7W0PecYDwbx0XILJDoakGXbIyXeqSmN_gVVNPQ9AsGZT
    UnLVwiJkwIdtgTXPyKwuJTrAHAo3in24iATKLbACFvOqOhQ4ac3sne1fy1b1O
    EwZMTX-SchuPsNucrM-VZJkHtdcrpACJ-d1B7hWKvCONcYtwnkoNMdEjihKMs
    2XjmjbM8u7qMco1j0B8FTOX0T497WWPPwQpjXeueR0AKJIaOl6C-w9O0vihCY
    fHB-ep8FDWnnMv9O10q6oG9fcX3iNPcGHskPEW9AdnIAYsgRCs3Bs9Ju9c-aO
    RRVNzvngs8Q0oB-ZI-p1DWUcw8lzfFUfMoiG1JlrQrTtmAABz51_ZKc9B46wC
    pxQRNlBYYDjAzZbZyn2Z7c0tKs3UHa3865-VxEVqRgDkOljRmOgt2bCTwCKQb
    f73Yszq1RQfyhoTf9NiU3k90FdZUYzm8UYzTnQBJSP7TLz4hbAREGGTfR1QF9
    Z1l5X9iPNEArh9RnW2NP8aiyES8Wt9MVaVO5I9CQDntef2cluOPNM2SRc8KgW
    g3ORIKP7X_R1tFBTyawaetdkt2B5MQq8S9CG1t43eLMP2Y1RXkqYFUHb10dbE
    -rB2UGqHRxIDscCXUBuz-zG01fyIOtaBTrQJSnodaPl-A3pCC0hx-KJ6FT5mC
    vkqf71j29IDNTtb07XKFUboZ29N5QnQIkqxlMUDJbxRPuqyyhDH2oCNr8dvzB
    p5Gf3ykljPZzjyzOeEkQwLoe0dAqcNnVj_EXLt-pOl9EbhqxPwNL4OEqt-qGD
    r5AKoDLWcDYEcjkY-10wHouY6f9DO7BtNceO8ZZg9VvEuC4Bf4341tpF_sMY8
    vi0EUMd86F8HE8Vwjxql__WDB_T3rTGm6lr_7Cibtk_upaxN6nQgwfHMgT1CV
    gBfbh4NlYZ9lc4HQAKXL80F0-xafW4d05pXoHCnuANktWmJQ_8HgrPuWqv_C8
    Qt3pfzaFeEgsErLb9yndbpu4HEty33fs9Q0ZVgINjvA4pniw9vP6md3PV2lDK
    h1w-Cu71c63gHIW9UnLW2xWll1Zgv2vNTOzsmI8g4wZWV33P0wUsHkDh6NjHR
    SUT1olkIrevpNJ56sHKHijPSUy9meRXkiFIN0B0Q9by-zCAayiNS7lB1tw7rU
    RFKAJV7HRnE6FdaIWcI_8XwVtNh6VS460qGWKJ-g_Mhktw3CCFZ8HZkBzhRNc
    x1rVTykoMMaYbe3TLTl5kql4y5PRXfIiTFytjCIRLLt9dtgeUfMfMxYRLoPbK
    YmDso385cmFeHIfvlxeyoF_NASXmf0tOhCqbRT45WI1BUmqH3EHhYAzlAspY7
    D7Ur5l8_VrbWSlVaq1x095SajyEoNNL7qjADeppjlBsNPNqlpUwU8_VXJDrah
    l4dE40zptNer-ST2PLRPqrBlRB59ehYFBUxzI_Ap8_Is7HtfjGcvYcGHQ1kmM
    CJJDtRgG4FSV2pA10bzBsfWTlJGTbAgqf0kQEyxuD516GY3ydPZZ9-E3Q_rgw
    kYQci_0zlwTrErI-lBQkvyp27O3_9hjhO_dKYxqeBjiFZGOo3BhJz4D0d-68H
    _BNQIakLvyoL_FQWCSeBnQee-HRsPRd-qrFGpLwSrTCumeEhm8b9m82MvbABm
    NS0YmyAIaykiwyiUTnrwoxsCszArX4AtwurMHSImKVyv8JX_wdb4Arp16QTjN
    bBGmxt_SAEVnBUWi0gtKQ_-iylcjkVAnDY1SOqRa5FNVHfF49SeDgYzW-78C9
    Y74RJLWZRApSfMKeG0tN8mKcVk3qZruX3cbw1WuUnmZXl-OQEoNbyJxt2e9T8
    Kqw66Ds8XYzJxtpzKQMDQyeEYMM8-QSOq27FkGn3C3zkwJPvU8ajEC7UcFbAy
    8VFHFV7t2Crr8zgnOpMtvN5T80nkANiQ9x6ZFwQfd7EHOXGMC8S-f9SqId4Mh
    6fT_Og19bmFeDgvJjULNvkDMuQ2IjMFb-c2qiRIUnluah1jzYq_WdrR1M9aVL
    EzvkqNFlHLZ9ZmIxmjFoGQnC9hMclrHqhhox5Ydip0SJsP7a-slbf2M5ti3Nm
    vCuw3F9ZzgRc6UNKla3V8J5QQ1gNfXh3nS8JbqV226LFKKnI9JwPIbuK3fsS-
    u0kkqTf483_s6U151yydWWp0XXF7l0kWnJC6pyuf-STLBDt66Emg6zIsgc55o
    FHl-3KCqtRRK6oVkZHiWW5E7l8DeTgDrN5si_2i1Q-QaBr3cCbfvi405aXvAV
    Z6FYN4rbFcc1VluMOfVaiFzww56D_c7WFZ-JXS3CClHK9gL_tOrvsVScQACre
    j0oycGjfJ9U2TDX0fxtOblC2nsOKk88LuxqTN5LfjMf7FdqKCCWHykIaIf954
    J03poSH_dc4nQuWwPEaIa29INMGK2zvPT_2lU-HOPqwPWGZffgym44yyvbWG8
    Rixp-lat5LI9byCT12M6zZapCydqUlnxUs8GcLfg_w1_HvErv_MV0BxiF9W9i
    Ii7t4U8B2uvxSqpQtageMybDlz69CobbXLWhgakXnY1iRpE9906vM4BfqaUzq
    7Wnj6q9iH3L6e4IunE2vXPK7jgW605ws66dYf7Pyo4ayn60R6mQMdbTL-3_UC
    pmLyCHFLv8LhT-Vn6yVY7H_bUN4d_d0HB5ohOiUHzT_BGqWx85o8oHEkMDp2W
    N05qof81g9kMzE3nqGfwgRE5l1PBmlxwLLgosqGY02q5f4ls6-4GFBZruIcj2
    YYXgNsKwVMnQ0V9E6_VlSfFDvv6y46EOIJsu4DBwQHNrCmZArSXDZ_XXruxwM
    -w6ZwszOW1gThfSf_FHs1XXS6rliC_MXu_hZsqsSv7mwh6uHMhRUAVKfxGFj1
    a1FJlM8Ppyn_qAj3zaVaISYVTxHdK0dSQ6vZ-XGm46S7wIXaeTEse4E_cWZhH
    _tMlhUbQHA2y-aZZnQamgNiGhD_r8_-7wWtLr0Y1xspp4UQq5AdvseQA9rsCO
    WHT19nuFKTTTtfLjjgI68_yeRmKwMk2cXFbyg_ilOnGWuPEJPeFuXLAxRMgMY
    teSdIj_nI8SvJ6t0f0xlfWTPbhXezZcpWrj2ZdE8agQGGOw5I_Vf1TYj1eJ_l
    ZEz5X03Z7XdOqJawddYCTfcefMeOUIgnSXV4h7Cz-FLLKBAeWiOllU2i88kFL
    f4wm07LiTeh6v8NGL3xhxsMja4piZASkexICYHHgZvNqeqY18j-o4IFnNPgJq
    MvTMisflnUinWYIdgHu-CNZE6ZO-c3iEcOR-UVDgv9dt2w4vmk_7h-JvJtlQ-
    Mk9wgRr3Ef0mnrYVxZzxgt6uIuqJlRjP_FFyjzzWgaL9QlQg8-sHoAUQ8JDRO
    555sdMFQCpHiTrhQ",
  "tag": "hyXd3meC4V_SRrDsobgH4f8skmb0R1XQUD1dNz268FI",
  "recipients": [
    {
      "encrypted_key": "Sm_D7ScQI9hhTknxXnSeg5ph2WugCTVUxmxJX-jmr
        GuxFdnLsJO2ww7hczEVsfdCPXXu2WjS2_nGBKr5T8YqfJnGqgvnoeddWC
        nlhnFDARrQCaj-Ra0rLADoCukdwubwsVnCuVaS1uuLRh0BGLq7GOSug5A
        NoXDyylfscaGO_2m2Jp1R8fk0G08SZ78SGRexkOhnpDAPFX1kOpVMWzS1
        ZYmYVTkZxjtv3Sm7YABnhvDhxdxHZFR_n83EYVSjIfenJOPnJ7M_hyWh2
        eStg2n-V6dpqc_PC9cHB-bGYey_Lnx4kDOiGeqjvg5yo_qYK0PYn-pr59
        Su0q0qZkp_3g80vQ"
    }
  ],
  "unprotected": {
    "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46",
    "cty": "application/vcon"
  }
}

B.8. Redacted vCon

This is an example redaction of the vCon in the example Two Party Call vCon With Externally Referenced Recording (Appendix B.4). Most notable is the Redacted_from object (Section 4.1.8) which references the lesser redacted version of this vCon. In addition the url parameter has been redacted from the Dialog Object (Section 4.5), but the rest of the Dialog Object (Section 4.5) was left in the redaction.¶

TODO: need a better conversation/recording to demonstrate redaction¶

{
  "vcon": "0.5.0",
  "created_at": "2022-06-21T13:53:00-04:00",
  "parties": [
    {
      "name": "Alice"
    },
    {
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "recording",
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "mediatype": "audio/ogg",
      "filename": "ab_call_2ch.ogg",
      "content_hash": "sha512-Y-Q9eclT6b5hFyIfLtnFAAXgqFzN5_Cjr3J
        Q3DMmcnpXHkGMgtvaxrLW2R2OhFTzR-DinyrngBG2w9lTZXr1EQ"
    }
  ],
  "analysis": [
    {
      "type": "transcript-redacted",
      "dialog": 0,
      "body": [
        {
          "parties": 0,
          "start": "2022-06-21T17:53:31.520000+00:00",
          "duration": 0.6400000000000006,
          "text": "Hi."
        },
        {
          "parties": 0,
          "start": "2022-06-21T17:53:32.240000+00:00",
          "duration": 2.16,
          "text": "I'd like to add Foo to my service."
        },
        {
          "parties": 0,
          "start": "2022-06-21T17:53:39.695001+00:00",
          "duration": 6.5600000000000005,
          "text": "My name is Alice and my number is {{BAN}}."
        },
        {
          "parties": 0,
          "start": "2022-06-21T17:53:53.820936+00:00",
          "duration": 0.5600020000000008,
          "text": "No."
        },
        {
          "parties": 0,
          "start": "2022-06-21T17:53:54.380938+00:00",
          "duration": 0.7999989999999997,
          "text": "Thank you."
        },
        {
          "parties": 0,
          "start": "2022-06-21T17:53:55.180937+00:00",
          "duration": 0.3200000000000003,
          "text": "Goodbye."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:27.120000+00:00",
          "duration": 0.5599999999999998,
          "text": "Hello."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:27.680000+00:00",
          "duration": 1.5999999999999999,
          "text": "This is {{URL}}."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:29.280000+00:00",
          "duration": 0.8800000000000003,
          "text": "My name is Bob."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:30.160000+00:00",
          "duration": 1.2000000000000002,
          "text": "How can I help you?"
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:35.040000+00:00",
          "duration": 0.7199990000000014,
          "text": "{{US_STATE}}."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:36.080000+00:00",
          "duration": 2.959999999999999,
          "text": "Can you give me your name and phone number so
            I can look up your account?"
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:46.635000+00:00",
          "duration": 0.7999999999999972,
          "text": "Thank you."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:48.795000+00:00",
          "duration": 0.7199999999999989,
          "text": "{{US_STATE}}."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:49.994999+00:00",
          "duration": 1.600002,
          "text": "I've added food to your service."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:51.595001+00:00",
          "duration": 1.6799989999999987,
          "text": "Is there anything else I can help you with?"
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:56.320875+00:00",
          "duration": 0.6400000000000006,
          "text": "Goodbye."
        },
        {
          "parties": 1,
          "start": "2022-06-21T17:53:56.960875+00:00",
          "duration": 0.8000009999999982,
          "text": "Have a nice day."
        }
      ],
      "encoding": "json",
      "vendor": "CapitalOne",
      "schema": "data_labeler_schema",
      "product": "dataprofiler"
    }
  ],
  "attachments": [],
  "sessions": [
    {
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0
      ]
    }
  ],
  "uuid": "01928e10-193e-8231-b9a2-279e0d16bc46",
  "redacted_from": {
    "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46",
    "type": "PII Redaction"
  }
}

B.9. Amended Signed vCon

This is an example vCon with an Amended_from Object (Section 4.1.9.1) referencing the vCon that it amends or adds additional content. In this case it is referencing the signed vCon example above. An example text Dialog Object (index 1) is the amendment.¶

{
  "vcon": "0.5.0",
  "created_at": "2022-06-21T13:53:00-04:00",
  "parties": [
    {
      "tel": "+12345678901",
      "name": "Alice"
    },
    {
      "tel": "+19876543210",
      "name": "Bob"
    }
  ],
  "dialog": [
    {
      "type": "recording",
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "url": "https://github.com/ietf-wg-vcon/draft-ietf-vcon-vco
        n-core/raw/refs/heads/main/examples/ab_call_2ch.ogg",
      "mediatype": "audio/ogg",
      "filename": "ab_call_2ch.ogg",
      "content_hash": "sha512-Y-Q9eclT6b5hFyIfLtnFAAXgqFzN5_Cjr3J
        Q3DMmcnpXHkGMgtvaxrLW2R2OhFTzR-DinyrngBG2w9lTZXr1EQ"
    },
    {
      "type": "text",
      "start": "2022-06-21T17:53:26.000+00:00",
      "parties": [
        1
      ],
      "mediatype": "text/plain",
      "body": "Good day!",
      "encoding": "none"
    }
  ],
  "analysis": [],
  "attachments": [],
  "sessions": [
    {
      "start": "2022-06-21T17:53:26.000+00:00",
      "duration": 32.932396,
      "parties": [
        0,
        1
      ],
      "dialog": [
        0,
        1
      ]
    }
  ],
  "uuid": "01a16b86-9ea3-8a32-a20f-d188127fad29",
  "amended_from": {
    "uuid": "01a16b86-96e7-80a8-b9a2-279e0d16bc46"
  }
}

Appendix C. vCon JSON Schema

This JSON schema is provided as informational. The text in sections 1-6 of this document define the normative definition of the vCon schema. If the JSON schema provided below differs from that in the text of the above sections, the text should be taken as the definitive definition and the JSON Schema below should be consider incorrect. The JSON Schema is permissive: parameters and type values which are not defined in this document do not cause validation to fail.¶

The JSON Schema definition below has been formatted with line breaks to print nicely on the page. The unformatted version of the JSON schema can be downloaded from: https://raw.githubusercontent.com/ietf-wg-vcon/draft-ietf-vcon-vcon-core/refs/heads/main/vcon_json_schema.json¶

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://ietf.org/vcon/schemas/unsigned-vcon.json",
  "title": "vCon - Unsigned Form",
  "description": "JSON schema for the unsigned form of vCon (Conv
    ersational Data Container) as defined in RFCXXXX",
  "type": "object",
  "required": [
    "uuid",
    "created_at"
  ],
  "properties": {
    "vcon": {
      "type": "string",
      "description": "DEPRECATED: Syntactic version of the JSON f
        ormat. This was used to indicate schema changes in the In
        ternet-Draft versions",
      "const": "0.5.0"
    },
    "uuid": {
      "type": "string",
      "description": "Globally unique identifier for the vCon. SH
        OULD be a version 8 UUID",
      "format": "uuid"
    },
    "extensions": {
      "type": "array",
      "description": "List of names of all vCon extensions used b
        y this vCon",
      "items": {
        "type": "string"
      }
    },
    "critical": {
      "type": "array",
      "description": "List of extension names that a consumer MUS
        T support to safely process this vCon",
      "items": {
        "type": "string"
      }
    },
    "created_at": {
      "type": "string",
      "description": "Creation time of this vCon in RFC3339 forma
        t",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "description": "Last modified time of this vCon in RFC3339
        format",
      "format": "date-time"
    },
    "subject": {
      "type": "string",
      "description": "Subject or topic of the conversation"
    },
    "redacted_from": {
      "type": "object",
      "description": "Reference to the unredacted or less redacte
        d vCon prior instance (Redacted_from Object); mutually ex
        clusive with amended_from",
      "required": [
        "type"
      ],
      "properties": {
        "uuid": {
          "type": "string",
          "description": "UUID of the unredacted or less redacted
             vCon prior instance",
          "format": "uuid"
        },
        "type": {
          "type": "string",
          "description": "Type of redaction performed; same set o
            f values as the type parameter of the Redacted_string
             Object"
        },
        "url": {
          "type": "string",
          "description": "HTTPS URL where the referenced vCon is
            stored",
          "format": "uri"
        },
        "content_hash": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Hash(es) of the external content using
            format: algorithm-base64url_encoded_hash"
        }
      },
      "dependencies": {
        "url": [
          "content_hash"
        ]
      }
    },
    "amended_from": {
      "type": "object",
      "description": "Reference to the prior vCon instance versio
        n that this vCon amends (Amended_from Object); mutually e
        xclusive with redacted_from",
      "properties": {
        "uuid": {
          "type": "string",
          "description": "UUID of the prior vCon instance version
            ",
          "format": "uuid"
        },
        "url": {
          "type": "string",
          "description": "HTTPS URL where the referenced vCon is
            stored",
          "format": "uri"
        },
        "content_hash": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Hash(es) of the external content (requi
            red if url is provided)"
        }
      },
      "dependencies": {
        "url": [
          "content_hash"
        ]
      },
      "if": {
        "not": {
          "required": [
            "url"
          ]
        }
      },
      "then": {
        "required": [
          "uuid"
        ],
        "$comment": "uuid is optional only if an external referen
          ce is provided"
      }
    },
    "redacted_strings": {
      "type": "array",
      "description": "Array of Redacted_string Objects, one for e
        ach unique substring replaced by __REDACTED_REF_# in the
        vCon",
      "items": {
        "$ref": "#/definitions/RedactedString"
      }
    },
    "sessions": {
      "type": "array",
      "description": "Array of Session Objects, each grouping the
         Dialog and Event Objects of one session of the conversat
        ion",
      "items": {
        "$ref": "#/definitions/Session"
      }
    },
    "parties": {
      "type": "array",
      "description": "Array of Party Objects representing all par
        ties involved in the conversation",
      "items": {
        "$ref": "#/definitions/Party"
      }
    },
    "events": {
      "type": "array",
      "description": "Array of Event Objects; order is not signif
        icant, Event Objects are sequenced by their time paramete
        r",
      "items": {
        "$ref": "#/definitions/Event"
      }
    },
    "dialog": {
      "type": "array",
      "description": "Array of Dialog Objects containing the capt
        ured conversation content",
      "items": {
        "$ref": "#/definitions/Dialog"
      }
    },
    "analysis": {
      "type": "array",
      "description": "Array of Analysis Objects containing analys
        is performed on the conversational data",
      "items": {
        "$ref": "#/definitions/Analysis"
      }
    },
    "attachments": {
      "type": "array",
      "description": "Array of Attachment Objects for ancillary d
        ocuments related to the conversation",
      "items": {
        "$ref": "#/definitions/Attachment"
      }
    }
  },
  "definitions": {
    "Session": {
      "type": "object",
      "description": "Represents one session of the conversation
        and references the Dialog Objects which are part of it; a
         Session Object with no parameters is permitted",
      "properties": {
        "start": {
          "type": "string",
          "format": "date-time",
          "description": "Start time of the session in RFC3339 fo
            rmat; SHOULD be present"
        },
        "duration": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "number",
              "minimum": 0
            }
          ],
          "description": "Duration of the session in seconds"
        },
        "parties": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0
          },
          "description": "Indices of the parties that are the rec
            eivers of the dialog in the session; SHOULD be presen
            t; the first party is the implied originator"
        },
        "originator": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the originating party; only pr
            ovided if the first party in parties is not the origi
            nator"
        },
        "session_id": {
          "$ref": "#/definitions/SessionId"
        },
        "sessions": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/SessionReference"
          },
          "description": "Relationships to other Session Objects"
        },
        "dialog": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0
          },
          "description": "Indices of the Dialog Objects which are
             part of the session"
        }
      }
    },
    "SessionReference": {
      "type": "object",
      "description": "Session_Reference Object: the relationship
        of another Session Object to the Session Object which con
        tains this reference",
      "required": [
        "session",
        "type"
      ],
      "properties": {
        "session": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the referenced Session Object
            in the sessions array"
        },
        "type": {
          "type": "string",
          "description": "Type of relationship: child, peer, prec
            ursor, breakout, or a value defined in a vCon extensi
            on"
        },
        "description": {
          "type": "string",
          "description": "Free form text description of the relat
            ionship"
        }
      }
    },
    "Party": {
      "type": "object",
      "description": "Represents a party involved in the conversa
        tion",
      "properties": {
        "tel": {
          "type": "string",
          "description": "TEL URL (RFC3966) for the party"
        },
        "sip": {
          "type": "string",
          "description": "SIP URL for the party"
        },
        "stir": {
          "type": "string",
          "description": "STIR PASSporT in JWS Compact Serializat
            ion form"
        },
        "mailto": {
          "type": "string",
          "description": "Email address for the party in any comm
            on form, including a bare address or a MAILTO URL"
        },
        "name": {
          "type": "string",
          "description": "Name of the party"
        },
        "did": {
          "type": "string",
          "description": "Decentralized Identifier (DID) URI for
            the party"
        },
        "validation": {
          "type": "string",
          "description": "Label or token identifying the method o
            f identity validation used"
        },
        "gmlpos": {
          "type": "string",
          "description": "Geographic location in GML pos format (
            latitude longitude)"
        },
        "civicaddress": {
          "$ref": "#/definitions/Civicaddress"
        },
        "uuid": {
          "type": "string",
          "description": "Free form unique identifier for the par
            ticipant; not constrained to UUID syntax"
        },
        "type": {
          "type": "string",
          "description": "Participant type"
        },
        "org": {
          "type": "string",
          "description": "Organization to which the party belongs
            "
        },
        "dept": {
          "type": "string",
          "description": "Department to which the party belongs"
        }
      }
    },
    "Civicaddress": {
      "type": "object",
      "description": "Civic address information for a party's loc
        ation",
      "properties": {
        "country": {
          "type": "string"
        },
        "a1": {
          "type": "string",
          "description": "National subdivision (state/province)"
        },
        "a2": {
          "type": "string",
          "description": "County/parish/district"
        },
        "a3": {
          "type": "string",
          "description": "City/township"
        },
        "a4": {
          "type": "string",
          "description": "City division/borough"
        },
        "a5": {
          "type": "string",
          "description": "Neighborhood/block"
        },
        "a6": {
          "type": "string",
          "description": "Street"
        },
        "prd": {
          "type": "string",
          "description": "Leading street direction"
        },
        "pod": {
          "type": "string",
          "description": "Trailing street suffix"
        },
        "sts": {
          "type": "string",
          "description": "Street suffix"
        },
        "hno": {
          "type": "string",
          "description": "House number"
        },
        "hns": {
          "type": "string",
          "description": "House number suffix"
        },
        "lmk": {
          "type": "string",
          "description": "Landmark"
        },
        "loc": {
          "type": "string",
          "description": "Additional location info"
        },
        "flr": {
          "type": "string",
          "description": "Floor"
        },
        "nam": {
          "type": "string",
          "description": "Name/occupant"
        },
        "pc": {
          "type": "string",
          "description": "Postal code"
        }
      }
    },
    "Event": {
      "type": "object",
      "description": "Represents an event which occurred in a ses
        sion, such as a party joining, a key press or a transfer"
        ,
      "required": [
        "type",
        "time"
      ],
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of event: join, drop, hold, unhold
            , mute, unmute, keydown, keyup, consultation-start, b
            lind-transfer, consultative-transfer, transfer-abando
            ned, channel-contributors, or a value defined in a vC
            on extension"
        },
        "time": {
          "type": "string",
          "format": "date-time",
          "description": "Time of the event in RFC3339 format"
        },
        "sessions": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index or indices of the Session Objects
             in which the event occurred; the event applies only
            to the listed Session Objects; for transfer event typ
            es, a single index to the Session Object for the orig
            inal call; MUST NOT be present for channel-contributo
            rs"
        },
        "party": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the party to which the event a
            pplies; for transfer event types, the Transferor; MUS
            T NOT be present for channel-contributors"
        },
        "dialog": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the Dialog Object to which the
             event relates; required for channel-contributors, wh
            ere it references a recording Dialog Object; SHOULD N
            OT be present for the other event types defined in RF
            CXXXX; an event type defined in a vCon extension may
            allow an array of indices"
        },
        "channel": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the channel of the recording,
            where 0 is the first channel (channel-contributors on
            ly)"
        },
        "contributors": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "Index or indices of the parties contrib
            uting to the channel starting at the time of the even
            t; null or absent means no party contributes (channel
            -contributors only)"
        },
        "button": {
          "type": "string",
          "description": "DTMF digit, character or string (requir
            ed for keydown and keyup events)"
        },
        "transferee": {
          "type": "integer",
          "minimum": 0,
          "description": "Party index of the Transferee (transfer
             event types)"
        },
        "transfer_target": {
          "type": "integer",
          "minimum": 0,
          "description": "Party index of the Transfer Target (tra
            nsfer event types; optional for transfer-abandoned)"
        },
        "consultation": {
          "type": "integer",
          "minimum": 0,
          "description": "Session index of the consultative call
            (consultation-start and consultative-transfer; option
            al for transfer-abandoned)"
        },
        "target_session": {
          "type": "integer",
          "minimum": 0,
          "description": "Session index of the target call (blind
            -transfer and consultative-transfer)"
        }
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "join",
                  "drop",
                  "hold",
                  "unhold",
                  "mute",
                  "unmute",
                  "keydown",
                  "keyup",
                  "consultation-start",
                  "blind-transfer",
                  "consultative-transfer",
                  "transfer-abandoned"
                ]
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "sessions",
              "party"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "channel"
                  ]
                },
                {
                  "required": [
                    "contributors"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "consultation-start",
                  "blind-transfer",
                  "consultative-transfer",
                  "transfer-abandoned"
                ]
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "properties": {
              "sessions": {
                "type": "integer",
                "minimum": 0
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "join",
                  "drop",
                  "hold",
                  "unhold",
                  "mute",
                  "unmute"
                ]
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "not": {
              "anyOf": [
                {
                  "required": [
                    "button"
                  ]
                },
                {
                  "required": [
                    "transferee"
                  ]
                },
                {
                  "required": [
                    "transfer_target"
                  ]
                },
                {
                  "required": [
                    "consultation"
                  ]
                },
                {
                  "required": [
                    "target_session"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "enum": [
                  "keydown",
                  "keyup"
                ]
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "button"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "transferee"
                  ]
                },
                {
                  "required": [
                    "transfer_target"
                  ]
                },
                {
                  "required": [
                    "consultation"
                  ]
                },
                {
                  "required": [
                    "target_session"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "const": "consultation-start"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "transferee",
              "transfer_target",
              "consultation"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "button"
                  ]
                },
                {
                  "required": [
                    "target_session"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "const": "blind-transfer"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "transferee",
              "transfer_target",
              "target_session"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "button"
                  ]
                },
                {
                  "required": [
                    "consultation"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "const": "consultative-transfer"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "transferee",
              "transfer_target",
              "consultation",
              "target_session"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "button"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "const": "transfer-abandoned"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "transferee"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "button"
                  ]
                },
                {
                  "required": [
                    "target_session"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "properties": {
              "type": {
                "const": "channel-contributors"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "dialog",
              "channel"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "sessions"
                  ]
                },
                {
                  "required": [
                    "party"
                  ]
                },
                {
                  "required": [
                    "button"
                  ]
                },
                {
                  "required": [
                    "transferee"
                  ]
                },
                {
                  "required": [
                    "transfer_target"
                  ]
                },
                {
                  "required": [
                    "consultation"
                  ]
                },
                {
                  "required": [
                    "target_session"
                  ]
                }
              ]
            }
          }
        }
      ],
      "$comment": "The rules for each known type follow the Event
         Object Parameter Applicability by Type tables. SHOULD NO
        T statements, such as dialog in the event types other tha
        n channel-contributors, are not enforced. An Event Object
         with a type which is not listed is only checked for the
        parameters common to all types."
    },
    "Dialog": {
      "type": "object",
      "description": "Represents a segment of captured conversati
        on; an empty Dialog Object holds a position in the dialog
         array",
      "anyOf": [
        {
          "required": [
            "type"
          ]
        },
        {
          "maxProperties": 0,
          "$comment": "An empty Dialog Object has no type and no
            meaning"
        }
      ],
      "properties": {
        "type": {
          "type": "string",
          "description": "Type of dialog: recording, text, incomp
            lete, or a value defined in a vCon extension"
        },
        "start": {
          "type": "string",
          "format": "date-time",
          "description": "Start time of the dialog in RFC3339 for
            mat; SHOULD be present unless not known"
        },
        "duration": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "number",
              "minimum": 0
            }
          ],
          "description": "Duration in seconds"
        },
        "parties": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            },
            {
              "type": "array",
              "items": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            }
          ],
          "description": "Index/indices of the parties that contr
            ibuted to the dialog content; SHOULD be present for r
            ecording and text types"
        },
        "mediatype": {
          "type": "string",
          "description": "Media type of the dialog content; MUST
            be present for inline content; not required when Dial
            og Content is absent"
        },
        "filename": {
          "type": "string",
          "description": "Original filename of the dialog content
            "
        },
        "body": {
          "description": "Inline content of the dialog (for inlin
            e files).  Any type for encoding json; a string for e
            ncoding base64url or none."
        },
        "encoding": {
          "type": "string",
          "description": "Encoding type for inline content: base6
            4url, json, none, or a value defined in a vCon extens
            ion"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "HTTPS URL for externally referenced con
            tent"
        },
        "content_hash": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Hash(es) of external content"
        },
        "disposition": {
          "type": "string",
          "description": "Reason the call or conversation failed
            (required for incomplete type, SHOULD NOT be present
            for other types): no-answer, congestion, failed, busy
            , hung-up, voicemail-no-message, or a value defined i
            n a vCon extension; \"failed\" SHOULD be used when th
            e reason is not known"
        },
        "session_id": {
          "anyOf": [
            {
              "$ref": "#/definitions/SessionId"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/definitions/SessionId"
              }
            },
            {
              "type": "array",
              "items": {
                "oneOf": [
                  {
                    "$ref": "#/definitions/SessionId"
                  },
                  {
                    "type": "array",
                    "items": {
                      "$ref": "#/definitions/SessionId"
                    }
                  }
                ]
              }
            }
          ],
          "description": "Session ID(s) for the dialog, correlate
            d with the parties parameter"
        },
        "application": {
          "type": "string",
          "description": "Application, communication channel or c
            ontext of the conversation"
        },
        "message_id": {
          "type": "string",
          "description": "Unique message identifier from the mess
            aging system"
        },
        "redacted_segments": {
          "type": "array",
          "description": "Redacted_segments Objects for the audio
            visual segments which were redacted; SHOULD NOT be pr
            esent for text; MUST NOT be present for incomplete",
          "items": {
            "$ref": "#/definitions/RedactedSegments"
          }
        }
      },
      "dependencies": {
        "url": [
          "content_hash"
        ]
      },
      "allOf": [
        {
          "if": {
            "properties": {
              "type": {
                "const": "incomplete"
              }
            },
            "required": [
              "type"
            ]
          },
          "then": {
            "required": [
              "disposition"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "mediatype"
                  ]
                },
                {
                  "required": [
                    "filename"
                  ]
                },
                {
                  "required": [
                    "body"
                  ]
                },
                {
                  "required": [
                    "encoding"
                  ]
                },
                {
                  "required": [
                    "url"
                  ]
                },
                {
                  "required": [
                    "content_hash"
                  ]
                },
                {
                  "required": [
                    "message_id"
                  ]
                },
                {
                  "required": [
                    "redacted_segments"
                  ]
                }
              ]
            }
          }
        },
        {
          "if": {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "not": {
                  "const": ""
                }
              }
            }
          },
          "then": {
            "required": [
              "encoding"
            ]
          }
        },
        {
          "if": {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "not": {
                  "const": ""
                }
              }
            }
          },
          "then": {
            "required": [
              "mediatype"
            ]
          }
        },
        {
          "if": {
            "properties": {
              "encoding": {
                "enum": [
                  "base64url",
                  "none"
                ]
              }
            },
            "required": [
              "encoding"
            ]
          },
          "then": {
            "properties": {
              "body": {
                "type": "string"
              }
            }
          }
        }
      ],
      "$comment": "The rules for each known type follow the Dialo
        g Object Parameter Applicability by Type table. A Dialog
        Object with a type which is not listed is only checked fo
        r the rules common to all types."
    },
    "SessionId": {
      "type": "object",
      "description": "Session identifier with local and remote UU
        IDs",
      "properties": {
        "local": {
          "type": "string",
          "description": "Local UUID for the session"
        },
        "remote": {
          "type": "string",
          "description": "Remote UUID for the session"
        }
      }
    },
    "Attachment": {
      "type": "object",
      "description": "Represents an ancillary document related to
         the conversation",
      "required": [
        "start",
        "party"
      ],
      "properties": {
        "purpose": {
          "type": "string",
          "description": "text description of what the attachment
             is for"
        },
        "start": {
          "type": "string",
          "format": "date-time",
          "description": "Time the attachment was sent/exchanged
            in RFC3339 format"
        },
        "party": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the party that contributed the
             attachment"
        },
        "dialog": {
          "type": "integer",
          "minimum": 0,
          "description": "Index of the dialog this attachment is
            part of (optional; at least one of dialog or session
            MUST be present)"
        },
        "session": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index/indices of the Session Object(s)
            this attachment is related to"
        },
        "mediatype": {
          "type": "string",
          "description": "Media type of the attachment content; M
            UST be present for inline content; not required when
            Attachment Content is absent"
        },
        "filename": {
          "type": "string",
          "description": "Original filename of the attachment"
        },
        "body": {
          "description": "Inline content of the attachment (for i
            nline files).  Any type for encoding json; a string f
            or encoding base64url or none."
        },
        "encoding": {
          "type": "string",
          "description": "Encoding type for inline content: base6
            4url, json, none, or a value defined in a vCon extens
            ion"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "HTTPS URL for externally referenced att
            achment"
        },
        "content_hash": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Hash(es) of external content"
        }
      },
      "dependencies": {
        "url": [
          "content_hash"
        ]
      },
      "anyOf": [
        {
          "required": [
            "dialog"
          ]
        },
        {
          "required": [
            "session"
          ]
        }
      ],
      "allOf": [
        {
          "if": {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "not": {
                  "const": ""
                }
              }
            }
          },
          "then": {
            "required": [
              "encoding"
            ]
          }
        },
        {
          "if": {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "not": {
                  "const": ""
                }
              }
            }
          },
          "then": {
            "required": [
              "mediatype"
            ]
          }
        },
        {
          "if": {
            "properties": {
              "encoding": {
                "enum": [
                  "base64url",
                  "none"
                ]
              }
            },
            "required": [
              "encoding"
            ]
          },
          "then": {
            "properties": {
              "body": {
                "type": "string"
              }
            }
          }
        }
      ]
    },
    "Analysis": {
      "type": "object",
      "description": "Represents analysis performed on the conver
        sational data",
      "required": [
        "type",
        "vendor"
      ],
      "properties": {
        "type": {
          "type": "string",
          "description": "Semantic type of analysis (e.g., report
            , sentiment, summary, transcript, translation, tts)"
        },
        "dialog": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index/indices of dialog objects this an
            alysis is based on (optional)"
        },
        "sessions": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index/indices of Session Objects this a
            nalysis is based on (optional)"
        },
        "attachment": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index/indices of attachment objects thi
            s analysis is based on (optional)"
        },
        "analysis": {
          "oneOf": [
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0
              }
            }
          ],
          "description": "Index/indices of other Analysis Objects
             this analysis is based on (optional); MUST NOT refer
            ence itself"
        },
        "mediatype": {
          "type": "string",
          "description": "Media type of the analysis content; SHO
            ULD be provided for inline content and for external c
            ontent without an HTTPS Content-Type header; when no
            media type is defined for the data format, the vendor
            , product and schema parameters SHOULD identify the f
            ormat instead"
        },
        "filename": {
          "type": "string",
          "description": "Original filename of the analysis data"
        },
        "vendor": {
          "type": "string",
          "description": "Vendor or product name that generated t
            he analysis"
        },
        "product": {
          "type": "string",
          "description": "Product name to differentiate from othe
            r vendor products"
        },
        "schema": {
          "type": "string",
          "description": "Token or label for the data format/sche
            ma of the analysis"
        },
        "body": {
          "description": "Inline content of the analysis (for inl
            ine files).  Any type for encoding json; a string for
             encoding base64url or none."
        },
        "encoding": {
          "type": "string",
          "description": "Encoding type for inline content: base6
            4url, json, none, or a value defined in a vCon extens
            ion"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "HTTPS URL for externally referenced ana
            lysis"
        },
        "content_hash": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          ],
          "description": "Hash(es) of external content"
        }
      },
      "dependencies": {
        "url": [
          "content_hash"
        ]
      },
      "allOf": [
        {
          "if": {
            "required": [
              "body"
            ],
            "properties": {
              "body": {
                "not": {
                  "const": ""
                }
              }
            }
          },
          "then": {
            "required": [
              "encoding"
            ]
          }
        },
        {
          "if": {
            "properties": {
              "encoding": {
                "enum": [
                  "base64url",
                  "none"
                ]
              }
            },
            "required": [
              "encoding"
            ]
          },
          "then": {
            "properties": {
              "body": {
                "type": "string"
              }
            }
          }
        }
      ],
      "$comment": "At least one of the dialog, sessions, attachme
        nt or analysis parameters SHOULD be present. An Analysis
        Object MUST NOT reference itself in the analysis paramete
        r; this is not enforced by this schema."
    },
    "RedactedString": {
      "type": "object",
      "description": "Information about a substring of the vCon w
        hich was replaced by __REDACTED_REF_#",
      "required": [
        "ref"
      ],
      "properties": {
        "ref": {
          "type": "integer",
          "minimum": 1,
          "maximum": 99999,
          "description": "Reference number of the redacted substr
            ing"
        },
        "type": {
          "type": "string",
          "description": "Type of information redacted: GOVT_ID_N
            UM, FIN_ID_NUM, MED_ID_NUM, BIOMETRIC, AUTH_DATA, CON
            TACT_INFO, LOC_INFO, EMPL_INFO, BELIEF_INFO, UNSPECIF
            IED or another value; absent means UNSPECIFIED"
        },
        "orig": {
          "type": "string",
          "description": "Original, unredacted value of the subst
            ring"
        }
      },
      "$comment": "That each __REDACTED_REF_# substring has a Red
        acted_string Object with a matching ref is not enforced b
        y this schema."
    },
    "RedactedSegments": {
      "type": "object",
      "description": "An audiovisual segment of a recording which
         was redacted",
      "required": [
        "start",
        "end"
      ],
      "properties": {
        "start": {
          "type": "string",
          "format": "date-time",
          "description": "Start time of the redaction in RFC3339
            format"
        },
        "end": {
          "type": "string",
          "format": "date-time",
          "description": "End time of the redaction in RFC3339 fo
            rmat"
        },
        "parties": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 0
          },
          "description": "Indices of the parties whose content wa
            s redacted"
        }
      },
      "$comment": "TODO: should use duration instead of end?"
    }
  },
  "not": {
    "required": [
      "redacted_from",
      "amended_from"
    ],
    "$comment": "The redacted_from and amended_from parameters ar
      e mutually exclusive"
  },
  "allOf": [
    {
      "if": {
        "anyOf": [
          {
            "required": [
              "dialog"
            ],
            "properties": {
              "dialog": {
                "minItems": 1
              }
            }
          },
          {
            "required": [
              "events"
            ],
            "properties": {
              "events": {
                "minItems": 1
              }
            }
          }
        ]
      },
      "then": {
        "required": [
          "sessions"
        ],
        "properties": {
          "sessions": {
            "minItems": 1
          }
        },
        "$comment": "At least one Session Object MUST exist if th
          e events array or the dialog array contain Objects"
      }
    }
  ],
  "$comment": "This schema is permissive: parameters and type val
    ues which are not defined in RFCXXXX do not cause validation
    to fail. At least one of the parties, dialog, analysis or att
    achments parameters SHOULD be present. SHOULD-level statement
    s are not enforced by this schema. Index values are not check
    ed against the size of the array which they reference."
}