> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deneysel etkileşimli mesajlar

> Yanıt düğmeleri, eylem çağrıları, seçim listeleri, konum istekleri ve görüntü karuselleri gönderin.

`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.

> [!WARNING]
>
> 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.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Düğme gönderme

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

`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.

| Düğme adı | Gerekli parametreler |
| - | - |
| `quick_reply` | Boş olmayan `display_text` ve `id` dizeleri. |
| `cta_url` | Boş olmayan `display_text` ve mutlak bir HTTP veya HTTPS `url`. |
| `cta_copy` | Boş olmayan `display_text` ve `copy_code` dizeleri. |
| `cta_call` | Boş olmayan `display_text` ve `phone_number` dizeleri. |
| `single_select` | Boş olmayan `title` ve `sections`. Her bölümde boş olmayan `rows` bulunmalıdır; her satırda boş olmayan `id` ve `title` dizeleri bulunmalıdır. |
| `send_location` | `{}` gibi bir JSON nesnesi. Kart içermeyen bir mesajdaki tek düğme olmalıdır. |

Seçim listesi için şu parametreleri kullanın:

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## Konum isteme

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

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

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

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ı

| Alan | Sınır |
| - | - |
| Mesaj `body` | Zorunludur ve boş olamaz; en fazla 4096 bayt. |
| Mesaj `footer` | En fazla 256 bayt. |
| `buttons` | Her mesaj veya kart için 1–10. |
| Düğme `params` | JSON nesnesi, en fazla 16,384 bayt. |
| `cards` | 2–10 kart. |
| Kart `body` | Zorunludur ve boş olamaz; en fazla 4096 bayt. |
| Kart `title` ve `footer` | Her biri en fazla 256 bayt. |
| Kart `image_base64` | En fazla 2,800,000 kodlanmış karakter ve 2,000,000 kodu çözülmüş bayt; sunucunun yapılandırılmış görüntü boyutu sınırı da geçerlidir. |
| Kodu çözülmüş görüntü | JPEG veya PNG, her kenarda en fazla 4096 piksel. |

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ı](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md), 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.


## Related topics

- [Mesaj Gönderme](https://gowa-docs.mintlify.site/tr/examples/sending-messages.md)
- [Deneysel bir etkileşimli mesaj gönder](https://gowa-docs.mintlify.site/tr/api-reference/send/deneysel-bir-etkileşimli-mesaj-gönder.md)
- [API Referansı](https://gowa-docs.mintlify.site/tr/api-reference/introduction.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/tr/index.md)
- [Kaybolan mesajlar zamanlayıcısını ayarla](https://gowa-docs.mintlify.site/tr/api-reference/chat/kaybolan-mesajlar-zamanlayıcısını-ayarla.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.