Maytapi
Maytapi/Dokümanlar/Java rehberi
Java rehberiYaklaşık 10 dakikaJava ile WhatsApp mesajı nasıl gönderilir?
Java 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:
- Java
- REST + JSON
- SDK gerekmez
- webhook ile yanıt
// Java 15+ (java.net.http, text blocks)
import java.net.URI;
import java.net.http.*;
String pid = "your-pid";
String phoneId = "your-phone-id";
String token = "your-token";
String body = """
{"to_number": "90532xxxxx67", "type": "text", "message": "Hello from Java!"}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.maytapi.com/api/" + pid + "/" + phoneId + "/sendMessage"))
.header("x-maytapi-key", token)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());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.
-
Java
Bir Java ortamı
Güncel bir Java sürümü ve standart HTTP istemcisi yeterlidir.
Java 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 Java!"}'{
"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
String body = """
{
"to_number": "90532xxxxx67",
"type": "media",
"message": "https://example.com/invoice-10482.pdf",
"text": "Your invoice for order #10482",
"filename": "invoice-10482.pdf"
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.maytapi.com/api/" + pid + "/" + phoneId + "/sendMessage"))
.header("x-maytapi-key", token)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());Java 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
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.maytapi.com/api/" + pid + "/setWebhook"))
.header("x-maytapi-key", token)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"webhook\": \"https://example.com/maytapi/webhook\"}"))
.build();
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());@RestController
public class WebhookController {
private final RestClient client = RestClient.create();
@PostMapping("/maytapi/webhook")
public ResponseEntity<Void> webhook(@RequestBody Map<String, Object> event) {
Map<String, Object> message = (Map<String, Object>) event.get("message");
if ("message".equals(event.get("type")) && !Boolean.TRUE.equals(message.get("fromMe"))) {
client.post()
.uri((String) event.get("reply"))
.header("x-maytapi-key", token)
.contentType(MediaType.APPLICATION_JSON)
.body(Map.of(
"to_number", event.get("conversation"),
"type", "text",
"message", "Thanks! We received your message."))
.retrieve()
.toBodilessEntity();
}
return ResponseEntity.ok().build();
}
}Java 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 Java SDK’sı var mı?
Gerek yok. API düz REST ve JSON olduğu için bu sayfadaki örneklerde olduğu gibi Java’in standart HTTP istemcisi yeterlidir.
Java 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.