API Nedir? API Entegrasyonu: WhatsApp, SMS, e-Fatura Örnekleri

API (Application Programming Interface, uygulama programlama arayüzü), iki yazılımın birbiriyle önceden belirlenmiş kurallarla konuşmasını sağlayan arayüzdür. API entegrasyonu ise kendi yazılımınızı bu arayüz üzerinden başka bir sisteme bağlamaktır. Müşteriye otomatik WhatsApp mesajı göndermek, randevu hatırlatması için SMS atmak ya da faturayı e-Fatura sistemine iletmek buna örnektir. Doğru kurduğunuzda elle yapılan tekrar işleri azaltır. Yanlış kurulduğunda ise sessizce veri kaybına ya da yasal sorunlara yol açabilir.

API nedir?

MDN Web Docs'un tanımıyla API, bir yazılımın içindeki, başka yazılımların onunla etkileşim kurmasını sağlayan özellikler ve kurallar bütünüdür. İnsanın kullandığı arayüzün (ekran, buton) aksine, API yazılımın yazılımla konuştuğu arayüzdür. MDN bunu, uygulama ile onu kullanan diğer yazılımlar arasındaki basit bir "sözleşme" olarak da tarif eder.

Gündelik bir benzetme: Restoranda siz mutfağa girmezsiniz. Garsona menüden sipariş verirsiniz, garson mutfağa iletir ve yemeği getirir. Menü, neyi hangi biçimde isteyebileceğinizi belirler. API de böyledir: Hangi isteği hangi adrese, hangi biçimde gönderebileceğinizi ve nasıl bir cevap alacağınızı tanımlar.

Bir web sitesinin ön yüzü ile arka yüzü de çoğu zaman bir API üzerinden konuşur. Bu ilişkiyi Frontend ve Backend Nedir? yazımızda anlattık.

API entegrasyonu işletmenize ne kazandırır?

• Elle tekrar girişi azaltır. Teklif onaylanınca bilgiler muhasebeye otomatik düşer; aynı veriyi iki kez yazmazsınız.
• Hızlandırır. Sipariş, kargo ya da servis durumu değiştiğinde müşteri anında bilgilendirilir.
• Hatayı azaltır. Elle kopyalama sırasında oluşan yazım hataları ortadan kalkar.
• Kayıt bırakır. Hangi mesajın ne zaman gönderildiği, hangi faturanın iletildiği sistemde izlenebilir.

Ama her entegrasyon, iki sistemi birbirine bağımlı hale getirir. Karşı sistem değiştiğinde, kapandığında ya da yavaşladığında sizin yazılımınızın ne yapacağı baştan tasarlanmalıdır.

Örnek 1: WhatsApp Business Platform

WhatsApp'ı işletmeniz için kullanmanın iki ayrı yolu vardır. İlki, telefona kurulan WhatsApp Business uygulamasıdır; bir kişinin elle mesajlaştığı yöntemdir. İkincisi, yazılımların kullandığı WhatsApp Business Platform'dur (Cloud API). Bu yazıdaki entegrasyon konusu ikincisidir.

Meta'nın geliştirici belgelerine göre Cloud API; metin, medya ve etkileşimli mesajları programla göndermeyi sağlar. Gelen mesajlar ve teslim durumları, sizin sisteminize webhook (karşı sistemin bir olay olduğunda sizin adresinize otomatik bildirim göndermesi) ile gelir.

Entegrasyon kurarken bilmeniz gereken temel kurallar (Eylül 2025 itibarıyla):

• 24 saatlik müşteri hizmeti penceresi: Bir kullanıcı size mesaj yazdığında 24 saatlik bir pencere açılır. Bu pencere içinde serbest metinle cevap verebilirsiniz.
• Pencere dışında yalnız şablon mesaj: Pencere kapalıyken yalnız şablon (template) mesajlar gönderilebilir. Şablonların kullanılabilmesi için Meta tarafından onaylanmış olması gerekir.
• Şablon kategorileri: Pazarlama (marketing), hizmet bildirimi (utility) ve kimlik doğrulama (authentication).
• Ücretlendirme: Meta, 1 Temmuz 2025'ten itibaren konuşma bazlı ücretlendirmeden mesaj başına ücretlendirmeye geçti. Ücret, şablon kategorisine ve alıcının ülke koduna göre değişir; açık pencere içindeki serbest mesajlar ücretsizdir. Güncel tarifeyi Meta'nın sayfasından kontrol edin.

Pratikte bu şu demek: "Servis randevunuz yarın saat 10:00'da" gibi otomatik bir hatırlatma göndermek isteyebilirsiniz. Bunun için önceden onaylanmış bir şablon hazırlamanız ve mesajı değişken alanlarla (isim, tarih, saat) doldurmanız gerekir.

Örnek 2: SMS entegrasyonu ve İYS

SMS entegrasyonunu genellikle bir SMS hizmet sağlayıcısının API'si üzerinden kurarsınız. Yazılımınız alıcı numarasını ve metni sağlayıcıya iletir. Ardından sağlayıcı mesajı operatörlere ulaştırır ve teslim raporunu geri döner.

Teknik kısım çoğu zaman kolaydır; dikkat edilmesi gereken asıl konu hukuki çerçevedir. Türkiye'de ticari elektronik iletiler (SMS, e-posta, arama), Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik ile düzenlenir. Yönetmeliğe göre:

• Ticari elektronik ileti göndermek isteyen gerçek ve tüzel kişiler İYS'ye kaydolur.
• Tanıtım ve pazarlama amaçlı iletiler için alıcıdan önceden onay alınır ve İYS üzerinde onayı bulunmayan alıcılara ticari elektronik ileti gönderilemez.
• Devam eden abonelik, tahsilat, borç hatırlatma, satın alma ve teslimat gibi bildirim iletileri için önceden onay aranmaz. Ancak bu iletilerde herhangi bir mal ya da hizmet tanıtılamaz.

Yazılım açısından bunun anlamı şudur: Sisteminiz "bildirim" ile "tanıtım" iletisini ayırt edebilmeli; tanıtım iletilerinde onay durumunu kontrol etmelidir. "Servis kaydınız tamamlandı" bir bildirimdir; aynı mesaja "bu ay filtrelerde indirim" eklemek onu tanıtıma çevirir.

Örnek 3: e-Fatura entegrasyonu (GİB)

e-Fatura, faturanın elektronik ortamda, Gelir İdaresi Başkanlığı'nın (GİB) belirlediği standartlara uygun olarak düzenlenmesi ve alıcıya iletilmesidir. GİB, e-Fatura uygulamasından yararlanmak için üç yöntem tanımlar:

Bir işletme yazılımı (CRM, sipariş ya da iş takip sistemi) e-Fatura ile çalışacaksa bağlantı çoğunlukla özel entegratörün API'si üzerinden yapılır. Ya da yazılım, faturayı zaten e-Fatura gönderebilen bir ön muhasebe programına aktarır. Hangi yolun uygun olduğu, mevcut muhasebe düzeninize ve fatura hacminize bağlıdır. e-Fatura'ya geçiş zorunluluğunu ve kapsamını mevzuat belirler ve bunlar zaman içinde değişebilir. Bu yüzden kendi durumunuzu mali müşavirinizle kontrol edin.

Entegrasyon kurarken kontrol listesi

1. Belge var mı? Karşı sistemin API belgeleri güncel ve açık mı?
2. Test ortamı var mı? Gerçek müşteriye mesaj göndermeden, gerçek fatura kesmeden deneme yapılabiliyor mu?
3. Kimlik bilgileri kimde? API anahtarları ve hesaplar işletmenin adına mı, yoksa geliştiricinin kişisel hesabında mı?
4. Hata olursa ne olacak? Karşı sistem cevap vermezse istek yeniden denenecek mi, kayıt düşülecek mi, kim haberdar olacak?
5. Kayıt tutuluyor mu? Gönderilen her mesaj ve fatura için zaman, durum ve hata bilgisi saklanıyor mu?
6. Yasal kurallar tasarıma yansıdı mı? İYS onayı, KVKK kapsamında aydınlatma ve şablon onayları gibi konular yazılımın akışına dahil mi?
7. Ücretlendirme biliniyor mu? Mesaj ve işlem başına ücretler bütçeye eklendi mi?

Entegrasyonların bütçeye etkisini Özel Yazılım Maliyeti Neye Göre Belirlenir? yazımızda anlattık. E-ticaret tarafındaki ödeme ve kargo bağlantılarını ise E-Ticaret Altyapısı yazımızda ele aldık.

Bizim deneyimimiz

Kurumsal web projelerinde "WhatsApp entegrasyonu" denince çoğu zaman kastedilen, aslında bir API entegrasyonu değil, tek dokunuşla telefon araması ya da WhatsApp sohbeti başlatan aksiyonlardır. Örneğin Tuğra Karot sitesinde telefon ve WhatsApp aksiyonları bu amaçla yer alıyor. Bu yöntem, ziyaretçinin sizinle sohbet başlatmasını kolaylaştırır ama otomatik mesaj göndermez. Otomatik bildirim gerekiyorsa WhatsApp Business Platform entegrasyonu gerekir. İkisini ayırmak, bütçeyi doğru planlamanın ilk adımıdır.

Özel yazılım projelerinde (CRM, panel, SaaS, API) entegrasyonları ayrı iş kalemi olarak ele alıyoruz. Her bağlantı için hata durumunu, kayıt tutmayı ve hesapların işletme adına açılmasını baştan planlıyoruz.

Sık sorulan sorular

Sonuç

API entegrasyonu, yazılımlarınızın birbirine elle değil, kurallı ve kayıtlı biçimde veri aktarmasını sağlar. WhatsApp, SMS ve e-Fatura örneklerinde gördüğünüz gibi işin teknik kısmı kadar karşı tarafın kuralları (şablon onayı, İYS, GİB yöntemleri) de tasarımın parçasıdır. Mevcut sistemlerinizi birbirine bağlamak ya da yeni bir yazılımı baştan entegrasyonlarla kurmak istiyorsanız Yazılım ve Dijital Çözümler sayfamıza göz atabilirsiniz. Dilerseniz bizimle iletişime de geçebilirsiniz.