İçeriğe atla

API anahtarlarını nasıl alırsınız

Bu rehber yazılım bilmeyen biri için yazıldı. Her adımda hangi ekrandasınız, neye tıklayacaksınız ve nereye ne yazacaksınız tek tek anlatılıyor. En önemlisi WhatsApp bölümü — onu ilk sıraya koyduk.

Acele etmeyin. Hiçbir anahtarı girmeseniz de sistem çalışır; sadece mesajlar müşteriye gitmez. İstediğiniz bölümü istediğiniz zaman bağlayabilirsiniz.

Bölüm 1 · 45–60 dakika · Orta

WhatsApp bağlantısı

En önemli bölüm bu. WhatsApp'ı bağladığınızda randevu onayları, hatırlatmalar ve kampanya mesajları müşterinizin telefonuna gerçekten düşer. Meta (Facebook'un şirketi) bu hizmeti WhatsApp Business Platform adıyla veriyor ve aylık belirli sayıda mesaj ücretsiz.

Başlamadan önce elinizde olması gerekenler

  • Bir Facebook hesabı (kişisel hesabınız yeterli, işletme sayfası şart değil)
  • İşletmenize ait, WhatsApp'ta AKTİF OLARAK KULLANILMAYAN bir telefon numarası
  • Bu numaraya gelecek SMS'i veya aramayı alabilecek bir telefon
  • İşletme belgeniz (vergi levhası gibi) — sadece doğrulama aşamasında gerekir

Kullanacağınız numara, normal WhatsApp veya WhatsApp Business uygulamasında kayıtlı OLMAMALI. Salonun ana numarasını kullanmak isterseniz önce o numarayı normal WhatsApp'tan silmeniz gerekir. En kolayı: sadece bu iş için yeni bir hat almak.

1

Meta İşletme Hesabı (Business Portfolio) oluşturun

Tarayıcınızda business.facebook.com adresine gidin ve Facebook hesabınızla giriş yapın.

Sol menünün en altındaki ayarlar (dişli) simgesine tıklayın. Eğer hiç işletme hesabınız yoksa karşınıza doğrudan bir oluşturma ekranı gelir.

İşletme adınızı (örneğin salonunuzun adını), adınızı soyadınızı ve iş e-postanızı yazıp devam edin.

Ekranda ne göreceksiniz

Sol tarafta menü, ortada 'İşletme portföyünüzü oluşturun' başlıklı bir form göreceksiniz.

Tıklayın:business.facebook.comAyarlar (dişli)İşletme oluştur

E-posta adresinize bir doğrulama bağlantısı gelir. Ona tıklamadan bir sonraki adımlarda takılabilirsiniz, önce e-postanızı kontrol edin.

2

Geliştirici hesabı açın ve uygulama oluşturun

developers.facebook.com adresine gidin. Sağ üstte 'Başlayın' (Get Started) yazıyorsa tıklayıp birkaç soruyu geçin — bu ücretsiz ve saniyeler sürer.

Sağ üstteki 'Uygulamalarım' (My Apps) bölümüne girin ve 'Uygulama oluştur' (Create App) düğmesine basın.

Karşınıza 'Ne yapmak istiyorsunuz?' diye bir liste gelir. Buradan 'İşletme' (Business) seçeneğini işaretleyin ve devam edin.

Uygulamaya bir ad verin — salonunuzun adı olabilir, müşteriniz bu adı görmez. Ardından az önce oluşturduğunuz işletme hesabını seçip 'Uygulama oluştur' deyin.

Ekranda ne göreceksiniz

Uygulama oluşturulduktan sonra sol tarafta uzun bir menü, ortada ürün kartlarının bulunduğu bir kontrol paneli açılır.

Tıklayın:developers.facebook.comUygulamalarımUygulama oluşturİşletme

3

WhatsApp ürününü ekleyin

Açılan kontrol panelinde aşağı doğru kaydırın; 'Ürün ekle' (Add product) başlığı altında kartlar göreceksiniz.

WhatsApp kartını bulun ve üzerindeki 'Kur' (Set up) düğmesine tıklayın.

Sizden bir işletme hesabı seçmenizi isteyecek; 1. adımda oluşturduğunuzu seçin ve devam edin.

Ekranda ne göreceksiniz

Sol menüde artık 'WhatsApp' başlığı ve altında 'API Kurulumu' (API Setup / Quickstart) bağlantısı belirir.

Tıklayın:Ürün ekleWhatsAppKur

Bu noktada Meta size otomatik olarak bir TEST numarası verir. Bu numara ile hemen deneme yapabilirsiniz, ancak sadece kendi eklediğiniz 5 numaraya mesaj gönderebilir. Gerçek müşterilere göndermek için kendi numaranızı eklemeniz gerekir (5. adım).

4

Telefon numarası kimliğini (Phone number ID) kopyalayın

Sol menüden WhatsApp > API Kurulumu (API Setup) sayfasına girin.

Sayfanın ortasında 'Kimden' (From) yazan bir kutu ve altında uzun bir sayı göreceksiniz. Bu sayı 'Telefon numarası kimliği' (Phone number ID) olarak etiketlenmiştir — genelde 15 haneli bir rakam dizisidir.

Bu sayının yanındaki kopyala simgesine tıklayın ve bir kenara not edin. Bu, .env.local dosyasına yazacağınız ilk değer.

Ekranda ne göreceksiniz

'Phone number ID: 123456789012345' benzeri bir satır. Yanında küçük bir kopyalama simgesi olur.

Tıklayın:WhatsAppAPI Setup

Aynı ekranda 'WhatsApp Business Account ID' de yazar — bu FARKLI bir numaradır. İkisini karıştırmayın; ikisini de not alın, ikisi de lazım olacak.

5

Kendi telefon numaranızı ekleyin

Aynı API Kurulumu sayfasında 'Telefon numarası ekle' (Add phone number) düğmesine tıklayın.

Açılan pencerede işletme adınızı, ülkenizi ve WhatsApp'ta kullanmadığınız telefon numaranızı girin.

Doğrulama yöntemi olarak SMS veya sesli arama seçin. Gelen 6 haneli kodu ekrana girin.

Numara doğrulandıktan sonra API Kurulumu sayfasındaki 'Kimden' listesinden bu numarayı seçin ve Telefon numarası kimliğini yeniden kopyalayın — artık kendi numaranızın kimliğini kullanacaksınız.

Ekranda ne göreceksiniz

Numara eklendikten sonra listede yeşil bir 'Bağlandı' (Connected) rozetiyle görünür.

Tıklayın:API SetupAdd phone numberDoğrula

Yeni numaranın günlük mesaj limiti başlangıçta 250'dir. İşletme doğrulamasını tamamladıkça ve müşteriler mesajlarınızı olumlu karşıladıkça bu limit 1.000, 10.000 ve sınırsıza kadar otomatik yükselir. Küçük bir salon için 250 zaten fazlasıyla yeter.

6

Kalıcı erişim anahtarı (token) oluşturun

API Kurulumu sayfasındaki 'Geçici erişim anahtarı' (Temporary access token) SADECE 24 SAAT geçerlidir. Kalıcı olanı oluşturmalısınız.

business.facebook.com adresine dönün, sol alttaki ayarlar simgesine tıklayın.

Sol menüden 'Kullanıcılar' > 'Sistem kullanıcıları' (Users > System users) bölümüne girin.

'Ekle' (Add) düğmesine basın. Bir ad verin (örneğin 'Randolu Entegrasyonu'), rol olarak 'Yönetici' (Admin) seçin ve oluşturun.

Oluşturduğunuz sistem kullanıcısına tıklayın, 'Varlık ekle' (Add assets) düğmesine basın. Sol taraftan 'Uygulamalar'ı seçin, 2. adımda oluşturduğunuz uygulamayı işaretleyin ve 'Uygulamayı yönet' (Manage app) iznini açın. Aynı şekilde 'WhatsApp hesapları' için de tam yetki verin.

Sonra 'Yeni anahtar oluştur' (Generate new token) düğmesine tıklayın. Uygulamanızı seçin, süre olarak 'Süresiz' (Never) seçeneğini işaretleyin.

İzinler listesinden şu ikisini mutlaka işaretleyin: whatsapp_business_messaging ve whatsapp_business_management.

'Anahtar oluştur' deyin. Karşınıza uzun bir metin çıkacak — 'EAA' ile başlar ve yüzlerce karakter uzunluğundadır.

Ekranda ne göreceksiniz

Beyaz bir pencere içinde çok uzun, karışık harflerden oluşan bir metin ve yanında 'Kopyala' düğmesi.

Tıklayın:business.facebook.comAyarlarKullanıcılarSistem kullanıcılarıEkleYeni anahtar oluştur

Bu anahtarı SADECE BİR KEZ görebilirsiniz. Pencereyi kapatırsanız bir daha göremezsiniz, yenisini oluşturmanız gerekir. Şimdi kopyalayıp güvenli bir yere kaydedin. Bu anahtar, banka şifreniz kadar gizlidir — kimseyle paylaşmayın, ekran görüntüsünü atmayın.

7

Uygulama gizli anahtarını (App Secret) alın

developers.facebook.com'daki uygulamanıza geri dönün.

Sol menünün en altında 'Uygulama ayarları' > 'Temel' (App settings > Basic) bölümüne girin.

'Uygulama gizli anahtarı' (App secret) satırındaki 'Göster' (Show) düğmesine tıklayın. Facebook şifrenizi tekrar isteyebilir.

Görünen kısa metni kopyalayın. Bu, size gelen mesajların gerçekten Meta'dan geldiğini doğrulamak için kullanılır.

Ekranda ne göreceksiniz

'App ID' ve hemen altında yıldızlarla gizlenmiş 'App secret' satırı, yanında 'Göster' düğmesi.

Tıklayın:Uygulama ayarlarıTemelGöster

8

Doğrulama jetonunu (Verify token) kendiniz belirleyin

Bu değeri hiçbir yerden almazsınız — siz uydurursunuz. Tek şartı: tahmin edilemeyecek kadar uzun ve karışık olması.

Örnek: randolu-mira-2026-x7k9m2p4q8w1 gibi bir metin yazın. Boşluk ve Türkçe karakter kullanmayın.

Bunu bir yere not edin; hem .env.local dosyasına hem de birazdan Meta paneline aynısını yazacaksınız.

9

Anahtarları .env.local dosyasına yazın

Projenizin ana klasöründe .env.example adında bir dosya var. Onu kopyalayın ve kopyanın adını .env.local yapın.

Dosyayı Not Defteri ile açın ve WhatsApp bölümünü aşağıdaki gibi doldurun.

Kaydedin, sonra terminalde çalışan sunucuyu durdurup (Ctrl + C) yeniden başlatın (npm run dev).

.env.local dosyasına yazacaklarınız

WHATSAPP_PROVIDER=meta-cloud
WHATSAPP_PHONE_NUMBER_ID=4. adımda kopyaladığınız uzun sayı
WHATSAPP_ACCESS_TOKEN=EAA ile başlayan çok uzun anahtar
WHATSAPP_BUSINESS_ACCOUNT_ID=WhatsApp Business Account ID
WHATSAPP_VERIFY_TOKEN=kendi-uydurdugunuz-uzun-gizli-metin
WHATSAPP_APP_SECRET=7. adımdaki kısa gizli anahtar

Sunucuyu yeniden başlattıktan sonra panelde Ayarlar > Entegrasyonlar sayfasına girin. WhatsApp satırında 'Deneme modu' yerine yeşil 'Canlı' rozeti görüyorsanız bağlantı kurulmuş demektir.

10

Webhook adresini tanıtın (müşteri size yazabilsin diye)

Buraya kadar olan adımlar mesaj GÖNDERMEK içindi. Müşterinin size yazdığı mesajların panele düşmesi için bir adım daha var.

Önemli: bu adım için siteniz internette yayında olmalı. Bilgisayarınızda localhost'ta çalışırken Meta size ulaşamaz.

Panelde Ayarlar > Entegrasyonlar sayfasının en üstündeki 'Callback URL' değerini kopyalayın (siteniz.com/api/webhooks/whatsapp şeklindedir).

developers.facebook.com'daki uygulamanızda WhatsApp > Yapılandırma (Configuration) bölümüne girin.

'Webhook' başlığındaki 'Düzenle' (Edit) düğmesine tıklayın. Açılan pencerede 'Callback URL' alanına kopyaladığınız adresi, 'Verify token' alanına 8. adımda uydurduğunuz metni yazın.

'Doğrula ve kaydet' (Verify and save) deyin. Yeşil onay gelirse başarılı.

Aynı sayfada 'Webhook alanları' (Webhook fields) listesinden 'messages' satırının yanındaki 'Abone ol' (Subscribe) düğmesine basın.

Ekranda ne göreceksiniz

Doğrulama başarılıysa Callback URL alanının yanında yeşil bir tik belirir. Başarısızsa kırmızı 'The callback URL or verify token couldn't be validated' uyarısı çıkar.

Tıklayın:WhatsAppConfigurationWebhookEditVerify and save

Yayına almadan denemek isterseniz ngrok adlı ücretsiz aracı kullanabilirsiniz. Terminalde 'ngrok http 3000' yazdığınızda size https ile başlayan geçici bir internet adresi verir; onu Meta paneline yazarsınız. Ngrok'u kapattığınızda adres kaybolur.

11

Mesaj şablonlarınızı onaya gönderin

WhatsApp'ta önemli bir kural var: müşteri size son 24 saat içinde yazmadıysa, ona istediğiniz metni gönderemezsiniz. Sadece Meta'nın önceden ONAYLADIĞI şablonları gönderebilirsiniz.

İyi haber: randevu hatırlatması, onay mesajı gibi şablonlar bu tür 'hizmet' mesajıdır ve genelde sorunsuz onaylanır.

business.facebook.com > WhatsApp Manager > Mesaj şablonları (Message templates) bölümüne girin.

'Şablon oluştur' (Create template) deyin. Kategori olarak 'Yardımcı program' (Utility) seçin — bu kategori daha ucuz ve daha kolay onaylanır.

Şablon adını, panelde gördüğünüz adla birebir aynı yazın: örneğin randevu_hatirlatma_24s. Dil olarak Türkçe seçin.

Mesaj metnine, panelde Otomasyonlar > Önizle ekranında gördüğünüz metni yapıştırın. Değişken yerlerine Meta'nın istediği {{1}}, {{2}} biçimini kullanın.

Gönderin. Onay genelde birkaç dakika ile birkaç saat arasında gelir.

Ekranda ne göreceksiniz

Şablon listesinde durumu 'Beklemede' (Pending) olarak görünür, onaylanınca yeşil 'Onaylandı' (Approved) olur.

Tıklayın:WhatsApp ManagerMesaj şablonlarıŞablon oluştur

Mesaj başına ne kadar ödeyeceğim?

Meta ayda belirli sayıda hizmet mesajını ücretsiz veriyor; onun üzerindeki hatırlatma mesajları için mesaj başına yaklaşık 0,20–0,35 TL civarında bir ücret oluşuyor. Küçük bir salonun aylık maliyeti genelde birkaç yüz lirayı geçmez. Güncel fiyatları Meta'nın kendi sayfasından kontrol edin; ücretlendirme zaman zaman değişiyor.

İşletme doğrulaması (Business Verification) şart mı?

Başlangıç için şart değil — doğrulama yapmadan da günde 250 mesaja kadar gönderebilirsiniz. Daha yüksek limitler ve WhatsApp'ta yeşil onay rozeti için gerekir. Doğrulama sırasında vergi levhası veya ticaret sicil belgesi istenir, sonuç birkaç gün sürer.

Numaramı sonradan değiştirebilir miyim?

Evet. Meta panelinden yeni numarayı ekleyip doğrularsınız, ardından .env.local dosyasındaki WHATSAPP_PHONE_NUMBER_ID değerini yeni numaranın kimliğiyle değiştirip sunucuyu yeniden başlatırsınız. Mesaj geçmişiniz panelde kalmaya devam eder.

Bölüm 2 · 15–20 dakika · Kolay

SMS yedeği

Her müşterinin WhatsApp'ı olmayabilir ya da numarası WhatsApp'ta kayıtlı olmayabilir. Bu durumda sistem aynı mesajı otomatik olarak SMS ile gönderir. Türkiye'de en yaygın sağlayıcı Netgsm.

1

Netgsm hesabı açın

netgsm.com.tr adresine gidin ve 'Ücretsiz Dene' ya da 'Kayıt Ol' bağlantısından bireysel/kurumsal kaydınızı yapın.

Kayıt sırasında size bir 'Kullanıcı kodu' verilir — genelde 850 ile başlayan bir numaradır. Şifrenizi de siz belirlersiniz.

Hesabınıza kredi yüklemeniz gerekir; SMS'ler bu krediden düşer.

Ekranda ne göreceksiniz

Giriş yaptıktan sonra sol menüde 'SMS İşlemleri' başlığı olan bir panel.

2

Gönderici adınızı (başlık) onaylatın

SMS'in kimden geldiğini gösteren isme 'başlık' deniyor. Örneğin MIRAGUZEL gibi.

Netgsm panelinde 'SMS İşlemleri' > 'Başlıklarım' bölümüne girin ve yeni başlık talebi oluşturun.

Başlık en fazla 11 karakter olabilir, Türkçe karakter ve boşluk içeremez.

Onay için vergi levhanız istenir, genelde 1 iş günü sürer.

Tıklayın:SMS İşlemleriBaşlıklarımYeni başlık

3

API erişimini açın

Netgsm panelinde 'Ayarlar' > 'API Erişim Ayarları' bölümüne girin.

API kullanımını aktif hale getirin. Bazı hesaplarda ayrı bir API şifresi tanımlamanız istenir; öyleyse o şifreyi kullanın.

Tıklayın:AyarlarAPI Erişim Ayarları

.env.local dosyasına yazacaklarınız

SMS_PROVIDER=netgsm
NETGSM_USERCODE=850 ile başlayan kullanıcı kodunuz
NETGSM_PASSWORD=şifreniz
NETGSM_HEADER=ONAYLI_BASLIGINIZ

Türkiye'de ticari SMS göndermek için İYS (İleti Yönetim Sistemi) kaydı yasal zorunluluktur. Randevu hatırlatması gibi bilgilendirme mesajları bu kapsamın dışındadır, ancak kampanya ve indirim mesajları için İYS'ye kayıtlı olmanız ve müşterinin izninin İYS'de bulunması gerekir.

Bölüm 3 · 20–30 dakika · Orta

Veritabanı (kalıcı kayıt)

Şu anda sistem demo veriyle çalışıyor ve kayıtlar bilgisayarın belleğinde tutuluyor — sunucuyu kapattığınızda sıfırlanıyor. Gerçek kullanıma geçmek için bir veritabanı bağlamanız gerekir. Supabase ücretsiz başlangıç paketi sunuyor ve küçük bir salon için fazlasıyla yeterli.

1

Supabase hesabı ve proje oluşturun

supabase.com adresine gidin, 'Start your project' deyip GitHub veya e-posta ile kaydolun.

'New project' düğmesine tıklayın. Projeye bir ad verin, güçlü bir veritabanı şifresi belirleyin (bir yere kaydedin) ve bölge olarak size en yakın olanı seçin — Frankfurt (eu-central-1) Türkiye için iyi bir seçimdir.

Proje hazırlanması 1–2 dakika sürer.

Ekranda ne göreceksiniz

Yeşil tonlarda bir kontrol paneli, sol tarafta Table Editor / SQL Editor menüleri.

2

Tabloları oluşturun

Projenizin ana klasöründe supabase/schema.sql adında bir dosya var. Bu dosya, sistemin ihtiyaç duyduğu tüm tabloları oluşturan komutları içerir.

Dosyayı Not Defteri ile açın, içindekilerin tamamını seçip kopyalayın (Ctrl+A, Ctrl+C).

Supabase panelinde sol menüden 'SQL Editor' bölümüne girin, 'New query' deyin.

Kopyaladıklarınızı boş alana yapıştırın ve sağ alttaki 'Run' düğmesine basın.

Ekranda ne göreceksiniz

Alt kısımda 'Success. No rows returned' yazısı görürseniz tablolar oluşmuştur.

Tıklayın:SQL EditorNew queryRun

3

Bağlantı anahtarlarını alın

Sol menünün altındaki ayarlar (dişli) simgesine tıklayın, 'API' bölümüne girin.

'Project URL' satırındaki adresi kopyalayın — https://xxxx.supabase.co şeklindedir.

Aşağıda 'Project API keys' başlığı altında iki anahtar vardır. 'service_role' yazanı kopyalayın (üzerinde 'secret' uyarısı olur).

Tıklayın:AyarlarAPI

service_role anahtarı veritabanınızda her şeyi yapabilen ana anahtardır. Asla tarayıcıda çalışan koda, halka açık bir yere veya ekran görüntüsüne koymayın. Sadece .env.local dosyasında durmalıdır.

.env.local dosyasına yazacaklarınız

DATABASE_PROVIDER=supabase
SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJhbGci... ile başlayan uzun anahtar

Anahtarları girdiniz ama tabloları oluşturmayı unuttuysanız sistem çökmez: demo veriye geri döner ve terminalde nedenini yazar. Terminaldeki mesajı okuyup eksik adımı tamamlayabilirsiniz.

Bölüm 4 · 10–15 dakika · Kolay

E-posta gönderimi

E-posta zorunlu değil ama randevu özetini müşteriye e-posta ile de göndermek isterseniz gerekir. Resend, kurulumu en kolay olan ve ayda 3.000 e-postayı ücretsiz veren sağlayıcı.

1

Resend hesabı açın

resend.com adresine gidin ve ücretsiz kaydolun.

Sol menüden 'API Keys' bölümüne girin, 'Create API Key' deyin. Bir ad verin, izin olarak 'Sending access' yeterlidir.

Oluşan anahtar re_ ile başlar. Kopyalayın — bu da sadece bir kez gösterilir.

Tıklayın:API KeysCreate API Key

2

Alan adınızı doğrulayın

Kendi alan adınızdan (örneğin randevu@salonunuz.com) e-posta göndermek için alan adını doğrulamanız gerekir.

Sol menüden 'Domains' > 'Add Domain' deyin ve alan adınızı yazın.

Resend size birkaç DNS kaydı verir. Bunları alan adınızı aldığınız firmanın (GoDaddy, Natro, Turhost gibi) panelindeki DNS ayarlarına eklemeniz gerekir.

Doğrulama genelde 15 dakika ile birkaç saat arasında tamamlanır.

Alan adınız yoksa veya bu adımla uğraşmak istemiyorsanız, deneme aşamasında Resend'in verdiği onboarding@resend.dev adresini kullanabilirsiniz — ancak bu adresle sadece kendi kayıtlı e-postanıza gönderim yapabilirsiniz.

.env.local dosyasına yazacaklarınız

EMAIL_PROVIDER=resend
RESEND_API_KEY=re_ ile başlayan anahtar
EMAIL_FROM=Mira Güzellik <randevu@salonunuz.com>

Bölüm 5 · 1–3 gün (başvuru onayı bekler) · Orta

Online ödeme (kapora)

Sürekli gelmeyen müşterileriniz varsa kapora almak en etkili çözümdür. Türkiye'de iyzico ve PayTR yaygın kullanılıyor; ikisi de sanal POS başvurusu gerektiriyor.

1

Başvuru yapın

iyzico.com adresinden 'Üye ol' diyerek işletme başvurusu yapın.

Vergi levhası, imza sirküleri ve kimlik belgesi istenir. Şahıs şirketi de başvurabilir.

Onay süreci genelde 1–3 iş günü sürer.

2

API anahtarlarını alın

iyzico panelinde 'Ayarlar' > 'Geliştirici' (Settings > Developer) bölümüne girin.

'API Key' ve 'Secret Key' değerlerini kopyalayın.

Panelde ayrıca bir 'Sandbox' (test) ortamı bulunur; gerçek para çekmeden denemek için önce oradaki anahtarları kullanabilirsiniz.

Tıklayın:AyarlarGeliştirici

.env.local dosyasına yazacaklarınız

PAYMENT_PROVIDER=iyzico
IYZICO_API_KEY=sandbox-... veya canlı anahtarınız
IYZICO_SECRET_KEY=sandbox-... veya canlı gizli anahtarınız

Ödeme entegrasyonu şu an demo modunda çalışıyor: kapora adımı her zaman başarılı sayılıyor ama para tahsil edilmiyor. Gerçek tahsilat için iyzico'nun kendi kütüphanesinin projeye eklenmesi gerekir — kod tarafındaki sözleşme hazır, tek dosyalık bir iştir.

Bölüm 6 · 20 dakika · Orta

Google Takvim eşitleme

İsteğe bağlı bir özellik. Bağlarsanız panelde oluşan her randevu, ilgili personelin Google Takvimine de yazılır ve telefonundan hatırlatma alır.

1

Google Cloud projesi oluşturun

console.cloud.google.com adresine Google hesabınızla girin.

Üst çubuktaki proje seçiciden 'Yeni proje' deyin, bir ad verip oluşturun.

Sol menüden 'API'ler ve Hizmetler' > 'Kitaplık' bölümüne girin, arama kutusuna 'Google Calendar API' yazın ve 'Etkinleştir' deyin.

Tıklayın:API'ler ve HizmetlerKitaplıkGoogle Calendar APIEtkinleştir

2

OAuth kimlik bilgilerini oluşturun

'API'ler ve Hizmetler' > 'Kimlik bilgileri' bölümüne girin.

'Kimlik bilgisi oluştur' > 'OAuth istemci kimliği' seçin. İlk seferde bir 'İzin ekranı' yapılandırmanız istenir; işletme adınızı ve e-postanızı yazıp geçin.

Uygulama türü olarak 'Web uygulaması' seçin. 'Yetkili yönlendirme URI'leri' alanına sitenizin adresini + /api/auth/google/callback ekleyin.

Oluştur deyin; 'İstemci kimliği' ve 'İstemci gizli anahtarı' değerlerini kopyalayın.

.env.local dosyasına yazacaklarınız

CALENDAR_PROVIDER=google
GOOGLE_CLIENT_ID=....apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-...

Bölüm 7 · 10 dakika · Kolay

Görsel ve dosya depolama

İsteğe bağlı. Bağlamazsanız yüklenen görseller saklanmaz. Supabase zaten kullanıyorsanız onun depolama alanını kullanmak en pratiği.

1

Supabase Storage kullanın

Supabase panelinde sol menüden 'Storage' bölümüne girin.

'New bucket' deyin, adını 'randolu' koyun ve 'Public bucket' seçeneğini işaretleyin (görseller müşteriye gösterileceği için).

Veritabanı için zaten girdiğiniz SUPABASE_URL ve SUPABASE_SERVICE_ROLE_KEY değerleri depolama için de kullanılır; ayrıca anahtar almanıza gerek yok.

Tıklayın:StorageNew bucket

.env.local dosyasına yazacaklarınız

STORAGE_PROVIDER=supabase

Bir şey ters gittiyse

Anahtarı girdiniz ama hâlâ "deneme modu" yazıyorsa neredeyse her zaman sebebi aynıdır: sunucu yeniden başlatılmamıştır. Ortam değişkenleri sadece açılışta okunur. Terminalde çalışan sunucuyu durdurup npm run dev komutunu tekrar çalıştırın.

İkinci en sık sebep: dosya adının .env.local olmaması. Windows dosya uzantılarını gizlediği için farkında olmadan .env.local.txt oluşturmuş olabilirsiniz.

Entegrasyon durumunu kontrol et