WhatsApp Business API

Genel bakış

ERP tetiklemeli mesajlar ve müşteri bildirimleri için kendi sunucunuzda çalışan API ağ geçidi.

Mesaj gönderme

Oturum başına REST uçları

• Metin, görsel, video, ses, belge, çıkartma ve konum için ayrı gönderim uçları.
• Medya; bağlantı (URL) ya da base64 ile verilir, görsel ve belgeye açıklama ve dosya adı eklenebilir.
• Bir mesaja emoji tepkisi verilebilir; gönderilen mesaj silinebilir.
• Mesaj geçmişi listelenir; durumlar: bekliyor, gönderildi, teslim edildi, okundu, başarısız.

Toplu gönderim

• Bir ad, alıcı listesi ve ortak bir metinle tek çağrıda toplu gönderim başlatılır; istenirse her alıcı için kendi metni verilir.
• Gönderimler arasındaki bekleme süresi (milisaniye cinsinden) siz belirlersiniz.
• Her toplu işin toplam, gönderilen ve başarısız sayısı ile durumu (kuyrukta, çalışıyor, tamamlandı, iptal edildi, başarısız) sorgulanır.
• Çalışan bir toplu iş iptal edilebilir.

Oturumlar ve QR ile bağlanma

Her WhatsApp hesabı bir oturumdur. Oturum oluşturulur, başlatılır ve durdurulur; QR kodu görsel olarak alınır.

• Telefonda WhatsApp → Ayarlar → Bağlı Cihazlar → Cihaz Bağla yolunu izleyip QR kodunu okutun.
• Oturum durumları: başlatılıyor, QR hazır, bağlanıyor, bağlı, bağlantı koptu, başarısız, durduruldu.
• Bağlantı bilgisi kalıcıdır; yeniden başlatmadan sonra QR'ı tekrar okutmanız yalnız cihaz telefondan kaldırılmışsa gerekir.
• Oturumun grupları ve kişileri de listelenebilir.

Webhook ile gelen mesajlar

• Her oturum için bir ya da birden çok webhook tanımlanır; hangi olayları alacağı seçilir, varsayılan olay gelen mesajdır.
• Olaylar adresinize HTTP POST ile iletilir; bir secret verirseniz gövde HMAC-SHA256 ile imzalanır ve imzayı başlıktan doğrulayabilirsiniz.
• Başarısız teslimler, belirlediğiniz yeniden deneme sayısı kadar (varsayılan 3) tekrarlanır.
• Webhook'u kaydettikten sonra test ucuyla adresinizin yanıt verdiğini doğrulayın.

Yetkilendirme ve güvenlik

• Her istek X-API-Key başlığıyla doğrulanır; anahtarlar veritabanında yalnız SHA-256 özeti olarak saklanır, ekranda yalnız kısa bir ön eki görünür.
• Üç rol: Viewer (okuma), Operator (oturum, mesaj ve webhook işlemleri), Admin (anahtar yönetimi, oturum silme, denetim kaydı).
• Anahtar başına isteğe bağlı IP izin listesi (CIDR) ve oturum kapsamı: kısıtlı anahtar yalnız kendi oturumlarının uçlarına ve listelerine erişir.
• Kimlik doğrulamasız yalnız sağlık uçları açıktır; oturum kapsamı kuralı testlerle kilitlidir.

İzleme, istatistik ve denetim

• Canlı olaylar: oturum ve mesaj olayları gerçek zamanlı (SignalR) kanaldan oturum bazında izlenir.
• İstatistik: oturum, mesaj ve webhook toplamları ile oturum bazlı özet.
• Sağlık: kimlik doğrulamasız canlılık ve hazırlık uçları; bağlantı ayrıntısı sızdırmaz.
• Denetim kaydı: yönetici, yapılan işlemleri listeler.
• Swagger: tüm uçlar etkileşimli olarak belgelenir ve denenebilir.

Kurulum ve işletim

• Veriler SQL Server'da tutulur; tablolar ilk açılışta otomatik oluşturulur.
• Kendi sunucunuzda Windows hizmeti olarak çalışır; yönetim paneli (oturumlar, mesaj deneme, webhook, API anahtarları, günlükler) ayrıca sunulur.
• Uç noktalar dışarıya HTTPS arkasında açılır; sağlık ucu ile izlenebilir.
• Uygulamanızdan kullanım için C#, VB.NET, Java ve curl örnekleri yayın sayfasında yer alır.