Этот модуль позволяет вам встраивать Kwizbot в свое приложение или встраивать бота на Kwizbot в другой бот.

Прием и отправка сообщений

Отправка сообщения в Kwizbot

POST https://{{engine_url}}/messengers_host/{{bot_id}}/custom_channel/hooks

Где

Пример тела запроса

{
 "update_id": 498995546,
  "message": {
    "from": {
      "id": "wregw3ergwergwergw==",
      "first_name": "",
      "last_name": "",
      "username": "Наталія",
      "language_code": "uk",
      "is_bot": false,
      "phone": "888888888888”,
      "channel": "viber",
      "dialog_name": "Наталія"
    },
    "chat": {
      "id": "wregw3ergwergwergw==_viber"
    },
    "date": 1696408917974,
    "text": "Київ",
    "type": "text"
  }
}

<aside> 🧑‍💻 Не забудьте что для старта бота нужно отправлять первым сообщением всегда текст /start

</aside>

Детализация запроса

Название Тип данных Количество символов Примечание
update_id int 9 всегда уникальные значения
id int 6 ид пользователя
first_name string 1–64 имя пользователя в операторской панели
last_name string 0–64 фамилия пользователя в операторской панели
username string 5–32 ник пользователя
language_code string 2 допускаются значения: uk\ru\en
chat:id string 6 код чата пользователя
text string 6 текст который передается для начала, допускается значение: /start
type string 4 тип сообщения, допускается значение: text

Отправка сообщения обратно на сервер стороннего приложения

Происходит по URL настроенному в “настройках бота”

Untitled

В каждое сообщение также передается x-access-token указанный в настройках

В итоге ваше приложение получит запрос такого вида

POST /your_url HTTP/1.1
Host: kw.requestcatcher.com
Content-Length: 222
Content-Type: application/json;charset=utf-8
User-Agent: Kwizbot
X-Access-Token: *****
Body:
{
	"reply_markup":{"remove_keyboard":false},
	"chat_id":"398866",
	"text":"Notifications bot\\nMy chat id: 398866,  channel custom_channel",
  "id":"71577138-fe1e-4ce7-b53e-0cec45ee3534",
  "from":"bot",
  "bot_id":71,
  "type":"text"
}

Типы сообщений