Telegram Bot Integration для Odoo

Модуль для интеграции Telegram бота с Odoo CRM. Позволяет автоматически создавать лиды (leads) в CRM из сообщений, отправленных в Telegram бот.

Функциональность

• Автоматическое создание лидов из сообщений Telegram
• Настройка нескольких ботов
• Привязка лидов к командам продаж и ответственным
• Статистика созданных лидов
• Отображение информации о Telegram в лиде

Установка

1. Установите модуль через Apps в Odoo
2. Убедитесь, что установлен модуль crm

Настройка

1. Создание Telegram бота

1. Откройте Telegram и найдите @BotFather
2. Отправьте команду /newbot
3. Следуйте инструкциям для создания бота
4. Сохраните токен бота (например: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

2. Настройка в Odoo

Перейдите в CRM → Telegram Bot. Создайте новую конфигурацию бота:

• Bot Name: Название бота (для идентификации)
• Bot Token: Токен, полученный от BotFather
• Company: Компания
• Sales Team: Команда продаж (опционально)
• Salesperson: Ответственный за лиды (опционально)
• Source: Источник для лидов (опционально)

Нажмите Test Connection для проверки подключения. Нажмите Set Webhook для установки webhook в Telegram.

3. Настройка Webhook URL

Убедитесь, что в настройках системы (Settings → Technical → Parameters → System Parameters) установлен параметр web.base.url с правильным URL вашего Odoo сервера.

Webhook URL будет автоматически сформирован как: {web.base.url}/telegram/webhook/{bot_id}

4. Установка Webhook в Telegram

После нажатия кнопки Set Webhook в Odoo, webhook будет автоматически установлен в Telegram.

Альтернативно, вы можете установить webhook вручную через API Telegram:

curl -X POST "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook"
-H "Content-Type: application/json"
-d '{"url": "https://your-odoo-server.com/telegram/webhook/<BOT_ID>"}'

Использование

После настройки:

• Пользователи могут отправлять сообщения вашему Telegram боту
• Каждое сообщение автоматически создаст лид в CRM
• В лиде будет сохранена информация:
  • Текст сообщения
  • Username пользователя Telegram
  • Chat ID и User ID
  • Message ID

Безопасность

• Webhook endpoint использует auth='public' для приема запросов от Telegram
• Рекомендуется добавить дополнительную проверку токена в URL или использовать reverse proxy с аутентификацией
• Для продакшена рекомендуется использовать HTTPS

Технические детали

• Модуль создает лиды типа lead
• Поля лида заполняются из сообщения Telegram
• Статистика обновляется автоматически
• Логирование всех операций в Odoo логах

Поддержка

При возникновении проблем проверьте:

• Логи Odoo на наличие ошибок
• Правильность токена бота
• Доступность webhook URL из интернета
• Настройки web.base.url в системе