Надсилання повідомлень до Creatio

Якщо ви хочете, щоб ваш сервіс відправляв повідомлення з Creatio за допомогою Beesender, вам потрібно увімкнути відправлення повідомлень у форматі JSON для вашого сервісу.

Адреса конектора — це хост, який використовується під час спілкування з Creatio. Це значення можна знайти у системному налаштуванні BeesenderOperatoHost.

Параметр type визначає тип відправленого повідомлення: текст, зображення, файл, місцезнаходження. Якщо type == 'text', поле text має бути заповненим. Те саме стосується інших типів.

SendMessage

Опис	Інтерфейс для надсилання повідомлень на Beesender за допомогою Creatio
Путь	{HOST}/api/v1.0/sendmessage/{Appid}/{ChannelId}
Метод запиту	POST

AppId – ваш секретний ключ
ChannelId – guid, напрям, отриманий в тестовому хуку

Специфікація запиту

Назва	Опис	Тип даних	Необхідно	Коментарі
sender	Sender	string	yes
message	Message	string	yes

Структура класу Sender

Назва	Опис	Тип даних	Необхідно
id	ID користувача вашої системи	string	yes
name	Ім'я користувача вашої системи	string	yes
avatar	Посилання на аватар користувача вашої системи	string	yes

Структура класу Message

Назва

Опис

Тип даних

Необхідно

Коментарі

type

Тип повідомлення

string

yes

Допустимі значення:

text,
image,
file,
location

text

Текст повідомлення

string

attachment

Вкладені файли

Attachment

Структура класу Attachment

Назва	Опис	Тип даних
image	Посилання на зображення	string
location	Місцезнаходження	Location
file	Файл	File

Структура класу Location

Назва	Опис	Тип даних	Необхідно	Коментарі
lat	Широта	string
lng	Довгота	string

Структура класу File

Назва	Опис	Тип даних	Коментарі
name	Назва файлу	string
size	Розмір файлу	long	У байтах. Наразі не використовується
url	Адреса файлу	string

Приклад текстового повідомлення, надісланого до Creatio

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