addInteraction
- Description
- This transaction adds interaction information including regarding detail and interaction type information to the database. This transaction can be used as a coarse-grained transaction to add the interaction with an interaction relationship.
- Web Services
- Operation name: addInteraction
- Example
Louise Jones phones a call center and requests marketing information. The customer service representative (CSR) records the interaction and adds the request to the database.
Jenny Smith, who is not a Party in the database, calls on behalf of her husband, John Smith, who is a Party in the database. The CSR records the interaction to note that Jenny Smith called on behalf of her husband and that she is the source of the interaction.
John Smith called to change his address on his life insurance policy. In this example, the regarding detail would include John Smith's life insurance policy number. The CSR records the change of address by selecting Customer service request under Category and Minor change under Type.
- Usage information
- InfoSphere® MDM
provides the ability to capture all contact history regardless of the method of communication.
Each interaction record includes a date that records when the interaction occurred, the method of the communication (such as fax, telephone, or e-mail), the reason and the details for the communication and, in particular, the source of the interaction. The source of an interaction is often an individual (Party), but interactions can also be recorded when the source is another system, a system user, an agent, or some other third party.
The interaction can also be about a contract, a party, an individual who is not a party in InfoSphere MDM, or another entity such as a grouping. If the interaction is about an individual that is not a Party in the database, the individual can be recorded as a name or other identifier such as a user ID or an account representative number.
Interaction types let a company predefine how the information for an interaction is categorized and typed.
When using this transaction as a coarse-grained transaction, the following simple transaction may also apply:
- Preconditions
-
Must either have a valid PartyId for the InteractionParty or a valid EntityName and InstancePK.
- Mandatory input
- InteractionPointType
- RecordedDate
- InteractionShortDescription
- InteractionParty
- InteractionDate
Note: InteractionParty is always a required input. If the request does not include valid EntityName and InstancePK values, then the InteractionParty value must be a valid Party ID. However, if a valid EntityName and InstancePK are provided in the request, then the InteractionParty value can be freeform, such as a name or a relationship description, and does not need to be a valid PartyId.- Inquiry levels
- Not applicable
- Filter values
- Not applicable
- Transaction behavior
-
If EntityName and InstancePK are not provided or are blank, the InteractionParty must provide a valid PartyId value.
If a valid EntityName and a valid InstancePK are provided, the InteractionParty value is still required, but the input can be freeform, such as a name, relationship description, or a PartyId. If EntityName and InstancePK values are provided, the EntityName may only be of type Contact or Contract. If the EntityName is a Contact, the InstancePK returns records for this case, as well as the case where the InteractionParty = InstancePK, as supplied to the transaction.
- Request message
- <TCRMTxType> addInteraction
<TCRMTxObject> TCRMInteractionBObj
<TCRMObject> TCRMInteractionBObj
with associations
- Response objects
- TCRMInteractionBObj
with associations
- Special note
- Not applicable