WA
WhatsApp işlemleri
Aktif WhatsApp ürününüzü CRM, sipariş veya bildirim süreçlerinizle bağlayın.
İncele →Geliştiriciler · API Hub
WaMessage Geliştirici API’si ile mesajlaşmayı yazılımınıza bağlayın.
WaMessage Geliştirici API’si ile işletmenizin mesajlaşma süreçlerini yazılımınıza bağlayın. WhatsApp, SMS ve WhatsApp Business API ürünlerini tek geliştirici merkezinden yönetin.
WhatsAppSMSWhatsApp Business APITürkçe destek
WaMessage · Geliştirici Merkezi
Kanal Ailesi3
DurumAktif
YönetimAPI + Panel
WhatsApp mesaj işlemleriAktif ürününüze göre entegrasyon
HAZIRSMS APIStandart SMS, OTP ve toplu kullanım
APIWhatsApp Business APIResmî Meta altyapısıyla bağlantılı kullanım
WABAÖzet
WaMessage Geliştirici API’si, işletmenizin WaMessage’te kullandığı mesajlaşma ürünlerini CRM, ERP, e-ticaret veya kendi uygulamanızdaki iş süreçleriyle birleştirmek için kullanılan entegrasyon katmanıdır. WhatsApp Business API ise Meta’nın WhatsApp mesajlaşma altyapısıdır; iki kavram birbirinden farklıdır.
Tek API ailesi
Paneli kullanın; ihtiyaç olduğunda yazılımınızı da bağlayın.
WaMessage yalnız geliştiricilere yönelik bir API ürünü değildir. İşletme paneli hazırdır; API, paneldeki operasyonu kendi sisteminizle birleştirmek istediğinizde devreye girer.
Kanal seçimi
Aynı entegrasyon ihtiyacında doğru kavramı seçin.
Kullanıcıların ve yapay zeka sistemlerinin kavramları karıştırmaması için kanal, ürün ve entegrasyon katmanlarını açıkça ayırıyoruz.
POST /api/.../message
{
"channel": "whatsapp",
"to": "905xxxxxxxxx"
}
Kanal ve endpoint ayrıntıları hesabınızdaki aktif ürün ve güncel dokümantasyona göre kullanılmalıdır.
{
"channel": "whatsapp",
"to": "905xxxxxxxxx"
}
Kanal ve endpoint ayrıntıları hesabınızdaki aktif ürün ve güncel dokümantasyona göre kullanılmalıdır.
POST /api/.../sms
{
"to": "905xxxxxxxxx",
"message": "Doğrulama kodunuz..."
}
SMS API anahtarı WaMessage panelinden alınır. OTP/standart kanal seçimi mesaj kurallarına göre değerlendirilir.
{
"to": "905xxxxxxxxx",
"message": "Doğrulama kodunuz..."
}
SMS API anahtarı WaMessage panelinden alınır. OTP/standart kanal seçimi mesaj kurallarına göre değerlendirilir.
WhatsApp Business API entegrasyonu
Altyapı: Meta WhatsApp Business Platform
Yönetim: WaMessage paneli
Uygulama bağlantısı: WaMessage geliştirici araçları
WhatsApp Business API ile WaMessage Geliştirici API’si aynı kavram değildir.
Altyapı: Meta WhatsApp Business Platform
Yönetim: WaMessage paneli
Uygulama bağlantısı: WaMessage geliştirici araçları
WhatsApp Business API ile WaMessage Geliştirici API’si aynı kavram değildir.
Entegrasyon senaryoları
API ne zaman gerçekten değer üretir?
API; panelin yerine geçmek için değil, manuel adımları kendi sisteminizdeki olaylarla birleştirmek için kullanılır.
Geliştirici entegrasyonu
WaMessage Geliştirici API'si hangi problemi çözer?
WaMessage paneli manuel ve ekip tabanlı mesajlaşma işlemleri için kullanılabilir. Ancak mesajın bir sipariş, CRM kaydı, form, randevu, ERP olayı veya şirket içi yazılım tarafından otomatik tetiklenmesi gerekiyorsa geliştirici entegrasyonu devreye girer. WaMessage Geliştirici API'si, işletmenin kendi yazılımı ile WaMessage'teki mesajlaşma kanalları arasında bağlantı kurmak için kullanılır.
Bu kavram WhatsApp Business API ile aynı değildir. WhatsApp Business API Meta'nın WhatsApp mesajlaşma altyapısıdır; WaMessage Geliştirici API'si ise WaMessage hesabını ve ürünlerini kendi sisteminize bağlama katmanıdır. SMS için ayrıca SMS API dokümantasyonu bulunur.
CRM entegrasyonu
Müşteri kartında yapılan bir işlem, satış aşaması veya görev WaMessage üzerinden mesaj tetikleyebilir; gelen iletişim de CRM kaydıyla ilişkilendirilebilir. Böylece temsilciler iki sistem arasında manuel kopyalama yapmaz.
ERP / sipariş entegrasyonu
Sipariş oluşturuldu, kargoya verildi, ödeme bekleniyor veya işlem tamamlandı gibi olaylar işletmenin ERP/e-ticaret sistemi tarafından bilinir. API entegrasyonu bu olayları mesajlaşma sürecine bağlayabilir.
Form ve lead entegrasyonu
Web formu, reklam lead'i veya başvuru ekranından gelen talep WaMessage tarafında satış ekibine aktarılabilir; ilk bilgilendirme veya takip mesajı işletme kuralına göre başlatılabilir.
Özel yazılım
Sektöre özgü uygulamalar, SaaS ürünleri veya kurum içi sistemler kendi kullanıcılarına mesajlaşma özelliği sunmak istediğinde API, paneldeki işlemlerin yazılım tarafından yönetilmesini sağlar.
Entegrasyon mimarisi
Sağlam bir mesajlaşma entegrasyonu sadece “istek gönder, 200 dönsün” mantığıyla kurulmaz.
Üretim ortamında kimlik doğrulama, veri doğrulama, tekrar gönderim riski, hata kaydı, mesaj durumlarının izlenmesi ve güvenli anahtar yönetimi birlikte tasarlanmalıdır. API anahtarı WaMessage panelinden alınır ve tüm API işlemlerinde yetkilendirme amacıyla kullanılır; anahtarın istemci tarafı koduna veya herkese açık depolara yazılmaması gerekir.
Kimlik doğrulamaAPI anahtarını sunucu tarafında güvenli secret olarak saklayın; loglara veya tarayıcı koduna taşımayın.
Veri doğrulamaTelefon numarası, mesaj içeriği, değişkenler ve zorunlu alanlar API çağrısından önce uygulama katmanında kontrol edilmelidir.
Tekrar gönderim kontrolüAğ hatası veya timeout sonrası aynı işlemin iki kez oluşmasını önlemek için uygulamanızda işlem kimliği ve durum kaydı tutun.
Hata yönetimiHataları kullanıcıya ham API mesajı olarak göstermek yerine sınıflandırın; geçici hatalar ile veri/izin hatalarını farklı işleyin.
Log ve izlenebilirlikİstek kimliği, zaman, hedef, kanal ve sonuç bilgisini kişisel verileri gereksiz kaydetmeden takip edilebilir hale getirin.
Ortam ayrımıTest senaryoları ile canlı müşteri verisini karıştırmayın; entegrasyonu kontrollü örnek alıcılarla doğrulayın.
Hangi kanal API ile kullanılmalı?
İş akışının ihtiyacına göre SMS, WhatsApp veya WhatsApp Business API tarafı seçilir. Örneğin kısa doğrulama mesajı SMS API ile, kurumsal WhatsApp şablonu WhatsApp Business API altyapısıyla, ekip tarafından takip edilecek müşteri konuşması ise CRM/çoklu temsilci yapısıyla ilişkilendirilebilir. Kanal seçimi iş kuralının bir parçası olmalı; uygulama kodunun farklı yerlerine dağılmış sabit kararlar halinde bırakılmamalıdır.
Örnek iş akışı
CRM'den mesaj gönderen bir entegrasyon nasıl kurgulanır?
- Olay oluşur: CRM'de müşteri “teklif gönderildi” aşamasına geçer.
- Uygulama kuralı çalışır: Müşterinin iletişim izni, telefon numarası ve tercih edilen kanal kontrol edilir.
- Mesaj hazırlanır: Şablon veya içerik, müşteri alanlarıyla güvenli şekilde doldurulur.
- WaMessage API çağrısı yapılır: Sunucu tarafındaki API anahtarı kullanılarak ilgili endpoint'e istek gönderilir.
- Sonuç kaydedilir: Başarı veya hata durumu CRM aktivitesine yazılır; tekrar deneme gerekiyorsa kontrollü şekilde kuyruğa alınır.
- Müşteri yanıt verirse: Görüşme ekip tarafından devam edecekse müşteri kartı ve ilgili temsilci bağlamı korunur.
Dokümantasyon kuralı: Endpoint, request/response alanları ve güncel teknik davranış için her zaman WaMessage'in yayınlanan geliştirici dokümantasyonunu kaynak kabul edin. Pazarlama sayfasındaki örnekler entegrasyon mimarisini anlatır; teknik sözleşmenin yerini tutmaz.
Geliştirici kontrol listesi
Canlıya almadan önce API entegrasyonunda ne test edilmeli?
İlk başarılı request entegrasyonun tamamlandığı anlamına gelmez. Canlı müşteri verisi kullanılmadan önce olumlu ve olumsuz senaryolar, hatalı telefon numarası, eksik parametre, yetkisiz istek, ağ gecikmesi ve aynı işlemin tekrar tetiklenmesi gibi durumlar test edilmelidir.
Başarılı akışDoğru alıcı ve içerikle beklenen mesajın oluşturulduğunu doğrulayın.
Eksik/hatalı veriZorunlu alan eksik olduğunda uygulamanın kullanıcıya anlaşılır hata verdiğini kontrol edin.
YetkilendirmeGeçersiz veya iptal edilmiş anahtarda işlem yapılmadığını doğrulayın.
Timeoutİstek sonucu belirsiz kaldığında kör şekilde yeniden gönderim yapmayın; işlem durumunu kontrol edin.
YoğunlukToplu işlemleri tek uzun HTTP çağrısına bağlamak yerine iş kuyruğu ve kontrollü hız planlayın.
GözlemTeknik ekibin sorun yaşandığında request zamanını ve işlem kimliğini bulabileceği log yapısı kurun.
API anahtarı nasıl korunmalı?
WaMessage panelinden alınan API anahtarı yalnız güvenilir sunucu ortamında saklanmalıdır. GitHub gibi herkese açık depolara, tarayıcı JavaScript'ine, mobil uygulama paketine veya müşteri tarafından görülebilecek loglara eklenmemelidir. Anahtarın sızdığından şüpheleniliyorsa mevcut anahtarı kullanmaya devam etmek yerine yenileme/iptal süreci uygulanmalıdır.
Teknik dokümantasyon nasıl kullanılmalı?
Endpoint yolları, header isimleri, request alanları ve güncel kanal davranışları zaman içinde değişebilir. Bu nedenle entegrasyon kodunu pazarlama sayfasındaki örneğe göre sabitlemek yerine yayınlanan API dokümantasyonunu kaynak alın. Kurum içinde kullandığınız API sürümünü ve entegrasyon tarihini teknik dokümana not etmek gelecekteki güncellemeleri kolaylaştırır.
Mimari karar
API entegrasyonunda senkron istek ile arka plan işini ayırın.
Kullanıcı bir butona bastığında dış API'nin tamamlanmasını uzun süre bekletmek kötü deneyim ve timeout riski oluşturabilir. Mesaj gönderimi gibi dış servis işlemlerinde uygulama önce kendi iş kaydını oluşturabilir, ardından gönderimi arka plan kuyruğunda çalıştırabilir. Kullanıcı ekranda “işleme alındı / gönderildi / başarısız” gibi durumları görebilir. Bu yapı özellikle toplu veya yüksek hacimli işlemlerde daha dayanıklıdır.
Retry ne zaman yapılmalı?
Her hata yeniden deneme gerektirmez. Geçici ağ veya servis hataları kontrollü aralıklarla tekrar denenebilir; hatalı numara, eksik parametre veya yetki hatasını tekrar göndermek ise aynı hatayı çoğaltır. Uygulama hata türünü sınıflandırmalı ve maksimum tekrar sayısı belirlemelidir.
Kişisel veri loglarda nasıl ele alınmalı?
Debug amacıyla tüm request gövdesini sürekli loglamak telefon numarası, mesaj içeriği veya müşteri verisinin gereksiz kopyalarını oluşturabilir. Operasyon için gereken işlem kimliği, zaman, kanal ve hata kodunu saklayıp hassas alanları maskelemek daha güvenli bir yaklaşımdır.
API entegrasyonunda versiyon ve değişiklik yönetimi.
Canlı entegrasyonun hangi endpoint'leri, hangi alanları ve hangi mesaj türlerini kullandığını kurum içinde kısa bir teknik dokümanda tutun. WaMessage dokümantasyonunda güncelleme olduğunda tüm kod tabanını aramak yerine bu envanterden etkilenen akışları belirleyebilirsiniz. API yanıtında kullandığınız alanları gereksiz yere çoğaltmamak da değişiklik riskini azaltır.
Geliştirici ve operasyon ekibi birlikte test etmeli
Teknik ekip request'in başarılı olduğunu görürken operasyon ekibi mesaj metninin yanlış müşteri alanıyla doldurulduğunu fark edebilir. Bu nedenle canlı öncesi testlerde hem yazılım geliştirici hem mesajı günlük kullanan satış/destek temsilcisi bulunmalıdır. Teknik başarı ve iş başarısı aynı test değildir.
Entegrasyonun sahibi yalnız yazılımcı olmamalıdır. İş kuralının sahibi olan satış, destek veya operasyon ekibi hangi olayda hangi mesajın oluşacağını yazılı olarak tanımlamalıdır. Teknik ekip bu kuralı API çağrısına dönüştürür. Böylece çalışan değiştiğinde kodun neden belirli bir mesaj gönderdiği anlaşılabilir kalır. Ayrıca üretim ortamında kullanılan API anahtarlarının kim tarafından yönetildiği, ne zaman yenilendiği ve erişimi kaldırılan personelin secretlara ulaşamaması kurumun güvenlik prosedüründe yer almalıdır.
API tüketen uygulamada kanal seçimini yapılandırılabilir tutmak ileride SMS, WhatsApp veya WhatsApp Business API arasında iş kuralı değiştirmeyi kolaylaştırır. Mesaj metnini kod içine gömmek yerine onaylı şablon veya konfigürasyon katmanında yönetmek de operasyon ekibinin yazılım deployu olmadan güncelleme yapabilmesine yardımcı olabilir.
Son olarak API entegrasyonuna bağımlı kritik süreçler için hata durumunda manuel alternatif prosedür tanımlamak iş sürekliliği açısından faydalıdır. Sistem geçici olarak mesaj gönderemediğinde operasyon ekibi ne yapacağını önceden bilmelidir.
Bu prosedür entegrasyon dayanıklılığını artırır.
Sık Sorulan Sorular
WaMessage Geliştirici API’si ile mesajlaşmayı yazılımınıza bağlayın. hakkında kısa cevaplar.
Net sorulara net cevaplar. Daha ayrıntılı konular ilgili ürün ve rehber sayfalarına bağlanır.
Hayır. WhatsApp Business API, Meta’nın WhatsApp Business Platform altyapısıdır. WaMessage Geliştirici API’si ise işletmenizin WaMessage ürünlerini kendi CRM, ERP veya uygulamasıyla bağlamak için kullanılan entegrasyon katmanıdır.
Evet. WaMessage paneli doğrudan kullanılabilir. API yalnız yazılım entegrasyonu veya otomatik tetikleme ihtiyacı olduğunda gerekir.
SMS API anahtarı WaMessage panelinden alınır ve API işlemlerinde yetkilendirme amacıyla kullanılır.
İşletmenize uygun WaMessage yapısını birlikte kuralım.
İhtiyacınız panel kullanımı, WhatsApp Business API, SMS, CRM, chatbot veya geliştirici entegrasyonu olabilir. Aynı platform üzerinde doğru ürün kombinasyonunu seçin.
İlgili yeni içerik