HTTP-интерфейс для ботов мессенджера Chatto. Он устроен так же, как Telegram Bot API: большинство библиотек и привычных приёмов переносятся с минимальными правками.
Откройте в Chatto @botstudio и нажмите «Создать бота». Адрес бота должен заканчиваться на bot.
2
Получите токен
Токен вида 123:AbC… находится в настройках бота. Храните его как пароль.
3
Подключите сервер
Получайте обновления через getUpdates или вебхук и отвечайте методом sendMessage.
Быстрый старт
Эхо-бот за минуту: получаем сообщения и отвечаем тем же текстом.
# 1. Проверяем токенTOKEN=123:AbCdEf...
curl "https://core.chatto.is/api/v1/bot/$TOKEN/getMe"# 2. Ждём сообщения (long polling до 25 секунд)
curl "https://core.chatto.is/api/v1/bot/$TOKEN/getUpdates?timeout=25"# 3. Отвечаем в чат из message.chat.id
curl -X POST "https://core.chatto.is/api/v1/bot/$TOKEN/sendMessage" \
-H 'Content-Type: application/json' \
-d '{"chat_id": 7, "text": "Привет!"}'
Бот пишет только в чаты, где он участник. Личный чат начинает пользователь — сообщением боту или кнопкой «Запустить» (придёт /start). В группах бот получает команды и сообщения с упоминанием @имя_бота.
Запросы и ответы
Все методы принимают GET и POST: параметры в строке запроса, application/json или form-data.
Два способа — выберите один. Пока установлен вебхук, getUpdates возвращает ошибку 409.
Long polling
Вызывайте getUpdates в цикле с timeout=25 и offset, равным последнему update_id + 1. Удобно при разработке — не нужен публичный адрес.
Вебхук
После setWebhook Chatto отправляет каждое обновление POST-запросом на ваш HTTPS-адрес с заголовком X-Chatto-Bot-Api-Secret-Token. Ответьте кодом 2xx, иначе доставка повторится.
Кнопки под сообщениями
reply_markup.inline_keyboard — до 10 рядов по 8 кнопок. Кнопка открывает ссылку, мини-приложение или присылает боту callback_query.
После нажатия кнопки с callback_data у пользователя показывается индикатор загрузки, пока бот не ответит answerCallbackQuery. На ответ — 5 секунд.
Виджеты
Карточка из блоков, которую Chatto рисует нативно на iPhone и компьютере: погода, статус заказа, курсы, счёт матча, статистика. Отправляется методом sendWidget, обновляется editMessageWidget. Кнопки — обычный reply_markup.
Собирайте карточку в конструкторе виджетов: шаблоны, живое превью и готовый код запроса.
title, subtitle, icon, image — шапка; картинка справа растворяется в фоне
hero
value (крупно), icon, title, subtitle, color
stats
items[] до 4: icon, label, value, color
columns
items[] до 8: title, icon, value, subtitle, highlight
list
items[] до 12: icon или image, title, subtitle, value, value_color
text
text, style: body | title | muted | caption, align
image
image (https или file_id), aspect 0.5–3, caption
progress
label, text, value 0…1, color
chips
items[]: строка или {text, icon, color}
divider, spacer
линия; отступ size: s | m | l
Иконки — эмодзи или имена: sun, moon, sun_cloud, cloud, rain, storm, snow, wind, drop, umbrella, location, clock, calendar, star, fire, check, warning, money, chart_up, chart_down, gift, game, trophy, bell, box, truck, phone и другие (полный список — в конструкторе). Цвета — #rrggbb или accent, green, red, orange, yellow, blue, purple, gray.
Картинки Chatto скачивает к себе при отправке (до 6 на карточку, кэш на сутки): у пользователей не пропадут, а ваш сервер не увидит их адреса. Старые версии приложений покажут вместо карточки поле text.
Отправка файлов
Фото, видео, голосовые, кружки, документы и альбомы. Файл в методах sendPhoto, sendVideo, sendDocument и других можно передать тремя способами.
Способ
Как передать
Загрузка
Запрос multipart/form-data, файл — в поле с именем параметра (photo, document…). До 100 МБ.
Ссылка
HTTP(S)-адрес — Chatto скачает файл сам. До 50 МБ, только публичные адреса.
file_id
Идентификатор файла, который бот уже отправлял или получал, — повторная отправка без загрузки.
# Загрузка файла с диска
curl -X POST "https://core.chatto.is/api/v1/bot/$TOKEN/sendPhoto" \
-F chat_id=7 \
-F photo=@sunset.jpg \
-F caption="Закат над морем"# Альбом: файлы — через attach://имя
curl -X POST "https://core.chatto.is/api/v1/bot/$TOKEN/sendMediaGroup" \
-F chat_id=7 \
-F media='[{"type":"photo","media":"attach://one","caption":"Офис"},{"type":"photo","media":"attach://two"}]' \
-F one=@office-1.jpg -F two=@office-2.jpg
Получение файлов
Когда пользователь присылает боту файл, в message приходит одно из полей photo, video, video_note, voice, audio, document, а подпись — в caption (поле text бывает только у текстовых сообщений). Если вложений несколько, полный список — в поле media.
# Python — скачать присланное фото
photo = msg["photo"][-1]
info = api("getFile", file_id=photo["file_id"])["result"]
data = requests.get(f"{BASE}/file/bot{TOKEN}/{info['file_path']}").content
open("photo.jpg", "wb").write(data)
Бот может переслать полученный файл по file_id в любой свой чат. Файлы из секретных чатов ботам недоступны — они зашифрованы на устройствах.
Mini Apps
Веб-приложения, которые открываются прямо в Chatto: магазины, сервисы, формы, игры. API совместим с Telegram Web Apps — код, написанный под Telegram.WebApp, работает без правок.
Как открыть мини-приложение
Способ
Как настроить
Кнопка меню
setChatMenuButton с type: "web_app" — кнопка слева от поля ввода в чате с ботом
Кнопка под сообщением
{"text": "Каталог", "web_app": {"url": "https://…"}} в inline_keyboard
Профиль бота
setMainWebApp — кнопка «Открыть приложение» в профиле
Ссылка
https://chatto.is/app/имя_бота?startapp=promo — параметр придёт в initDataUnsafe.start_param
Подключение SDK
Внутри Chatto SDK подключается автоматически. Добавьте его явно, чтобы страница работала и в обычном браузере:
<script src="https://chatto.is/js/chatto-web-app.js"></script>
<script>
const app = window.Chatto.WebApp; // то же, что window.Telegram.WebApp
app.ready();
app.MainButton.setText('Купить за 990 ₽').show().onClick(() => {
app.HapticFeedback.impactOccurred('medium');
fetch('/api/order', { method: 'POST', body: app.initData }); // проверьте подпись на сервере
});
</script>
Возможности SDK
API
Описание
initData
Подписанные данные запуска: user, query_id, start_param, auth_date, hash
themeParams
Цвета приложения и CSS-переменные --tg-theme-bg-color, --tg-theme-text-color, --tg-theme-button-color и другие
Нативные окна до трёх кнопок; также showAlert и showConfirm
showScanQrPopup
Встроенный сканер QR-кодов
CloudStorage
Хранилище «ключ — значение» для пары бот и пользователь: до 1024 ключей, значения до 4096 символов
sendData
Строка до 4096 байт боту — придёт как message.web_app_data, приложение закроется
openLink
Открыть ссылку в браузере; openChattoLink — ссылку Chatto внутри приложения
прочее
readTextFromClipboard, expand, close, enableClosingConfirmation, setHeaderColor, setBackgroundColor — как в Telegram
Проверка initData на сервере
Не доверяйте initDataUnsafe — проверяйте подпись. Алгоритм такой же, как в Telegram: secret = HMAC_SHA256(key="WebAppData", data=токен), затем hash = hex(HMAC_SHA256(key=secret, data=data_check_string)), где data_check_string — все поля, кроме hash, в виде ключ=значение, отсортированные по алфавиту и соединённые символом \n.
# Pythonimport hmac, hashlib
from urllib.parse import parse_qsl
def check(init_data: str, token: str) -> bool:
data = dict(parse_qsl(init_data))
received = data.pop("hash", "")
check_string = "\n".join(f"{k}={v}"for k, v in sorted(data.items()))
secret = hmac.new(b"WebAppData", token.encode(), hashlib.sha256).digest()
return hmac.compare_digest(hmac.new(secret, check_string.encode(), hashlib.sha256).hexdigest(), received)
Не хотите считать HMAC самостоятельно — вызовите validateWebAppData. Живой пример — демо мини-приложение; в Chatto оно открывается кнопкой «Демо Mini App» в @botstudio.
Long polling: возвращает накопившиеся обновления. Обновления с id меньше offset считаются подтверждёнными и удаляются. Не работает, пока установлен вебхук.
Параметр
Тип
Описание
offset необязательный
Integer
id первого нужного обновления (последний полученный update_id + 1)
Отправить карточку-виджет: Chatto рисует её нативно (погода, заказ, курс, матч). text — подпись для списка чатов и уведомлений; без него соберётся из шапки.
Параметр
Тип
Описание
chat_id обязательный
Integer
id чата
widget обязательный
Widget
Блоки карточки — объект или JSON-строка
text необязательный
String
Текст для превью и уведомлений
reply_markup необязательный
InlineKeyboardMarkup
Кнопки под карточкой (style: primary — залитая акцентом)
Альбом: до 10 фото, видео, файлов или аудио одним сообщением. Для загрузки укажите attach://имя и передайте файл в поле multipart с этим именем. Подпись альбома — caption первого элемента.
«Что умеет этот бот?» — показывается в пустом чате перед «Запустить».
Параметр
Тип
Описание
description необязательный
String
До 512 символов
curl -X POST "https://core.chatto.is/api/v1/bot/$TOKEN/setMyDescription" \
-H 'Content-Type: application/json' \
-d '{
"description": "Прогноз погоды на неделю для любого города"
}'
import requests
r = requests.post(
f"{BASE}/bot/{TOKEN}/setMyDescription",
json={
"description": "Прогноз погоды на неделю для любого города"
},
)
print(r.json())
const r = await fetch(`${BASE}/bot/${TOKEN}/setMyDescription`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"description": "Прогноз погоды на неделю для любого города"
}),
});
console.log(await r.json());
curl -X POST "https://core.chatto.is/api/v1/bot/$TOKEN/setMyShortDescription" \
-H 'Content-Type: application/json' \
-d '{
"short_description": "Погода в любом городе"
}'
import requests
r = requests.post(
f"{BASE}/bot/{TOKEN}/setMyShortDescription",
json={
"short_description": "Погода в любом городе"
},
)
print(r.json())
const r = await fetch(`${BASE}/bot/${TOKEN}/setMyShortDescription`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"short_description": "Погода в любом городе"
}),
});
console.log(await r.json());