Versions Compared

Old Version 2

changes.mady.by.user Сергей Ходусов

Saved on

compared with

New Version 3

changes.mady.by.user Сергей Ходусов

Saved on

Key

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

...

ПараметрЗначениеКомментарий
МетодPOST
Путь/api/v1/auth/login/basic/default
Запрос
ПараметрТипОбязательныйКомментарий

email

StringДа

Данные учетной записи в бот-платформе,

использующейся для авторизации чат-платформы

password

StringДа

Данные учетной записи в бот-платформе,

использующейся для авторизации чат-платформы


Ответ
ПараметрТипОбязательныйКомментарий

status

StringНетСтатус запроса. Если все хорошо, то success

message

StringНет

Описание статуса запроса

Если все хорошо, то значение будет Login successful

payload



Блок

jwt

StringДаТокен доступа

exp

StringДаВремя жизни токена

Пример запроса:


Code Block
languagejs
{
"email": "superbot@bot.ru",
"password": "password"
}

Пример ответа:


Code Block
languagejs
Отправка сообщения в бот-платформу
ПараметрЗначениеКомментарий
МетодPOST
Путьapi/v1/bots/chat-bank/converse/sid/secured
botID - идентификатор чат-бота в бот-платформе
sid - уникальный идентификатор сессии для текущего диалога
АвторизацияBearerТокен берем из ответа на запрос авторизации
Запрос
ПараметрТипОбязательныйКомментарий
typestringдаПо умолчанию всегда "text"
text
stringдаТекст сообщения
payloadstringНетПри использовании кнопок или выпадающего списка заполняется значением из payload выбранного элемента

Ответ
ПараметрТипОбязательныйКомментарий
type
stringДаТип сообщения. Может быть text, card, carousel, single-choice, 
text
stringДаТекст сообщения
groupidstringНетПереадресация на группу операторов
operatoridstringНетПереадресация на оператора
closedialogbooleanНетЗакрытие диалога
isDropdownbooleanНетПризнак выпадающего списка (при type = singlechoice). Если TRUE - отображается выпадающий список, если FALSE - кнопки.
dropdownPlaceholderstringНетЗаглушка/значение по умолчанию для выпадающего списка
skillstringНетТип навыка
title
stringНетЗаголовок для картинки
image
stringНетСсылка на картинку
choicesБлокДа (при "type": "single-choice")
Список значений для кнопок или выпадающего списка
НаименованиеТипОбязательностьКомментарий
titlestringДаНазвание пункта
valuestringДаЗначение
actions
БлокДа, при "type": "card"
Список действий
НаименованиеТипОбязательностьКомментарий
title
stringДаНазвание кнопки
action
stringДа
Действие. Может быть:
Postback
URL
payload
stringДаЗначение - передается боту при нажатии на кнопку
items
БлокДа, при 
"type": "carousel"
Список объектов actions

Пример запроса:
 Code Block
languagejs
{	
	"type": "text",     
	"text": "До которого часа работает банк?" 
}
Пример ответа:
 Code Block
languagejs
{
    "responses": [
        {
            "type": "text",
            "text": "Переключаю вас на оператора",
            "markdown": true,
            "groupid": "100"
        }
    ]
}
...