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"

...


}