Telegram Bot API

Telegram Bot API — это интеграция для работы с Telegram через управляемую аутентификацию. Она позволяет отправлять сообщения, изображения, опросы, геолокацию и многое другое через вашего Telegram-бота.

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

Пример запроса для получения информации о боте:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/telegram/:token/getMe')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/telegram/:token/{method}

Плейсхолдер :token автоматически заменяется на токен вашего бота из конфигурации подключения. Параметр {method} необходимо заменить на название метода Telegram Bot API (например, sendMessage или getUpdates).

Аутентификация

Все запросы требуют API-ключ Maton, который передается в заголовке Authorization:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Зарегистрируйтесь или войдите на сайте maton.ai
• Перейдите в раздел настроек (settings)
• Скопируйте свой API-ключ

Управление подключениями

Управление подключениями Telegram-бота осуществляется через панель:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=telegram&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'telegram'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Получение информации о подключении

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Пример ответа:

{
 "connection": {
 "connection_id": "e8f5078d-e507-4139-aabe-1615181ea8fc",
 "status": "ACTIVE",
 "creation_time": "2026-02-07T10:37:21.053942Z",
 "last_updated_time": "2026-02-07T10:37:59.881901Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "telegram",
 "metadata": {}
 }
}

Откройте полученный URL в браузере, чтобы завершить настройку токена вашего бота.