WhatsApp API

Tüm instance'ları ve durumlarını listele

Yeni instance oluştur. ID otomatik atanır.

{ "description": "İş Hattı" }

Yanıt: { "success": true, "instanceId": "inst_a1b2c3d4" }

Instance'ı ve tüm oturum verilerini sil

Bağlantı durumunu kontrol et

Yanıt: { "status": "open", "account": { "id": "...", "name": "...", "phone": "..." } }

QR kodunu al (base64 data URI)

Bağlı hesabın bilgilerini al

Bağlantıyı başlat (QR oluşturma için)

Bağlantıyı yeniden başlat

WhatsApp oturumunu kapat

Metin mesajı gönder

{ "to": "+905xxxxxxxxx", "body": "Merhaba!" }

Resim gönder (URL veya Base64 data URI)

{
  "to": "+905xxxxxxxxx",
  "image": "https://example.com/photo.jpg",
  "caption": "Açıklama (opsiyonel)"
}

Video gönder

{
  "to": "+905xxxxxxxxx",
  "video": "https://example.com/video.mp4",
  "caption": "Açıklama (opsiyonel)"
}

Dosya/döküman gönder

{
  "to": "+905xxxxxxxxx",
  "document": "https://example.com/file.pdf",
  "filename": "rapor.pdf",
  "caption": "Açıklama (opsiyonel)"
}

Ses dosyası gönder

{ "to": "+905xxxxxxxxx", "audio": "https://example.com/audio.mp3" }

Sesli mesaj (PTT) gönder

{ "to": "+905xxxxxxxxx", "audio": "https://example.com/voice.ogg" }

Konum gönder

{
  "to": "+905xxxxxxxxx",
  "lat": 41.0082,
  "lng": 28.9784,
  "name": "İstanbul",
  "address": "Sultanahmet (opsiyonel)"
}

Kişi kartı gönder

{
  "to": "+905xxxxxxxxx",
  "contact_name": "Ahmet Yılmaz",
  "contact_phone": "905xxxxxxxxx"
}

Sticker gönder (WebP formatı)

{ "to": "+905xxxxxxxxx", "sticker": "https://example.com/sticker.webp" }

Anket gönder

{
  "to": "+905xxxxxxxxx",
  "name": "Toplantı ne zaman olsun?",
  "values": ["Pazartesi", "Çarşamba", "Cuma"],
  "selectableCount": 1
}

Mesaja emoji tepkisi gönder

{ "to": "+905xxxxxxxxx", "msgId": "MESSAGE_ID", "emoji": "👍" }

Gönderilmiş mesajı sil (herkesten)

{ "to": "+905xxxxxxxxx", "msgId": "MESSAGE_ID" }

Mesaj geçmişini al

Mesaj istatistiklerini al (toplam, gönderilen, alınan, bekleyen, başarısız)

Tüm mesaj geçmişini temizle

Tüm kişileri listele

Belirli bir kişinin bilgilerini al

Numaranın WhatsApp'ta kayıtlı olup olmadığını kontrol et

Yanıt: { "exists": true, "jid": "905xx@s.whatsapp.net" }

Kişinin profil fotoğrafı URL'ini al

Kişiyi engelle

{ "phone": "905xxxxxxxxx" }

Kişinin engelini kaldır

{ "phone": "905xxxxxxxxx" }

Tüm grupları listele (isim, katılımcı sayısı, açıklama)

Grup detaylarını al (katılımcılar, admin bilgisi)

Tüm sohbetleri listele

Belirli sohbetin mesajlarını al

Sohbeti okundu olarak işaretle

{ "chatId": "905xx@s.whatsapp.net" }

Sohbeti arşivle

{ "chatId": "905xx@s.whatsapp.net" }

Yeni toplu mesaj işi başlat

{
  "recipients": [
    { "id": "905xx@s.whatsapp.net", "name": "Ali" },
    { "id": "905yy@s.whatsapp.net", "name": "Veli" }
  ],
  "messageType": "text",
  "body": "Herkese merhaba!",
  "delay": 3
}

Toplu mesaj işlerini listele

İş detayını ve alıcı durumlarını al

Çalışan toplu mesaj işini iptal et

Yeni zamanlı mesaj oluştur

{
  "recipient": "+905xxxxxxxxx",
  "messageType": "text",
  "body": "Bu mesaj ileri tarihte gönderilecek",
  "scheduledAt": "2026-04-01T10:00:00"
}

Zamanlı mesajları listele

Bekleyen zamanlı mesajı iptal et ve sil

Tüm chatbot kurallarını listele

Yeni kural oluştur veya güncelle

{
  "match_type": "contains",
  "trigger_text": "fiyat",
  "response": "Fiyat listemiz için: example.com/fiyat",
  "delay": 2,
  "enabled": true,
  "priority": 0
}

Chatbot kuralını sil

Chatbot'u aç/kapat

{ "enabled": true }

Instance ayarlarını al (webhook URL, durum)

Instance ayarlarını güncelle

{
  "webhookUrl": "https://yoursite.com/webhook",
  "webhookEnabled": true
}

# message_received — Yeni mesaj geldiğinde
{
  "event": "message_received",
  "data": {
    "id": "MSG_ID", "from": "905xx@s.whatsapp.net",
    "body": "Merhaba", "type": "chat",
    "timestamp": 1711100000, "fromMe": false
  }
}

# message_ack — Mesaj durumu değiştiğinde
{
  "event": "message_ack",
  "data": { "id": "MSG_ID", "status": "read" }
}

# connection_status — Bağlantı durumu değiştiğinde
{
  "event": "connection_status",
  "data": { "status": "connected", "account": {...} }
}

Tüm hatalar { "error": "Hata mesajı" } formatında döner.