Maytapi/Dokümanlar//interactive
/interactiveŞablon onayı yokWhatsApp 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

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.
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
Ç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
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
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"
}
]
}'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",
"message": "Here is 10% off your next order.",
"buttons": [
{
"code": "WELCOME10",
"text": "Copy code"
}
]
}'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": "list",
"title": "How can we help?",
"message": "Choose a topic and we will connect you to the right team.",
"footer": "Support",
"button_text": "See options",
"sections": [
{
"title": "Support topics",
"rows": [
{
"rowId": "status",
"title": "Order status",
"description": "Track a recent order"
},
{
"rowId": "returns",
"title": "Returns",
"description": "Start a return or exchange"
}
]
}
]
}'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": "carousel",
"message": "New arrivals this week",
"cards": [
{
"title": "Classic sneaker",
"body": "Sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "add_sneaker",
"text": "Add to cart"
},
{
"url": "https://example.com/sneaker",
"text": "Details"
}
]
},
{
"title": "Canvas backpack",
"body": "Free shipping",
"media": "https://example.com/backpack.jpg",
"buttons": [
{
"id": "add_backpack",
"text": "Add to cart"
},
{
"url": "https://example.com/backpack",
"text": "Details"
}
]
}
]
}'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.
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.
Diğer WhatsApp API özellikleri

Anahtarı alın, ilk mesajı on dakikada gönderin
Onay yok, şablon yok, kart yok. Üç gün boyunca tüm uçlar açık.