WhatsApp-коннектор — Документация Leadarr

WhatsApp-коннектор позволяет подключить мессенджер WhatsApp как канал коммуникации. Агент автоматически получает и обрабатывает входящие сообщения, отвечает клиентам и ведёт диалоги 24/7.

Коннектор работает через WAHA (WhatsApp HTTP API) — self-hosted решение, которое необходимо развернуть на вашем сервере.

Для работы WhatsApp-коннектора требуется собственный WAHA-сервер. Leadarr не предоставляет WAHA-серверы — разверните его самостоятельно.

Возможности

Автоматические ответы 24/7 — агент обрабатывает входящие WhatsApp-сообщения в реальном времени.
Мультиканальность — WhatsApp работает параллельно с Email, Telegram и Avito в одном агенте.
Квалификация лидов — агент фильтрует обращения, определяет интент и передаёт горячие лиды в CRM.
База знаний — агент ищет ответы в подключённых документах, прайсах и каталогах.
Обучение стилю — агент адаптирует тон общения под стиль вашей компании.

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

Требование	Описание
WAHA-сервер	Развёрнутый экземпляр WAHA (рекомендуется Docker)
WAHA API Key	Ключ авторизации, настроенный на сервере
WhatsApp аккаунт	Привязан к WAHA через QR-код
Белый IP	Сервер должен быть доступен из интернета для webhook-ов

Как развернуть WAHA

Установите WAHA на ваш сервер (рекомендуется Docker или Docker Compose).
Настройте API Key для авторизации запросов.
Привяжите WhatsApp аккаунт — откройте веб-интерфейс WAHA и отсканируйте QR-код.
Проверьте доступность — убедитесь, что сервер отвечает по указанному URL.

Документация WAHA доступна на GitHub. Поддерживается развёртывание через Docker, Docker Compose и Kubernetes.

Пошаговая настройка

Откройте раздел коннекторов

Настройки → Коннекторы → «+ Подключить коннектор» → выберите WhatsApp.

Заполните параметры

Поле	Пример
Название	`WhatsApp — основной`
WAHA URL	`https://waha.example.com`
WAHA API Key	`your-api-key-here`
Session Name	`default`

Подключите и проверьте

Нажмите «Подключить». Система проверит соединение с WAHA-сервером. При успехе коннектор появится со статусом «Активен».

Как это работает

Клиент пишет в WhatsApp
        ↓
WAHA получает сообщение
        ↓
Webhook → Leadarr
        ↓
Агент анализирует сообщение + ищет в базе знаний
        ↓
Агент формирует ответ
        ↓
WAHA отправляет ответ в WhatsApp

Все переписки отображаются в разделе «Сообщения» — общий поток диалогов агента.

Частые вопросы

Можно ли подключить несколько аккаунтов?
Да. Создайте отдельный коннектор для каждого аккаунта с разными WAHA-серверами или сессиями.

Что если WAHA-сервер недоступен?
Сообщения не будут доставляться. Leadarr покажет ошибку подключения. После восстановления сервера обработка возобновится автоматически.

Поддерживаются ли групповые чаты?
Зависит от настроек WAHA-сервера. По умолчанию обрабатываются только личные сообщения.

← Предыдущее Telegram-коннектор Далее → MAX-коннектор