REST tabanlı SMS API ile CRM, e-ticaret, çağrı merkezi ve web uygulamalarınızdan toplu SMS, OTP doğrulama ve zamanlanmış mesaj gönderin.
REST tabanlı SMS API ile mevcut sistemlerinizden toplu SMS, OTP SMS ve zamanlanmış mesaj gönderin. JSON formatında istek ve yanıt, HTTPS zorunlu, API anahtarı ile kimlik doğrulama.
API anahtarınızı KobiKom panelinden > Ayarlar > API Anahtarları bölümünden alabilirsiniz.
curl -X POST https://api.kobikom.com.tr/v1/sms/bulk \
-H "Authorization: Bearer <API_ANAHTARI>" \
-H "Content-Type: application/json" \
-d '{
"recipients": [
"+905551234567",
"+905559876543",
"+905553334444"
],
"message": "Kampanyamızda %30 indirim fırsatı! Detaylar: kobikom.com.tr",
"sender": "KOBIKOM",
"campaignName": "Mart2026"
}'{
"success": true,
"batchId": "batch_xk9p2mq7r",
"totalRecipients": 3,
"queued": 3,
"filtered": 0,
"estimatedDelivery": "~5 saniye",
"creditUsed": 3,
"creditRemaining": 9997,
"campaignName": "Mart2026",
"createdAt": "2026-03-24T10:30:00Z"
}Panel > Ayarlar > Webhook bölümünden callback URL tanımlayın. Her SMS teslimatında veya hata durumunda POST isteği alırsınız.
{
"event": "sms.delivered",
"messageId": "msg_abc123xyz",
"to": "+905551234567",
"status": "delivered",
"deliveredAt": "2026-03-24T10:30:04Z",
"operator": "Turkcell"
}Rate limit aşıldığında 429 Too Many Requests döner. Retry için Retry-After header\'ını kontrol edin.
Türkiye'de ticari SMS göndermek için İleti Yönetim Sistemi (IYS) izin sorgulaması yasal zorunluluktur. KobiKom SMS API, her gönderimde IYS sorgusunu otomatik yapar. Kendi altyapınız varsa POST /v2/iys/query endpoint'ini kullanabilirsiniz.
# IYS İzin Sorgulama — SMS Göndermeden Önce
curl -X POST https://api.kobikom.com.tr/v2/iys/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"recipient": "+905xxxxxxxxx",
"channel": "SMS",
"brand_code": "YOUR_BRAND_CODE"
}'
# Başarılı Yanıt
{
"status": "success",
"recipient": "+905xxxxxxxxx",
"consent": "APPROVED",
"consent_date": "2025-03-15T14:22:10Z",
"query_id": "iys_qry_8f3a2c1d"
}# Toplu IYS Kontrolü — Kampanya Listesi
{
"recipients": ["+905111111111", "+905222222222", "+905333333333"],
"channel": "SMS",
"brand_code": "YOUR_BRAND_CODE"
}
# Yanıt: Her numara için consent durumu
{
"results": [
{ "recipient": "+905111111111", "consent": "APPROVED" },
{ "recipient": "+905222222222", "consent": "REJECTED" },
{ "recipient": "+905333333333", "consent": "APPROVED" }
],
"summary": { "total": 3, "approved": 2, "rejected": 1 }
}KobiKom SMS API'sini entegre etmeden önce Postman üzerinde tüm endpoint'leri test edebilirsiniz. Environment variable, Bearer Token ayarları, bulk SMS, OTP ve durum sorgulama adımlarının tamamı rehberde.
Teknik ekibimiz entegrasyon sürecinde size destek verir. Sandbox ortamında testlerinizi yapın, canlıya geçişi sorunsuz tamamlayın.