Чат-бот в ТамТам создаётся не внутри самого приложения, а через специального бота-регистратора — Masterbot (@masterbot), который выдаёт уникальный токен доступа к Bot API мессенджера. Именно с поиска этого бота в поиске контактов и начинается вся настройка: без токена ни один конструктор или самописный скрипт не сможет подключиться к платформе.
ТамТам — российский мессенджер с открытым Bot API, который позволяет бизнесу и разработчикам автоматизировать общение с клиентами: рассылать уведомления, отвечать на типовые вопросы и собирать заявки. В этой статье разберём, как зарегистрировать бота, какие способы реализации доступны и как избежать типичных ошибок при подключении.
Что умеют боты в ТамТам
Боты в мессенджере работают примерно так же, как в других платформах: пользователь находит бота по имени, начинает диалог и взаимодействует через текстовые команды или кнопки. Бот может отвечать в личных сообщениях и добавляться в групповые чаты.
- 🤖 Автоответы на частые вопросы клиентов по заранее заданным сценариям
- 📢 Рассылка уведомлений подписчикам — новости, акции, статусы заказов
- 📝 Сбор заявок и обратной связи через диалоговые формы
- 🔗 Интеграция с внешними системами через Bot API — CRM, базы данных, сайты
Возможности конкретного бота ограничены только логикой, которую вы в него заложите, и методами, которые предоставляет API платформы. Перед началом работы полезно изучить официальную документацию Bot API на сайте мессенджера — актуальный список методов и ограничений может меняться с обновлениями платформы.
Регистрация бота через Masterbot
Первый шаг — получение токена доступа. Для этого откройте ТамТам и найдите в поиске контактов бота @masterbot. Это официальный инструмент платформы для управления ботами.
Начните с ним диалог и отправьте команду создания нового бота — Masterbot пошагово запросит название и юзернейм для вашего бота. После завершения регистрации вы получите длинную строку — токен, который служит ключом для всех запросов к API.
☑️ Регистрация бота в ТамТам
⚠️ Внимание: токен — это полный доступ к вашему боту. Не публикуйте его в открытом коде, скриншотах и переписке. Если токен скомпрометирован, сгенерируйте новый через Masterbot.
Точные названия команд и пунктов меню Masterbot могут меняться с обновлениями платформы, поэтому сверяйтесь с подсказками, которые бот выводит в диалоге, — он сам подсказывает доступные команды.
Три способа реализовать логику бота
После получения токена нужно решить, где будет «жить» логика бота. Вариантов несколько, и выбор зависит от ваших технических навыков и задач.
Первый путь — конструкторы чат-ботов, поддерживающие ТамТам. Вы подключаете токен в личном кабинете сервиса и собираете сценарии визуально, без программирования. Это подходит для простых воронок: приветствие, меню, сбор контактов.
Второй путь — собственный скрипт на сервере. Вы пишете код (популярный вариант — Python или PHP), который принимает обновления от платформы и отправляет ответы через API. Это даёт полную гибкость, но требует сервера и навыков разработки.
Третий путь — гибридный: базовые сценарии в конструкторе, а сложные операции (оплата, проверка заказа) через вебхуки на свой сервер.
Подключение через Bot API: основные принципы
Если вы выбрали самостоятельную разработку, взаимодействие с платформой строится на HTTP-запросах к API. Есть два механизма получения сообщений: long polling (скрипт периодически опрашивает сервер) и webhook (платформа сама отправляет события на ваш URL).
| Параметр | Long polling | Webhook |
|---|---|---|
| Требования к серверу | Минимальные | Нужен публичный HTTPS-адрес |
| Скорость реакции | Зависит от интервала опроса | Почти мгновенная |
| Сложность настройки | Простая | Средняя (SSL-сертификат) |
| Подходит для | Тестов и малых нагрузок | Рабочих проектов |
Для отправки сообщения используется метод API, куда передаётся токен, идентификатор чата и текст. Пример запроса в общем виде:
POST https://botapi.tamtam.chat/messages?access_token=ВАШ_ТОКЕН&chat_id=ID_ЧАТА
{"text": "Здравствуйте! Чем могу помочь?"}
Актуальный базовый адрес API и формат методов всегда проверяйте в официальной документации ТамТам — параметры могут обновляться, и устаревшие примеры из статей перестают работать.
⚠️ Внимание: для работы webhook ваш сервер должен быть доступен из интернета по HTTPS с валидным сертификатом. Самоподписанные сертификаты и адреса вида localhost платформа не примет.
Тестирование и публикация
Перед запуском бота для пользователей проверьте его работу на себе. Найдите своего бота в поиске ТамТам по юзернейму и пройдите все сценарии: приветствие, кнопки, обработку нестандартных ответов.
- ✅ Бот отвечает на команду старта и выводит главное меню
- ✅ Кнопки и ссылки в сообщениях работают корректно
- ✅ На неизвестный текст бот отвечает понятной подсказкой, а не молчит
- ✅ Логи сервера не содержат ошибок при каждом сообщении
Если бот не отвечает, проверяйте по цепочке: верный ли токен в запросах, запущен ли ваш скрипт, приходят ли обновления от платформы (видно в логах), не истёк ли SSL-сертификат при использовании webhook. Большинство проблем на старте связано именно с токеном или недоступностью сервера.
Почему бот «молчит» в групповом чате
Боты в группах могут иметь ограничения на чтение сообщений в зависимости от настроек приватности и прав, выданных при добавлении. Проверьте, что бот добавлен в чат корректно и что ваш сценарий обрабатывает события именно группового типа — их структура в API отличается от личных диалогов.
Типичные ошибки при настройке
Начинающие разработчики чаще всего сталкиваются с одними и теми же проблемами. Разберём самые частые.
Неверный токен. При копировании токена из переписки с Masterbot легко захватить лишний пробел или потерять символ. Скрипт при этом получает ошибку авторизации. Решение — хранить токен в переменной окружения или конфигурационном файле и проверять его целиком.
Бот не видит сообщения. Если используется webhook, убедитесь, что подписка на обновления реально создана — после настройки отправьте тестовое сообщение и проверьте логи сервера. При long polling проверьте, что скрипт не завершается с ошибкой после первого запроса.
Игнорирование ограничений платформы. У Bot API есть лимиты на частоту запросов и рассылки. Массовая отправка сообщений без учёта ограничений может привести к временной блокировке бота. Документация платформы описывает допустимые режимы — изучите их до запуска рассылок.
Часто задаваемые вопросы
Нужно ли платить за создание бота в ТамТам?
Регистрация бота через Masterbot и использование Bot API бесплатны. Затраты возникают только на хостинг сервера для собственного скрипта или на подписку в конструкторе ботов, если выбран этот путь.
Можно ли создать бота без навыков программирования?
Да. Визуальные конструкторы чат-ботов позволяют собрать сценарий из готовых блоков: сообщения, кнопки, условия. Вам понадобится только токен от Masterbot для подключения.
Что делать, если токен бота попал к посторонним?
Немедленно перевыпустите токен через Masterbot — старый ключ перестанет работать. Затем обновите токен в настройках вашего скрипта или конструктора.
Можно ли добавить бота в групповой чат?
Да, боты поддерживают работу в группах. Учтите, что структура событий групповых чатов в API отличается от личных диалогов, и сценарий нужно тестировать отдельно для обоих случаев.
Бот перестал отвечать — с чего начать диагностику?
Проверьте по порядку: работает ли ваш сервер и скрипт, не истёк ли SSL-сертификат (для webhook), корректен ли токен, нет ли ошибок в логах. Чаще всего причина находится на одном из этих шагов.