Maytapi
Maytapi/Dokümanlar//sendMessage
/sendMessageHer dosya türü, tek uç noktaWhatsApp Medya Mesajı API
Kendi WhatsApp numaranızdan görsel, video, GIF, PDF, Excel ve Word dokümanı, ses ve sticker gönderin ya da butonlu bir mesajın üstüne fotoğraf koyun. Tek sendMessage uç noktası: URL ya da base64 verin, dosya türü otomatik algılanır.
- görsel, video ve GIF
- PDF, Excel ve Word
- 50MB'a kadar dosya
- butonlarda medya
WhatsApp'ın taşıyabildiği her dosya
Her tip için aynı uç nokta ve aynı başlıklar — yalnızca type alanı ve birkaç seçenek değişir.
-
type: media
Görseller
İsteğe bağlı açıklamayla JPG, PNG ve WebP görseller. WhatsApp'ın desteklediği yerlerde daha net fotoğraf için isHd kullanın.
-
type: media
Video
Sohbette doğrudan oynayan, açıklamalı MP4 videolar. Yuvarlak video notu için type: shortVideo kullanın.
-
isGif: true
GIF'ler
Kısa bir MP4'ü isGif ile gönderin; WhatsApp onu GIF gibi döngüde oynatır.
-
type: media + filename
PDF, Excel ve Word
Fatura, fiyat listesi ve raporları müşterinizin göreceği dosya adıyla PDF, XLSX veya DOCX olarak gönderin.
-
type: media
Ses
OGG (Opus) ve MP3 ses dosyalarını URL ya da base64 ile gönderin.
-
type: sticker
Sticker'lar
WebP sticker, görsel gönderir gibi gönderilir.
Her dosyayı URL ya da base64 ile gönderin
message alanına herkese açık bir URL verin ya da dosyayı base64 olarak gönderin. text ile açıklama ekleyin, daha net görseller için isHd açın.
- ✓URL ya da base64 ile görsel, video ve ses
- ✓Her medya mesajında açıklama
- ✓50MB'a kadar dosya
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": "media",
"message": "https://example.com/new-arrival.jpg",
"text": "New arrival: classic sneaker, $59",
"isHd": true
}'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": "media",
"message": "https://example.com/unboxing.mp4",
"text": "How to set up your order"
}'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": "media",
"message": "data:image/png;base64,iVBORw0KG...",
"text": "Screenshot"
}'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": "media",
"message": "https://example.com/welcome.ogg"
}'Kendi dosya adınızla PDF, Excel ve Word
Fatura, fiyat listesi ve raporları doküman olarak gönderin. filename verdiğinizde müşteri rastgele bir ad yerine fatura-10482.pdf görür.
- ✓PDF, XLSX, DOCX ve diğer doküman türleri
- ✓Özel dosya adı ve açıklama
- ✓Sohbet, grup ve kanallarda çalışır
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": "media",
"message": "https://example.com/files/inv-10482.pdf",
"filename": "invoice-10482.pdf",
"text": "Your invoice for order #10482"
}'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": "media",
"message": "https://example.com/files/prices-oct.xlsx",
"filename": "price-list-october.xlsx",
"text": "This month’s price list"
}'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": "media",
"message": "https://example.com/files/contract.docx",
"filename": "service-agreement.docx"
}'GIF'ler, sticker'lar ve video notları
Kısa bir MP4'e isGif ekleyin, WhatsApp onu GIF gibi döngüde oynatır. Sticker'lar WebP dosyası olarak gider, shortVideo ise yuvarlak video notu gönderir.
- ✓Döngüdeki GIF'ler için isGif: true
- ✓WebP sticker'lar ve yuvarlak video notları
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": "media",
"message": "https://example.com/sale.mp4",
"text": "Weekend sale starts now",
"isGif": true
}'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": "sticker",
"message": "https://example.com/thanks.webp"
}'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": "shortVideo",
"message": "https://example.com/hello.mp4"
}'Butonlu mesajın üstüne fotoğraf koyun
Butonlu mesajlar da media alanı alır: Siparişi takip et ya da Hemen al butonlarının üstünde ürün fotoğrafı, kargo görseli veya kampanya afişi gösterin.
- ✓buttons mesajlarında media alanı
- ✓Yanıt, URL, arama ve kod kopyalama butonları
- ✓Medyanın etrafında isteğe bağlı başlık ve alt bilgi
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": "Classic sneaker, sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "buy",
"text": "Buy now"
},
{
"id": "sizes",
"text": "See sizes"
}
]
}'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": "10% off your next order",
"title": "Thank you!",
"footer": "Valid until Sunday",
"media": "https://example.com/banner.jpg",
"buttons": [
{
"url": "https://example.com/shop",
"text": "Open the shop"
},
{
"code": "THANKS10",
"text": "Copy code"
}
]
}'Ekipler medya API ile neler gönderiyor
-
Fatura ve makbuz
Ödemeden sonra PDF faturayı veya makbuzu doğrudan müşterinin WhatsApp'ına gönderin.
-
Fiyat listeleri
Bu ayın fiyat listesini bayilere ve toptan müşterilere Excel ya da PDF olarak gönderin.
-
Ekran görüntülü destek
Destek ekibinizden nasıl yapılır görselleri, kısa videolar ve sesli mesajlar gönderin.
-
Butonlu ürün fotoğrafları
Müşteri bir ürünü sorduğunda Hemen al ve Detaylar butonlarıyla ürün fotoğrafını gösterin.
-
Kampanya videoları ve GIF'ler
Bir indirimi topluluğa ya da kanala kısa bir video veya döngüdeki bir GIF ile duyurun.
-
Müşteri raporları
Günlük veya haftalık raporları doküman olarak her müşterinin numarasına iletin.
Medya mesajı SSS
Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.
Destek merkezi →Bir dosya en fazla ne kadar büyük olabilir?
sendMessage ile 50MB'a kadar dosya gönderilebilir. Çok büyük videoların WhatsApp'a yüklenmesi yine de daha uzun sürebilir.
Dosyayı bir yerde barındırmadan gönderebilir miyim?
Evet. Herkese açık link yerine dosyayı message alanında base64 data URL olarak gönderin.
Medya göndermek için şablon onayı gerekir mi?
Hayır. Maytapi WhatsApp Web üzerinden kendi numaranızla gönderir; görsel, video, doküman ve diğer tüm medya türleri Meta şablon incelemesi olmadan gider.
Gruplara ve kanallara medya gönderebilir miyim?
Evet. to_number olarak grup ya da kanal kimliğini kullanın; kanallar da görsel, video, doküman, GIF ve sticker kabul eder.
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.