Maytapi/Dokümanlar/Mesaj gönderme
Mesaj göndermeTüm mesaj türleri için tek uç noktaKendi numaranızdan API ile WhatsApp mesajı gönderin
Tek bir POST isteğiyle herhangi bir WhatsApp numarasına, gruba veya kanala metin, dosya, butonlu mesaj ya da konum gönderin. Şablon onayı, konuşma penceresi ve mesaj başına ücret yok.
- POST /sendMessage
- metin · medya · buton
- grup ve kanal
- iletim bilgisi
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",
"type": "text",
"message": "Your order #10482 has shipped."
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ to_number: "90532xxxxx67", type: "text", message: "Your order #10482 has shipped." })
});
console.log(await res.json());import requests
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={"to_number": "90532xxxxx67", "type": "text", "message": "Your order #10482 has shipped."},
timeout=10,
)
print(res.json())$ch = curl_init("https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $TOKEN", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["to_number" => "90532xxxxx67", "type" => "text", "message" => "Your order #10482 has shipped."]),
]);
echo curl_exec($ch);
WhatsApp API ile neler gönderebilirsiniz
type alanını değiştirin, aynı uç nokta başka bir şey göndersin.
-
type: text
Metin
Sipariş bildirimleri, hatırlatmalar, OTP kodları ve yanıtlar; WhatsApp biçimlendirmesiyle.
-
type: media
Görsel, video, dosya
URL veya base64 ile gönderin: fatura, fotoğraf, sesli mesaj ve belgeler, WhatsApp'ın sınırlarına kadar.
-
type: buttons
Buton ve listeler
Hızlı yanıt, bağlantı, arama ve kod kopyalama butonları, listeler ve carousel'ler.
-
type: location
Konum ve kişi
Bir konum işareti, vCard ya da WhatsApp kişi kartı paylaşın.
Tek istekle WhatsApp mesajı gönderin
Token'ınızı x-maytapi-key başlığına koyun ve alıcıyla mesajı içeren bir JSON gövdesi gönderin. API mesajı numaranızda kuyruğa alır ve kimliğini hemen döndürür.
- ✓to_number uluslararası formatta, örn. 90532xxxxx67
- ✓HTTP isteği atabilen her dille çalışır
- ✓Yanıt, takip için mesaj kimliğini içerir
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",
"type": "text",
"message": "Your order #10482 has shipped."
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ to_number: "90532xxxxx67", type: "text", message: "Your order #10482 has shipped." })
});
console.log(await res.json());import requests
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={"to_number": "90532xxxxx67", "type": "text", "message": "Your order #10482 has shipped."},
timeout=10,
)
print(res.json())$ch = curl_init("https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $TOKEN", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["to_number" => "90532xxxxx67", "type" => "text", "message" => "Your order #10482 has shipped."]),
]);
echo curl_exec($ch);Dosya, görsel ve sesli mesaj gönderin
Herkese açık bir URL veya base64 metni verin. Açıklama, dosya adı ya da görseller için HD kalite ekleyin.
- ✓Dosya adıyla PDF fatura ve belgeler
- ✓Açıklamalı görsel ve video
- ✓Sticker, sesli mesaj ve ses dosyası
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/invoice-10482.pdf",
"text": "Your invoice for order #10482",
"filename": "invoice-10482.pdf"
}'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/product.jpg",
"text": "New arrival",
"isHd": true
}'Tek dokunuşla yanıtlanan butonlar gönderin
Müşteriler tek dokunuşla yanıt verir, yanıt buton kimliğiyle birlikte webhook'unuza düşer; kodunuz neyin seçildiğini tam olarak bilir.
- ✓Hızlı yanıt, URL, arama ve kod kopyalama butonları
- ✓Menüler için bölümlü listeler
- ✓Hiçbiri için şablon onayı gerekmez
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": "Your order #10482 has shipped. Want to follow it?",
"buttons": [
{
"id": "track",
"text": "Track order"
},
{
"id": "address",
"text": "Change address"
}
]
}'Gruplara ve kanallara gönderin
Alıcı olarak grup kimliği veya kanal kimliği kullanın. Resmi Cloud API kanalları hiç desteklemez.
- ✓Grup kimlikleri @g.us ile biter
- ✓Kanal kimlikleri @newsletter ile biter
- ✓Katılımcıları etiketleyin, anket ve etkinlik 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": "120363012345678901@g.us",
"type": "text",
"message": "Weekly update: all orders shipped."
}'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": "120363204759413821@newsletter",
"type": "text",
"message": "New collection is live."
}'İşletmeler API ile neler gönderiyor
-
Sipariş ve kargo bildirimleri
Onay, kargo ve teslimat mesajları doğrudan mağazanızdan veya ERP'nizden.
-
Hatırlatma ve onaylar
Onayla ve iptal et butonlu randevu hatırlatmaları.
-
Destek yanıtları
CRM'inizden yanıt verin ya da ekibiniz ortak gelen kutusundan yazsın.
Mesaj gönderme hakkında SSS
Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.
Destek merkezi →Şablon olmadan WhatsApp mesajı gönderebilir miyim?
Evet. Maytapi kendi numaranızdan serbest metin gönderir; şablon onayı ve 24 saatlik pencere yoktur.
Toplu mesaj gönderebilir miyim?
İhtiyacınız kadar mesaj gönderebilirsiniz, mesaj başına ücret yoktur. Numaranızı korumak için mesajınızı bekleyen kişilere gönderin, içeriği çeşitlendirin ve doğal bir hızda kalın; Safe Mode yeni numaraları ısıtır.
Mesajlar hangi numaradan gider?
QR kodla eşlediğiniz kendi WhatsApp numaranızdan. Müşteriler her zamanki gibi adınızı ve fotoğrafınızı görür.
Mesajın iletildiğini nasıl anlarım?
Bir webhook tanımlayın; her mesaj için gönderildi, iletildi ve okundu olaylarını alırsınız. Kuyruğu ve telefon durumunu API üzerinden de kontrol edebilirsiniz.
Hangi dilleri kullanabilirim?
Mesaj göndermenin maliyeti nedir?
Mesaj başına hiçbir şey. Bağlı numara başına sabit ücret ödersiniz: yıllık faturalandırmada aylık $24'dan, aylık faturalandırmada $29.
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.