KobiKom SMS API entegrasyon rehberi

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önderebilirsiniz. İstek ve yanıtlar JSON formatındadır, HTTPS zorunludur ve kimlik doğrulama API anahtarıyla yapılır.

Entegrasyon üç adımda başlar: panelden API anahtarı alınır, HTTPS üzerinden Bearer Token ile kimlik doğrulanır ve ilk istek gönderilir. Canlıya geçmeden önce sandbox ortamında test yapılabilir.

Mesaj Gönderim Uçları

Tekil gönderim, toplu gönderim, OTP gönderimi ve zamanlanmış gönderim için ayrı uç noktalar bulunur. Toplu gönderimde tek istekte çok sayıda alıcıya mesaj iletilir; zamanlanmış gönderimde mesaj ileri bir tarihe kuyruklanır.

Durum ve Raporlama

Gönderilen her mesajın teslim durumu kimliğiyle sorgulanabilir. Dönemsel rapor uçları gönderim özetini verir, bakiye ucu kalan kredi bilgisini döner. Böylece kredi tükenmeden önce uyarı mekanizması kurulabilir.

OTP Doğrulama

Üyelik, giriş ve işlem onayı akışlarında kullanılan tek kullanımlık şifre gönderimleri için ayrı uç nokta sunulur. OTP mesajları öncelikli kuyrukta işlenir; gecikmenin kullanıcı deneyimini doğrudan etkilediği akışlar için tasarlanmıştır.

IYS İzni Kontrolü

Ticari içerikli SMS göndermeden önce alıcının İleti Yönetim Sistemi’ndeki izin durumu doğrulanmalıdır. KobiKom IYS yetkili entegratörü olduğu için izin sorgulaması gönderim akışına gömülü çalışır; izinsiz alıcılar otomatik ayıklanır ve kredi harcanmaz.

Postman ile Test

Kod yazmadan önce uç noktaları Postman üzerinden deneyebilirsiniz. Sandbox ortamında gerçek gönderim yapılmadan istek ve yanıt yapısı doğrulanır; entegrasyon hataları canlıya çıkmadan görülür.

API anahtarı alın Toplu SMS hizmetini inceleyin Postman test rehberini okuyun