RestoranTakibi paneli 10 dilde kullanılabilir: Türkçe, İngilizce, Arapça (sağdan sola), Rusça, Almanca, İspanyolca, Fransızca, İtalyanca, Portekizce ve Çince. Farklı dilleri konuşan ekipler paneli kendi dilinde kullanır.
Restoranlar artık sadece Yemeksepeti, Trendyol veya Getir siparişlerini takip etmek istemiyor. Müşteri WhatsApp'tan yazıyor, ödemeyi online almak gerekiyor, Google yorumları itibarı belirliyor, muhasebe tarafında fatura ve gün sonu duruyor. Bu yüzden entegrasyon katmanı sipariş kanallarının yanına iş araçlarını da aldı.
Bu yazıda dört entegrasyon ailesini tek tek anlatıyoruz. Her başlıkta iki şeyi ayrı ayrı yazıyoruz: bugün gerçekten ne çalışıyor ve ne çalışmıyor. Bir entegrasyonun panelde kartı olması onun uçtan uca çalıştığı anlamına gelmez; bu ayrımı gizlemek işletmeciyi kurulum günü yakar.
Entegrasyon kartlarının tamamını entegrasyonlar sayfasında görebilirsiniz.
Önce bir kavram: entegrasyon kartlarının durum rozeti üç farklı gerçeği ayırır.
Bazı entegrasyonlar uzak servise gerçekten sorar ve cevabı alırsa "bağlı" yazar. Bazıları ise yalnız bilgi saklar; onlarda rozet "kayıtlı" der, "doğrulanmadı" anlamına gelir. Webhook ile çalışanlar ise ancak ilk gerçek bildirim geldiğinde bağlı sayılır. Yani rozetin yeşil olması için bir kutuyu işaretlemeniz yetmez, sistemin kanıt görmesi gerekir.
Aynı dürüstlük eksik anahtar durumunda da geçerlidir: zorunlu alanı boş bırakılmış bir entegrasyon "hatalı" değil, "eksik yapılandırılmış" olarak işaretlenir ve hangi anahtarın eksik olduğu yazar.
| Entegrasyon ailesi | Bugün çalışan yön | Panele giren bilgi | Sınırı |
|---|---|---|---|
| WhatsApp Cloud API | Gelen mesaj panele düşer, giden toplu mesaj gönderilir | Access Token, Webhook Verify Token, Phone Number ID | Gelen mesaj otomatik siparişe dönüşmez |
| Ödeme sağlayıcıları | Sağlayıcıdan gelen imzalı bildirim tahsilat olarak yazılır | API Key, API Secret, Merchant ID | Ödeme linkini panel üretmez |
| Google Business Profile | Yorumlar panele çekilir, ortalama puan güncellenir | OAuth Access Token, Location ID | Instagram, Facebook, YouTube, X senkronu yok |
| Muhasebe / e-Fatura | Siparişten e-Arşiv veya e-Fatura kesilir | Client ID, Client Secret, Şirket ID, panel kullanıcısı | Yalnız Paraşüt canlı; diğer adaptörler seçilemez |
WhatsApp bağlantısı Meta'nın resmi Cloud API'si üzerinden kurulur. Panele üç bilgi girilir: Access Token, Webhook Verify Token ve Phone Number ID. Meta'nın isteyeceği webhook adresi de karttan kopyalanır. Gelen bildirimin imza sırrı (App Secret) restoran kartında değil sunucu tarafında tutulur; bu sır tanımlı değilse bildirim doğrulanamayacağı için kabul edilmez, sessizce içeri alınmaz.
Müşteri veya ekip üyesi işletme numarasına yazdığında, kart üzerindeki operasyon mesajları ayarı açıksa mesaj panele operasyon mesajı olarak kaydedilir. Burada küçük ama işe yarayan bir ayrıntı var: mesaj metni "acil", "iptal", "gecikti", "eksik", "yanlış", "şikayet", "stok yok" gibi kelimeler içeriyorsa kayıt uyarı seviyesine çıkar ve aksiyon gerektiren olarak işaretlenir. Bu kontrol büyük harfle yazılmış mesajlarda da çalışır — Türkçe küçültmede "IPTAL" kelimesinin "ıptal" olup sinyalin kaçtığı bir hata yaşandı ve düzeltildi.
Gelen mesajlar aynı anda panele canlı olarak da düşer, yani ekranı açık olan yönetici mesajı beklemeden görür.
WhatsApp, CRM tarafındaki segment kampanyalarının gönderim kanalıdır. Hedef kitleyi seçersiniz (örneğin belirli bir süredir sipariş vermemiş müşteriler ya da belirli tutarın üzerinde harcamış olanlar), mesajı yazarsınız, mesaj içindeki isim alanı her alıcı için kişiselleştirilerek gönderilir. Kampanya arka planda ilerler, gönderilen ve başarısız sayıları kampanya kaydına işlenir.
Burada iki koruma vardır. Gönderimler arasında bekleme konur, yani liste tek seferde ateşlenmez. Ayrıca restoran başına günlük gönderim tavanı vardır (varsayılan 1.000 alıcı) ve tavan aşılırsa istek reddedilir. Sebebi hem spam riski hem de Meta tarafındaki faturadır. Segment mantığının tamamı restoran CRM yazısında.
WhatsApp'tan gelen bir mesaj otomatik olarak siparişe dönüşmez. Mesaj operasyon kaydı olur; siparişi ekip açar. Ayrıca SMS kanalı bağlı değildir ve panel bunu gizlemez, kampanya ekranında açıkça "SMS sağlayıcı henüz bağlı değil" der. Liste dışa aktarma seçeneği her zaman çalışır.
Bu başlıkta en çok yanlış anlaşılan şeyi baştan söyleyelim: panel ödeme linkini kendisi oluşturmaz. Bugün çalışan yön gelen yöndür. Ödeme sağlayıcınızın tarafında bir tahsilat gerçekleştiğinde, sağlayıcı bunu panele bildirir ve tahsilat kaydı oluşur.
Sekiz sağlayıcı için kart hazırdır: iyzico, PayTR, Param, Sipay, Paynet, Paratika, Craftgate ve Paycell. Her biri için API Key, API Secret ve Merchant/Supplier ID alanları vardır.
Gelen bildirimlerin doğrulanması sağlayıcıya özeldir ve bu detay önemlidir, çünkü doğrulanmamış bir bildirimi kabul etmek "sahte ciro" demektir:
İmza yoksa veya tutmuyorsa istek 401 ile reddedilir ve güvenlik günlüğüne yazılır. API Secret kaydedilmemişse bildirim doğrulanamaz ve yine reddedilir. Fail-open bir yol bırakılmamıştır.
İki gerçek hatanın nasıl düzeltildiğini de yazalım, çünkü bunlar bu tür entegrasyonların klasik tuzağıdır.
PayTR tutarları kuruş cinsinden gönderir. Jenerik bir okuma bunu lira sanıp tutarı 100 kat şişiriyordu. Artık sağlayıcıya özel tutar okuması yapılıyor.
Ödeme durumları eskiden parça eşlemeyle sınıflanıyordu. Sonuç: "CAPTURED" içinde "RED" geçtiği için başarılı tahsilat başarısız sayılıyor, "TOKEN_INVALID" içinde "OK" geçtiği için başarısız ödeme ciroya giriyordu. Şimdi eşleme tam değer üzerinden yapılıyor ve tanınmayan bir durum para sayılmıyor — eksik ciro fark edilip düzeltilir, hayalet ciro sessizce yanlış rapor üretir.
Kart verisi panelde saklanmaz; tutulan şey işlem sonucu, tutar, sağlayıcı, referans numarası ve zaman damgasıdır. Fiziksel kart çekimi isteyen işletmeler için ayrı bir yol vardır; onu ÖKC nedir, nasıl kurulur ve POS ve yazarkasa entegrasyon altyapısı yazılarında anlattık.
Google tarafı yalnız bilgi saklayan bir kart değil; yorumlar gerçekten senkronize edilir.
İki yol vardır. Birincisi Google Business Profile bağlantısıdır: panele OAuth Access Token ve Location ID girilir, yorumlar işletme profilinden çekilir. İkincisi Google Places yoludur: Place ID girilir ve sunucu tarafındaki Google anahtarı kullanılır. Senkron sonunda yorumlar panele kaydedilir, ortalama puan ve toplam yorum sayısı güncellenir, son senkron zamanı ve varsa hata mesajı saklanır.
Manuel içe aktarım da mümkündür ve burada küçük bir kalite kontrolü çalışır: metni olmayan beş yıldız, çok kısa metinli beş yıldız ve aynı yazar-metin ikilisinin tekrarı şüpheli olarak işaretlenir. İşaret, hükmü kendisi vermez; kayıtta açıkça "tek başına kesin kanıt değildir, manuel kontrol önerilir" yazar.
Instagram, Facebook, YouTube ve X yorumları için senkron yoktur. Bu uç çağrıldığında sistem sessizce boş dönmez; 501 döner ve neyin gerektiğini listeler (Meta Graph API izinleri, YouTube kanal yorum izni, X API erişimi ve her kaynak için işletme sahibinin açık veri izni). Bağlantı adresleri yine de saklanır, çünkü yapay zekâ tarafı bu bağlamı kullanır.
Ayrıca WhatsApp gruplarını gizlice tarama gibi bir yöntem kullanılmaz. Bu bilinçli bir karardır: müşteri sesi ya resmi API'den ya da panel içi operasyon sohbetinden gelir.
Muhasebe tarafında çalışan somut şey giden satış faturasıdır. Bir siparişten e-Arşiv veya e-Fatura kesilir.
Nasıl çalıştığı şöyle:
Bugün canlı çalışan sağlayıcı Paraşüt'tür. Logo ve Nilvera için mimari hazırdır ama adaptörler canlı doğrulama beklediği için sağlayıcı seçicisinde hiç görünmezler. Kimlik bilgisi eksikse adaptör uydurma bir sonuç üretmez, açık hata verir.
Ters yön de vardır: alış faturalarınızın UBL-TR XML dosyasını yükleyip stok kalemlerini otomatik artırabilirsiniz. Alias hafızası sayesinde tedarikçinin "DOMATES SALKIM 1KG" yazdığı kalem bir kez eşleştirildikten sonra bir daha sorulmaz. Stok ve reçete tarafının nasıl kurulduğu restoran stok takip programı yazısında.
Vergi tarafında ayrı bir ekran vardır: KDV, kâr vergisi, stopaj ve SGK oranlarını girer, tahmini yükü görürsünüz. Bunun beyanname olmadığını net söylemek gerekir — bu bir planlama aracıdır, mali müşavirinizin yerini almaz.
Entegrasyon listesi uzun diye hepsini birden açmak iyi fikir değil. Pratikte sıralama şöyle işliyor:
Önce sipariş kanallarını bağlayın; ciro oradan geliyor. Sonra ödeme bildirimini bağlayın; tahsilatın rapora doğru yazılması kanal kârlılığı hesabını ayakta tutar, komisyon hesabının neden bu kadar önemli olduğunu sipariş platformu komisyonları yazısında ölçtük. Google tarafını itibar takibi ciddiye alındığında açın. Muhasebe bağlantısını ise fatura talebi düzenli gelmeye başladığında.
Ürünün genel kapsamı için özellikler sayfasına, raporlama tarafı için restoran raporlama ve analiz yazısına bakabilirsiniz. Tüm entegrasyonlar fiyat planına dahildir, entegrasyon başına ücret alınmaz; koşullar fiyatlar sayfasında.
Hayır. Gelen mesaj panele operasyon kaydı olarak düşer ve canlı bildirilir; siparişi ekip açar. Mesajda acil, iptal, gecikti, eksik, yanlış, şikayet veya stok yok gibi ifadeler geçerse kayıt uyarı seviyesine çıkar ve aksiyon gerektiren olarak işaretlenir.
Meta'nın resmi Cloud API'si üzerinden çalışır. Panele Access Token, Webhook Verify Token ve Phone Number ID girilir; Meta'nın isteyeceği webhook adresi karttan kopyalanır. İmza sırrı (App Secret) restoran kartında değil sunucu tarafında tutulur. Numaranın WhatsApp Business hesabına ve Cloud API erişimine bağlı olması gerekir.
Evet. Restoran başına günlük gönderim tavanı vardır (varsayılan 1.000 alıcı) ve tavan aşılırsa istek reddedilir. Ayrıca gönderimler arasında bekleme konur, liste tek seferde ateşlenmez. Bunun sebebi hem spam ve hesap askıya alınma riski hem de Meta tarafındaki maliyettir.
Hayır. Panel ödeme linkini kendisi üretmez. Bugün çalışan yön gelen yöndür: sağlayıcı tarafında tahsilat gerçekleştiğinde imzalı bildirim panele düşer ve tahsilat kaydı oluşur. İmzası olmayan veya tutmayan bildirim reddedilir.
iyzico, PayTR, Param, Sipay, Paynet, Paratika, Craftgate ve Paycell için alanlar hazırdır. Her biri API Key, API Secret ve Merchant/Supplier ID ister. Kart verisi panelde saklanmaz; tutulan şey işlem sonucu, tutar, sağlayıcı, referans ve zamandır.
Ciroya yazılmıyor. Durum eşlemesi tam değer üzerinden yapılır ve tanınmayan değer bilinmeyen sayılıp ciro sorgusunun dışında bırakılır, ayrıca uyarı olarak loglanır. Eksik ciro fark edilip düzeltilir; hayalet ciro sessizce yanlış rapor üretir.
Evet. Google Business Profile bağlantısıyla (OAuth Access Token ve Location ID) ya da Google Places yoluyla (Place ID) yorumlar çekilir, ortalama puan ve toplam yorum sayısı güncellenir. Manuel içe aktarımda metinsiz veya tekrar eden beş yıldızlı yorumlar şüpheli olarak işaretlenir.
Hayır. Sosyal medya yorum senkronizasyonu yoktur; bu uç çağrıldığında ne gerektiğini listeleyen bir hata döner. Bağlantı adresleri saklanır ama yorum verisi çekilmez. WhatsApp gruplarını gizlice tarama gibi bir yöntem de bilinçli olarak kullanılmaz.
Paraşüt ile evet: siparişten e-Arşiv veya e-Fatura kesilir, alıcının vergi numarası 10 haneliyse e-Fatura, değilse e-Arşiv üretilir. Kesim talep üzerine ve tek tektir, aynı sipariş için mükerrer fatura oluşmaz. Logo ve Nilvera adaptörleri canlı doğrulama beklediği için sağlayıcı listesinde görünmez.
Evet. Alış faturasının UBL-TR XML dosyasını yüklediğinizde kalemler okunur ve stok artırılır. Tedarikçinin kullandığı ürün adı bir kez eşleştirildikten sonra alias hafızasına yazılır ve sonraki faturalarda tekrar sorulmaz.