Начиная с релиза 5.7.1-1 в систему AutoFAQ можно подключить eXpress messenger (https://express.ms/ ) как канал.
Создание канала в AutoFAQ
Для настройки канала понадобятся Идентификатор бота и специальный ключ доступа:
Создание бота
Подробно про создание бота на вашем сервере eXpress написано в руководстве https://express.ms/admin_guide.pdf.
Кратко схема выглядит следующим образом:
В панели администратора нужно создать нового бота по кнопке
Create Bot
Заполнить все поля на странице создания.
Пункт 1 - указываем идентификатор бота с приставкой _bot, например autofaq_bot
Пункт 2- адрес сервера с адрес сервера с express-adapter, https://адрес_сервера_АФ/express-adapter ,например https://chat.autofaq.ai/express-adapter
Пункт 3- имя бота
Пункт 4 - описание бота
После сохранения нового бота на странице бота нужно скопировать значение
IDи вставить его в полеИдентификатор ботав канал AutoFAQ.
Генерация ключа доступа
Для генерации ключа доступа нужно воспользоваться инструкцией по ссылке https://docs.express.ms/chatbots/developer-guide/development-and-debugging/interaction-with-bot-api-and-botx-api/ - раздел Получение токена чат-бота. Секретный ключ также отображается на странице бота и параметр называется Secret key:
Шаг 1. Генерируем подпись, выполнив команду в терминале:
echo "bot_id secret_key" | python3 -c "import base64, hmac, hashlib; bot_id, secret_key = input().split(); signed_bot_id = hmac.new(key=secret_key.encode(), msg=bot_id.encode(), digestmod=hashlib.sha256).digest(); print(base64.b16encode(signed_bot_id).decode())"
Здесь нужно заменить bot_id и secret_key на ваши значения. В результате вы получите подпись вида ниже, которую надо использовать на следующем шаге.
A72AA7733868C............DE96EB33428E59
Шаг 2. Через терминал нужно вызвать API метод по шаблону ниже для генерации финального ключа доступа.
curl '$express_server/api/v2/botx/bots/$bot_id/token?signature=$signature'
$express_server - ваш адрес сервера eXpress
$bot_id- Идентификатор бота
$signature - Подпись из шага 1.
В итоге у вас должна получиться примерно следующая команда,
curl 'https://expr.autofaq.ai/api/v2/botx/bots/ef563e86-c0d683db/token?signature=8C9E3E66293649E081'
результатом выполнения которой будет нужный ключ в поле result:
{"result":"STY.g2gDbQA...FiAAFRgA.533...0aUZg","status":"ok"}
Скопируйте его значение и вставьте в поле Ключ доступа в канале AutoFAQ, активируйте канал и сохраните изменения.
Начало переписки с ботом
Для начала переписки найдите бота по имени в контактах и напишите свой вопрос:
В первой версии не поддерживаются чаты, инциированные оператором, а также обмен стикерами.