5.13.0 5.12.0 5.11.0 5.10.0 5.9.0 5.8.0 5.7.0 5.6.0 5.5.0 5.4.0 5.3.0 5.2.0 5.1.0 5.0 4.10 4.9 4.8 4.7 4.6 4.5.3 4.5.2 4.5.1 4.5 4.4 4.3
5.13.0 5.12.0 5.11.0 5.10.0 5.9.0 5.8.0 5.7.0 5.6.0 5.5.0 5.4.0 5.3.0 5.2.0 5.1.0 5.0 4.10 4.9 4.8 4.7 4.6 4.5.3 4.5.2 4.5.1 4.5 4.4 4.3

Conversations API (3rd-party apps)

The properties of the Activities API is described below:

POST/forms

The body should be in JSON format and include the following properties:

Request

Parameter

Description

Type

Properties

id  Required  

System generated form ID

String

-

header Required

Details of the header are explained in

CIM Messages

.

Object

-

body Required

The message body can change with respect to the type of activity being defined by 3rd-party. Any attribute can be added in the form of key:value pair.

The body of Message Types can be viewed here in CIM Messages for inspiration.

String

Example: 

"type": "FNB",

"markdownText": "hello",
 "custom1": "DummyValue1",
 "custom2": "DummayVlaue2"


Code

Description

200

Code 200 implies that the activity has been accepted.


{
    "id": "{{$guid}}",
    "header": {
    "sender": {
      "id": "460df46c-adf9-11ed-afa1-0242ac120002",
      "type": "APP",
      "senderName": "APPName",
      "additionalDetail": null
    },
    "channelData": {
      "channelCustomerIdentifier": "",
      "serviceIdentifier": "",
      "requestPriority": 0,
      "additionalAttributes": []
    },
    "language": {},
    "timestamp": 1677151053951,
    "securityInfo": {},
    "stamps": [],
    "intent": null,
    "entities": {},
    "channelSessionId": null,
    "conversationId": "642b51a7d9ba694f5ba0ba7f",
    "customer": {"_id": "642b51a661e49d5776378711"},
    "replyToMessageId": null,
    "providerMessageId": null
  },
    "body": {
        "type": "FNB",
        "markdownText": "hello",
        "custom1": "DummyValue1",
        "custom2": "DummayVlaue2"
    }
}




Quick Links