Update Channel

Overview

Use this API to update an existing channel in the Conversation Manager with your specific custom requirements.

Scope

Client application must have 'app.conversation.conversationmgr.manage' scope assigned.

SecurityoAuthClient

Request

path Parameters

required

string = 36 characters

id of object

Example: 7b6c5fff-036e-4a40-b68a-a67c592fc079

Request Body schema: application/json

Update channel

type required	string [ 1 .. 255 ] characters Unique channel type. Do not prefix with 'custom.' for channels supported by eGain.
displayName required	string [ 1 .. 255 ] characters
icon required	string [ 1 .. 512000 ] characters base64 encoded image. This icon is used in eGain Chat Advisor desktop for activities of this channel. If eGain Chat is used for live agents then use icon file in ‘png’ format with pixel dimensions 32 X 32.
description	string [ 1 .. 1023 ] characters
active	boolean Default: true
	object (Restrictions) Channel restriction on inbound(from customer) and outbound( to customer) messages.
	Array of objects (L10nProperties) [ 1 .. 25 ] items
modified	string <date-time> Last modified time in GMT

Responses

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal server error

put/channels/{id}

Request samples

Payload
curl
JavaScript
Node.js

application/json

{"type": "custom_channel",
"icon": "<base64>",
"displayName": "Custom Channel",
"description": "Custom Channel",
"active": true,
"modified": "2021-06-11T23:14:41.836Z",
"restrictions": {"inbound": {"maxTextLength": 140,
"features": ["typing_events",
"attachments",
"richText"
],
"attachmentPolicy": {"enabled": true,
"maxSize": 12345,
"type": "block",
"extensions": ["bat",
"exe"
]
}
},
"outbound": {"maxTextLength": 140,
"systemMessages": true,
"midChatAuth": true,
"features": ["typing_events",
"attachments",
"richText"
],
"richMessageTypes": ["listpicker",
"quickreply",
"timepicker",
"richlink"
],
"attachmentPolicy": {"enabled": true,
"maxSize": 12345,
"type": "block",
"extensions": ["bat",
"exe"
]
}
}
},
"l10nProperties": [{"language": "en-US",
"properties": [{"name": "msg_hub_retain_and_retry",
"value": "Thank you for reaching out. We will respond to you at the earliest."
},
{"name": "msg_hub_off_hours",
"value": "Thank you for your inquiry. Our service hours are 9am-5pm PST, Monday-Friday. If you are trying within the service hours and still getting this message, please try again after some time."
},
{"name": "msg_hub_invalid_content_type_to_customer",
"value": "This content type is not currently supported."
},
{"name": "msg_hub_invalid_content_type_to_agent",
"value": "This content type is not currently supported."
},
{"name": "msg_hub_channel_msg_failed",
"value": "Message could not be delivered. Please try again after some time."
},
{"name": "msg_hub_blocked_file_extension",
"value": "Attachment file type '{0}' is not allowed."
},
{"name": "msg_hub_attachment_size_exceeds_limit",
"value": "File could not be sent. It exceeded the maximum limit of {0}"
}
]
}
]
}

Response samples

application/json

Required attribute is missing in payload

{"code": "400-143",
"developerMessage": "Required attribute is missing in the request body: <attribute>"
}