ELEKTRAWEB · ENTEGRASYON REHBERİ

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.

1) Kısa Özet — tüm adımların hızlı bir referans listesi
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

Dikkat: Kullanılacak telefon numarası üzerinde hâlihazırda WhatsApp veya WhatsApp Business hesabı bulunuyorsa, kurulum öncesi WhatsApp hesap ayarları bölümünden "Hesabı Sil" butonu ile ilgili WhatsApp hesabı silinmelidir (hesap silindikten sonra tekrar kurulum yapılabilmesi için ortalama 3-5 dakika bekleme süresi bulunmaktadır).
  1. 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.
  2. Meta for Developers'a kayıt olun — Daha önce kayıt olmadıysanız developers.facebook.com adresinden geliştirici olarak kaydolun.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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_product ve pin alanlarını, Permissions'ta ise gerekli 3 izni girin.
  8. Ü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.
  9. 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.
  10. 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.
Not: Entegrasyon otel yetkilileri veya ElektraWeb çalışanları tarafından yapılabilir. ElektraWeb çalışanları sizden hiçbir zaman Meta kullanıcı adı/şifresi veya kredi kartı bilgileriniz gibi özel bilgiler talep etmez.
ADIM 1

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.

Meta Business Suite — İşletme portföyü oluşturma (İşletme portfolyosu oluştur)
ADIM 2

Meta for Developers'a Kayıt Olma

Daha önce kaydolmadıysanız, aşağıdaki adresten geliştirici olarak kayıt olunmalıdır:

Geliştirici Kayıt Linki
https://developers.facebook.com/
ADIM 3

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.

Meta for Developers > Create App ekranı
Create an app > Use cases — "Connect with customers through WhatsApp" seçili olmalıdır
Zorunlu adım: "Create an app" sihirbazının "Type" adımında uygulama türü olarak mutlaka "İşletme" seçilmelidir; "Tüketici" seçilirse WhatsApp ürünü sonradan eklenemez.
Create an app > Select an app type — "İşletme" seçili olmalıdır
ADIM 4

İş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.

Available products — WhatsApp satırı — "Set up" butonu

Karşınıza çıkan ekranda oluşturduğunuz Business Portfolio'yu (işletme portföyünüzü) seçmeniz istenir.

WhatsApp Business Platform — Select a business portfolio

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.

WhatsApp > Quickstart — Welcome to the WhatsApp Business Platform
ADIM 5

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.

App Settings > Basic — Privacy Policy URL ve Terms of Service URL alanları
App Mode alanının "Live" konuma alınması
ADIM 6

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.

Sol menü — WhatsApp > 2. Adım. Üretim kurulumu
Önemli: WhatsApp panelinde "Üretim kurulumu" (production setup) menüsüne girerek configure webhook ve register your whatsapp number kısımları ekranda göründükleri sırayla, hiçbir adım atlanmadan tamamlanmalıdır; sıra dışı ilerlemek doğrulama hatalarına yol açabilir.

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:

Callback URL
https://whatsapp-api.elektraweb.com/whatsapp/{HOTEL_ID}/webhook
Dikkat: Callback URL içindeki {HOTEL_ID} kısmı kuruluma özeldir — her otel için farklı bir değer olacaktır. Aşağıdaki ekran görüntüsünde bu kısım kırmızı kutu ile işaretlenmiştir.
Verify Token
EAAESf1T5xnkBO3rZAKsq3b5WZA3lVm2M4faS7HOGwnVqR3iEZCVOlLSApUYr6t6GBz8qDASgZBoNc35cChCuNnuyktnaBzUcoA5TRRXbGWsHnJKf1o5yMZAKOKggQn3TayPh3qKuTlhoorw1lZB77R6F991iU62p61NYcsfNoO2ciVXw7RMbzanuygviGg8QUyBWogf38toYzJbW2S5wZDZD
Üretim kurulumu — Configure Webhooks — Callback URL içindeki HOTEL_ID kuruluma özeldir

İş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.

Üretim kurulumu — Configure Webhooks ve Register your WhatsApp phone number tamamlandı
Zorunlu adım: Üretim kurulumu (production setup) kısımları ekranda göründükleri sırayla tamamlanmalıdır: önce Configure Webhooks, ardından Register your WhatsApp phone number. Her iki adım da yeşil onay işaretiyle tamamlanmadan sonraki adımlara geçilmemelidir.
Not: Bu resimde görülen Phone Number ID ve WhatsApp Business Account ID değerleri, kurulumun ilerleyen aşamalarında gerekmektedir. Bu sebeple not edilmesi tavsiye edilir.

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.

Webhook fields listesi — "messages" satırı Subscribed konumunda
ADIM 7

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.

Meta üst menü — Tools > Graph API Explorer
  1. İstek türünü (method) GET değil, POST olarak seçin.
  2. 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.
  3. JSON sekmesini seçip aşağıdaki gövdeyi (body) yapıştırın:
JSON Body (kopyalanabilir)
{ "messaging_product": "whatsapp", "pin": "123456" }

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:

Graph API Explorer — POST .../register isteği, gerekli izinler ve başarılı yanıt
Bunu görünce tamamdır: "Submit" butonuna bastıktan sonra sağ panelde "success": true yanıtını görürseniz, telefon numarası kaydı başarıyla tamamlanmış demektir.
ADIM 8

Ü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.

Üretim kurulumu — Register your WhatsApp phone number yeşil onaylı, Subscribe webhooks açık
Her iki madde de (Configure Webhooks ve Register your WhatsApp phone number) yeşil onay işaretiyle görünüyorsa bu aşama tamamlanmış demektir.
ADIM 9

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 10

ElektraWeb 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.

ElektraWeb — WhatsApp İşletme Bilgileri ekranı: Telefon Numarası Kimliği (Phone Number ID) ve İşletme Kimliği (WhatsApp Business Account ID) alanları
Bilgiler girildikten sonra, WhatsApp mesajlaşmasının sizin adınıza yönetilebilmesi için ekranın sağ altında yer alan Facebook ikonuna tıklanmalıdır. Bu butona tıklanmadan önce yeni sekmede Meta Business Suite hesabı açık olmalıdır; sonrasında açılan ekranda "Tümünü seç" butonlarına tıklanarak sayfalar ilerletilmelidir. En son sayfada işlem başarıyla tamamlanması halinde Meta sizlere "Success" mesajı verecektir.
Mesajlaşma hatırlatması: Bir müşteriye ilk mesajın gönderilebilmesi için genellikle Meta tarafından onaylanmış bir mesaj şablonu (template) gerekir. Müşteri size yazdığında ise 24 saatlik pencere içinde serbestçe (şablonsuz) yanıt verilebilir.
Güvenlik hatırlatması: Entegrasyon otel yetkilileri veya ElektraWeb çalışanları tarafından yapılabilir; ancak ElektraWeb çalışanları sizden Meta kullanıcı adı/şifresi veya kredi kartı bilgileriniz gibi özel bilgileri asla talep etmez.