Пошаговая инструкция: Интеграция бота ProTalk с LeadTech для автоматизации обработки заказов в Telegram

Эта инструкция поможет вам настроить чат-бота на базе ProTalk (визуальный конструктор сценариев ботов) в сервисе LeadTech (no-code платформа для создания Telegram-ботов с блоками действий, условиями и интеграциями). Мы создадим сценарий, где:

• Триггер: Пользователь отправляет сообщение в Telegram-бот (например, "Готов!" для подтверждения заказа).
• Действие: LeadTech вызывает API ProTalk (/api/v1.0/ask/<token>) с данными пользователя (botid, chatid, message).
• Обработка ответа: API возвращает ответ (текст или аудио), который сохраняется в переменную и отправляется обратно в Telegram.
• Дополнительно: Сбор данных клиента (имя, телефон, email и т.д.) и валидация форм для создания заказа.

Цель: Автоматизировать обработку заказов — от подтверждения ("Готов!") до отправки ссылок на оплату и сбора контактных данных. На основе предоставленных скриншотов ProTalk (адаптировано для LeadTech: используем блоки условий, HTTP-запросов, переменных и форм).

Предварительные требования

1. Аккаунт в ProTalk: У вас должен быть создан бот с API-токеном (из скриншотов: URL вида https://api.pro-talk.ru/api/v1.0/ask/{token}). Получите bot_id (ID бота, например, 18955) и токен.
2. Аккаунт в LeadTech: Зарегистрируйтесь на leadtech.ru (бесплатный тариф для тестов). Подключите Telegram-канал: Войдите в аккаунт → Каналы → Telegram → Создайте бота через @BotFather и укажите токен.
3. Telegram-бот: Создайте бота через @BotFather в Telegram, получите токен бота (API token). Добавьте бота в чат/группу и настройте webhook в LeadTech (автоматически при подключении).
4. Тестовые данные: Подготовьте переменные для клиента, например:

• telegram_id: ID чата из Telegram (доступен как переменная в LeadTech).
• user_question: Текст сообщения пользователя (например, "Готов!").

1. Знания: Базовые навыки работы с визуальными блоками в LeadTech (шаги, условия, действия, переменные).

Время настройки: 20–30 минут.

---

Шаг 1: Настройка сценария в ProTalk (на основе скриншотов 1–4)

Этот шаг идентичен предыдущим инструкциям (для Make.com/n8n/BotHelp/SaleBot). ProTalk здесь выступает как backend-API; LeadTech будет его вызывать.

6. Войдите в ProTalk: Перейдите в дашборд бота (api.pro-talk.ru).
7. Создайте новый сценарий (Message Chain):

• Добавьте Start блок (круглый, синий).
• Подключите Send Order (колокольчик) — это триггер на отправку заказа пользователем.
• От Start подключите стрелку к Message Chain (цепочка сообщений).

6. Добавьте условия для сообщений (скриншот 1):

• В Message Chain добавьте Intent блоки:
  • Зеленый: "Готов!" (готов к заказу) → Подключите к HTTP-запросу.
  • Серый: "Any other phrase" (любая другая фраза) → Подключите к fallback (продолжить диалог).
• Для "Готов!": Добавьте стрелку к HTTP Request блоку.

6. Настройте HTTP Request (скриншоты 2–3):

• URL: https://api.pro-talk.ru/api/v1.0/ask/{token} (замените {token} на ваш, e.g., your_token).
• Method: POST.
• Headers: Оставьте пустыми (или добавьте Content-Type: application/x-www-form-urlencoded если нужно).
• Body: Form-data (выберите в dropdown):
  • bot_id = 18955 (ваш ID бота из скриншота).
  • chat_id = {{telegram_id}} (переменная из Telegram, скриншот 2: circled "chat_id").
  • message = {{user_question}} (текст от пользователя, e.g., "Готов!", скриншот 2: underlined).
• Опционально: Добавьте message_id для трекинга.

6. Обработка ответов от API (скриншот 3):

• Добавьте No response from server (красный блок) → Если API не отвечает, fallback к "Any other phrase".
• Для успешного ответа: Подключите к Write JSON response to variables (скриншот 3: orange circle).
  • Mapping: done → protalk_reply (переменная для ответа, скриншот 3: "done" → "protalk_reply").
• Подключите к следующему Message Chain для отправки {{protalk_reply}} пользователю (скриншот 4: chain с текстом {{protalk_reply}}).

6. Сохраните и протестируйте: Нажмите "Save". Тестируйте в Telegram: Отправьте "Готов!" — бот должен вызвать API и ответить.

Результат: ProTalk готов как API. Теперь LeadTech будет его "клиентом".

---

Шаг 2: Создание сценария в LeadTech

LeadTech использует визуальный конструктор с блоками (blocks): Start, Сообщение, Условие, HTTP-запрос, Переменные, Форма. Мы создадим цепочку блоков для обработки сообщений.

12. Войдите в LeadTech и создайте новый проект:

• Перейдите в раздел Боты → Новый бот.
• Выберите канал Telegram, укажите имя бота (e.g., "ProTalk Order Bot").
• Нажмите Создать — откроется визуальный редактор (canvas с блоками).

12. Добавьте стартовый блок (скриншот 1: Start с Send Order):

• По умолчанию есть Старт блок — отредактируйте: Добавьте сообщение приветствия (e.g., "Привет! Готовы к заказу?").
• Используйте переменные {{user.name}} для персонализации.
• Подключите следующий блок: Нажмите "+" для добавления Сообщение или Условие.

12. Добавьте условие для "Готов!" (скриншот 1: зеленый Intent "Готов!"):

• Добавьте Условие блок (из раздела Логика) после Start.
• Настройка: Условие на текст сообщения — {{user.message}} содержит "Готов!" (или равно "Готов!").
  • Да-ветка: Перейдите к HTTP-запросу.
  • Нет-ветка: Fallback — добавьте Сообщение с "Не понял, повторите." и вернитесь к циклу (используйте переход на предыдущий блок).
• Назовите блок: "Проверка готовности".

12. Добавьте HTTP-запрос к API ProTalk (скриншоты 2–3: HTTP Request):

• В Да-ветке добавьте HTTP-запрос блок (из раздела Действия).
• Настройка (кликните на блок для редактирования):
  • URL: https://api.pro-talk.ru/api/v1.0/ask/your_token (токен в пути; или без токена + Заголовок Authorization: Bearer your_token).
  • Метод: POST.
  • Заголовки: Добавьте: Content-Type: application/x-www-form-urlencoded.
  • Тело запроса: Форма (ключ-значение):
  • bot_id: 18955 (статический).
  • chat_id: {{user.id}} (ID чата из Telegram, скриншот 2: circled).
  • message: {{user.message}} (текст от пользователя, скриншот 2: underlined).
  • Опционально: message_id: {{user.message_id}}.
  • Тест: Нажмите "Тестировать" — введите тестовые данные. Проверьте Response (статус 200, JSON в теле).
• Если статус не 200: Добавьте условие после для fallback.

12. Сохраните ответ в переменную (скриншот 3: Write JSON to variables):

• В HTTP-блоке перейдите во вкладку Обработка ответа.
• Добавьте переменную: protalk_reply = {{response.done}} (JSON-путь к полю "done").
• Значение сохранится в сессии пользователя как {{protalk_reply}}.

12. Обработка ошибок (скриншот 3: "No response from server"):

• После HTTP добавьте Условие: {{http.status}} == 200.
  • Да: К следующему блоку.
  • Нет: Сообщение с "Извините, ошибка сервера. Попробуйте позже." (красный fallback).

12. Отправьте ответ в Telegram (скриншот 4: Message Chain с {{protalk_reply}}):

• После успешного HTTP добавьте Сообщение блок.
• Текст: {{protalk_reply}} (замените ##NL## на переносы строк в редакторе).
• Форматирование: Markdown (для ссылок/жирного текста).
• Тестируйте: Должен отправить ответ от API.

12. Сбор данных клиента и валидация (скриншот 5: Form fields + Validation):

• После отправки ответа добавьте цепочку Форма блоков (для сбора данных):
  • Форма 1: Поле "Полное имя", Сохранить в: full_name.
  • Аналогично: first_name, last_name, phone, username, id (как {{user.id}}), telegram_id ({{user.id}}), email, address (скриншот 6: список полей с описаниями на русском).
• Валидация (скриншот 5: Validation dropdown): В Форме настройте:
  • Валидация: Включить.
  • Правила: Для phone — регулярка ^\+?[1-9]\d{1,14}$; для email — содержит "@".
  • Если неверно: Повторить вопрос или отправить ошибку ("Неверные данные!").
• После форм: Сообщение с "Оплатите: https://pay.pro-talk.ru/…" (ссылка на оплату).
• Для loop: Используйте Цикл блок для повторений (max 3 раза).

12. Дополнительные опции:

• Keyboard settings (скриншот 1, right panel): В Сообщении добавьте клавиатуру (Inline или Reply): e.g., кнопка "Готов!" с callback="ready".
• Audio/TTS: Если API возвращает MP3 (в protalk_reply), используйте Медиа блок (Аудио) с URL.
• Delete variable after order (скриншот 1): В конце: Переменные блок с очисткой (установите sensitive поля в null).
• Repeat question (скриншот 1): В Форме включите "Повторять при ошибке" (до 3 раз).

12. Сохраните и активируйте:

• Нажмите Сохранить в каждом блоке, затем Сохранить бот.
• Тест: Кнопка "Тестировать" в редакторе — симулируйте чат.
• Активируйте: Бот auto-runs на webhook от Telegram.

---

Шаг 3: Тестирование и отладка

22. Тест флоу:

• Отправьте "Готов!" в Telegram-бот.
• Проверьте: LeadTech логи (в Боты → Аналитика/Выполнения) — статус HTTP 200, protalk_reply сохранен.
• Ответ приходит? Данные собраны (проверьте профиль лида в LeadTech).

22. Общие проблемы:

• 401 Token error: Проверьте токен в URL/Заголовках HTTP-блока.
• Missing fields: Убедитесь, что bot_id, chat_id, message в теле (переменные как {{user.message}}).
• JSON parse error: В Обработке ответа используйте правильный путь (e.g., {{response.done}}); протестируйте в редакторе.
• Webhook issues: В LeadTech Каналы проверьте подключение; в @BotFather: /setwebhook.
• Rate limits: LeadTech free — лимиты на запросы; мониторьте в дашборде.

22. Расширение: Для интеграций с CRM (e.g., Bitrix24) — используйте другой HTTP после форм. LeadTech поддерживает до 500 блоков.

Итог

Теперь ваш бот в ProTalk интегрирован с LeadTech: Пользователь говорит "Готов!" → API обрабатывает заказ → Ответ + форма данных → Оплата. Сценарий готов к запуску в Telegram. Если нужны скриншоты LeadTech или доработки (e.g., для других платформ), дайте знать! Для продакшена — настройте аналитику и теги в LeadTech.