Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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"
}

...