Send External Chat Message

User Guide > Resources > Send External Chat Message

This request posts a message to an external chat session created by an external chat gateway.

Resource

POST https://<HOST>/portal/chat/<TENANT>/gateways/<GATEWAY_ID>/sessions/<SESSION_ID>/messages

Where 'GATEWAY_ID' is the id of the gateway and 'SESSION_ID' is the id of the session.

Parameters

None

Payload

External Chat Contents

Response

External Chat Message

The External Chat Message object contains the chat contents and the object ID.

Context

Authorization

Authorized by token:
The Xelion token should be send in the Authorization header.

Errors

Common Errors

HTTP code Description

400

Missing tenant, gateway id or chat contents

500

General error, gateway not found, session not found or not linked to this gateway, message is too long

Example

Request
POST https://xelion.nl/portal/chat/master/gateways/1234567/sessions/2045858/messages
Payload
{
     "text": "hello"
}
Response
{
    "id": "2045886",
    "contents": "hallo",
    "creatorName": "peter",
    "date": "2022-10-14 12:08:23",
    "incoming": true,
    "read": false,
    "forwarded": false
}