REST API v1

curl -X POST https://wpbeta.yoncu.com.tr/api/v1/send-message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "905551234567",
    "message": "Merhaba! Bu mesaj REST API üzerinden gönderilmiştir."
  }'

<?php
$apiUrl = "https://wpbeta.yoncu.com.tr/api/v1/send-message";
$apiKey = "YOUR_API_KEY";

$data = [
    "number" => "905551234567",
    "message" => "Merhaba! Bu mesaj REST API üzerinden gönderilmiştir."
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey,
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
echo $response;

curl -X POST https://wpbeta.yoncu.com.tr/api/v1/send-bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "numbers": [
      "905551112233",
      { "number": "905324445566", "name": "Ahmet Bey" }
    ],
    "message": "Sayın {name}, özel teklifinizi inceleyin!",
    "media_url": "https://example.com/kampanya.jpg",
    "min_delay": 2,
    "max_delay": 4
  }'

<?php
$apiUrl = "https://wpbeta.yoncu.com.tr/api/v1/send-bulk";
$apiKey = "YOUR_API_KEY";

$data = [
    "numbers" => [
        "905551112233",
        ["number" => "905324445566", "name" => "Ahmet Bey"]
    ],
    "message" => "Sayın {name}, özel teklifinizi inceleyin!",
    "min_delay" => 2,
    "max_delay" => 4
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey,
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
echo $response;

curl -X POST https://wpbeta.yoncu.com.tr/api/v1/send-media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "905551234567",
    "mediaUrl": "https://example.com/document.pdf",
    "caption": "Sipariş Faturanız"
  }'

curl -X POST https://wpbeta.yoncu.com.tr/api/v1/check-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": "905551234567"}'

WhatsApp bağlı cihaz oturumunuzun aktiflik (`READY`, `DISCONNECTED`) durumunu ve telefon numarasını döndürür.

curl -X GET https://wpbeta.yoncu.com.tr/api/v1/status \
  -H "Authorization: Bearer YOUR_API_KEY"

WhatsApp hesabınızdaki tüm kişi ve grupları, okunmamış mesaj adetleri ve son mesaj metinleriyle birlikte JSON olarak listeler.

curl -X GET https://wpbeta.yoncu.com.tr/api/v1/get-chats \
  -H "Authorization: Bearer YOUR_API_KEY"

Bağlı WhatsApp hesabınızdaki kayıtlı kişileri (isim, telefon, avatar, işletme durumu) tekilleştirilmiş liste olarak çeker.

curl -X GET https://wpbeta.yoncu.com.tr/api/v1/get-contacts \
  -H "Authorization: Bearer YOUR_API_KEY"

<?php
$apiUrl = "https://wpbeta.yoncu.com.tr/api/v1/get-contacts";
$apiKey = "YOUR_API_KEY";

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey
]);

$response = curl_exec($ch);
echo $response;

curl -X GET "https://wpbeta.yoncu.com.tr/api/v1/get-messages?chatId=905551234567&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

<?php
$chatId = "905551234567";
$limit = 50;
$apiUrl = "https://wpbeta.yoncu.com.tr/api/v1/get-messages?chatId=" . urlencode($chatId) . "&limit=" . $limit;
$apiKey = "YOUR_API_KEY";

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey
]);

$response = curl_exec($ch);
echo $response;

Webhook Nedir ve Nasıl Çalışır?

WhatsApp profilinize bir mesaj veya dosya geldiğinde, sunucumuz anında belirttiğiniz HTTPS adresine JSON formatında HTTP POST isteği gönderir.

{
  "event": "message_received",
  "timestamp": 1724458000,
  "datetime": "2026-08-24T02:15:00.000Z",
  "session": {
    "id": "sess_173ee107...",
    "phoneNumber": "902169900099",
    "pushName": "Yöncü Bilişim Çözümleri",
    "apiKey": "wpkey_...",
    "webhookSecret": "a8f9c2e1..."
  },
  "sender": {
    "id": "905321234567@c.us",
    "phoneNumber": "905321234567",
    "pushName": "Ahmet Yılmaz",
    "isGroup": false,
    "groupInfo": null
  },
  "message": {
    "id": "true_905321234567@c.us_3EB0...",
    "type": "image",
    "body": "Sipariş faturası ektedir.",
    "timestamp": 1724458000,
    "fromMe": false,
    "hasMedia": true,
    "media": {
      "mimetype": "image/jpeg",
      "filename": "fatura.jpg",
      "filesize": 1048576,
      "data": "/9j/4AAQSkZJRgABAQEASABIAAD/..."
    }
  }
}

<?php
// webhook.php - Gelen WhatsApp Mesajlarını Yakalama

// 1. Gelen JSON verisini oku
$rawPayload = file_get_contents("php://input");
$data = json_decode($rawPayload, true);

// 2. Güvenlik Doğrulaması (Token Kontrolü)
$receivedToken = $_SERVER["HTTP_X_WEBHOOK_TOKEN"] ?? ($data["session"]["webhookSecret"] ?? "");
$mySecretToken = "BURAYA_TANIMLADIGINIZ_TOKEN";

if ($receivedToken !== $mySecretToken) {
    http_response_code(401);
    die("Yetkisiz İstek (Unauthorized)");
}

// 3. Mesaj Bilgilerini İşle
$senderPhone = $data["sender"]["phoneNumber"];
$senderName  = $data["sender"]["pushName"];
$messageBody = $data["message"]["body"];
$messageType = $data["message"]["type"];

// Medya Dosyası Varsa Base64'ten Kaydet
if (!empty($data["message"]["hasMedia"]) && !empty($data["message"]["media"]["data"])) {
    $base64Data = $data["message"]["media"]["data"];
    $filename = $data["message"]["media"]["filename"] ?? "dosya";
    file_put_contents(__DIR__ . "/downloads/" . $filename, base64_decode($base64Data));
}

// 4. WhatsApp Sunucusuna 200 OK Dön
http_response_code(200);
echo json_encode(["status" => "success"]);