Docker ile WhatsApp Toplu Mesaj Sistemi Kurulumu

Kendi sunucunuzda çalışan, mesaj başına ücret istemeyen bir WhatsApp toplu mesaj sistemini Docker ile kurmak göründüğünden kolaydır: bir veritabanı şeması çalıştırır, tek bir .env dosyası doldurur ve docker compose up dersiniz. Bu rehber gereksinimlerden QR bağlantısına, Dokploy ile üretime almadan sorun gidermeye kadar tüm adımları sırayla anlatıyor. Sistem QR tabanlıdır (whatsapp-web.js), resmi Business API değildir; yani başvuru, şablon onayı veya konuşma ücreti yoktur.

1. Kurulum öncesi gereksinimler

Kuruluma başlamadan önce elinizde şunların olması gerekir:

Bu mimarinin nasıl çalıştığını ve neden bir sunucuda barındırmanın avantajlı olduğunu ayrıntılı görmek için self-hosted WhatsApp mesaj sistemi yazısına göz atabilirsiniz.

2. Docker Compose neyi ayağa kaldırıyor?

Tek bir docker compose up komutu dört servisi başlatır. Her biri bilinçli olarak ayrılmıştır; böylece hız sınırı yalnızca tek bir yerde — worker'da — yaşar.

Server'ın hiçbir zaman mesaj göndermemesi kritik bir tasarım kararıdır: panele saniyede yüz istek de gelse WhatsApp'a giden trafik insan hızını aşamaz. Worker'ın bağlandığı WhatsApp Web protokolü hakkında daha fazlası için whatsapp-web.js nedir yazısına bakın.

3. Adım 1 — Veritabanı şemasını kurun

Önce ücretsiz bir Supabase projesi oluşturun. Projenin SQL Editor bölümünü açın ve depodaki şema dosyasını yapıştırıp çalıştırın. Bu, notification_messages ve whatsapp_web_sessions tablolarını oluşturur.

# Depoyu sunucuya klonlayın
git clone https://github.com/kullanici/whatsapp-oto-message.git
cd whatsapp-oto-message

# supabase/migrations/001_init.sql içeriğini
# Supabase > SQL Editor > New query alanına yapıştırıp Run edin

Ardından Supabase panelinden Project URL ile service_role anahtarını not alın; bir sonraki adımda .env dosyasına gireceksiniz.

4. Adım 2 — .env dosyasını doldurun

Örnek dosyayı kopyalayın ve gizli değerleri güçlü bir şekilde üretin. Rastgele sırlar için openssl kullanmak, tahmin edilebilir parolalardan çok daha güvenlidir.

cp .env.example .env

# Güçlü sırlar üretin
openssl rand -hex 32   # REDIS_PASSWORD için
openssl rand -hex 32   # WA_CONTROL_SECRET için

.env içinde doldurulması gereken temel alanlar:

REDIS_PASSWORD=uretilen_32_baytlik_deger
WA_CONTROL_SECRET=uretilen_32_baytlik_deger
SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ...
TZ=Europe/Istanbul

5. Adım 3 — Servisleri başlatın

Tüm imajları derleyip konteynerleri arka planda başlatmak için tek komut yeterlidir:

docker compose up -d --build

# Servislerin durumunu kontrol edin
docker compose ps

# Worker loglarını canlı izleyin (QR ve gönderim burada görünür)
docker compose logs -f whatsapp-worker

İlk derleme, Chromium bağımlılıkları yüzünden birkaç dakika sürebilir. docker compose ps çıktısında dört servisin de running olması gerekir. Sistemi bir HTTP API üzerinden dış uygulamalara bağlamak isterseniz HTTP API entegrasyonu yazısı gönderim uç noktasını ve kimlik doğrulamayı anlatır.

6. Adım 4 — QR kodu okutun

Konteynerler ayağa kalktıktan sonra tarayıcıdan panele girin ve Bağlantı sayfasını açın. Burada worker'ın ürettiği QR kod görünür.

1. Telefonunuzda WhatsApp > Ayarlar > Bağlı Cihazlar yolunu açın.
2. Cihaz Bağla'ya dokunun ve paneldeki QR kodu okutun.
3. Oturum, LocalAuth ile kalıcı bir volume'da saklanır; konteyner yeniden başlasa bile tekrar QR okutmanız gerekmez.

Bilgisayarınızın açık kalmasına gerek yoktur; sistem sunucuda çalışır. Telefonun ise oturumun canlı kalması için yaklaşık iki haftada bir internete bağlanması yeterlidir.

7. Üretime alma: Dokploy ile

Geliştirme için docker compose up yeterli olsa da, üretimde alan adı, TLS sertifikası ve otomatik yeniden başlatma istersiniz. Dokploy gibi bir self-hosted PaaS paneli, aynı compose dosyasını yönetip bunları kolaylaştırır:

• Site ve panel için ayrı alan adları tanımlayın (ör. dispatch-wa.com ve panel.dispatch-wa.com).
• Servisleri ortak bir dokploy-network ağına bağlayın.
• Let's Encrypt ile otomatik HTTPS alın.
• Redis verisi ve WhatsApp oturumu için kalıcı volume tanımlayın; yeniden dağıtımda oturum kaybolmaz.

8. Sorun giderme

Kurduğunuz sistemi ilk kez çalıştırırken küçük bir liste ile test edin; hız tavanı zaten güvenlidir ama yeni numaralarda kademeli başlamak isterseniz numara ısıtma (warm-up) yaklaşımını uygulayın.

Sık sorulan sorular