Описание
Наш сервис предоставляет доступ к API для подключения сторонних приложений к чат-боту. Подключение через API имеет некоторые ограничения: во-первых, отсутствует сохранение чатов, а во-вторых нельзя настроить "действия при отсутствии оператора"
Для отправки вопроса боту используется POST запрос по адресу https://chatandbot.com/api/ с следующими параметрами:
1. test=”-1” – константа
2. bid – константа (Значение можно узнать в настройках бота)
3. key- константа (Это ключ доступа к роботу. Значение можно узнать в настройках бота. Для избегания несанкционированного доступа, держите его в секрете.)
4. pid= “0000000000” – начальное значение (Для продолжения диалога необходимо переписывать при каждом ответе. Значение “0000000000” означает начало нового диалога)
5. ask=”” – ваш вопрос
В качестве ответа приходит текст в формате JSON с двумя параметрами:
1. reply – ответ чат-бота
2. pid-идентификатор диалога для перезаписи pid
Если у робота нет ответа или если Вы превысили лимиты тарифа тогда reply=”” , pid=””
Пример кода в JQuery.
1. Создаем HTML форму с одной кнопкой и двумя текстовыми полями.
<input type="text" id="reply" style="width:100px;">
<input type="text" id="question" style="width:100px;">
<input style="width:100px;" type="button" id="send_button" value="click!">
2. Пишем JS код
<script type="text/javascript">
var test_global='-1';
var bid_global=1234567891234567; /*из настроек робота в личном кабинете */
var key_global='edac7ab83b0f8bf29b4284ae4c8e6f33526f3371'; /*из настроек робота в личном кабинете */
var pid_global='0000000000';
var reply=$('#reply'); /*поле для ответа*/
var question = $('#question'); /*поле для вопроса*/
var send_button = $('#send_button'); /*кнопка для отправки запроса*/
/*обрабатываем нажатие кнопки*/
send_button.click(function () {
var result=getApiAnwser(question.val());/*отправляем вопрос роботу*/
var getobj= $.parseJSON(result); /*превращаем ответ в объект JSON*/
reply.val(getobj.reply); /*получаем из объекта ответ робота*/
pid_global=getobj.pid; /*перезаписываем pid*/
});
function getApiAnwser(ask) {
var ret;
$.ajax({
dataType: "text",
type: "POST",
url: "https://chatandbot.com/api/",
async: false,
data: {test: test_global, pid: pid_global, ask: ask, bid: bid_global, key: key_global},
success: function (result) {
ret = result;
}
});
return ret;
}
</script>