Convord gelen sipariş ve mesajları WhatsApp Cloud API üzerinden işler. Aşağıdaki değişkenler config/services.php içinde whatsapp grubuna okunur.
Ön koşullar
- Meta Business portföyünde uygulama ve WhatsApp ürünü etkin; test veya canlı için geçerli bir WhatsApp Business numarası.
- Sabit genel URL ile erişilen sunucu (webhook için HTTPS). Yerelde test için tünel (ngrok vb.) kullanılabilir.
- Meta dokümantasyonu: WhatsApp Cloud API — Get Started.
Sunucu (.env) değişkenleri
Aşağıdaki anahtarlar uygulamanın WhatsApp Graph istekleri ve webhook doğrulaması için kullanılır:
- WHATSAPP_API_TOKEN — Geçici veya sistem kullanıcı token’ı; Meta geliştirici panelinden üretilir. Üretimde süresi dolan token’ları yenilemeyi unutmayın.
- WHATSAPP_PHONE_NUMBER_ID — WhatsApp > API Kurulumu bölümündeki Phone number ID (Graph çağrılarında kullanılır).
- WHATSAPP_VERIFY_TOKEN — Sizin belirleyeceğiniz rastgele bir dize; Meta webhook “Verify” ekranında aynı değer girilir.
- WHATSAPP_API_URL — İsteğe bağlı; örneğin
https://graph.facebook.com/v18.0 (sürüm yükseltirken güncelleyin).
Webhook adresi
Meta “Callback URL” olarak şu tam adresi kullanın: https://convord.com/webhook/whatsapp
- GET isteği: Meta doğrulama sırasında
hub.verify_token değeri WHATSAPP_VERIFY_TOKEN ile aynı olmalıdır.
- POST isteği: Gelen mesajlar bu uca düşer; uygulama imza/doğrulama ve işleme mantığını kendi kodunda uygular.
Kurulum sonrası
Webhook alanında “Verify” tamamlandıktan sonra test numarasına mesaj göndererek uygulama loglarını kontrol edin. Token veya Phone Number ID hatalarında Graph API hata gövdesi log’da görünür.
Ek bilgi
Panel içi müşteri numarası eşleme ve operasyon akışı için Entegrasyon Rehberi ile birlikte okuyun.
Tam Meta Developer rehberi (Aşama 1–7, depo) →