Revision as of 10:19, June 12, 2017 by Xavier (talk | contribs) (added text, messageType, and treatAs parameters)
Jump to: navigation, search

SendCustomNotice

This operation is part of the Chat API section of the Web Services API.

Overview

This request sends a custom notice to all chat participants.

Request URL /api/v2/me/chats/{id}
HTTP Method POST
Required Features api-multimedia

Parameters

Parameter Value
operationName SendCustomNotice
noticeText The notice text to send to all chat participants.
text (Optional) The text to send to the customer.
messageType (Optional) Defines the message type. Note that this parameter must be provided together with the text parameter.
treatAs (Optional) Specifies how the message should be treated: Normal or System. Note that this parameter must be provided together with the text parameter.

Sample

Request

POST api/v2/me/chats/0000RaB4Q006001F
{
  "operationName": "SendCustomNotice",
  "noticeText": "This is a custom notice"
}

Response

{
  "statusCode": 0
}

Notification

{
    "chatPath": "/chats/0000RaB4Q006001F",
    "messages": [
        {
            "index": 5,
            "noticeText": "This is a custom notice",
            "from": {
                "participantId": "0093564DA4BB0039",
                "type": "Agent",
                "uri": "http://localhost:8090/api/v2/users/4ff5b43c856d4cb2a3d6c20a88740257",
                "visibility": "All",
                "path": "/users/4ff5b43c856d4cb2a3d6c20a88740257",
                "nickname": "TestName",
                "id": "0093564DA4BB0039"
            },
            "timestamp": "2015-11-19 12:30:20.000+0200",
            "visibility": "All",
            "type": "CustomNotice",
            "timestampSeconds": 1447929020000L
        }
    ],
    "notificationType": "NewMessages",
    "messageType": "MessageLogUpdated",
    "chatUri": "http://localhost:8090/api/v2/chats/0000RaB4Q006001F"
}
Comments or questions about this documentation? Contact us for support!