Dokümantasyon

WhatsApp grup mesajları

OTP akışından bağımsız olarak, kendi cron’unuz veya COM zamanlayıcısı ile bir WhatsApp grubuna mesaj atabilirsiniz. Hedef alanına grup id yazmanız yeterlidir.

Grup ID nedir?

Baileys / WhatsApp grup kimliği genelde şu biçimdedir:

1203630XXXXXXXXXX@g.us

API’ye tam JID veya yalnızca sayısal kısım (1203630XXXXXXXXXX) verebilirsiniz; sistem @g.us ekler.

Grup ID nasıl alınır?

1. Dashboard’da WhatsApp QR oturumunu bağlayın (Kanal ayarları veya Taban entegrasyon).
2. Bağlı oturumdayken GET /v1/wapi/groups çağırın (X-Api-Key token ile).
3. Veya tarayıcıda /groups sayfasından token girerek listeleyin.
4. Yanıttaki groupId / jid değerini kopyalayın.
5. Dashboard oturumu için GET /v1/providers/whatsapp/groups de çalışır.

GET /v1/wapi/groups
  X-Api-Key: com_live_…
  

Örnek yanıt alanı: groups[].groupId, groups[].name, groups[].jid.

API ile grup mesajı

POST /v1/wapi/send
  X-Api-Key: com_xxx
  {"to":"1203630XXXXXXXXXX","message":"Ekip duyurusu"}
  

veya dispatch:

POST /v1/dispatch
  {"to":"1203630XXXXXXXXXX","channels":"whatsapp","message":"Duyuru"}
  

Zamanlanmış görev

Dashboard → Zamanlanmış görevler: kanal WhatsApp, alıcıya grup id yapıştırın. Aynı gövde API’den POST /v1/scheduled ile de oluşturulur.

Kendi cron job’unuz

Sunucunuzdaki cron her sabah 09:00’da:

0 9 * * * curl -sS -X POST https://api.com.seed.tr/v1/wapi/send \
    -H "X-Api-Key: $COM_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"to":"1203630XXXXXXXXXX","message":"Günaydın ekip"}'
  

Önemli: istek WhatsApp kanalı olmalı; to telefon değil grup id. OTP veya tek kullanıcı mesajı gerekmez.

Dikkat

• Grup mesajları telefon defteri / abonelik kontrolüne takılmaz.
• QR oturumu düşerse önce yeniden bağlayın; aksi halde PROVIDER_UNAVAILABLE.
• Kredi, normal WhatsApp birim fiyatından düşer.

Gruplarımı canlı listele Tam API rehberine dön