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:
- Business settings → System users → Add (rol: Admin).
- Kullanıcıyı seçin → Generate new token → uygulamanızı seçin → süre Never.
- İzinlerden
whatsapp_business_messagingvewhatsapp_business_managementişaretleyin. - Çıkan anahtarı hemen kopyalayın — bir daha gösterilmez.
- 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
- 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).
- Display Name onayı isteyin (müşterinin göreceği işletme adı; 1–3 gün).
- Günde 1.000 mesaj sınırını kaldırmak için Business verification yapın (vergi levhası vb.).
- WhatsApp faturalandırmasına ödeme yöntemi ekleyin.
- 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 gitmiyor | Eriş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 list | Test 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ış. |