WhatsApp Ads Conversions API 2026: CTWA Kampanyaları için CAPI Kurulumu [Teknik Kılavuz]

SendSeven Team, Editorial Team

Click-to-WhatsApp Ads kampanyalarını Conversions API olmadan yürütenler, ölçülebilir dönüşümlerinin yüzde 20–40'ını kaybediyor. Bu teknik kılavuz: sunucu tarafı CAPI kurulumu, CTWA için dört standart etkinlik, Click-ID eşleme, SHA-256 hashleme ve SendSeven webhook entegrasyonu.

Bu makale, Click-to-WhatsApp Ads ana rehberinin Conversions API bölümünü derinleştirir. 7 adımlık CTWA kurulumunu tamamlayanlar için bu yazı teknik izleme katmanını açıklar.

Neden piksel tek başına yetmez

Meta pikseli, tarayıcıda çalışan bir JavaScript takip aracıdır. Son yıllarda güvenilirliği ciddi ölçüde düştü:

• Apple App Tracking Transparency (iOS 14.5, Nisan 2021) — Pazara ve hedef kitleye bağlı olarak iOS kullanıcılarının yüzde 60–75'i takibi reddediyor — gizlilik konusunda hassas pazarlarda bu oranın üst bandına yaklaşılıyor.
• Tarayıcı gizlilik kısıtlamaları — Safari (ITP) ve Firefox üçüncü taraf çerezleri tamamen engelliyor.
• Reklam engelleyiciler (uBlock Origin, AdBlock Plus, Brave) piksel isteklerini ağ düzeyinde bloke ediyor.
• iOS 17 ve sonrası — Link Tracking Protection, Mail ve mesajlardaki URL'lerden takip parametrelerini temizliyor.

Pratik sonuç: yalnızca piksel kullanan yapılar tipik olarak ölçülebilir dönüşümlerin yüzde 20–40'ını kaybediyor. CTWA için sorun daha da keskin: gerçek dönüşüm WhatsApp sohbetinde gerçekleşiyor. Piksel reklam tıklamasını görür ama leadın nitelendirilip nitelendirilmediğini, randevunun alınıp alınmadığını ya da satın almanın tamamlanıp tamamlanmadığını göremez. CAPI olmadan Meta algoritması, nitelikli konuşmalar yerine tıklamalar için optimize eder.

CAPI teknik olarak nasıl çalışır

CAPI pikselin yerini almaz, onu tamamlar. Dört adımlık iş akışı:

CTWA hunileri için dört standart etkinlik

Öneri: önce Lead ve Purchase ile başlayın — bunlar iki minimum etkinliktir. Huni stabil çalışınca Schedule ve AddToCart ekleyin.

Click-ID eşleme ve atıf

Meta'nın sunucu dönüşümünü orijinal reklama atfedebilmesi için CAPI etkinliğinin bir tıklama tanımlayıcısına ihtiyacı vardır. CTWA'da Meta, reklam tıklandığında bu tanımlayıcıyı WhatsApp'a iletir (ctwa_clid gibi dahili parametreler aracılığıyla).

Pratik akış:

1. Kullanıcı CTWA reklamını tıklar → Meta bir Click-ID oluşturur ve WhatsApp'a iletir.
2. WhatsApp, Click-ID'yi ilk mesajla birlikte platform gelen kutusuna iletir.
3. Platform Click-ID'yi kişi profiline kaydeder.
4. Dönüşüm gerçekleştiğinde (örn. gelen kutusunda „Lead” etiketi), platform kayıtlı Click-ID'yi alır ve sunucu etkinliğiyle birlikte Meta'ya gönderir.
5. Meta reklamı bulur ve dönüşümü kampanya hesabına atfeder.

Click-ID kalıcılığı olmayan platform kullananlar atıfın büyük bölümünü kaybeder. SendSeven webhooklarıyla, CTWA reklamından gelen ilk inbound mesajda ctwa_clid'yi referans parametresi olarak alırsınız — bunu REST API aracılığıyla kişi profiline kendiniz kaydedin.

Kullanıcı verilerinin SHA-256 hashlenmesi

Kişisel veriler Meta'ya açık metin olarak gönderilemez. Conversions API şu alanlar için SHA-256 ile hashleme zorunlu kılar:

• E-posta (em) — hashlemeden önce: kırp ve küçük harfe çevir
• Telefon numarası (ph) — artı işareti olmadan E.164 formatı, yalnızca rakamlar
• Ad / Soyad (fn / ln) — kırp, küçük harfe çevir, özel karakterleri kaldır
• Şehir / İl / Posta kodu — hashlemeden önce aynı şekilde normalleştir
• External ID — kendi dahili kullanıcı ID'niz, yine hashlenmiş

Meta hashleri kendi veri kümeleriyle karşılaştırır; açık metin veriler iletilmez veya kalıcı olarak saklanmaz. KVKK açısından işlem yine de bilgilendirme yükümlülüğüne tabidir — bkz. makale CTWA ve KVKK.

Örnek etkinlik payload'u

CTWA hunisinden bir Lead etkinliği için tam CAPI JSON payload'u:

POST https://graph.facebook.com/v19.0/<PIXEL_ID>/events

{
  "data": [{
    "event_name": "Lead",
    "event_time": 1746091800,
    "event_source_url": "https://wa.me/90501XXXXXXX",
    "action_source": "business_messaging",
    "messaging_channel": "whatsapp",
    "user_data": {
      "ph": ["a1b2c3d4..."],          // SHA-256 hashlenmiş telefon
      "em": ["e5f6a7b8..."],          // SHA-256 hashlenmiş e-posta
      "ctwa_clid": "ARDEr...",         // CTWA Click-ID
      "client_user_agent": "Mozilla/5.0..."
    },
    "custom_data": {
      "currency": "EUR",
      "value": 50.00,                  // lead değeri
      "content_name": "Tadilat hizmet talebi"
    }
  }],
  "access_token": "<ACCESS_TOKEN>"
}

CAPI ve çerez onayı

Tarayıcı tarafından tetiklenen CAPI etkinlikleri (örn. sitenizde „Satın Al” butonuna basıldığında) piksel ile aynı onay yükümlülüğüne tabidir — çerez bannerında pazarlama onayı gerektirir.

Saf sunucu tarafı etkinliklerde ise durum farklıdır (örn. WhatsApp gelen kutusundaki „Lead” etiketi CAPI etkinliğini tetiklediğinde): bu tetikleyici tarayıcı eylemi değil, bilinçli bir iş eylemidir. Yasal dayanak (genellikle KVKK md. 5/2(c) veya meşru menfaat) ve gizlilik politikasında bilgilendirme mevcutsa ek çerez onayı gerekmez.

Pratikte: CTWA için CAPI etkinlikleri tipik olarak saf sunucu tarafı etkinlikleridir — tetikleyici tarayıcı tıklaması değil, platform üzerindeki eylemdir. Bu, KVKK açısından en temiz izleme yollarından biridir.

SendSeven ile CAPI entegrasyonu — Webhooks ve REST API

SendSeven şu an için UI tabanlı bir CAPI entegrasyonuna sahip değildir. WhatsApp hunisinden Meta'ya CAPI etkinliği göndermek isteyenler bunu mevcut geliştirici bloklarıyla — webhooks ve REST API — kendileri kurar. Gerekli her şey bu bloklarda mevcuttur. Dört adım:

1. SendSeven'da webhook yapılandırın. Konuşma durumu değiştiğinde veya gelen mesaj geldiğinde sunucunuza payload gönderen bir endpoint kaydedin. Yapılandırma rehberi için webhook kılavuzuna bakın.
2. Sunucu handler'ı oluşturun. Sunucunuz webhook etkinliğini alır, Conversation-ID, Contact-ID ve durum bilgisini çıkarır. Gerekirse kişi verilerini (e-posta, telefon) almak için SendSeven REST API'ye ek çağrılar yapılır.
3. CAPI payload'u oluşturun. Kullanıcı verilerini SHA-256 ile hashleyin, kişi profilinden Click-ID'yi alın, event_name ve gelir değeriyle custom_data'yı doldurun.
4. Meta Graph API'ye HTTPS POST gönderin: graph.facebook.com/v<version>/<PIXEL_ID>/events — System User Access Token ile.

Click-ID kalıcılığını kendiniz kurarsınız: WhatsApp Business API, CTWA reklamından gelen ilk inbound mesajda ctwa_clid'yi referans parametresi olarak sağlar — ilk mesaj geldiğinde hemen kişi profiline kaydedin. SHA-256 hashleme, kullandığınız dilin standart kriptografi kütüphanesiyle (Python hashlib, Node crypto, PHP hash) tek satırda halledilir.

Yaygın uygulama hataları

1. Veri hashlemeden göndermek. Meta etkinliği sessizce reddeder veya eşleme oranını sıfıra düşürür. Göndermeden önce daima SHA-256 uygulayın.
2. Click-ID kalıcılığı olmaması. ctwa_clid'yi kişi profiline kaydetmeyenler, etkinlik doğru gönderilse bile atıfı kaybeder.
3. Tekilleştirme olmadan çift izleme. Hem piksel hem CAPI aynı etkinliği event_id olmadan gönderirse Meta dönüşümleri iki katına çıkarır.
4. Üretim izlemede test etkinlikleri. Unutulan test etkinlikleri birikerek optimizasyon verilerini bozar.
5. Yanlış action_source. CTWA etkinlikleri website değil business_messaging gerektirir.
6. 7 günden eski etkinlik zaman damgası. Meta, 7 günden eski zaman damgalı etkinlikleri kabul etmez.

SSS

72 saatlik Free Entry Point kullanıyor olsam bile CAPI'ye ihtiyacım var mı?

Evet — bu durumda bile CAPI, Meta'ya sohbetin gerçek bir dönüşümle sonuçlandığını bildirmenin tek yoludur. CAPI olmadan Meta yalnızca tıklamayı görür ve algoritmasını iş sonuçları yerine tıklamalar için optimize eder.

CTWA için CAPI'de normal eşleme oranı nedir?

İyi yapılandırılmış kurulumlarda eşleme oranı yüzde 85–95 arasındadır (Meta Events Manager Diagnostics'e göre); bu, yalnızca pikselin (yüzde 60–75) çok üzerindedir. Temel neden: telefon numarası ve Click-ID çok kararlı eşleme anahtarlarıdır.

CAPI'yi sonraki CRM iş akışıyla nasıl birleştirebilirim?

İdeal olarak CRM'deki durum değişikliği (örn. „Lead”'den „Customer”'a) bir CAPI etkinliği tetikler. SendSeven webhooklarıyla bu tetikleyiciyi kendiniz kurabilirsiniz — CRM durum değişimi olayı sunucunuzda CAPI POST'unu tetikler.

CAPI'yi platform olmadan doğrudan kendim uygulayabilir miyim?

Teknik olarak evet — Python, Node veya PHP Server-Side SDK ile. Pratik olarak Click-ID kalıcılığı, hashleme pipeline'ı, etkinlik tekilleştirme ve denetim günlüğü gerektirir. Çoğu Türk KOBİ için entegre platform çözümü çok daha verimlidir.

Daha fazla okuma:

• Pillar: Click-to-WhatsApp Ads 2026 — Kapsamlı Rehber
• S1: 7 Adımda Kurulum
• S2: KVKK Uyumluluğu
• S3: Maliyet ve ROI
• Sözlük: Meta Conversions API
• Meta Conversions API — resmi geliştirici dokümantasyonu