UAEN
Завантажити
На головну

Для розробників

Боти у Squeek

Бот — це акаунт, за який відповідає програма. Він є в пошуку, йому можна написати, його можна додати в групу чи канал. Тут — як створити бота з телефона й запустити його за кілька хвилин.

Створити бота в застосунку

  1. Відкрийте «Профіль» → «Мої боти».
  2. Натисніть «Створити бота». Введіть ім’я — так бота бачитимуть у чатах, наприклад Погода, — і нікнейм: латиницею, обов’язково з bot наприкінці, наприклад weather_bot.
  3. Натисніть «Створити». З’явиться вікно з токеном — довгий рядок вигляду 7:a91f…:3c0d…. Натисніть «Поділитися» і надішліть його собі (в «Обране», на пошту — куди завгодно) або скопіюйте довгим натисканням.

Бот уже існує: він є в пошуку як @weather_bot з позначкою «бот», йому можна написати, його можна додати в групу або канал.

Запустити бота на Node.js

Програма, яка відповідатиме за бота, працює на вашому комп’ютері або сервері. Потрібен Node.js і бібліотека squeek-bot.

bash
mkdir my-bot && cd my-bot && npm init -y && npm install squeek-bot

Створіть файл bot.js:

bot.js
const { SqueekBot } = require('squeek-bot');

const bot = new SqueekBot('7:a91f…:3c0d…'); // токен із застосунку

bot.on('message', async (msg) => {
  console.log(msg.from.name, ':', msg.text);
  if (msg.text === '/hi') await msg.reply('Привіт! 🐀');
});

bot.on('connected', () => console.log('бот онлайн'));

bot.start();
bash
node bot.js

Тепер напишіть боту /hi із застосунку — він відповість.

  • message — вхідне повідомлення. У msg.from.name — хто написав, у msg.text — текст, msg.reply(text) відповідає в той самий чат.
  • connected — бот під’єднався до сервера.
  • bot.start() — відкриває з’єднання і починає отримувати повідомлення.

Постити в канал без бібліотеки

Якщо бот лише публікує в канал, бібліотека не потрібна. Додайте бота адміністратором каналу і зробіть два HTTP-запити з будь-якої мови.

Токен складається з трьох частин, розділених двокрапкою: botId:…:secret. Для входу потрібні перша (botId) і третя (secret).

Отримати accessToken
curl https://api.squeek.net/auth/bot \
  -H 'content-type: application/json' \
  -d '{"botId":7,"secret":"3c0d…"}'

У відповіді буде accessToken. Далі — повідомлення в канал, де chatId — ідентифікатор каналу:

Надіслати повідомлення
curl https://api.squeek.net/messages \
  -H "authorization: Bearer <accessToken>" \
  -H 'content-type: application/json' \
  -d '{"chatId":17,"content":"Привіт, канале"}'