API Entegrasyonu

MsgTR REST API ile WhatsApp mesajlaşmasını kendi web sitenize, CRM’inize veya uygulamanıza entegre edin.

API Anahtarı Oluşturma

1. MsgTR panelinde Ayarlar sayfasına gidin
2. “Yeni Anahtar” butonuna tıklayın
3. Anahtar adını girin ve gerekli izinleri seçin
4. Oluşturulan anahtarı güvenli bir yere kaydedin (tekrar gösterilmez)

Kimlik Doğrulama

Tüm API isteklerinde Authorization başlığını kullanın:

Authorization: Bearer gw_sizin_api_anahtariniz

Mesaj Gönderme

POST /v1/messages/send
Content-Type: application/json

{
  "session_id": "oturum-uuid",
  "to": "905551234567",
  "type": "text",
  "content": "Siparişiniz hazır, teslim alabilirsiniz."
}

Desteklenen mesaj tipleri

• text: Düz metin mesajı
• image: Fotoğraf (URL ile)
• document: Belge/PDF (URL ile)

Sohbetleri Listeleme

GET /v1/conversations?session_id=oturum-uuid

Mesaj Geçmişi

GET /v1/conversations/905551234567?session_id=oturum-uuid&page=1&limit=50

Webhook Kurulumu

Yeni mesaj geldiğinde anında bildirim almak için webhook ekleyin:

POST /v1/webhooks
{
  "url": "https://siteniz.com/webhook",
  "events": ["message.received", "session.connected"]
}

Webhook güvenliği

Her webhook isteği X-Gowapp-Signature başlığıyla HMAC-SHA256 imzalanır. Webhook oluştururken size verilen secret ile doğrulayabilirsiniz.

WebSocket ile Gerçek Zamanlı Bağlantı

ws://api.msgtr.com/v1/ws?api_key=gw_sizin_api_anahtariniz

// Kanal abone olma
{"action": "subscribe", "channel": "messages:905551234567"}

// Gelen mesaj eventi
{"event": "message.received", "data": {...}}

Rate Limit

• Başlangıç: 30 istek/dakika
• İşletme: 200 istek/dakika
• Kurumsal: 1000 istek/dakika

Rate limit bilgisi yanıt başlıklarında döner: X-RateLimit-Limit ve X-RateLimit-Remaining

Tam API Dokümantasyonu

Tüm endpointlerin detaylı dokümantasyonu için OpenAPI (Swagger) spesifikasyonuna bakabilirsiniz.