Как создать бота в ТамТам: PrimeBot, API и первый ответ

Бот в TamTam создаётся через PrimeBot, после чего программа получает события из Bot API и отправляет ответы. Нужны аккаунт, токен нового бота и компьютер или сервер для обработчика. Профиль без программы отвечать не сможет.

Какой результат собрать первым

Первый проверяемый результат лучше ограничить командой /start и одним ответом. Не добавляйте сразу ИИ, базу клиентов и оплату. Сначала докажите, что токен принадлежит нужному боту, событие приходит в программу, а ответ возвращается в тот же диалог.

• Исходные условия: рабочий аккаунт TamTam, доступ к PrimeBot, среда для запуска Python и стабильный интернет.
• Ожидаемый результат: пользователь открывает бота, запускает диалог и получает одно предсказуемое сообщение.
• Обязательные шаги: создать профиль, сохранить токен, проверить метод /me, выбрать способ получения событий, запустить обработчик и пройти тест.
• Проверка: ответ приходит один раз, неизвестный текст не ломает процесс, перезапуск не раскрывает токен.
• Частые сбои: неверный токен, два получателя событий одновременно, неправильный user_id, остановленный процесс или недоступный webhook.
• Ограничение: официальный API требует программного обработчика; эта инструкция не превращает TamTam в визуальный конструктор без кода.

Правило запуска: сначала /me, затем получение одного события, затем один ответ. Если перескочить через слой, одинаковое молчание бота может скрывать три разные причины.

Создайте бота через PrimeBot

В официальной OpenAPI-схеме TamTam PrimeBot назван основным ботом для создания и редактирования ботов. После создания он выдаёт access_token, который нужно передавать при обращении к API. Токен равен ключу управления: не вставляйте его в публичный код, скриншот, чат или промпт нейросети.

1. Найдите PrimeBot внутри TamTam и откройте его профиль из официального клиента.
2. Запустите диалог и выберите создание нового бота.
3. Задайте понятное имя и свободное короткое имя.
4. Добавьте описание, которое объясняет одно действие бота.
5. Получите токен и сразу сохраните его в переменной окружения на рабочем устройстве.
6. Не добавляйте бота в общий чат, пока личный диалог не прошёл проверку.

Сравните путь с инструкциями по боту в Telegram и по боту в MAX. Выбирайте платформу, где уже находится аудитория.

По теме: Как создать бота в Яндексе: Мессенджер или Алиса

Проверьте токен без запуска сценария

Метод GET /me возвращает сведения о текущем боте, определённом по токену. Этот способ проверки описан в официальной OpenAPI-схеме TamTam. Не публикуйте фактический ответ, если в нём есть служебные идентификаторы, которые не нужны читателям или поддержке.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install requests
export TAMTAM_TOKEN='вставьте_токен_локально'

Создайте файл check_bot.py. Пример читает секрет из окружения, а не из кода. Он проверяет HTTP-ответ и печатает только имя и признак бота:

import os
import requests

token = os.environ["TAMTAM_TOKEN"]
response = requests.get(
    "https://botapi.tamtam.chat/me",
    params={"access_token": token},
    timeout=20,
 )
response.raise_for_status()
data = response.json()
print({"name": data.get("name"), "is_bot": data.get("is_bot")})

Запустите python check_bot.py. Успех означает только, что токен принят и относится к ожидаемому профилю. Он ещё не доказывает получение сообщений. Код 401 указывает на проблему аутентификации, а 429 означает превышение числа запросов; эти коды перечислены в официальной документации API.

Выберите long polling или webhook

TamTam поддерживает два способа получать обновления: long polling через /updates и push-уведомления через WebHook. Официальная документация предупреждает, что оба способа нельзя использовать одновременно. Для первого локального теста выбирайте long polling, потому что ему не нужен публичный адрес. Webhook нужен для постоянного сервера и предсказуемой доставки.

• Long polling подходит для локальной разработки, проверки команды и небольшого теста. Процесс сам периодически запрашивает обновления.
• Webhook подходит для постоянной работы на сервере. TamTam отправляет событие на ваш HTTPS-адрес, а обработчик должен вернуть 200 OK.
• Если включён webhook, /updates не является запасным параллельным каналом. Сначала удалите подписку штатным методом, потом возвращайтесь к long polling.
• Если webhook долго не отвечает успешно, доставка повторяется, а подписка может быть отменена. Поэтому до подключения нужен рабочий адрес и журнал ошибок.

Официальный Java-клиент находится в репозитории tamtam-chat/tamtam-bot-api. Его описание подтверждает, что для каждого бота нужен свой ACCESS_TOKEN, а библиотека даёт доступ к методам API. Библиотека не заменяет сценарий: правила ответов всё равно задаёте вы.

Составьте карту диалога до кода

Минимальная карта защищает от бесконечного эхо и тупиков. Для сервисного бота достаточно четырёх состояний:

1. Старт: бот коротко сообщает назначение и доступные команды.
2. Помощь: команда /help повторяет список действий.
3. Обычный текст: бот подтверждает получение, но не обещает обработку, которой нет.
4. Неизвестное событие: программа записывает его тип без текста сообщения и продолжает работу.
5. Безопасный выход: команда администратора останавливает тестовый процесс локально, а не через общий чат.

По теме: Сбер ИИ-агенты: как создать агента на GigaChat

Запустите получение событий и первый ответ

Для минимального long polling в цикле вызывайте GET /updates с параметрами access_token, текущим marker, limit и timeout. Из события bot_started возьмите user.user_id, затем отправьте заранее заданный текст запросом POST /messages с тем же токеном, параметром user_id и JSON-телом {"text":"Бот работает"}. После успешного ответа сохраните новый marker для следующего цикла.

Для безопасного прототипа обработчик должен принимать только bot_started и текстовую команду /start. Не делайте эхо любого входящего текста в рабочем чате: оно может вернуть человеку приватные данные, которые он отправил по ошибке. Отправляйте заранее заданный ответ.

1. Запустите процесс long polling в отдельном тестовом окружении.
2. Откройте личный диалог с ботом и нажмите запуск.
3. Убедитесь, что журнал получил тип события и идентификатор диалога, но не печатает токен.
4. Отправьте /start и дождитесь одного заранее заданного ответа.
5. Повторите тест с неизвестным текстом и проверьте безопасную подсказку.
6. Остановите процесс, запустите снова с сохранённым маркером и убедитесь, что старый ответ не дублируется.

Проверочный чек-лист перед добавлением в чат

• Токен отсутствует в исходниках, истории команд, скриншотах и логах.
• Метод /me показывает ожидаемое имя бота.
• Работает только один способ получения событий.
• Каждое входящее событие обрабатывается не больше одного раза.
• Неизвестный текст получает нейтральную подсказку.
• Ошибка API записывается без токена и содержимого личных сообщений.
• После остановки процесс можно запустить без потери понятного состояния.
• В групповом чате бот имеет только необходимые права.

По теме: Комментарии в MAX: как настроить бота для канала

Диагностика по симптому

• 401: токен неверен или отозван. Получите новый через PrimeBot и замените значение окружения.
• 429: запросов слишком много. Уменьшите частоту, не запускайте несколько копий обработчика и учитывайте повторные попытки.
• /me работает, но событий нет: проверьте активную webhook-подписку и убедитесь, что второй процесс не забирает обновления.
• Событие приходит, ответа нет: отдельно проверьте user_id или chat_id, тело запроса и HTTP-код метода отправки.
• Ответы дублируются: сохраняйте и передавайте marker, затем ищите второй экземпляр процесса.
• Webhook отключается: проверьте публичный HTTPS-адрес и возврат 200 OK; не открывайте случайный порт без настройки защиты.

Если токен мог попасть постороннему, не пытайтесь выяснить, воспользовались ли им. Отзовите его через PrimeBot, получите новый, замените секрет в окружении и перезапустите только нужный процесс.

Когда этот способ не подходит

TamTam Bot API не подходит, если вы не готовы поддерживать работающую программу или сервер. Для простой формы обратной связи может хватить сайта. Для визуальной сборки сценариев без кода выбирайте конструктор, который официально поддерживает нужный мессенджер, и отдельно проверяйте, кому передаётся токен.

Частые вопросы

Можно ли создать бота TamTam без программирования?

Профиль через PrimeBot создать можно, но для автоматических ответов нужен обработчик или сторонний конструктор с подтверждённой поддержкой TamTam.

Что выбрать для первого теста: webhook или long polling?

Long polling. Он не требует публичного сервера. После проверки сценария переносите обработчик на webhook, если нужен постоянный запуск.

Можно ли отправить токен разработчику в чате?

Нет. Создайте защищённый способ передачи секрета или отдельный тестовый бот. При подозрении на утечку сразу отзовите токен.

Почему бот молчит после создания?

Потому что профиль и программа являются разными слоями. Проверьте /me, получение события и отправку ответа по очереди.