Подключение платформ

Этот гайд научит вас подключать ботов к различным платформам: Telegram, WhatsApp, веб-сайтам, API и AmoCRM. После подключения бот сможет общаться с пользователями в выбранных каналах.

🌐 Обзор платформ

Доступные платформы

Канал	Тип	Сложность	Стоимость
Telegram	Мессенджер	⭐⭐	Бесплатно
WhatsApp	Мессенджер	⭐⭐⭐	Бесплатно*
Web Chat	Веб-сайт	⭐	Бесплатно
API	Интеграция	⭐⭐⭐⭐	По запросу
AmoCRM	CRM	⭐⭐⭐	По запросу

*WhatsApp Business API

Требует регистрации в Meta Business, но не оплачивает Meta напрямую.

Когда использовать каждую платформу

Telegram

✅ Для начала работы
✅ Быстрая настройка
✅ Тестирование и разработка
✅ Сообщества и группы

WhatsApp

✅ Бизнес-коммуникации
✅ Высокая вовлеченность
✅ Официальные каналы
✅ B2C и B2B

Web Chat

✅ Корпоративные сайты
✅ SaaS платформы
✅ Поддержка на сайте
✅ Лидогенерация

API

✅ Интеграция с CRM
✅ Внутренние системы
✅ Автоматизация процессов
✅ Программные клиенты

AmoCRM

✅ Автоматизация обработки заявок ✅ Синхронизация с воронкой продаж ✅ Централизованное общение с клиентами

📱 Telegram

Самая простая платформа для начала работы.

Шаг 1: Создание бота в Telegram через BotFather

Откройте Telegram и найдите @BotFather.
Отправьте команду /newbot.
Введите имя бота (например, "Мой помощник").
Введите username (должен заканчиваться на bot, например, mycompany_support_bot).
BotFather отправит сообщение с токеном (вида: 123456789:ABCdef...). Скопируйте его - он понадобится для Agent Lab.

Сохраните токен!

Токен - это пароль бота. Не делитесь им и храните в безопасности.

Шаг 2: Настройка в Agent Lab

Перейдите в раздел "Боты" и откройте нужного бота.
На вкладке "Каналы" найдите блок "Telegram".
Активируйте платформу, вставьте скопированный токен в соответствующее поле.
Нажмите "Сохранить".

Важно: Бот будет работать в режиме long polling (не требует настройки webhook URL).

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

Откройте Telegram, найдите вашего бота по username и отправьте сообщение (например, /start).
Если бот ответил - поздравляем! Telegram настроен.

💬 WhatsApp Business

Профессиональная платформа для бизнес-коммуникаций, требующая настройки через Meta Business.

Шаг 1: Настройка в Meta Business Suite

Зарегистрируйтесь или войдите в Meta Business Suite.
Создайте приложение WhatsApp Business и добавьте WhatsApp как продукт.
В разделе WhatsApp получите:
Phone Number ID - уникальный идентификатор вашего телефонного номера WhatsApp Business.
Access Token - токен для доступа к API WhatsApp Business.
Webhook Verify Token - придумайте и сохраните этот токен, он понадобится для верификации webhook в Agent Lab.
Настройте номер телефона, который будет использоваться для WhatsApp Business (требуется подтверждение).

Шаг 2: Настройка Webhook в Meta Developers

В приложении Meta Developers перейдите в раздел "Webhooks" для WhatsApp.
Добавьте Callback URL: https://{ваша_компания}.agents-lab.ru/api/v1/webhook/whatsapp/company:{ID_КОМПАНИИ}:flow:{ID_БОТА} (замените {ваша_компания}, {ID_КОМПАНИИ} и {ID_БОТА} на актуальные данные).
Вставьте Webhook Verify Token, который вы придумали на предыдущем шаге.
Подпишитесь на необходимые события (минимум messages).

Шаг 3: Настройка в Agent Lab

В настройках бота найдите вкладку "Каналы" и выберите "WhatsApp".
Включите платформу и введите полученные данные:
Phone Number ID
Access Token
Verify Token (должен совпадать с тем, что вы указали в Meta Developers).
Нажмите "Сохранить".

Шаг 4: Тестирование

Отправьте тестовое сообщение на ваш настроенный номер WhatsApp. Бот должен ответить. Обратите внимание, что первое подключение может занять до 1-2 минут.

🌐 Web Chat виджет

Встраиваемый чат для вашего сайта, позволяющий клиентам взаимодействовать с ботом прямо на веб-странице.

Шаг 1: Включение виджета в Agent Lab

В настройках бота на вкладке "Каналы" найдите блок "Web Chat".
Активируйте платформу и нажмите "Сохранить".
После сохранения появится уникальный HTML/JavaScript код для вставки на ваш сайт.

Шаг 2: Установка на сайт

Вставьте полученный код на ваш сайт перед закрывающим тегом </body>. Пример:

<!DOCTYPE html>
<html>
<head>
    <title>Мой сайт</title>
</head>
<body>
    <!-- Контент сайта -->

    <!-- Agent Lab Chat Widget -->
    <script>
        window.agentLabConfig = {
            botId: '{{ ID_ВАШЕГО_БОТА }}',
            apiUrl: 'https://{ваша_компания}.agents-lab.ru'
        };
    </script>
    <script src="https://{ваша_компания}.agents-lab.ru/static/chat-widget.js"></script>
</body>
</html>

Замените {{ ID_ВАШЕГО_БОТА }} и {ваша_компания} на актуальные значения.

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

Откройте ваш сайт в браузере. В правом нижнем углу должен появиться виджет чата, с которым вы можете взаимодействовать.

🔌 API интеграция

Для программного взаимодействия с вашим ботом через REST API.

Шаг 1: Включение API в Agent Lab

В настройках бота на вкладке "Каналы" найдите блок "REST API".
Активируйте платформу и нажмите "Сохранить".
На этой же вкладке вы увидите примеры запросов curl и структуру JSON тела запроса.

Шаг 2: Отправка запросов

Используйте предоставленные примеры curl или HTTP-клиент (например, Postman) для отправки сообщений боту. Вам потребуется user_id, session_id (опционально) и text сообщения.

Пример curl запроса:

curl -X POST "https://{ваша_компания}.agents-lab.ru/api/v1/flows/{ID_БОТА}/message" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "user_id": "user123",
    "session_id": "session456",
    "text": "Привет!"
  }'

🏢 AmoCRM

Интеграция с популярной CRM-системой для автоматизации взаимодействия с клиентами.

Шаг 1: Настройка в AmoCRM

В вашем аккаунте AmoCRM создайте новую интеграцию (обычно в разделе "Настройки" -> "Интеграции").
Получите необходимые данные: Subdomain вашего аккаунта AmoCRM, Integration ID и Secret Key.
Настройте виджет или кнопку для вызова бота в нужных местах AmoCRM (например, карточка сделки или лида).

Шаг 2: Настройка в Agent Lab

В настройках бота на вкладке "Каналы" найдите блок "AmoCRM".
Активируйте платформу и введите полученные данные:
Subdomain (например, mycompany.amocrm.ru)
Integration ID
Secret Key
Нажмите "Сохранить".

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

В AmoCRM создайте новый лид или откройте существующую сделку и протестируйте вызов вашего бота через настроенный виджет или кнопку.

Вернуться к Управлению ботами | Биллинг