Maytapi
Maytapi/Dokümanlar/PHP rehberi
PHP rehberiYaklaşık 10 dakikaPHP ile WhatsApp mesajı nasıl gönderilir?
PHP 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:
- PHP
- REST + JSON
- SDK gerekmez
- webhook ile yanıt
<?php
$pid = "your-pid";
$phoneId = "your-phone-id";
$token = "your-token";
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/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" => "Hello from PHP!",
]),
]);
echo curl_exec($ch);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.
-
PHP
Bir PHP ortamı
Güncel bir PHP sürümü ve standart HTTP istemcisi yeterlidir.
PHP 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 PHP!"}'{
"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
$ch = curl_init("https://api.maytapi.com/api/$pid/$phoneId/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" => "media",
"message" => "https://example.com/invoice-10482.pdf",
"text" => "Your invoice for order #10482",
"filename" => "invoice-10482.pdf",
]),
]);
echo curl_exec($ch);PHP 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
$ch = curl_init("https://api.maytapi.com/api/$pid/setWebhook");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["x-maytapi-key: $token", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["webhook" => "https://example.com/maytapi/webhook"]),
]);
echo curl_exec($ch);<?php
// webhook.php
$event = json_decode(file_get_contents("php://input"), true);
http_response_code(200);
if (($event["type"] ?? "") === "message" && !$event["message"]["fromMe"]) {
$ch = curl_init($event["reply"]);
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" => $event["conversation"],
"type" => "text",
"message" => "Thanks! We received your message.",
]),
]);
curl_exec($ch);
}PHP 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 PHP SDK’sı var mı?
Gerek yok. API düz REST ve JSON olduğu için bu sayfadaki örneklerde olduğu gibi PHP’in standart HTTP istemcisi yeterlidir.
PHP 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.