- İki yol var: doğrudan Meta Cloud API (tam kontrol, yüksek kurulum maliyeti) ya da hazır panel API'si (dakikalar içinde entegrasyon).
- Mesajilet Geliştirici API'si REST + webhook sunar; kanal bağımsızdır (WhatsApp ve diğer kanallar aynı uçtan).
- Webhook'lar HMAC imzalıdır; gelen bildirimin gerçekliğini doğrularsiniz.
- Şablon gönderimleri için panelde hazır API örnekleri bulunur; kopyala-yapıştır ile başlarsınız.
İki entegrasyon yolu
| Konu | Doğrudan Meta Cloud API | Mesajilet Geliştirici API |
|---|---|---|
| Kurulum | Meta app, numara, sertifika, şablon yönetimi… haftalar | Panelden anahtar al, ilk isteği dakikalar içinde at |
| Şablon yönetimi | Kendi arayüzünüzü yazarsınız | Panelde hazır; API örnekleri şablonun yanında |
| Gelen mesajlar | Webhook altyapısını sıfırdan kurarsınız | HMAC imzalı hazır webhook |
| Ekip ekranı | Yok; kendiniz yazarsınız | Panel hazır: sohbet, atama, rapor |
| Diğer kanallar | Her kanal ayrı API | Kanal bağımsız tek uç |
Mimari: REST + webhook
Entegrasyon iki yönlüdür. Giden: yazılımınız REST isteğiyle mesajı gönderir — serbest metin (açık pencerede) ya da onaylı şablon (değişkenleriyle). Gelen: müşteri yanıtları ve teslim/okundu durumları, sizin belirlediğiniz URL'ye webhook olarak düşer. Böylece sipariş sisteminiz “mesaj iletildi mi” bilgisini anında işler, gelen yanıtları kendi akışınıza bağlarsınız.
Tipik kullanım senaryoları
- Sipariş/kargo bildirimi: ERP ya da e-ticaret yazılımınız durum değiştiğinde şablonlu mesajı tetikler.
- OTP / doğrulama: Giriş ve işlem onayı kodları WhatsApp'tan gider; SMS'e göre çok daha yüksek ulaşma oranı.
- Form → sohbet: Sitenizden gelen talep formunu sohbete dönüştürür, satış ekibi panelden devralır.
- Kendi uygulamanız + hazır panel: Mesajları API ile gönderirsiniz; ekibiniz yanıtları yine hazır panelden yönetir. İki dünyanın iyisi.
Güvenlik
- API anahtarı sunucu tarafında saklanır; istemci koduna gömülmez.
- Webhook imzası (HMAC) her bildirimde doğrulanır; sahte istek işlenmez.
- Gönderimler resmî Meta altyapısı üzerinden yapılır; numara güvenliği API tarafında da geçerlidir.
Başlama adımları
- Hesap açın ve numarayı bağlayın; deneme süresinde API de kullanılabilir.
- API anahtarınızı alın ve dökümantasyondaki ilk isteği çalıştırın.
- Şablonlarınızı hazırlayın: panelde onaylatın; her şablonun yanındaki hazır API örneğini kopyalayın.
- Webhook URL'nizi tanımlayın; gelen mesaj ve durum bildirimlerini kendi sisteminize bağlayın.
Ayrıntılı dökümantasyon ve uç listesi için geliştirici sayfasına bakın.
Sık sorulan sorular
WhatsApp API entegrasyonu için Meta onayı gerekir mi?
Numaranızın WhatsApp Business Platform'a bağlanması gerekir; bunu Mesajilet kurulum sihirbazı halleder. Sonrasında kendi yazılımınız Mesajilet API'siyle konuşur, Meta tarafıyla ayrıca uğraşmazsınız.
Hangi programlama dilleriyle kullanılabilir?
API standart REST/JSON'dur; HTTP isteği atabilen her dil (PHP, Python, Node.js, C#, Java…) kullanılabilir. Panelde kopyalanabilir örnekler bulunur.
Gelen mesajları kendi sistemimde işleyebilir miyim?
Evet; webhook tanımladığınızda gelen mesajlar ve iletildi/okundu durumları HMAC imzalı bildirimlerle sizin URL'nize iletilir.
API ile gönderilen mesajlar panelde görünür mü?
Görünür. API'den gönderilen mesajlar da aynı sohbet akışına düşer; ekibiniz kaldığı yerden panelden devam eder.
OTP (tek kullanımlık kod) gönderimi yapılabilir mi?
Evet; doğrulama kategorisinde onaylı şablonla OTP gönderilir. WhatsApp'ta ulaşma ve okunma oranı SMS'e göre belirgin yüksektir.
İlk isteğinizi bugün atın.
API anahtarınızı alın, hazır örnekle ilk mesajı gönderin; yanıtları ister webhook'la işleyin ister panelden yönetin.