Maytapi
Maytapi/Dokümanlar/Python rehberi
Python rehberiYaklaşık 10 dakikaPython ile WhatsApp mesajı nasıl gönderilir?
Python ile tek bir HTTP isteğiyle metin ve medya mesajı gönderin, yanıtları kendi webhook’unuzda alın. Düz REST ve JSON — SDK yok, şablon onayı yok.
Son güncelleme:
- Python
- REST + JSON
- SDK gerekmez
- webhook ile yanıt
import requests
PID = "your-pid"
PHONE_ID = "your-phone-id"
TOKEN = "your-token"
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 Python!",
},
timeout=10,
)
print(res.json())Neye ihtiyacınız var?
Dört şey; hepsi birkaç dakika içinde console’da hazır.
-
hesap
Bir Maytapi hesabı
Kaydolun ve ücretsiz denemeyi başlatın — kart gerekmez.
-
telefon
Eşleştirilmiş bir numara
QR kodu telefonunuzdaki WhatsApp ile okutun. Numaranız her zamanki gibi çalışmaya devam eder.
-
token
pid ve token
Console’daki token sayfasından kopyalayın; phone_id numaranızın yanında yazar.
-
Python
Bir Python ortamı
Güncel bir Python sürümü ve standart HTTP istemcisi yeterlidir.
Python ile metin mesajı gönderin
Token’ınızı x-maytapi-key başlığında göndererek /sendMessage adresine bir JSON gövdesi POST edin. Mesaj telefonunuzun kuyruğuna eklenir ve yanıt hemen döner.
- ✓to_number uluslararası formatta, örn. 90532xxxxx67
- ✓type: text ve mesaj metni
- ✓Yanıtta mesaj kimliği döner
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 Python!"}'{
"success": true,
"data": {
"chatId": "90532xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Görsel, video veya belge gönderin
Aynı endpoint’i type media ve herkese açık bir dosya URL’si ya da base64 data URI ile kullanın. İsteğe bağlı açıklama ve dosya adı ekleyin.
- ✓Görsel, video, ses, PDF ve diğer belgeler
- ✓Açıklama text alanında
- ✓URL gibi base64 data URI da çalışır
res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/sendMessage",
headers={"x-maytapi-key": TOKEN},
json={
"to_number": "90532xxxxx67",
"type": "media",
"message": "https://example.com/invoice-10482.pdf",
"text": "Your invoice for order #10482",
"filename": "invoice-10482.pdf",
},
timeout=10,
)Python webhook ile yanıtları alın
Webhook adresinizi bir kez kaydedin. Gelen mesajlar, iletildi ve okundu bilgileri JSON olarak gelir; her olaydaki reply adresiyle yanıt verin.
- ✓Önce hızlıca 200 dönün, sonra olayı işleyin
- ✓Kendi mesajlarınızı fromMe ile atlayın
- ✓Aynı sohbete yanıt için event.reply kullanın
requests.post(
f"https://api.maytapi.com/api/{PID}/setWebhook",
headers={"x-maytapi-key": TOKEN},
json={"webhook": "https://example.com/maytapi/webhook"},
timeout=10,
)from flask import Flask, request
import requests
app = Flask(__name__)
@app.post("/maytapi/webhook")
def webhook():
event = request.get_json()
if event.get("type") == "message" and not event["message"]["fromMe"]:
requests.post(
event["reply"],
headers={"x-maytapi-key": TOKEN},
json={
"to_number": event["conversation"],
"type": "text",
"message": "Thanks! We received your message.",
},
timeout=10,
)
return "", 200Python WhatsApp API SSS
Aklınıza takılanı destek ekibine WhatsApp'tan sorabilirsiniz. Ortalama yanıt süresi 24 saatin altında.
Destek merkezi →Resmi bir Python SDK’sı var mı?
Gerek yok. API düz REST ve JSON olduğu için bu sayfadaki örneklerde olduğu gibi Python’in standart HTTP istemcisi yeterlidir.
Python ile gruplara mesaj gönderebilir miyim?
Evet. to_number olarak grup kimliğini (@g.us ile biten) kullanın; grup yönetimi endpoint’leri her pakette açıktır.
Mesajım neden ulaşmadı?
Önce telefon durumunun aktif olduğunu kontrol edin, sonra console’daki kuyruğa ve loglara bakın. Yeni numaralar yoğun gönderimden önce ısındırılmalıdır.
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.