...
The type parameter defines the type of sending message: text, image, file, location. If type == 'text', the text field must be filled in. Same for the rest of types.
SendMessage
Description | Interface for sending messages on Beesender using Creatio |
Path | {HOST}/api/v1.0/sendmessage/{Appid}/{ChannelId} |
Method type | POST |
AppId – your secret key
ChannelId – guid, recieved in test hook
Request Specification
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
sender | Sender | Sender | yes | |
message | Message | Messagee | yes |
Class structure Sender
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
id | Your system’s User Id | string | yes | |
name | Name of your system’s user | string | yes | |
avatar | Your system’s user avatar link | string | yes |
Class structure Message
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
type | Message type | string | yes | Possible values: text, image, file, location |
text | Message text | string | ||
attachment | Attachment | Attachment |
Class structure Attachment
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
image | Image link | string | ||
location | Location | Location | ||
file | File | File |
Class structure Location
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
lat | Latitude | string | ||
lng | Latitude | string |
Class structure File
Name | Description | Data type | Required | Comments |
---|---|---|---|---|
name | File name | string | ||
size | File size | long | In bytes. Not used yet | |
url | File url | string |
Text message sample sent to Creatio:
Code Block |
---|
{ |
...
"sender": |
...
{ |
...
"id": 4, |
...
"name": " |
...
Alex Wilson", |
...
"avatar": |
...
"https://media.fox9.com/media.fox9.com/photo/2018/03/02/5%20P%20MISSING%20DOG%20FOUND%20DEAD_00.00.06.04_1520042792006.png_5029487_ver1.0_640_360.jpg" |
...
}, |
...
"message": |
...
{ |
...
"type": "text", |
...
"text": "Test text" |
...
} |
...
} |
...
If the request was successful, then 200 OK is returned with the body, for example, |
...
{ |
...
"ok": true |
...
} |
...
If there are errors, then the text of the error will be indicated in the response body, for example, |
...
{ |
...
"ok": false, |
...
"error": "hook.message.attachment.image can't be empty" |
...
} |