Знакора Bot API — это универсальный интерфейс для управления автоматизированными сценариями. Система полностью построена на POST-запросах, что обеспечивает промышленный стандарт передачи данных и команд.

Быстрый старт

import requests
import time

# 1. Вставьте ваш токен
TOKEN = "ВАШ_ТОКЕН_ЗДЕСЬ"
API_URL = f"https://znakora.ru/api/bot{TOKEN}"

def api(method, data=None):
    try:
        # Все запросы — POST
        return requests.post(f"{API_URL}/{method}", json=data).json()
    except Exception as e:
        print(f"Ошибка соединения: {e}")
        return {}

def main():
    print("🤖 Бот запущен (Python)...")
    api("deleteWebhook") # Переключаемся на Long Polling
    
    while True:
        try:
            # Long Polling запрос (висит до 30 сек)
            updates = api("getUpdates")
            
            if updates.get("ok") and updates.get("result"):
                for update in updates["result"]:
                    
                    # Обработка текстовых сообщений
                    if "message" in update:
                        msg = update["message"]
                        chat_id = msg["chat"]["id"]
                        text = msg.get("text", "")
                        
                        print(f"📩 От {chat_id}: {text}")

                        if text == "/start":
                            # Отправка Inline-клавиатуры
                            keyboard = {
                                "inline_keyboard": [[
                                    {"text": "❤️ Лайк", "callback_data": "like"},
                                    {"text": "🌍 Сайт", "url": "https://google.com"}
                                ]]
                            }
                            api("sendMessage", {"chat_id": chat_id, "text": "Привет! Выберите действие:", "reply_markup": keyboard})
                        
                        elif text == "Меню":
                            # Отправка обычной клавиатуры
                            reply_kb = {
                                "keyboard": [[{"text": "Помощь"}, {"text": "Настройки"}]],
                                "resize_keyboard": True
                            }
                            api("sendMessage", {"chat_id": chat_id, "text": "Меню открыто.", "reply_markup": reply_kb})

                    # Обработка нажатий на кнопки (Callback)
                    if "callback_query" in update:
                        cb = update["callback_query"]
                        cb_id = cb["id"]
                        data = cb["data"]
                        chat_id = cb["message"]["chat"]["id"]
                        msg_id = cb["message"]["message_id"]

                        print(f"🔘 Кнопка: {data}")

                        # ВАЖНО: Ответ на callback, чтобы убрать "часики"
                        api("answerCallbackQuery", {"callback_query_id": cb_id, "text": "Принято!"})

                        if data == "like":
                            api("editMessageText", {
                                "chat_id": chat_id, 
                                "message_id": msg_id, 
                                "text": "Спасибо за ваш лайк! 👍"
                            })

        except Exception as e:
            print(f"Критическая ошибка: {e}")
            time.sleep(5)

if __name__ == "__main__":
    main()

const axios = require('axios');

// 1. Вставьте ваш токен
const TOKEN = 'ВАШ_ТОКЕН_ЗДЕСЬ';
const API_URL = `https://znakora.ru/api/bot${TOKEN}`;

async function api(method, data = {}) {
    try {
        const res = await axios.post(`${API_URL}/${method}`, data);
        return res.data;
    } catch (e) {
        console.error('Ошибка API:', e.message);
        return {};
    }
}

async function startBot() {
    console.log('🤖 Бот запущен (Node.js)...');
    await api('deleteWebhook'); // Long Polling

    while (true) {
        try {
            const updates = await api('getUpdates'); // Висит до 30 сек
            
            if (updates.ok && updates.result) {
                for (const update of updates.result) {
                    
                    // Сообщения
                    if (update.message) {
                        const msg = update.message;
                        const chatId = msg.chat.id;
                        const text = msg.text;

                        console.log(`📩 Msg: ${text}`);

                        if (text === '/start') {
                            await api('sendMessage', {
                                chat_id: chatId,
                                text: 'Привет из Node.js!',
                                reply_markup: {
                                    inline_keyboard: [[
                                        { text: '🔥 Круто', callback_data: 'cool' }
                                    ]]
                                }
                            });
                        }
                    }

                    // Кнопки
                    if (update.callback_query) {
                        const cb = update.callback_query;
                        console.log(`🔘 Callback: ${cb.data}`);

                        // ВАЖНО: Ответ на callback
                        await api('answerCallbackQuery', { 
                            callback_query_id: cb.id,
                            text: 'Обработано!'
                        });

                        if (cb.data === 'cool') {
                            await api('editMessageText', {
                                chat_id: cb.message.chat.id,
                                message_id: cb.message.message_id,
                                text: 'Рад, что понравилось! 🎉'
                            });
                        }
                    }
                }
            }
        } catch (e) {
            console.log('Ошибка пулинга, повтор через 3с...');
            await new Promise(r => setTimeout(r, 3000));
        }
    }
}

startBot();

Справочник API

POST /getUpdates

Используется для получения новых сообщений методом Long Polling. Запрос удерживается сервером до 30 секунд, если нет новых данных.

Возвращает: Array<Update>

POST /sendMessage

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

chat_id (int, required) — ID получателя.
text (string, required) — Текст сообщения.
reply_markup (object) — Inline или Reply клавиатура.

POST /sendPhoto

Отправка изображения. Используйте multipart/form-data.

chat_id (int, required)
photo (file, required) — Файл изображения.
caption (string) — Подпись к фото.

POST /editMessageText

Изменение текста ранее отправленного сообщения.

message_id (string, required) — ID сообщения для редактирования.
text (string, required) — Новый текст.
reply_markup (object) — Новая клавиатура.

POST /answerCallbackQuery

Обязательный метод для ответа на нажатие Inline-кнопки. Убирает индикатор загрузки у пользователя.

callback_query_id (string, required) — ID из полученного `callback_query`.
text (string) — Текст всплывающего уведомления (опционально).

POST /deleteMessage

Удаление сообщения.

message_id (string, required) — ID сообщения.

Оформление

Внешний вид

Цветовая тема

Размер текста

A A

Форма сообщений

Размер текста в чате

A A

Пример сообщения в чате

Галочки сообщений

Доставлено

Прочитано

Эффекты

Мягкая подложка Анимации сообщений

Бизнес-аккаунтВсе тарифы

Доступен в «Базовом», «Стандарте» и «Про».

✓ Галочка «Компания» во всей Знакора ✓ Логотип, описание, категории и услуги ✓ Сайт, адрес, телефон, e-mail и график ✓ Один профиль в вебе и приложении

Включение и отключение — не чаще одного раза в 14 дней.

Выберите план

Базовый

59 ₽

1 месяц

—

ХИТ

Стандарт

109 ₽

3 месяца

−38%

Про

599 ₽

6 месяцев

−28%

Разовая оплата через ЮKassa · Автопродление не подключается
Условия возврата — в Пользовательском соглашении

Ближе к людям.
Спокойнее к общению.

Создайте аккаунт

Подтвердите почту

Восстановить доступ

Проверьте почту

Подтвердите вход

Новый пароль

В пространстве между людьми рождаются слова

Поиск в разговоре

Стикеры

Собеседник

Доступ ограничен

Аккаунт временно заблокирован

Ближе к людям.Спокойнее к общению.

С возвращением

Создайте аккаунт

Подтвердите почту

Восстановить доступ

Проверьте почту

Подтвердите вход

Новый пароль

В пространстве между людьми рождаются слова

Быстрый старт

Справочник API

Аккаунт

Чёрный список

Оформление

Память и хранилище

Участники

Активные сеансы

Доступ ограничен

Оформление чата

Ваш фон

Общий фон разговора

Знакора — полноценный мессенджер

Новое приложение Знакора!

Аккаунт временно заблокирован

Ближе к людям.
Спокойнее к общению.