If you want your service to send messages from to Creatio using Beesender, you need to enable message sending in JSON-format for your service.
...
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 |
to Creatio using Beesender |
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 |
Message | yes | |||
clientId | Client identificator | string | no |
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/ |
...
116.png_360.jpg" |
...
}, |
...
"message": |
...
{
...
{ "type": "text", |
...
"text": "Test text" |
...
} |
...
} |
If the request was successful, then 200 OK is returned with the body, for example,
| Code Block | ||
|---|---|---|
| ||
{ |
...
"ok": true |
...
} |
If there are errors, then the text of the error will be indicated in the response body, for example,
| Code Block | ||
|---|---|---|
| ||
{ |
...
"ok": false, |
...
"error": "hook.message.attachment.image can't be empty" |
...
} |