Chat
{
"type": "object",
"required": [
"requesterId",
"widgetId",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"language": {
"type": "string"
},
"widgetId": {
"type": "string",
"format": "uuid"
},
"browserInfo": {
"$ref": "#/components/schemas/BrowserInfo"
},
"requesterId": {
"type": "string",
"format": "uuid"
}
}
}
ChatAttributes
{
"type": "object",
"required": [
"isAutomated"
],
"properties": {
"content": {
"$ref": "#/components/schemas/Content"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"isAutomated": {
"type": "boolean"
}
}
}
ChatConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"state": {
"type": "string",
"description": "values: [AwaitingPending, Closed, Open, Pending]"
},
"channel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"browserInfo": {
"$ref": "#/components/schemas/BrowserInfo"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
}
}
}
ClaimConversationInput
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"force": {
"type": "boolean",
"description": "Set as false to avoid taking over the conversation if it is already assigned to an agent"
},
"agentId": {
"type": "string",
"format": "uuid",
"description": "The id of the agent who is claiming the conversation"
}
}
}
CloseConversationInput
{
"type": "object",
"properties": {
"userId": {
"type": "string",
"format": "uuid"
}
}
}
Conflict
{
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
}
}
ContactEndpoint
{
"oneOf": [
{
"$ref": "#/components/schemas/EmailEndpoint"
},
{
"$ref": "#/components/schemas/TelephonyEndpoint"
}
]
}
ContactForm
{
"type": "object",
"required": [
"requesterId",
"emailIntegrationId",
"subject",
"message"
],
"properties": {
"message": {
"$ref": "#/components/schemas/CreateMessageInput"
},
"subject": {
"type": "string"
},
"language": {
"type": "string"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"emailIntegrationId": {
"type": "string"
}
}
}
ContactFormAttributes
{
"type": "object",
"required": [
"isAutoReply"
],
"properties": {
"cc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"to": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"bcc": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"from": {
"$ref": "#/components/schemas/EmailContact"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"isAutoReply": {
"type": "boolean"
},
"emailContent": {
"$ref": "#/components/schemas/EmailContent"
},
"inlineImages": {
"type": "array",
"items": {
"$ref": "#/components/schemas/File"
}
},
"originalContentUrl": {
"$ref": "#/components/schemas/File"
},
"replyDefaultToEmails": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EmailContact"
}
},
"deliveryFailureReason": {
"type": "string"
}
}
}
ContactFormConversation
{
"type": "object",
"required": [
"id",
"requesterId",
"channel",
"createdAt",
"fromEmail"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"link": {
"$ref": "#/components/schemas/ConversationLink"
},
"queue": {
"$ref": "#/components/schemas/Queue"
},
"state": {
"type": "string",
"description": "values: [AwaitingPending, Closed, Open, Pending]"
},
"channel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
},
"subject": {
"type": "string"
},
"toEmail": {
"type": "string"
},
"language": {
"type": "string"
},
"createdAt": {
"type": "string",
"format": "date-time"
},
"direction": {
"type": "string",
"description": "values: [Inbound, Internal, Outbound]"
},
"fromEmail": {
"type": "string"
},
"assignment": {
"$ref": "#/components/schemas/Assignment"
},
"requesterId": {
"type": "string",
"format": "uuid"
},
"stateUpdatedAt": {
"type": "string",
"format": "date-time"
},
"customAttributes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomAttribute"
}
},
"integrationEmail": {
"type": "string"
}
}
}
Content
{
"oneOf": [
{
"$ref": "#/components/schemas/Html"
},
{
"$ref": "#/components/schemas/Text"
}
]
}
Conversation
{
"oneOf": [
{
"$ref": "#/components/schemas/AnonymizedConversation"
},
{
"$ref": "#/components/schemas/ChatConversation"
},
{
"$ref": "#/components/schemas/ContactFormConversation"
},
{
"$ref": "#/components/schemas/EmailConversation"
},
{
"$ref": "#/components/schemas/FacebookMessengerConversation"
},
{
"$ref": "#/components/schemas/GenericConversation"
},
{
"$ref": "#/components/schemas/MessengerConversation"
},
{
"$ref": "#/components/schemas/PstnPhoneConversation"
},
{
"$ref": "#/components/schemas/SmsConversation"
},
{
"$ref": "#/components/schemas/TwitterConversation"
},
{
"$ref": "#/components/schemas/WhatsAppConversation"
}
]
}
ConversationAnonymizationType
{
"type": "object"
}
ConversationAssignedActivityType
{
"type": "object"
}
ConversationAssignedAttribute
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"agentId": {
"type": "string"
},
"agentName": {
"type": "string"
}
}
}
ConversationAutoReplySentAttribute
{
"type": "object",
"required": [
"templateName"
],
"properties": {
"templateName": {
"type": "string"
}
}
}
ConversationAutoreplySentActivityType
{
"type": "object"
}
ConversationClaimedActivityType
{
"type": "object"
}
ConversationClaimedAttribute
{
"type": "object",
"properties": {
"claimedFromType": {
"type": "string"
},
"claimedFromLabel": {
"type": "string"
}
}
}
ConversationClosedActivityType
{
"type": "object"
}
ConversationCreatedAttribute
{
"type": "object",
"properties": {
"subject": {
"type": "string"
}
}
}
ConversationCreatedByAgentActivityType
{
"type": "object"
}
ConversationCreatedByCustomerActivityType
{
"type": "object"
}
ConversationEndUserReplacedActivityType
{
"type": "object"
}
ConversationEndUserReplacedAttribute
{
"type": "object",
"required": [
"oldUser",
"newUser"
],
"properties": {
"newUser": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"oldUser": {
"$ref": "#/components/schemas/ActivityLogUser"
}
}
}
ConversationFlow
{
"type": "object",
"required": [
"id",
"name",
"channel",
"contactEndpointId"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"name": {
"type": "string"
},
"channel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
},
"contactEndpointId": {
"type": "string"
}
}
}
ConversationLanguageUpdatedActivityType
{
"type": "object"
}
ConversationLanguageUpdatedAttribute
{
"type": "object",
"required": [
"language"
],
"properties": {
"language": {
"type": "string"
}
}
}
ConversationLink
{
"oneOf": [
{
"$ref": "#/components/schemas/EmailForward"
},
{
"$ref": "#/components/schemas/FollowUp"
},
{
"$ref": "#/components/schemas/SideConversation"
}
]
}
ConversationOfferAcceptedActivityType
{
"type": "object"
}
ConversationOfferRejectedActivityType
{
"type": "object"
}
ConversationOfferTimeoutActivityType
{
"type": "object"
}
ConversationOfferedActivityType
{
"type": "object"
}
ConversationOfferedAttribute
{
"type": "object",
"properties": {
"agentNames": {
"type": "array",
"items": {
"type": "string"
}
},
"queueLabel": {
"type": "string"
}
}
}
ConversationPendingActivityType
{
"type": "object"
}
ConversationRatedActivityType
{
"type": "object"
}
ConversationRatedAttribute
{
"type": "object",
"required": [
"agent"
],
"properties": {
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"score": {
"type": "integer",
"format": "int32"
},
"message": {
"type": "string"
}
}
}
ConversationRating
{
"type": "object",
"required": [
"id",
"ratingType",
"conversationChannel",
"userId",
"ratingStatus",
"timestamps"
],
"properties": {
"id": {
"type": "string"
},
"userId": {
"type": "string"
},
"agentId": {
"type": "string"
},
"language": {
"type": "string"
},
"ratingType": {
"type": "string",
"description": "values: [Csat, ThumbsUpOrDown]"
},
"timestamps": {
"$ref": "#/components/schemas/Map_String"
},
"ratingScore": {
"type": "integer",
"format": "int32"
},
"ratingStatus": {
"type": "string",
"description": "values: [Unscheduled, Offered, Rated, Scheduled, Cancelled]"
},
"ratingComment": {
"type": "string"
},
"conversationChannel": {
"type": "string",
"description": "values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]"
}
}
}
ConversationRatingCancelledActivityType
{
"type": "object"
}
ConversationRatingOfferedActivityType
{
"type": "object"
}
ConversationRatingOfferedAttribute
{
"type": "object",
"required": [
"agent",
"user"
],
"properties": {
"user": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
}
}
}
ConversationRatingScheduledActivityType
{
"type": "object"
}
ConversationRatingScheduledAttribute
{
"type": "object",
"required": [
"ratingScheduledTime"
],
"properties": {
"ratingScheduledTime": {
"type": "string"
}
}
}
ConversationRatingUnscheduledActivityType
{
"type": "object"
}
ConversationReopenedActivityType
{
"type": "object"
}
ConversationReservedAttribute
{
"type": "object",
"required": [
"agent",
"queueId",
"queueName",
"reservationType",
"validUntil"
],
"properties": {
"agent": {
"$ref": "#/components/schemas/ActivityLogUser"
},
"queueId": {
"type": "string"
},
"queueName": {
"type": "string"
},
"validUntil": {
"type": "string"
},
"reservationType": {
"type": "string"
}
}
}
ConversationReservedType
{
"type": "object"
}
ConversationResponse
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"format": "int64"
}
}
}
ConversationSearchHit
{
"type": "object",
"required": [
"id",
"highlights"
],
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Identifier of a Conversation where a match was found"
},
"innerHits": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ConversationSearchInnerHit"
},
"description": "List of sub-entities (such as Messages) where a match was found"
},
"highlights": {
"$ref": "#/components/schemas/Map_Vector_String"
}
}
}
ConversationSearchInnerHit
{
"type": "object",
"required": [
"id",
"highlight"
],
"properties": {
"id": {
"type": "string",
"description": "Identifier of a sub-entity (such as a Message) where a match was found"
},
"highlight": {
"$ref": "#/components/schemas/Map_String"
}
}
}