Техническое Задание: Интеграция Telegram-бота с AmoCRM 1. Общее описание задачи Разработать и настроить Telegram-бота для первичного сбора данных от клиентов, синхронизации всей истории переписки в карточку сделки AmoCRM и обеспечения возможности бесшовного перехода на живого оператора. 2. Основной функционал 2.1. Идентификация и работа с базой (Анти-дубль) * Проверка по номеру телефона/ID: При входящем сообщении бот должен проверять наличие контакта в AmoCRM по Telegram ID или Номеру телефона. * Логика дублей: * Если контакт существует — привязывать новый чат к текущей открытой сделке. * Если сделок нет — создавать новую. * Если контакт не найден — создавать новый Контакт и Сделку. * Компании: Если клиент указывает название компании, бот должен искать совпадения в базе и привязывать контакт к существующей карточке компании. 2.2. Сбор данных и Генерация заголовков * Анкетирование: Бот запрашивает у клиента: Имя, Телефон, Суть запроса (или другие квалифицирующие вопросы). * Smart-заголовок: На основе первого сообщения или сути запроса бот должен автоматически формировать название сделки (например: «Запрос: [Услуга] — [Имя клиента]»). * Воронки: Распределение сделок по этапам в зависимости от ответов клиента (например, если выбран «Опт» — в воронку оптовых продаж). 2.3. Синхронизация переписки * История: Вся переписка (текст, фото, документы) должна отображаться в ленте событий (Timeline) карточки сделки в AmoCRM. * Исходящие: Ответы менеджера из интерфейса AmoCRM должны уходить клиенту в Telegram от имени бота. 2.4. Перевод на оператора * Ручной перехват: Менеджер в любой момент может зайти в чат AmoCRM и начать писать клиенту. В этот момент бот должен вставать на «паузу» (не присылать автоматические ответы), пока сделка не будет переведена обратно в статус «Бот». * Уведомления: При запросе клиента «Связаться с менеджером» бот должен ставить задачу ответственному менеджеру в AmoCRM. 3. Технические требования * Стек: Python (aiogram/pyrogram) или Node.js. Допустимо использование No-code платформ (Albato, Make, Salebot), если это согласуется с бюджетом. * API: Использование официального AmoCRM API и Telegram Bot API. * Безопасность: Данные должны передаваться по защищенному протоколу HTTPS. 4. Ожидаемый результат * Клиент пишет в Telegram → создается сделка в AmoCRM с заполненными полями (Имя, Телефон). * В AmoCRM нет дублей (один человек = одна карточка). * Менеджер видит всю историю общения в одном окне. * Менеджер может перехватить диалог в любой момент. 5. Интеграция Искусственного Интеллекта (ИИ) 5.1. Роль ИИ в диалоге * Автоматическая квалификация: ИИ не просто задает вопросы по списку, а ведет живой диалог. Если клиент сразу написал: "Привет, я Иван, мне нужны окна в офис, звоните на +7...", ИИ должен распознать эти данные и не переспрашивать их заново. * Консультация по базе знаний: Загрузка в ИИ информации о компании (услуги, цены, условия доставки). Бот должен отвечать на вопросы клиента, опираясь только на эти данные. * Определение намерения (Intent): ИИ должен понимать, когда клиент просто спрашивает цену, а когда готов купить или просит позвать человека. 5.2. Обработка данных для AmoCRM * Суммаризация (Summary): Перед передачей диалога оператору ИИ должен сформировать краткое резюме: о чем шел разговор и каков итог. Это резюме записывается в Примечание к сделке. * Автозаполнение полей: ИИ должен извлекать из контекста диалога данные (например, "бюджет", "тип услуги", "город") и автоматически заполнять соответствующие кастомные поля в карточке AmoCRM. 5.3. Логика переключения «ИИ — Человек» * Триггер выхода: ИИ мгновенно прекращает отвечать, если: * Клиент просит позвать менеджера. * Клиент проявляет агрессию (анализ тональности). * ИИ не может ответить на специфический вопрос более 2-х раз. * Менеджер вручную написал сообщение в чат AmoCRM. Обновленная схема воронки с ИИ | Этап воронки | Действие системы | |---|---| | Первый контакт | ИИ приветствует, узнает потребность, выявляет Имя и Телефон. | | Квалификация | ИИ проверяет наличие дублей. Создает сделку, заполняет поля. | | Продажа/Консультация | ИИ отвечает на вопросы. Если клиент "созрел" — переводит на этап "Принятие решения". | | Передача менеджеру | ИИ пишет резюме в AmoCRM, ставит задачу менеджеру: "Срочно ответьте, клиент готов". | Что нужно подготовить для разработчика (Prompts): Чтобы ИИ работал корректно, вам нужно будет предоставить: * Роль: (Например: "Ты экспертный ассистент компании по продаже спецтехники..."). * База знаний: (PDF или текстовый файл со всеми нюансами вашего бизнеса). * Скрипт: Список обязательных данных, которые ИИ должен "выудить" у клиента до того, как позовет менеджера.
