Техническое задание: Разработка Telegram-бота с интеграцией amoCRM

Цель проекта

Создание автоматизированной системы обработки заявок с сайта, которая обеспечивает бесшовную коммуникацию клиента через Telegram-бота и менеджера через интерфейс amoCRM.

Основные требования к функционалу

1. Интеграция с сайтом и amoCRM

Реализация API-взаимодействия для создания контакта и сделки в amoCRM при отправке заявки с сайта
Получение ID созданных сущностей (контакт, сделка) от API amoCRM
Формирование уникальной ссылки для перехода клиента в Telegram-бота с передачей contact_id

2. Функционал Telegram-бота

Парсинг параметра start при запуске бота для получения contact_id
Автоматическое создание чата в amoCRM через API с привязкой к существующему контакту
Двусторонняя синхронизация сообщений:
- Сообщения от клиента в боте → появляются в чате amoCRM
- Ответы менеджера из amoCRM → отправляются клиенту в Telegram

3. Технические требования

Язык программирования: Python
Использование официальных API amoCRM и Telegram Bot API
Реализация надежной обработки ошибок и логирования
Обеспечение безопасности передачи данных

4. Архитектурные варианты реализации

Предлагается рассмотреть два подхода:

Полный цикл: Бот обрабатывает весь процесс от получения заявки до создания чата
Частичная интеграция: Первые этапы (создание контакта/сделки) реализуются на стороне заказчика, бот подключается на этапе создания чата

Ожидаемый результат

Работоспособный Telegram-бот, интегрированный с amoCRM, обеспечивающий автоматическую обработку заявок и двустороннюю коммуникацию между клиентами и менеджерами.

код