WhatsApp'ı MesajPilot'a bağlayın

Kendi (ücretsiz) Meta uygulamanızı kurarsınız, MesajPilot onun webhook'unu dinler. Müşteri mesajları pazaryeri sorularının yanına, aynı gelen kutusuna düşer; yanıtlar panelden — isterseniz otomatik yanıt moduyla — gider. İlk kurulum yaklaşık 20–30 dakika sürer.

1. Meta Business hesabı açın5 dk

business.facebook.com Hesap oluştur. İşletme adınızı ve e-postanızı girin, doğrulama e-postasını onaylayın.

2. Meta geliştirici uygulaması oluşturun3 dk

developers.facebook.com/apps Create App. Use case: Other, tür: Business. 1. adımdaki işletme hesabını seçin.

3. WhatsApp ürününü ekleyin1 dk

Uygulama panosunda WhatsApp → Set up. Meta otomatik olarak bir WhatsApp Business Account (WABA) ve ücretsiz test numarası oluşturur — canlıya geçmeden her şeyi bu numarayla deneyebilirsiniz.

4. Phone Number ID'yi kopyalayın1 dk

WhatsApp → API Setup sayfasında, telefon numarasının altındaki Phone Number ID'yi kopyalayın. MesajPilot bağlantı formuna bu girilecek.

5. KALICI erişim anahtarı oluşturun8 dk

API Setup'taki hazır anahtar 24 saatte ölür — üretimde kullanmayın. Kalıcısı için:

  1. Business settings → System usersAdd (rol: Admin).
  2. Kullanıcıyı seçin → Generate new token → uygulamanızı seçin → süre Never.
  3. İzinlerden whatsapp_business_messaging ve whatsapp_business_management işaretleyin.
  4. Çıkan anahtarı hemen kopyalayın — bir daha gösterilmez.
  5. Aynı sayfada Assign assets → WhatsApp hesabınız (full control) ve uygulamanız.

6. App Secret'ı kopyalayın1 dk

App settings → Basic → App Secret → Show. MesajPilot bu değerle gelen webhook'un gerçekten Meta'dan geldiğini doğrular — imzasız istekler reddedilir.

7. Bir Verify Token uydurun1 dk

İstediğiniz bir ifade, örn. magazam-mesajpilot-2026. Aynı ifadeyi iki yere yazacaksınız: MesajPilot formu ve Meta webhook penceresi.

8. MesajPilot'ta bağlantıyı kaydedin1 dk

Panel → Veri Yükleme → WhatsApp → Bağla: Phone Number ID (adım 4), kalıcı erişim anahtarı (adım 5), App Secret (adım 6) ve Verify Token (adım 7). MesajPilot kaydetmeden önce bilgileri canlı doğrular; bilgiler AES-256 ile şifrelenerek saklanır.

⚠️ Bu adımı bir sonrakinden ÖNCE yapın — Meta'nın webhook denetimi, ancak MesajPilot sizin Verify Token'ınızı zaten biliyorsa geçer.

9. Meta'da webhook'u ayarlayın3 dk

Meta uygulaması → WhatsApp → Configuration → Webhook → Edit:

Callback URL: https://mesajpilot.com.tr/api/webhook/whatsapp

Verify Token: adım 7/8'de yazdığınızın birebir aynısı.

Verify and Save → yeşil onay görmelisiniz.

Ardından Webhook fields listesinde messages satırında Subscribe'a basın. Bu yapılmazsa Meta gelen mesajları hiç iletmez.

10. Test edin2 dk

Test numarası kullanıyorsanız önce kendi telefonunuzu API Setup → To → Manage phone number list'e ekleyin (test numarası yalnızca onaylı 5 alıcıyla konuşabilir).

İşletme numarasına bir WhatsApp mesajı atın. Saniyeler içinde MesajPilot gelen kutunuza WhatsApp rozetiyle düşer. Panelden yanıtlayın — müşteriye WhatsApp'tan gider.

Müşterinin son mesajından sonraki 24 saat içinde verdiğiniz yanıtlar Meta'nın servis penceresinde ücretsizdir; ayda ilk 1.000 konuşma da ücretsizdir.

11. Gerçek numarayla canlıya geçişdeğişken

  1. WhatsApp uygulamasına hiç kayıt olmamış bir numara ekleyin (doğrulama SMS ya da arama — Türkiye'de SMS gecikebilir, "Call me" seçin).
  2. Display Name onayı isteyin (müşterinin göreceği işletme adı; 1–3 gün).
  3. Günde 1.000 mesaj sınırını kaldırmak için Business verification yapın (vergi levhası vb.).
  4. WhatsApp faturalandırmasına ödeme yöntemi ekleyin.
  5. Yeni numaranın Phone Number ID'si değişir — MesajPilot formunu güncelleyin.

Sık karşılaşılan sorunlar

Webhook verify failed (kırmızı)Meta'daki Verify Token ile formdaki aynı değil. Karakter karakter karşılaştırın; önce MesajPilot formunu kaydedin.
Mesaj geliyor, yanıt gitmiyorErişim anahtarınızın süresi doldu — 24 saatlik anahtarı kullanmışsınız. Kalıcı System User anahtarı oluşturun (adım 5).
Recipient not in allowed listTest numarası yalnızca onaylı alıcılara gönderir — API Setup → To listesine ekleyin.
24 saat sonra çalışmayı bıraktıAynı sebep: geçici anahtar. Kalıcısına geçin.
Mesajlar gelen kutusuna düşmüyor'messages' alanına abone olunmamış (adım 9) ya da formdaki Phone Number ID yanlış.
WhatsApp Kurulum Rehberi — MesajPilot