Bağlantı bilgilerini alın,
doğru alanlara güvenle girin.

Canlı bağlantı için aşağıdakiler hazır olmalıdır:

• Yönetici erişiminiz olan bir Facebook/Meta hesabı
• Meta Business Suite içinde bir Business Portfolio (işletme portföyü)
• İşletmeye ait görünen ad, yasal bilgiler ve gerektiğinde doğrulama belgeleri
• SMS veya sesli arama ile doğrulama kodu alabilen bir telefon numarası
• İnternetten erişilebilen, geçerli SSL sertifikalı HTTPS alan adı

1. business.facebook.com adresinde oturum açın.
2. Sol üstteki işletme seçicisinden mevcut işletmenizi seçin. Yoksa yeni bir işletme portföyü oluşturun.
3. Ayarlar → İşletme ayarları bölümünde işletme adı, adres, web sitesi ve iletişim bilgilerinin doğru olduğunu kontrol edin.
4. Güvenlik Merkezi / Security Center bölümünde Meta sizden işletme doğrulaması isterse belgeleri gönderin.
5. En az iki güvenilir yönetici tanımlayın ve hesaplarda iki faktörlü doğrulamayı etkinleştirin.

1. developers.facebook.com/apps sayfasına gidin ve Create App / Uygulama Oluştur düğmesine basın.
2. Meta arayüzündeki seçenekler sürüme göre değişebilir. WhatsApp veya işletme mesajlaşması kullanım senaryosunu seçin.
3. Uygulama adını ve iletişim e-postasını girin; doğru Business Portfolio ile ilişkilendirin.
4. Uygulama panelinde Add products / Ürün ekle bölümünden WhatsApp ürününü kurun.
5. Sol menüden WhatsApp → API Setup / Getting Started ekranını açın.

Bu ekran ilk kurulumda size Meta test numarası, geçici erişim tokeni, Phone Number ID ve WABA ID sağlar. Önce bu değerlerle bağlantıyı sınayabilirsiniz.

1. API Setup ekranındaki geçici tokeni görüntüleyin.
2. To / Alıcı alanına kendi telefonunuzu ekleyin ve Meta’nın gönderdiği doğrulama kodunu tamamlayın.
3. Meta’nın hazır hello_world şablonuyla test mesajı gönderin.
4. Mesaj telefonunuza ulaşıyorsa uygulama, alıcı ve temel Cloud API bağlantısı çalışıyor demektir.

1. Meta uygulamasında WhatsApp → API Setup → Add phone number adımını açın.
2. WhatsApp’ta görünecek işletme adını, kategoriyi, saat dilimini ve açıklamayı girin.
3. Ülke koduyla birlikte telefon numarasını yazın.
4. SMS veya sesli arama doğrulamasını seçip gelen kodu girin.
5. Meta isterse telefon kaydı için altı haneli iki adımlı doğrulama PIN’i belirleyin. Bu PIN erişim tokeni değildir; güvenli bir yerde ayrıca saklayın.
6. WhatsApp Manager içinde numaranın durumunu, görünen ad onayını ve kalite bilgisini kontrol edin.

Bu değerler ayrıca WhatsApp Manager içindeki telefon numarası ayrıntılarında bulunabilir. Birden fazla WABA veya telefon varsa bu üç değerin aynı işletme ve uygulamaya ait olduğunu kontrol edin.

1. Meta Business Settings sayfasında doğru işletmeyi seçin.
2. Users / Kullanıcılar → System Users / Sistem Kullanıcıları bölümüne gidin.
3. Add / Ekle ile yalnızca bu entegrasyon için bir sistem kullanıcısı oluşturun. Gerekli varlık atamalarını yapabilecek uygun rolü seçin.
4. Add Assets / Varlık Ekle ile Meta uygulamanızı ve WhatsApp hesabınızı bu kullanıcıya atayın. Mesaj yönetimi için gereken tam kontrol/mesajlaşma yetkilerini verin.
5. Generate New Token / Yeni Token Oluştur düğmesine basın ve bu projeye bağlı uygulamayı seçin.
6. En az whatsapp_business_messaging ve whatsapp_business_management izinlerini işaretleyin. İşletme varlıklarını API ile yönetiyorsanız Meta ayrıca business_management isteyebilir.
7. Meta arayüzünde süre seçimi sunuluyorsa kullanım politikanıza uygun uzun süreli seçeneği belirleyin. Oluşan tokeni hemen güvenli parola kasanıza kaydedin.

1. Panelde WhatsApp Ayarları sayfasını açın.
2. Yukarıdaki değerleri girin.
3. Webhook anahtarı için en az 32 karakterlik rastgele bir değer üretin ve ayrıca parola kasasında saklayın.
4. İlk kayıtta Mock test modu açık kalsın, Entegrasyon aktif açık olsun ve ayarları kaydedin.
5. Webhook başarıyla doğrulandıktan sonra Mock test modunu kapatıp tekrar kaydedin.

Sistem, ürün tablosundaki uygun kayıtları Meta’nın desteklediği CSV veri feed’ine dönüştürür. Stok kodu Meta’daki product_retailer_id olur; ürün adı, açıklama, fiyat, stok, görsel ve ürün bağlantısı düzenli güncellenir.

1. Commerce Manager içinde bir e-ticaret ürün kataloğu oluşturun veya mevcut kataloğu seçin.
2. Katalog → Ayarlar bölümündeki Catalog ID değerini paneldeki Meta Katalog ID alanına girip kaydedin.
3. Panelin oluşturduğu Planlanmış ürün feed URL’sini kopyalayın.
4. Commerce Manager’da Veri Kaynakları → Veri Feed’i → Planlanmış Feed yolunu açın ve URL’yi ekleyin.
5. Para birimini TRY, ülkeyi Türkiye ve çekim sıklığını işletme ihtiyacınıza göre günlük veya saatlik seçin.
6. İçe aktarma tamamlanınca hata raporunda görsel, fiyat, bağlantı ve stok alanlarını kontrol edin.
7. WhatsApp Manager içinde bu kataloğu doğru WABA/telefon numarasıyla ilişkilendirin.

Meta’nın sunucusu aşağıdaki adrese doğrulama isteği ve daha sonra mesaj/durum olayları gönderir:

1. Önce bu panelde Webhook doğrulama anahtarını belirleyin, entegrasyonu aktif edin ve kaydedin.
2. Meta uygulamanızda WhatsApp → Configuration bölümünü açın. Bazı arayüzlerde aynı alan Webhooks ürünü altında olabilir.
3. Callback URL alanına yukarıdaki HTTPS adresini girin.
4. Verify Token alanına panelde oluşturduğunuz webhook doğrulama anahtarının aynısını, boşluk eklemeden girin.
5. Verify and Save düğmesine basın. Meta bir GET isteği gönderir; sistem anahtar eşleşirse Meta’nın challenge değerini döndürür.
6. Webhook alanlarında messages olayına abone olun. Bu alan gelen mesajları ve gönderim/teslim/okunma/hata durumlarını taşır.
7. Uygulamanın doğru WABA’ya abone olduğundan emin olun. Bir WABA aboneliği, o WABA altındaki telefonların olaylarını kapsar.

1. Mock test modunu kapatıp entegrasyonu aktif kaydedin.
2. Test telefonundan işletme numaranıza bir WhatsApp mesajı gönderin.
3. Panelde WhatsApp → Görüşmeler ekranını açın; yeni konuşmanın oluştuğunu kontrol edin.
4. Panelden yanıt gönderin. Mesaj önce kuyruğa alınır.
5. Sunucuda aşağıdaki kuyruk komutunu çalıştırın veya dakikada bir cron görevi olarak tanımlayın.

Paylaşımlı hosting kullanıyorsanız PHP çalıştırılabilir dosya yolu firmaya göre değişir. Cron panelinde tam PHP yolunu seçin ve proje dizinindeki cron/whatsapp_kuyruk_isle.php dosyasını hedefleyin.