WhatsApp API Kurulum Dokümanı
Meta Business, Meta for Developers ve ElektraWeb CRM üzerinde WhatsApp Cloud API entegrasyonunun adım adım, görsel destekli kurulum rehberi.
2) Detaylı Anlatım — her adımın ekran görüntüsüyle açıklaması
Kısa Özet — Adım Adım Kurulum
Aşağıdaki liste tüm süreci hızlıca görmeniz için hazırlanmıştır. Her adımın detaylı açıklaması ve ekran görüntüsü, bu özetin devamında yer almaktadır.
Başlamadan önce gerekenler
- Otelin Meta Business ve Meta for Developers hesapları içerisinde bulunan işletme portföyü üzerinde admin yetkisi bulunan bir kullanıcı
- Yurt dışı alışverişe açık, EUR veya USD ile ödeme yapabilen bir kredi kartı
- WhatsApp için kullanılacak, SMS/arama alabilen bir telefon numarası
- Hotel ID gereklidir
- Meta Business hesabı hazırlığı — business.facebook.com üzerinden şirket adına bir Business Portfolio oluşturun ve gerekiyorsa iş yeri doğrulamasını (Business Verification) tamamlayın.
- Meta for Developers'a kayıt olun — Daha önce kayıt olmadıysanız developers.facebook.com adresinden geliştirici olarak kaydolun.
- Uygulama (App) oluşturun — "Create App" ile Use Case olarak "Connect with customers through WhatsApp", uygulama türü olarak Business (İşletme) seçip oluşturmayı tamamlayın. Bu adımda bir İşletme (Business) hesabı seçmek zorunludur — mevcut işletmenizi seçip devam edin.
- WhatsApp ürününü ekleyin — Uygulama panosunda Products listesinde WhatsApp'ın yanındaki "Setup" butonuna basıp oluşturduğunuz Business Portfolio'yu seçerek WhatsApp ürününü ekleyin.
- App Settings bilgilerini doldurun — Basic menüsünde Privacy Policy URL ve Terms of Service URL alanlarını doldurup "Save Changes" ile uygulamayı Live moda alın.
- Telefon numarasını ekleyin — WhatsApp panelinde "Üretim kurulumu" (production setup) menüsüne girerek configure webhook ve register your whatsapp number kısımları mutlaka sırayla yapılmalıdır.
- Graph API Explorer ile Telefon Numarasını Kaydetme (Register) — Tools > Graph API Explorer aracıyla POST isteği atıp telefon numaranızı PIN ile kaydedin; JSON body'de
messaging_productvepinalanlarını, Permissions'ta ise gerekli 3 izni girin. - Üretim kurulumuna dönüp doğrulayın — "Üretim kurulumu" sayfasına geri dönün; Register your WhatsApp phone number adımının yeşil onay işaretiyle tamamlandığını ve Subscribe webhooks seçeneğinin açık olduğunu kontrol edin.
- Add payment to send business-initiated messages — Üretim kurulumu listesindeki bu adımdan işletme başlatımlı mesajlar için ödeme yöntemi ekleyin.
- ElektraWeb ile bağlantıyı kurun — Ekranda görünen Phone Number ID ve WhatsApp Business Account ID değerlerini kopyalayıp CRM > WhatsApp > Cloud API Ayarları > WhatsApp İşletme Bilgileri ekranında yeni kayıt açarak girin.
Meta Business Hesabı ve Yetkilendirme Hazırlığı
Kurulum yapılacak otelin Meta Business ve Meta for Developers hesapları içerisinde bulunan işletme portföyü üzerinde admin yetkisine sahip bir kullanıcı sağlaması gerekir.
- business.facebook.com adresinden şirket adına bir Business Portfolio oluşturun.
- Gerekirse Meta Business Suite > Settings > Security Center > Business Verification adımından iş yeri doğrulamasını tamamlayın (vergi levhası, ticaret sicil, adres/telefon uyumu istenebilir).
Meta for Developers'a Kayıt Olma
Daha önce kaydolmadıysanız, aşağıdaki adresten geliştirici olarak kayıt olunmalıdır:
Uygulama (App) Oluşturma
"Create App" ile Use Case olarak "Connect with customers through WhatsApp", uygulama türü olarak Business (İşletme) seçip oluşturmayı tamamlayın. Bu adımda bir İşletme (Business) hesabı seçmek zorunludur — mevcut işletmenizi seçip devam edin.
İşletme Türünü Seçme ve WhatsApp Ürününü Ekleme
Mevcut işletmenizi seçip devam edin. Ardından uygulama panosunda Products listesinde WhatsApp'ın yanındaki "Setup" butonuna basıp oluşturduğunuz Business Portfolio'yu seçerek WhatsApp ürününü ekleyin.
Karşınıza çıkan ekranda oluşturduğunuz Business Portfolio'yu (işletme portföyünüzü) seçmeniz istenir.
Portföyünüzü seçip devam ettikten sonra Quickstart sayfası açılır; bu ekran WhatsApp Business Platform kurulumunuzun başlangıç noktasıdır.
App Settings — Privacy Policy ve Terms of Service
App Settings > Basic menüsü altındaki "Privacy Policy URL" ve "Terms of Service URL" alanları doldurulmalıdır (sayfanın dili fark etmeksizin). İşaretli alanlar, kurulum yapılan işletmenin kendi internet sitesinde bulunan KVKK veya gizlilik sözleşmesi linki ile doldurulmalıdır.
Alanlar doldurulduktan sonra "Save Changes" butonuna tıklanarak uygulama canlıya (Live) alınır.
Telefon Numarası Ekleme ve Webhook Yapılandırması
WhatsApp panelinde "Üretim kurulumu" (production setup) menüsüne girilmeli ve telefon numarası ekleme işlemi buradan tamamlanmalıdır.
Webhook (Configuration) Ayarları
Kurulum yapılan yerin mesaj alabilmesi için WhatsApp panelinde "Üretim kurulumu" (Production setup) menüsüne gidilmeli ve Configure Webhooks ile Register your WhatsApp phone number adımları sırayla tamamlanmalıdır.
Açılan ekrandaki Callback URL ve Verify Token alanları aşağıdaki bilgilerle doldurulmalıdır: Callback URL içindeki {HOTEL_ID} kısmı kendi işletmenize göre değiştirilmelidir; Verify Token ise herkes için aynıdır, aşağıdaki değeri olduğu gibi (aynen) yapıştırabilirsiniz.
Callback URL ve Verify Token kısmına aşağıdaki bilgiler girilmeli, ardından "Verify and save" butonuna tıklanmalıdır:
İşlem başarılı olduktan sonra Configure Webhooks adımı yeşil onay işaretiyle tamamlanır. Ardından Register your WhatsApp phone number adımında numaranız eklenip doğrulanır ve Subscribe webhooks açık konuma alınmalıdır.
Webhook tanımlandıktan sonra Configure Webhooks sekmesinin altında bulunan Webhook fields listesinde "messages" satırı mutlaka bulunup Subscribed konumuna alınmalıdır — bu olmadan mesajlar sisteme ulaşmaz.
Graph API Explorer ile Telefon Numarasını Kaydetme (Register)
Telefon numarasını iki adımlı doğrulama (PIN) ile kaydetmek için Tools > Graph API Explorer aracı kullanılır.
- İstek türünü (method) GET değil, POST olarak seçin.
- Adres kısmına otelin kendi Phone Number ID'sini yazıp sonuna /register ekleyin (örn.
1224870037372290/register) — bu numara her kurulumda farklıdır. - JSON sekmesini seçip aşağıdaki gövdeyi (body) yapıştırın:
Sağ taraftaki Access Token panelinde Meta App olarak ilgili uygulama, User or Page olarak User Token seçilmeli; Permissions sekmesinden şu 3 izin mutlaka eklenmelidir:
business_managementwhatsapp_business_managementwhatsapp_business_messaging
"success": true yanıtını görürseniz, telefon numarası kaydı başarıyla tamamlanmış demektir.Üretim Kurulumuna Geri Dönüş ve Doğrulama
Graph API Explorer üzerinden telefon numarası kaydı (register) tamamlandıktan sonra tekrar WhatsApp panelindeki "Üretim kurulumu" (Production setup) sayfasına dönülür. Register your WhatsApp phone number adımının yeşil onay işaretiyle tamamlandığı ve Subscribe webhooks seçeneğinin açık (mavi) konumda olduğu kontrol edilmelidir.
Add Payment to Send Business-Initiated Messages
Üretim kurulumu listesindeki "Add payment to send business-initiated messages" adımından, işletme başlatımlı (business-initiated) mesajlar gönderebilmek için bir ödeme yöntemi eklenmelidir.
ADIM 10ElektraWeb ile Bağlantı
Meta tarafında elde edilen Phone Number ID ve WhatsApp Business Account ID değerleri, ElektraWeb panelinde CRM > WhatsApp > Cloud API Ayarları > WhatsApp İşletme Bilgileri ekranına girilerek Meta ile ElektraWeb arasındaki bağlantı kurulur.
- Telefon Numarası Kimliği alanına Meta tarafındaki Phone Number ID değeri girilir.
- İşletme Kimliği alanına Meta tarafındaki WhatsApp Business Account ID değeri girilir.
- Telefon Numarası ve Telefon Numarası Adı alanları doldurularak kayıt Aktif duruma getirilir.