Yeni Safe Mode yeni numaraları ısıtarak WhatsApp ban riskini azaltır. Detaylı bilgi →

Maytapi/Dokümanlar//interactive

/interactiveŞablon onayı yok

WhatsApp Interactive Message API

Kendi WhatsApp numaranızdan yanıt butonları, link ve arama butonları, liste menüleri ve ürün carousel'leri gönderin. Tek sendMessage ucu, şablon onayı yok — müşterinin seçimi webhook'unuza döner.

  • yanıt butonları
  • link ve arama butonu
  • liste mesajı
  • carousel
WhatsApp interaktif buton ve liste mesajları
Mesaj tipleri

Tüm interactive formatlar tek uç noktada

type alanını ve buton türünü seçin — isteğin geri kalanı aynı kalır.

  • buttons · id

    Yanıt butonları

    Onayla veya İptal gibi hızlı yanıtlar. Butonun id'si geri döner, kodunuz neyin seçildiğini bilir.

  • buttons · url

    Link butonları

    Takip sayfasını, ödeme linkini veya web sitenizi tek dokunuşla açtırın.

  • buttons · phoneNumber

    Arama butonları

    Müşteri destek hattınızı doğrudan mesajdan arasın.

  • buttons · code

    Kod kopyalama butonları

    Müşterinin tek dokunuşla kopyalayabileceği indirim veya doğrulama kodu paylaşın.

  • type: list

    Liste mesajları

    Bölüm ve satırları açan bir menü butonu — destek menüleri ve randevu saatleri için ideal.

  • type: carousel

    Carousel

    Ürün ve kampanyalar için medya ve en fazla 5 buton içeren, kaydırılabilir en fazla 10 kart.

Butonlar

Medya, başlık ve alt bilgili butonlar

Görsel veya video, başlık, gövde ve alt bilgi ekleyin; yanıt, link, arama ve kod kopyalama butonlarını aynı mesajda birlikte kullanın.

  • ✓Yanıt butonları id'lerini webhook'unuza döndürür
  • ✓Link ve arama butonları ek ayar gerektirmez
  • ✓Kupon ve tek kullanımlık kodlar için kod kopyalama butonu
Maytapi API ile gönderilen fotoğraflı, başlıklı ve dört yanıt butonlu WhatsApp mesajı
Listeler

Çok seçenek için liste menüleri

Üç buton yetmediğinde liste gönderin. Müşteri listeyi sizin buton metninizle açar ve bölümlerinizden bir satır seçer.

  • ✓Satırları başlıklı bölümlerde gruplayın
  • ✓Her satırda başlık, açıklama ve rowId bulunur
  • ✓Destek menüleri, şubeler ve saat seçimleri için ideal
Maytapi API ile gönderilen, seçenek menüsü açık bir WhatsApp liste mesajı
Carousel

Kaydırılabilir ürün kartları

Birden fazla ürünü veya kampanyayı yan yana gösterin. Her kartın kendi medyası, metni ve butonları olur.

  • ✓Carousel başına en fazla 10 kart
  • ✓Kart başına en fazla 5 buton
  • ✓Her kartta medya zorunludur
Maytapi API ile gönderilen, butonlu ve kaydırılabilir ürün kartlarından oluşan WhatsApp carousel mesajı
İstek

Aynı uç nokta, farklı tip

Buton, liste ve carousel mesajlarının hepsi POST /sendMessage ile gönderilir. Yalnızca type alanı ve seçenekleri değişir.

  • ✓cURL, Node.js, Python, PHP ve her HTTP istemcisiyle çalışır
  • ✓Şablon incelemesi yok, hemen gönderin
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
  -H "x-maytapi-key: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to_number": "90532xxxxx67@c.us",
    "type": "buttons",
    "title": "Your order #10482",
    "message": "Your order is ready to ship. Please confirm the delivery address.",
    "footer": "Maytapi Store",
    "media": "https://example.com/order.jpg",
    "buttons": [
      {
        "id": "confirm",
        "text": "Confirm"
      },
      {
        "url": "https://example.com/track/10482",
        "text": "Track order"
      },
      {
        "phoneNumber": "90532xxxxx67",
        "text": "Call us"
      }
    ]
  }'
Kullanım alanları

Interactive mesajların en iyi çalıştığı yerler

  • Sipariş onayı

    Siparişi yazılı yanıt yerine tek dokunuşla onaylatın, değiştirtin veya iptal ettirin.

  • Randevu hatırlatma

    Onayla ve Ertele butonlu hatırlatma gönderin, takviminizi webhook'tan güncelleyin.

  • Destek menüleri

    Temsilci bağlanmadan önce müşteriyi liste mesajıyla doğru ekibe yönlendirin.

  • Ürün vitrini

    Yeni ürünleri sepete ekle ve detay butonlu bir carousel ile tanıtın.

  • Kupon ve kodlar

    İndirim veya doğrulama kodlarını kod kopyalama butonuyla iletin.

  • Chatbot akışları

    Bot konuşmalarını butonlarla yönlendirin, yanıtlar düzenli kalsın.

SSS

Interactive mesaj SSS

Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.

Destek merkezi →
Buton göndermek için şablon onayı gerekir mi?

Hayır. Maytapi interactive mesajları kendi numaranızdan WhatsApp Web üzerinden gönderir; Meta şablon incelemesi yoktur. Hemen göndermeye başlayabilirsiniz.

Hangi buton tipleri destekleniyor?

id ile yanıt butonları, url ile link butonları, phoneNumber ile arama butonları ve code ile kod kopyalama butonları. Başlık, alt bilgi ve medya isteğe bağlıdır.

Bir carousel'de kaç kart olabilir?

Carousel başına en fazla 10 kart. Her kartta medya zorunludur ve kart başına en fazla 5 buton eklenebilir.

Müşterinin hangi butona bastığını nasıl anlarım?

Müşterinin seçimi webhook'unuza diğer gelen mesajlar gibi ulaşır; kodunuz hemen tepki verebilir.

Buton mesajına görsel ekleyebilir miyim?

Evet. İsteğe bir media adresi ekleyin; görsel veya video mesaj gövdesinin üstünde gösterilir.

WhatsApp API'yi kullanmaya başlayın

Anahtarı alın, ilk mesajı on dakikada gönderin

Onay yok, şablon yok, kart yok. Üç gün boyunca tüm uçlar açık.