Global_PublicCannedMessage

You need Manage Public Canned Messages permission to manage the public canned message.

Global_PublicCannedMessages
- Global_PublicCannedMessages Manage
GET global/publicCannedMessages
GET global/publicCannedMessages/{id}
POST global/publicCannedMessages
PUT global/publicCannedMessages/{id}
DELETE global/publicCannedMessages/{id}
Model
Global_PublicCannedMessage JSON Format

Global_PublicCannedMessage is represented as simple flat JSON objects with the following keys:

Name Type Description
id guid Id of the public canned message.
categoryId guid Id of the category.
name string Name of the canned message.
message string Default message content in all channels. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
htmlMessage string Message content for html email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
textMessage string Message content for plaintext email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
shortcuts string Shortcut using which agents can quickly locate the canned message while chatting with a visitor.
similarQuestions string [] Available when Agent Assist is enabled.
Endpoint
Get the list of Global_PublicCannedMessages

GET global/publicCannedMessages

Parameters:
Name Type In Required Description
category guid query no Id of the public canned message category.
keywords string query no Filter by keywords in name and message of the public canned message.
include string query no Allowed value is "publicCannedMessageCategory".
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/publicCannedMessages \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

[{"id":"7ea02303-959b-eb11-8103-00155d081d0b","categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}]
Get a single Global_PublicCannedMessage

GET global/publicCannedMessages/{id}

Parameters:
Name Type In Required Description
include string query no Allowed value is "publicCannedMessageCategory".
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/publicCannedMessages/7ea02303-959b-eb11-8103-00155d081d0b \
-X 'GET' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 200 OK

{"id":"7ea02303-959b-eb11-8103-00155d081d0b","categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}
Create a new Global_PublicCannedMessage

POST global/publicCannedMessages

Parameters:
Name Type In Required Description
categoryId guid body yes Id of the category.
name string body yes Name of the canned message.
message string body yes Default message content in all channels. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
htmlMessage string body no Message content for html email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
textMessage string body no Message content for plaintext email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
shortcuts string body no Shortcut using which agents can quickly locate the canned message while chatting with a visitor.
similarQuestions string [] body no Available when Agent Assist is enabled.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/publicCannedMessages \
-X 'POST' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}'

Response:

 HTTP/1.1 201 Created

{"id":"7ea02303-959b-eb11-8103-00155d081d0b","categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}
Update the Global_PublicCannedMessage

PUT global/publicCannedMessages/{id}

Parameters:
Name Type In Required Description
categoryId guid body yes Id of the category.
name string body yes Name of the canned message.
message string body yes Default message content in all channels. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
htmlMessage string body no Message content for html email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
textMessage string body no Message content for plaintext email in Ticketing & Messaging. You can pass both plaintext and base64 encoded text. If the request containing plaintext is blocked by comm100 WAF, use base64 format. When using base64, add "data:text/plain;base64," before the content.
shortcuts string body no Shortcut using which agents can quickly locate the canned message while chatting with a visitor.
similarQuestions string [] body no Available when Agent Assist is enabled.
Response:
Example

Sample Request:

curl https://api15.comm100.io/v4/global/publicCannedMessages/7ea02303-959b-eb11-8103-00155d081d0b \
-X 'PUT' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-D '{"categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}'

Response:

 HTTP/1.1 200 OK

{"id":"7ea02303-959b-eb11-8103-00155d081d0b","categoryId":"79a02303-959b-eb11-8103-00155d081d0b","name":"thanks","message":"thanks","htmlMessage":"<p>thanks</p>","textMessage":"thanks","shortcuts":"thx","similarQuestions":["are you ok?"]}
Remove the Global_PublicCannedMessage

DELETE global/publicCannedMessages/{id}

Parameters:
No Parameters
Response:

No Content

Example

Sample Request:

curl https://api15.comm100.io/v4/global/publicCannedMessages/7ea02303-959b-eb11-8103-00155d081d0b \
-X 'DELETE' \
-H 'Authorization: Bearer {access_token}' \

Response:

 HTTP/1.1 204 No Content