Цей модуль допоможе інтегрувати 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 id користувача
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)
dialog_name string ім’я чату для відображення в ОП

Відправка повідомлення на сервер стороннього застосунку

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

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