Maytapi
Maytapi/Dokümanlar/Getting started
Getting startedYaklaşık 10 dakikaWhatsApp API ile ilk mesajı nasıl gönderirsiniz
Yeni bir hesaptan teslim edilmiş bir mesaja dört adımda: numaranızı eşleyin, bilgilerinizi kopyalayın, tek istek gönderin ve teslim bilgisini dinleyin. Onay süreci ve şablon yok.
- QR ile eşleme
- pid ve token
- tek POST isteği
- webhook'ta teslim bilgisi
İlk mesaja dört adım
Aşağıdakilerin hepsi console ve terminalden yapılabilir — SDK gerekmez.
-
step 1
Hesap oluşturun
Console'dan kayıt olun ve ücretsiz denemeyi başlatın — kart gerekmez.
-
step 2
Numaranızı eşleyin
Telefon ekleyin ve QR kodu telefonunuzdaki WhatsApp ile okutun (Bağlı cihazlar). Numaranız olduğu gibi kalır.
-
step 3
Bilgilerinizi kopyalayın
pid ve API token'ınız console'daki token sayfasında; phone_id numaranızın yanında görünür.
-
step 4
İsteği gönderin
x-maytapi-key başlığı ve JSON gövdesiyle /sendMessage'a POST atın.
pid, phone_id ve token'ı bulun
Her istek pid ve phone_id içeren aynı temel URL'yi ve x-maytapi-key başlığında token'ınızı kullanır. Telefonlarınızı API ile de listeleyebilirsiniz.
- ✓Token ve pid: console → Settings → Token
- ✓phone_id: her numaranın yanında veya /listPhones ile
- ✓Token'ı gizli tutun — hesabınıza tam erişim sağlar
curl "https://api.maytapi.com/api/$PID/listPhones" \ -H "x-maytapi-key: $TOKEN"
İlk mesajı gönderin
Uluslararası formattaki herhangi bir WhatsApp numarasına metin mesajı gönderin. İstek mesajı telefonunuzun kuyruğuna ekler ve hemen döner.
- ✓Uluslararası formatta to_number, örn. 90532xxxxx67
- ✓type: text ve message
- ✓Yanıt mesaj id'sini 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": "Hello from the Maytapi WhatsApp API!"
}'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: "Hello from the Maytapi WhatsApp API!" })
});
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": "Hello from the Maytapi WhatsApp API!"},
timeout=10,
)
print(res.json())Ulaştığını kontrol edin
Teslim ve okundu bilgisi için webhook tanımlayın; bir mesaj gitmezse telefon durumunu kontrol edin.
- ✓Bildirimler ve gelen mesajlar için /setWebhook
- ✓Oturum için /{phone_id}/status ve /screen
- ✓Bekleyen mesajlar için /{phone_id}/queue
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/status" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/queue" \ -H "x-maytapi-key: $TOKEN"
curl -X POST "https://api.maytapi.com/api/$PID/setWebhook" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"webhook": "https://example.com/maytapi/webhook"
}'Buradan sonra nereye
-
Mesaj alın
Gelen mesajlar ve bildirimler için webhook'u kurun.
-
Buton ekleyin
Aynı uç noktadan buton, liste ve carousel gönderin.
-
Ban'dan korunun
Yeni numaraları ısıtın ve kısıtlamaları neyin tetiklediğini öğrenin.
Başlangıç SSS
Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.
Destek merkezi →Yeni bir telefon numarası gerekir mi?
Hayır. Mevcut WhatsApp numaranızı QR ile eşlersiniz; telefonunuzda her zamanki gibi çalışmaya devam eder.
Mesajım neden ulaşmadı?
Önce telefon durumunu kontrol edin — oturum aktif olmalı. Ardından console'daki kuyruğa ve loglara bakın. Yeni numaralara ilk mesajlar WhatsApp tarafından da kısıtlanabilir; ban rehberine göz atın.
Ödeme yapmadan deneyebilir miyim?
Evet. Deneme sürümü kart olmadan üç gün boyunca tüm uçları açar.
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.