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:
An array of Global_PublicCannedMessage
Example
Sample Request:
curl https://api15.comm100.io/v4/global/publicCannedMessages \
-X
'GET'
\
-H
'Authorization: Bearer {access_token}'
\
Response:
HTTP/1.1 200 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
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
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
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