Note
Note of the ticket.
Note
- Note Manage
GET ticketing/notes/{id}
GET ticketing/tickets/{id}/notes
POST ticketing/notes
Model
Note JSON Format
Note is represented as simple flat JSON objects with the following keys:
| Name | Type | Description |
|---|---|---|
id |
guid | Id of the ticket note. |
ticketId |
selfIncrementId | Id of the ticket which the note belongs to. |
agentId |
guid | Id of the agent who sent the note. |
createdTime |
datetime | Time when the note was created. |
text |
string | Content of the note. 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. |
attachments |
attachments[] | Reference to NoteAttachment. |
noteMentions |
noteMentions[] | Reference to NoteMention. |
NoteAttachment JSON Format:
| Name | Type | Description |
|---|---|---|
id |
guid | Id of the attachment. |
noteId |
guid | Id of the note which the attachment belongs to. |
fileKey |
string | Unique key in file service. |
name |
string | Name of the attachment. |
size |
integer | Size of the attachment. |
type |
string | Type of the attachment. Allowed values are "video", "audio", "image", "file". |
url |
string | Download URL of the attachment. |
NoteMention JSON Format:
| Name | Type | Description |
|---|---|---|
isReadByAgent |
bool | Whether the mention has been read by agent or not. |
noteId |
guid | Id of the note which the mention belongs to. |
id |
guid | Id of the mention. |
agentId |
guid | Id of the mentioned agent. |
ticketId |
selfIncrementId | Id of the ticket which the note belongs to. |
Endpoint
Get a single Note
GET ticketing/notes/{id}
Parameters:
| Name | Type | In | Required | Description |
|---|---|---|---|---|
include |
string | query | no | Allowed values are "ticketingNoteAttachment", "ticketingNoteMention", "agent". |
Response:
Example
Sample Request:
curl https://api15.comm100.io/v4/ticketing/notes/4d103607-f113-4884-8f7e-735f6fefdbf9 \
-X
'GET'
\
-H
'Authorization: Bearer {access_token}'
\
Response:
HTTP/1.1 200 OK
Get the list of Note
GET ticketing/tickets/{id}/notes
Parameters:
| Name | Type | In | Required | Description |
|---|---|---|---|---|
include |
string | query | no | Allowed values are "ticketingNoteAttachment", "ticketingNoteMention", "agent". |
Response:
An array of Note
Example
Sample Request:
curl https://api15.comm100.io/v4/ticketing/tickets/4d103607-f113-4884-8f7e-735f6fefdbf9/notes \
-X
'GET'
\
-H
'Authorization: Bearer {access_token}'
\
Response:
HTTP/1.1 200 OK
Create a new Note
POST ticketing/notes
Parameters:
| Name | Type | In | Required | Description |
|---|---|---|---|---|
ticketId |
selfIncrementId | body | yes | Id of the ticket which the note belongs to. |
text |
string | body | no | Content of the note. 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. |
attachments |
attachments[] | body | no | The list of note attachment. |
Response:
Example
Sample Request:
curl https://api15.comm100.io/v4/ticketing/notes \
-X
'POST'
\
-H
'Authorization: Bearer {access_token}'
\
-H
'Content-Type: application/json'
\
-D
'{"ticketId":"11","text":"data:text/plain;base64,MTEx","attachments":[{"fileKey":"isqo-ngLG1Vw7Uh0ieeIGXSjVoAX2DhmQKeWmi7","name":"my file","size":10,"type":"file","url":"http://myfile/url"}],"noteMentions":[{"isReadByAgent":false,"agentId":"bdf96bad-890f-4af5-8f4e-42d2cc29e61b","ticketId":"11"}]}'
Response:
HTTP/1.1 201 Created