Genel Bakış
WhatsApp AI mesajlaşma, müşterilerinizden gelen WhatsApp mesajlarını işleyerek AI Agent’iniz aracılığıyla otomatik yanıtlar üreten, uçtan uca bir mesajlaşma çözümüdür. Tüm akış — mesaj alımı, oturum yönetimi, AI yanıt üretimi ve mesaj gönderimi — tamamen otomatik olarak gerçekleşir.Mesajlaşma Akışı (Uçtan Uca)
1. Gelen Mesaj Akışı
Müşteri WhatsApp üzerinden mesaj gönderdikten sonra aşağıdaki adımlar otomatik olarak gerçekleşir:Webhook Alımı
Meta, mesajı platformun webhook endpoint’ine iletir. Platform,
X-Hub-Signature-256 başlığını kullanarak mesajın Meta’dan geldiğini doğrularOlay İşleme
Webhook verisi şifrelenir, veritabanına kaydedilir ve olay türüne göre dallandırılır:
- Mesaj Alındı — Yeni gelen mesaj
- Durum Güncellemesi — Gönderilen mesajın teslimat durumu
- SMB Echo — Başka cihazdan gönderilen mesaj yansıması
- Hesap Güncellemesi — WABA hesap bilgi değişikliği
Müşteri Tanımla
Gelen mesajdaki WhatsApp ID ile müşteri kaydı eşleştirilir. Yeni bir müşteri ise otomatik olarak oluşturulur
Oturum Yönetimi
Aktif bir mesajlaşma oturumu var mı kontrol edilir. Yoksa yeni oturum başlatılır. Önceki oturum süresi dolmuşsa kapatılır ve yeni oturum oluşturulur
2. AI Yanıt Üretimi
AI turn tetiklendikten sonra:Turn Talep Etme
AI turn işleme için talep edilir ve kilit alınır. Eşitlik sağlamak için aynı anda birden fazla çalışan işlem, aynı turn’u işleyemez
Ön Kontroller
Sırayla aşağıdaki kontroller yapılır:
whatsapp_messaging_channelyetkisi kontrol edilir- Çok sayıda iptal edilen AI turu tespit edildiğinde taşma koruması devreye girer
- WhatsApp devre kesici durumu kontrol edilir
- Organizasyonun kredi bakiyesi kontrol edilir (minimum 0.2 kredi gerekli)
Kontekst Yükleme
AI modeli için gerekli veriler yüklenir:
- Agent yapılandırması ve sistem talimatları
- Son 80 bağlam zaman çizelgesi öğesi
- Ardından birleşik mesajlar oluşturulur (aynı yöndeki ardışık metin mesajlar birleştirilerek en fazla 20 öğeye indirgenir)
AI Yanıt Üretimi
LLM (büyük dil modeli) çağrılır ve yanıt üretilir. Yanıt metin içeriyorsa doğrudan kullanılır. Araç çağırısı içeriyorsa, araç çalıştırılır ve sonuç LLM’e geri beslenir (en fazla 2 adım, adım başına en fazla 5 araç çağırısı)
3. Giden Mesaj Dağıtımı
Kuyruk Teslimi
Gönderilecek mesaj dağıtım kuyruğundan alınır ve kilit koyulur (eş zamanlı en fazla 50 işlem)
Gönderim Ön Kontrol
Yetki, devre kesici durumu ve gerekli alanların (erişim anahtarı, telefon numarası, müşteri numarası) tamlığını kontrol edilir
Mesajlaşma Oturumları
Her WhatsApp konuşması bir mesajlaşma oturumu içerisinde yönetilir:- Oturum Başlangıcı: Müşteriden gelen ilk mesajla otomatik başlar
- Oturum Süresi: Yapılandırılabilir hareketsizlik zaman aşımıyla (varsayılan değer agent ayarlarında belirlenir)
- Oturum Sonu: Zaman aşımı, AI aracı ile kapatma veya manuel kapatma ile sonlanır
- Oturum Sonrası: Analiz, yapılandırılmış çıktı oluşturma ve transkript üretimi başlatılır
Her AI yanıtı 0.2 kredi tüketir. Kredi bakiyeniz yetersiz olduğunda müşteriye otomatik bir sistem mesajı gönderilir (yapılandırıldıysa).
Araç/Fonksiyon Çağırıları
AI Agent’iniz WhatsApp üzerinden de araç (tool/function) çağırılarını kullanabilir:Yerleşik Araçlar
- Oturumu Sonlandır: Konuşmayı programatik olarak kapatır
- Özel Aksiyon: HTTP webhook ile dış sistemlerle entegrasyon
- Müşteri Opt-Out: Müşteriyi mesajlaşma listesinden çıkarır
Araç Döngüsü Limitleri
| Parametre | Limit |
|---|---|
| Maksimum araç döngüsü adımı | 2 |
| Adım başına maksimum araç çağırısı | 5 |
Teslimat Durumları
Gönderilen mesajların teslimat durumu gerçek zamanlı olarak izlenir:| Durum | Açıklama |
|---|---|
| sent | Mesaj Meta sunucularına iletildi |
| delivered | Mesaj müşterinin cihazına teslim edildi |
| read | Müşteri mesajı okudu |
| failed | Mesaj gönderilemedi |
Devre Kesici Mekanizması
Platform, WhatsApp mesaj gönderim hatalarında otomatik devre kesici (circuit breaker) mekanizması uygular:Nasıl Çalışır?
- Bir mesaj gönderimi başarısız olduğunda ve hata kodu devre kesici açmayı gerektiriyorsa, ilgili WhatsApp hesabı için devre kesici açılır
- Devre kesici açık olduğunda, o hesaptan yeni mesaj gönderimi engellenir
- AI yanıt üretimi de devre kesici açıkken atlanır (gereksiz kredi tüketimi önlenir)
- Platform, süresi dolan devre kesicileri otomatik olarak normalleştirir (en fazla 200 kayıt/tur)
Devre Kesiciyi Açan Durumlar
| Hata Türü | Kod | Devre Kesici |
|---|---|---|
| Erişim anahtarı geçersiz | access_token_invalid | ✅ Açılır |
| Kimlik doğrulama hatası | auth_failure | ✅ Açılır |
| Rate limit aşıldı | rate_limit_exceeded | ✅ Açılır |
| Geçici gönderim hatası | temporary_send_failure | ✅ Açılır |
| Ağ zaman aşımı | network_timeout | ✅ Açılır |
| Ağ hatası | network_error | ✅ Açılır |
| Kalıcı gönderim hatası | permanent_send_failure | Kimlik hatasıysa açılır |
| Bağlam iptal edildi | context_canceled | ❌ Açılmaz |
| Genel gönderim hatası | send_failed | ❌ Açılmaz |
Devre kesici normalleşme işlemi arka planda periyodik olarak çalışır. Acil durumlarda destek ekibi ile iletişime geçin.
Sistem Mesajları
Platform, belirli durumlarda müşterilere otomatik sistem mesajları gönderir:Oturum Zaman Aşımı Mesajı
Oturum hareketsizlik nedeniyle sonlandığında, yapılandırıldıysa müşteriye bir kapanış mesajı gönderilir.Yetersiz Kredi Mesajı
Organizasyonun kredi bakiyesi 0.2’nin altına düştüğünde, müşteriye otomatik bir bilgilendirme mesajı gönderilir (yapılandırıldıysa). Bu mesaj, belirli bir periyot içinde bir kez gönderilir (tekrar önleme). Sistem mesajı atlama nedenleri:- Oturum uygun değil
- Davranış
silentolarak ayarlanmış - Mesaj metni boş
- Aynı mesaj zaten kuyrukta
- 24 saatlik müşteri penceresi kapanmış
İlgili Makaleler
Desteklenen Mesaj Türleri
Aktif ve planlanan mesaj türleri
Mesaj Şablonları
24 saat penceresi ve şablon yönetimi
Ajan Yapılandırması
AI Agent WhatsApp ayarları
Sorun Giderme
AI yanıt ve gönderim sorunları