Skip to main content
Version: 2.1

Interaction

An Interaction is a significant direct exchange of ideas or information between a number of participants, e.g. a Sell Side party and one or more Buy Side parties. An Interaction might be a call, a meeting (physical or virtual), an IM or the preparation of some specialist data, such as financial data for a given company or sector.

Notes:

  • interactionType SHOULD be one of 'Instant Message', 'Email', 'Call', or 'Meeting' although other string values are permitted.
  • origin is used to represent the application or service that the interaction was created from to aid in tracing the source of an interaction.
  • id does not need to be populated by the originating application, however the target application could store it for future reference and SHOULD return it in a TransactionResult.
  • id can be used by a target application to pass an identifier back to the originating application after an interaction record has been created, updated or deleted.
  • id.URI can be used by a target application to pass a record's link back to the originating application. This offers the originating application a way to open the record for a user to view.

Type

fdc3.interaction

Schema

https://fdc3.finos.org/schemas/2.1/context/interaction.schema.json

Details

PropertyTypeRequiredExample Value
typestringYesfdc3.interaction
participantsfdc3.contactListYesSee below
timeRangefdc3.timeRangeYesSee below
interactionTypestringYesInstant Message
descriptionstringYesBlah, blah, blah
initiatorfdc3.contactNoSee below
originstringNoOutlook
id.SINGLETRACKstringNoa0S8d000000uO05EAE
id.SALESFORCEstringNoa0S8d000000uO05EAE
id.URIstringNohttps://example.com/record/a0S8d000000uO05EAE

Example

const interaction = {
type: 'fdc3.interaction',
participants: {
type: 'fdc3.contactList',
contacts: [
{
type: 'fdc3.contact',
name: 'Jane Doe',
id: {
email: 'jane.doe@mail.com'
}
},
{
type: 'fdc3.contact',
name: 'John Doe',
id: {
email: 'john.doe@mail.com'
}
},
]
},
interactionType: 'Instant Message',
timeRange: {
type: 'fdc3.timeRange',
startTime: '2022-02-10T15:12:00Z'
},
description: 'Laboris libero dapibus fames elit adipisicing eu, fermentum, dignissimos laboriosam, erat, risus qui deserunt. Praesentium! Reiciendis. Hic harum nostrud, harum potenti amet? Mauris. Pretium aliquid animi, eget eiusmod integer proident. Architecto ipsum blandit ducimus, possimus illum sunt illum necessitatibus ab litora sed, nonummy integer minus corrupti ducimus iste senectus accumsan, fugiat nostrud? Pede vero dictumst excepturi, iure earum consequuntur voluptatum',
initiator: {
type: 'fdc3.contact',
name: 'Jane Doe',
id: {
email: 'jane.doe@mail.com'
}
},
origin: 'Outlook'
}

fdc3.raiseIntent('CreateInteraction', interaction)

See Also

Other Types

Intents