WhatsApp Business API
WhatsApp Cloud API entegrasyonu ve mesaj ayarları
Entegrasyon Durumu
WhatsApp API yapılandırılmış
Yapılandırma Rehberi
WhatsApp Business API'yi kullanmak için aşağıdaki adımları takip edin
Meta Developer Hesabı Oluşturun
Meta for Developers portalında bir hesap oluşturun ve yeni bir uygulama ekleyin.
Meta Developer PortalWhatsApp Ürününü Ekleyin
Uygulamanıza WhatsApp ürününü ekleyin ve bir test telefon numarası alın.
Environment Variables Ekleyin
Aşağıdaki değerleri Vercel environment variables olarak ekleyin:
WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
WHATSAPP_ACCESS_TOKEN=your_access_token
WHATSAPP_WEBHOOK_VERIFY_TOKEN=random_string_for_webhook
WHATSAPP_APP_SECRET=your_app_secret
Webhook URL'i Yapılandırın
Meta Developer Portal → WhatsApp → Configuration → Webhook
Webhook Fields: messages, message_status
Telegram Sandbox (Test Kanalı)
WhatsApp production akışını bozmadan AI, Inbox ve mesajlaşma senaryolarını test etmek için güvenli alan. Bu kanal WhatsApp production'ı ETKİLEMEZ.
Bağlantı & Güvenlik Durumu
1. TELEGRAM_BOT_TOKEN
87808145...r-B02. Webhook Durumu
3. Müşteri İzni (Whitelist)
Sadece bu Telegram kullancıları test yapabilir.
Kurulum & Test Rehberi
Adım 1: BotFather ile Bot Oluşturun↓
1. Telegram uygulamasında @BotFather arayın.
2. /newbot komutunu gönderin ve botunuza bir isim verin.
3. Size verilen HTTP API Token değerini Vercel/Env dosyanıza TELEGRAM_BOT_TOKEN olarak kaydedin.
Adım 2: Telegram User ID Nasıl Bulunur? (Kritik)↓
Sistemin güvenliği için sadece yetkili Telegram hesaplarından gelen mesajlar işlenir.
1. Telegramda @userinfobot arayın ve Başlat'a basın.
2. Bota herhangi bir şey yazın. Size sayısal bir Id değeri dönecektir (Örn: 123456789).
3. Bu değeri alıp `.env` değişkenlerinize TELEGRAM_ALLOWED_USER_IDS içerisine girin. (Birden fazla ise virgül kullanın).
Adım 3: Güvenlik Secret & Webhook İşlemi↓
1. Güvenlik için kafadan zor bir metin belirleyin ve TELEGRAM_WEBHOOK_SECRET içerisine kaydedin.
2. Botun mesajları sistemimize iletmesi için tarayıcınızdan şu adrese giderek webhook bağlayın. (Bilgileri yerlerine koyun):
https://api.telegram.org/bot<TOKEN>/setWebhook?url=https://service.t3dizayn.com/api/whatsapp/webhook/api/telegram/webhook&secret_token=<YOUR_SECRET><TOKEN> yazan yere TELEGRAM_BOT_TOKEN değerini, <YOUR_SECRET> yazan yere belirlediğiniz SECRET değerini koyun.
Doğrulama Checklist
- Kendi User ID'nizi Whitelist'e kaydettiniz mi? (En üstteki panelden teyit edin)
- Oluşturduğunuz bota Telegram'dan "Merhaba" yazın.
- Admin Inbox sayfasına gidin.
- Sol listede Telegram (Sandbox) yazılı, MAVİ renkli badge içeren mesajı bulun.
- AI (Yapay Zeka) tarafından çıkarılmış Özet, Kategori ve Taslak Yanıtı inceleyin.
Mesaj Şablonları
Durum değişikliklerinde gönderilecek mesaj şablonları
Sayın {{1}}, {{2}} numaralı servis kaydınız oluşturulmuştur. Cihazınız incelemeye alınacaktır. T3 Dizayn
Sayın {{1}}, {{2}} cihazınız T3 Dizayn tarafından teslim alınmıştır. Servis No: {{3}}. İnceleme sonrası bilgilendirileceksiniz.
Sayın {{1}}, {{2}} numaralı servis kaydınız için teklifimiz hazırlanmıştır. Tutar: {{3}}₺. Onayınızı bekliyoruz. T3 Dizayn
Sayın {{1}}, {{2}} numaralı servis kaydınız için onayınız alınmıştır. Cihazınız onarıma alınacaktır. T3 Dizayn
Sayın {{1}}, {{2}} numaralı cihazınız şu anda onarım sürecindedir. İşlem tamamlandığında bilgilendirileceksiniz. T3 Dizayn
Sayın {{1}}, {{2}} numaralı cihazınızın onarımı tamamlanmıştır. Teslim almak için mağazamıza gelebilirsiniz. T3 Dizayn - Sultangazi, İstanbul
Sayın {{1}}, {{2}} numaralı servis kaydınız kargoya verilmiştir. Kargo Takip No: {{3}}. T3 Dizayn
Sayın {{1}}, {{2}} numaralı cihazınız teslim edilmiştir. Bizi tercih ettiğiniz için teşekkür ederiz! T3 Dizayn
Hi {{1}}, Thank you for your purchase! Your order number is {{2}}. We'll start getting your farm fresh groceries ready to ship. Estimated delivery: {{3}}. We will let you know when your order ships.
Free delivery for all online orders with Jasper's Market
Our in-house chefs have prepared some delicious and fresh summer recipes.
Welcome to Jasper’s Market, your local grocery store providing farm-fresh produce and high-quality goods!
Welcome and congratulations!! This message demonstrates your ability to send a WhatsApp message notification from the Cloud API, hosted by Meta. Thank you for taking the time to test with us.
Önemli Notlar
- WhatsApp Business API conversation başına ücretlidir (~$0.03-0.08)
- İlk 1000 conversation/ay ücretsizdir
- Mesaj şablonlarının Meta tarafından onaylanması 1-3 gün sürebilir
- 24 saat kuralı: Müşteri mesaj göndermediyse sadece onaylı şablonlar kullanılabilir