Введение
WAHA (WhatsApp HTTP API) – это middleware-решение для интеграции WhatsApp с внешними системами через HTTP-запросы. Оно предоставляет REST API и Webhooks для отправки и получения сообщений, медиафайлов, управления чатами и контактами, а также обработки уведомлений в реальном времени. WAHA поддерживает гибкое развертывание: его можно разместить локально или использовать в облаке. Решение идеально подходит для бизнесов, которые хотят автоматизировать коммуникацию, службу поддержки или рассылки через WhatsApp, сохраняя полный контроль над инфраструктурой.
Предварительные требования
1. Docker и Docker Compose
- Убедитесь, что установлены последние версии `docker` и `docker compose`.
- Пример версий (на момент написания инструкции):
docker --version # Docker 26.1.3 или новее
docker compose version # Docker Compose v2.27.0 или новее
Зачем Docker?
Docker позволяет запускать приложения в изолированных контейнерах, что упрощает развертывание.
Зачем Docker Compose?
Инструмент для управления многоконтейнерными приложениями через YAML-файл.
1. Установка Docker
Пример для Ubuntu/Debian:
# Обновление системы
sudo apt-get update && sudo apt-get upgrade -y
Установка Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Установка плагина Docker Compose
sudo apt install docker-compose-plugin
2. Загрузка Docker-образа WAHA
docker pull devlikeapro/waha
3. Настройка проекта
Скачайте конфигурационные файлы:
# Файл переменных окружения
wget -O .env https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/.env.example
Docker Compose файл
wget -O docker-compose.yaml https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/docker-compose.yaml```
Настройте файлы:
- **`.env`** — измените обязательные параметры:
vi .env
Ключ API для доступа:
WHATSAPP_API_KEY=ваш_ключ # Например: mysecret123
Логин и пароль для Dashboard (веб-панели):
WAHA_DASHBOARD_USERNAME=admin
WAHA_DASHBOARD_PASSWORD=admin
Логин и пароль для Swagger (документации API):
WHATSAPP_SWAGGER_USERNAME=admin
WHATSAPP_SWAGGER_PASSWORD=admin
`docker-compose.yaml` — удалите ненужные сервисы (например, `mongodb`, `minio`), если они не требуются.
4. Запуск сервиса
docker compose up -d
5. Доступ к сервису
Локальный доступ
- Dashboard: [http://localhost:3000/dashboard](http://localhost:3000/dashboard)
- Логин: `admin/admin` (по умолчанию).
- **Доступ из интернета:**
- **Важно!** Контейнеры работают только на localhost. Для внешнего доступа:
Измените в `docker-compose.yaml` строку `127.0.0.1:3000:3000` → `3000:3000`.
Перезапустите контейнеры:
docker compose down && docker compose up -d
Откройте `http://ваш-IP:3000/dashboard`.
Рекомендация: Используйте Nginx как прокси-сервер для безопасного доступа.
Важные примечания
Безопасность: Не оставляйте значения по умолчанию (`admin/admin`) в продакшене!
Обновление: Чтобы обновить образ, выполните:
docker compose pull && docker compose up -d
Логи: Для просмотра логов контейнера:
docker compose logs -f waha
Если возникнут проблемы — проверьте, открыты ли порты в фаерволе и корректно ли настроены переменные окружения.
Статья будет расширяться и продолжаться, чтобы читатели смогли поднять все необходимое и настроить для работы с `whatsapp`.