⚠️ Внимание: Вы выложили реальные credentials!
Немедленно регенерируйте Telegram токен и WooCommerce API ключи!
🚀 Быстрый старт (5 минут)
- Прочитайте QUICKSTART.md
- Скопируйте
.env.example → .envи заполните данные - Установите webhook в Telegram
- Отправьте
/startботу и начните тестировать!
✅ Готово! Ваш бот будет онлайн за 5 минут
📚 Документация
⚡
Быстрый старт
За 5 минут запустите полностью рабочий бот. Пошаговые инструкции.
📖
Полная документация
Полное руководство с решением проблем и примерами использования.
🔌
Интеграция
Примеры кода и расширенные интеграции с WooCommerce и Telegram.
📦
Обзор проекта
Структура проекта и описание всех файлов и компонентов.
✨ Возможности
- 🎫 Показывает доступные билеты из WooCommerce
- 🛒 Позволяет покупать билеты прямо из Telegram
- 👤 Автоматически регистрирует клиентов с рандомными email
- 📧 Интегрируется с системой уведомлений WooCommerce (PDF билеты)
- 📋 Показывает историю заказов пользователя
- 🔐 Безопасное хранение credentials в .env файле
- 📊 Логирование всех действий пользователей
- 🔌 Простое расширение и кастомизация
💻 Требования
- PHP >= 7.4
- cURL расширение включено
- HTTPS сертификат (для webhook)
- Доступ на хостинг (FTP или SSH)
📁 Структура проекта
bot-project/
├── webhook.php ← Главный файл (точка входа)
├── config.php ← Конфигурация
├── test-bot.php ← Тестирование
│
├── services/
│ ├── TelegramService.php
│ ├── WooCommerceService.php
│ └── UserCustomerMapper.php
│
├── handlers/
│ ├── UserHandler.php
│ ├── ProductHandler.php
│ └── OrderHandler.php
│
├── logs/ ← Логи (создаются автоматически)
├── cache/ ← Кеш (создаётся автоматически)
│
├── .env.example ← Шаблон (копируйте в .env)
├── .gitignore ← Исключения для git
├── .htaccess ← Защита файлов
├── composer.json ← Зависимости
└── setup.sh ← Скрипт установки
🔐 Безопасность
⚠️ КРИТИЧНО!
Вы выложили реальные токены! Немедленно:
Вы выложили реальные токены! Немедленно:
- @BotFather → /mybots → Regenerate token
- WordPress → WooCommerce → REST API → Удалите и создайте новые ключи
- Обновите .env с новыми значениями
Что сделано правильно:
- Credentials хранятся в .env (не в коде)
- .env защищен .htaccess
- Используется Basic Auth для WooCommerce API
- Webhook только принимает POST запросы
- SSL сертификат требуется для Telegram
🧪 Команды для тестирования
Проверка конфигурации:
php test-bot.php
Установка webhook:
curl "https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://ваш-домен.com/webhook.php"
Проверка webhook:
curl "https://api.telegram.org/bot<TOKEN>/getWebhookInfo"
🎯 Следующие шаги
- Начните с QUICKSTART.md - за 5 минут будет работать
- Прочитайте README.md - полная документация
- Смотрите INTEGRATION.md - примеры расширения
- Тестируйте - используйте
test-bot.php - Расширяйте - добавляйте свои команды