Maytapi
Maytapi/Dokümanlar//catalog
/catalogWhatsApp Business numaraları içinWhatsApp Ürün Kataloğu API
WhatsApp Business numaranızın ürün kataloğunu kendi sisteminizden yönetin. Ürün ve koleksiyon ekleyin, sohbette tek bir ürünü veya tüm kataloğu gönderin ve müşterilerin verdiği siparişleri kodunuzdan çıkmadan alın.
- ürün ve koleksiyon
- ürün mesajı
- katalog mesajı
- webhook'ta sipariş
Kataloğunuz, API ile yönetilir
WhatsApp kataloğunu uygulamada elle düzenlemek yerine mağazanızla senkron tutun.
-
catalog/addProduct
Ürün ekle ve düzenle
Ad, açıklama, fiyat, görsel, link ve retailer id ile ürün oluşturun; sonra düzenleyin veya gizleyin.
-
catalog/getProducts
Ürünleri listele
Katalogdaki tüm ürünleri ya da id ile tek bir ürünü okuyun.
-
catalog/addCollection
Koleksiyonlar
Ürünleri koleksiyonlarda gruplayın, koleksiyonlara ürün ekleyip çıkarın.
-
type: product
Ürün mesajı
Müşterinin görüp sipariş verebileceği tek bir ürün kartını sohbete gönderin.
-
type: catalog
Katalog mesajı
Tüm kataloğunuzu başlık ve açıklamayla tek mesajda paylaşın.
-
catalog/getOrders
Siparişler
Katalogdan verilen siparişler webhook'unuza gelir; son siparişler API ile de listelenebilir.
Ürünleri mağazanızdan senkronlayın
E-ticaret sisteminizdeki ürünleri her biri tek istekle WhatsApp kataloğuna gönderin. Fiyatları güncellemek veya tükenen ürünleri gizlemek de aynı şekilde.
- ✓Ad, açıklama, fiyat ve görsel
- ✓Ürün linki ve kendi retailer id'niz
- ✓Ürünü silmeden gizleme
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/addProduct" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Classic sneaker",
"description": "Canvas sneaker, sizes 38–45",
"price": "49.90",
"imageUrl": "https://example.com/sneaker.jpg",
"url": "https://example.com/sneaker",
"retailerId": "SKU-1042",
"isHidden": false
}'curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getProducts" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getCollections" \ -H "x-maytapi-key: $TOKEN"
Tek bir ürünü veya tüm kataloğu gönderin
Müşteri sorduğunda ürün kartının kendisiyle ya da tüm katalogla yanıt verin — ikisi de WhatsApp'ta yerel olarak açılır.
- ✓type: product ve ürün id'si
- ✓type: catalog, isteğe bağlı başlık ve açıklama
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": "product",
"productId": "3121315354601301"
}'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": "catalog",
"message": "Check out our products!",
"title": "Our catalog",
"description": "New arrivals every week"
}'Siparişleri webhook'unuzda alın
Müşteri katalogdan sipariş gönderdiğinde, sipariş diğer mesajlar gibi webhook'unuza iletilir. Kendi veritabanınıza kaydedin — getOrders yalnızca oturum çalışırken gelen siparişleri tutar.
- ✓Sipariş mesajları anında gelir
- ✓Son siparişler için getOrders ve getOrders/{orderId}
- ✓Geçmiş için siparişleri kendi sisteminizde saklayın
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders/$ORDER_ID" \ -H "x-maytapi-key: $TOKEN"
Katalog API'yi kimler kullanıyor
-
Online mağazalar
WhatsApp kataloğunu fiyatlar dahil web mağazanızla birebir tutun.
-
Satış ekipleri
Ürün sorularına uzun mesaj yerine ürün kartıyla yanıt verin.
-
Ajans ve SaaS
Birçok müşteri numarasının kataloğunu tek platformdan yönetin.
Ürün kataloğu SSS
Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.
Destek merkezi →WhatsApp Business hesabı gerekir mi?
Evet. Katalog bir WhatsApp Business özelliğidir; bağlı numaranın WhatsApp Business numarası olması gerekir.
Siparişleri Maytapi saklıyor mu?
Siparişler webhook'unuza anında iletilir. getOrders yalnızca oturum çalışırken gelen siparişleri döner; kalıcı geçmiş için kendi veritabanınıza kaydedin.
Sohbete tek bir ürün gönderebilir miyim?
Evet. type product ve ürün id'siyle mesaj gönderin; müşteri yerel ürün kartını görür.
Ürünleri gruplayabilir miyim?
Evet. API ile koleksiyon oluşturup ürün ekleyip çıkarabilirsiniz.
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.