WhatsApp gönderimi için
kurum içi API geçidi

Entegrasyon Kılavuzu

Bir uygulamanın WApi ile uçtan uca konuşmaya başlaması üç adımdır: API anahtarı al, oturum aç, mesaj gönder. Aşağıdaki örnekler tipik bir entegrasyonun her adımını yapay YOUR_API_KEY değişkeniyle gösterir.

1. 1 · API anahtarı oluşturun

   İlk kurulumda appsettings.json'daki Security:MasterKey değeri ilk Admin anahtarınızdır; sonraki anahtarları bununla yaratırsınız. Operasyonda günlük kullanım için Master yerine rolü uygun (Operator/Viewer) iş-anahtarları kullanılması önerilir.

   curl -X POST https://wapi.erp.tr/api/auth/api-keys \
        -H "X-API-Key: $MASTER_KEY" \
        -H "Content-Type: application/json" \
        -d '{ "name": "billing-app-prod", "role": 1, "allowedIps": "203.0.113.0/24" }'
   
   # Yanıt: oluşturulan apiKey **bir kez** ham olarak döner. Sakla.
   # { "dto": { ... }, "apiKey": "wapi_..." }

   Roller: 0 = Viewer, 1 = Operator, 2 = Admin.

2. 2 · Bir oturum açın ve telefonu bağlayın

   Her WhatsApp numarası ayrı bir oturum (session) olarak tutulur. node-bridge engine ile, oturum başlatıldığında bir QR kodu üretilir; telefon WhatsApp uygulamasından Ayarlar → Bağlı Cihazlar → Cihaz Bağla ile bu QR'i tarayarak eşleşir. Eşleşme sonrası auth state diskte saklanır; servis yeniden başlasa bile rescan gerekmez.

   # Oturum oluştur
   curl -X POST https://wapi.erp.tr/api/sessions \
        -H "X-API-Key: $YOUR_API_KEY" -H "Content-Type: application/json" \
        -d '{ "name": "satis-departmani", "proxyUrl": null, "proxyType": null }'
   
   # Yanıttaki id'yi sakla; bundan sonra her uçta o id geçecek.
   SESSION_ID=...
   
   # Oturumu başlat (engine'i ayağa kaldırır; QR üretir)
   curl -X POST https://wapi.erp.tr/api/sessions/$SESSION_ID/start \
        -H "X-API-Key: $YOUR_API_KEY"
   
   # QR'i çek — base64 PNG olarak döner (img src'ye doğrudan verilebilir)
   curl https://wapi.erp.tr/api/sessions/$SESSION_ID/qr \
        -H "X-API-Key: $YOUR_API_KEY"
   # { "sessionId": "...", "qrCode": "data:image/png;base64,iVBORw...", "status": 0 }

3. 3 · Mesaj gönderin

   Oturum connected duruma geçtikten sonra herhangi bir mesaj uç noktası çağrılabilir. Aşağıda her dilde, gerçek üretim koduna yakın bir minimal entegrasyon vardır.

   C# VB.NET Java curl HTTP / Swagger

   // .NET 8+ — HttpClient ile minimal istemci
   using System.Net.Http.Headers;
   using System.Net.Http.Json;
   
   var http = new HttpClient { BaseAddress = new Uri("https://wapi.erp.tr") };
   http.DefaultRequestHeaders.Add("X-API-Key", "YOUR_API_KEY");
   
   // Mesaj gönder
   var payload = new { chatId = "905321234567@s.whatsapp.net", text = "Merhaba!" };
   var res = await http.PostAsJsonAsync($"/api/sessions/{sessionId}/messages/send-text", payload);
   res.EnsureSuccessStatusCode();
   var msg = await res.Content.ReadFromJsonAsync<MessageDto>();
   Console.WriteLine($"WApi message id: {msg!.Id}  WhatsApp id: {msg.WaMessageId}");
   
   // Hata kontrolü
   if (msg.Status == MessageStatus.Failed)
       throw new Exception("Mesaj engine tarafından kabul edilmedi.");
   
   public record MessageDto(Guid Id, Guid SessionId, string? WaMessageId,
       string ChatId, string? Body, int Type, int Direction, int Status,
       long Timestamp, DateTime CreatedAt);
   
   public enum MessageStatus { Pending = 0, Sent = 1, Delivered = 2, Read = 3, Failed = 4 }