Test modu

Test anahtarı, entegrasyonunuzu gerçek müşterilere dokunmadan geliştirmenizi sağlar. Bu sayfa test modunun neyi simüle ettiğini ve neyi etkilemediğini anlatır.

#Test anahtarı nedir?

vmk_test_ ile başlayan anahtarlar test modundadır. Panelde API → Anahtarlar sayfasından anahtar oluştururken modu test seçin.

Test modunda:

• POST /messages Meta'ya istek göndermez. Mesaj gerçek alıcıya gitmez.
• Yanıtta mode: "test", simulated: true ve credits_used: 0 döner.
• wamid sahtedir ve test. ile başlar.
• POST /media Meta'ya dosya yüklemez; test.media. önekli bir kimlik döner.
• Arama eylemleri Meta'ya gitmeden simüle edilir; arama kimliği test.wacid. ile başlar.
• Okuma uçları (GET) canlı anahtarla aynı veriyi döner.
• Kapsam, hız sınırı ve idempotency kuralları canlı anahtardaki gibi çalışır.
• Test mesajları raporlara (GET /reports/summary) dahil edilmez.

#Uç bazında davranış

Hiçbir yazma ucu test anahtarıyla gerçek veriye ya da Meta'ya dokunmaz. İstek normal doğrulanır (aynı 4xx hataları döner), sonra ya gerçekçi bir başarı yanıtı simüle edilir (simulated: true, mode: "test") ya da 403 test_mode_unsupported döner. İki durumda da yanıtta X-Test-Mode: 1 başlığı bulunur.

#Sahte gelen mesaj oluşturun

Webhook alıcınızı denemek için POST /test/inbound kullanın. Bu uç yalnız test anahtarıyla çalışır; sahte mesajı gerçek gelen mesaj hattından geçirir ve imzalı olayı aktif webhook aboneliklerinize gönderir.

curl -X POST https://api.verimerkezi.app/wa/test/inbound \
  -H "Authorization: Bearer $VM_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_number_id": "1234567890", "type": "text", "from": "905550000000", "text": "Merhaba, bu bir test mesajıdır." }'

const res = await fetch('https://api.verimerkezi.app/wa/test/inbound', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.VM_TEST_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ phone_number_id: '1234567890', type: 'text', from: '905550000000', text: 'Merhaba, bu bir test mesajıdır.' }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.verimerkezi.app/wa/test/inbound",
    headers={"Authorization": f"Bearer {os.environ['VM_TEST_KEY']}"},
    json={"phone_number_id": "1234567890", "type": "text", "from": "905550000000", "text": "Merhaba, bu bir test mesajıdır."},
)
print(res.status_code, res.json())

<?php
$ch = curl_init('https://api.verimerkezi.app/wa/test/inbound');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('VM_TEST_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['phone_number_id' => '1234567890', 'type' => 'text', 'from' => '905550000000', 'text' => 'Merhaba, bu bir test mesajıdır.']),
]);
print_r(json_decode(curl_exec($ch), true));

type alanı dört değer alır:

• text: message.received olayı üretir. text zorunludur.
• edit: message.edited olayı üretir. text ve original_message_id gönderin.
• revoke: message.revoked olayı üretir. original_message_id gönderin.
• app_contact_sync: add, update ve remove içeren örnek bir contact.synced olayı üretir. Rehbere kayıt yazılmaz. Bkz. Uygulama rehberi.

Başarılı istek 202 Accepted döner. Canlı anahtarla çağrılırsa 403 test_only alırsınız.

#Webhook bağlantısını sınayın

Abonelik oluşturduktan sonra POST /webhooks/{id}/test ile anında imzalı bir test.ping olayı gönderebilirsiniz. Bu uç test ve canlı anahtarla çalışır. Ayrıntı: Webhooklar.

#Canlıya geçiş

1. Panelden vmk_live_ anahtarı oluşturun ve yalnız gereken kapsamları seçin.
2. Ortam değişkenini canlı anahtarla değiştirin. Kodda başka değişiklik gerekmez.
3. Kredi bakiyenizi GET /credit/balance ile kontrol edin ve credit.low olayına abone olun.