Ana içeriğe atla
POST /send/interactive, seçilen cihaz üzerinden WhatsApp native-flow mesajları gönderir. Basic Auth, X-Device-Id ve bir JSON gövdesi kullanın. Bu uç nokta, anında REST gönderimlerini destekler. Zamanlanmış gönderimler ve MCP bu uç noktayı sunmaz.
Bu deneysel uç nokta, resmi olmayan bir WhatsApp protokolü kullanır. Alıcıdaki görüntüleme istemciye göre değişir ve önceden haber verilmeksizin değişebilir. Kullanmadan önce hedef istemcilerinizde test edin. Başarılı bir API yanıtı, gönderimin kabul edildiğini doğrular; teslimatı veya görüntülemeyi doğrulamaz.
curl örneklerini çalıştırmadan önce sunucu URL’sini ve kimlik bilgilerini ayarlayın. Uzak bir sunucu için genel HTTPS URL’sini kullanın ve yapılandırılmışsa APP_BASE_PATH değerini ekleyin.

Düğme gönderme

phone, bir telefon numarası veya tam kullanıcı ya da grup JID’si kabul eder. Gruba gönderim için üyelik ve paylaşım izni gerekir. Bülten ve yayın alıcıları desteklenmez. Üst düzeyde buttons veya cards sağlayın. İkisini birden sağlamak veya ikisini de sağlamamak doğrulama hatasına neden olur. Seçim listesi için şu parametreleri kullanın:

Konum isteme

Bu JSON’u /send/interactive uç noktasına gönderin. Alıcının konum paylaşmayı seçmesi gerekir. Uç nokta, alıcı işlem yapmadan konum almaz.

Görüntü karuseli gönderme

Görüntü yer tutucularını, data URL öneki olmadan ham standart base64 ile değiştirin. Her kartta görüntü isteğe bağlıdır. GOWA, sağlanan görüntüleri 1280 piksele sığacak şekilde yeniden boyutlandırır, JPEG’e dönüştürür, küçük resimler oluşturur ve WhatsApp’a yükler. Uzak görüntü URL’leri kabul edilmez.

İstek sınırları

Sunucunun genel HTTP istek gövdesi sınırı da geçerlidir. Birden fazla kart gönderirken küçük görüntüler kullanın. Geçersiz seçimler veya boyutlar, gönderimden önce doğrulama hatası döndürür.

Yanıtları ve alındı bilgilerini işleme

Başarılı gönderimler, results.message_id ve alıcıdaki görüntülemenin doğrulanmadığını belirten bir durum içeren normal başarı yanıtını döndürür. Yanıtlar için gelen webhook’ları, alındı bilgileri için message.ack olaylarını kullanın. Sonucu belirsiz bir zaman aşımından sonra yeniden denemek yinelenen mesajlara neden olabilir. Entegrasyonlardaki Android testlerinde yanıt, URL, kopyalama, arama, seçim, konum ve karusel eylemlerinin çalıştığı bildirilmiştir. Bu raporlar, farklı hesaplarda, iOS’ta veya WhatsApp Web’de uyumluluk sağlandığını göstermez. Ana mesajda tikler görünse ve alıcı yanıt verebilse bile karuseldeki ayrı kartlarda bekleme simgeleri görünebilir. Bu sorun henüz çözülmemiştir. Uç nokta resmi şablonları kaydetmez ve satır içi Flows, katalog veya yerel ödeme özelliklerini desteklemez.