Kendi yazılımınızdan WhatsApp mesajı gönderin.
Tek bir REST API ile şablon, medya, konum ve kişi kartı, düğmeli ve listeli mesaj gönderin; gelen mesajları ve durum bildirimlerini webhook ile anında alın. Test anahtarıyla kredi harcamadan deneyin.
- Meta yetkili Tech Provider altyapısı
- Node.js, Python ve PHP kütüphaneleri
- Yapay zekâ asistanlarına hazır doküman

curl -X POST "https://api.verimerkezi.app/wa/test/inbound" \
-H "Authorization: Bearer $VM_API_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_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"phone_number_id": "1234567890",
"type": "text",
"from": "905550000000",
"text": "Merhaba, bu bir test mesajıdır."
}),
});
const data = await res.json();import os, requests
res = requests.post(
"https://api.verimerkezi.app/wa/test/inbound",
headers={"Authorization": f"Bearer {os.environ['VM_API_KEY']}"},
json={
"phone_number_id": "1234567890",
"type": "text",
"from": "905550000000",
"text": "Merhaba, bu bir test mesajıdır."
},
)
data = res.json()<?php
$ch = curl_init("https://api.verimerkezi.app/wa/test/inbound");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("VM_API_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."
]),
]);
$data = json_decode(curl_exec($ch), true);Üç adımda ilk mesaj
- 1API anahtarı oluşturun
Panelde Geliştirici sayfasından bir test anahtarı (
Panele gitvmk_test_…) alın. - 2İlk isteği gönderin
Onaylı bir şablonla
Hızlı başlangıçPOST /messagesçağrısı yapın. - 3Webhook'u bağlayın
Gelen mesajları ve teslim bildirimlerini sisteminize alın.
Webhook rehberi
Taban adres
https://api.verimerkezi.app/waKimlik doğrulama
Authorization: Bearer vmk_live_…Biçim
JSON · UTF-8 · HTTPSSürüm
v2.32.1 · değişikliklerRehberler
Başlarken
Temeller
- Kimlik doğrulamaBearer API anahtarı, anahtar türleri, kapsamlar, IP kısıtı ve anahtar güvenliği.
- HatalarHata yanıtının yapısı, HTTP durum kodları, sık görülen hata kodları ve doğru yeniden deneme stratejisi.
- Hız sınırlarıAnahtar ve hesap düzeyinde dakikalık istek sınırları, birinci taraf önceliği, X-RateLimit başlıkları, 429 ve 503 yanıtlarını doğru işleme.
- SayfalamaListe uçlarında imleç (cursor) tabanlı sayfalama, uç bazında yanıt zarfları ve tüm kayıtları çekme örnekleri.
- IdempotencyIdempotency-Key başlığıyla ağ hatalarında isteği güvenle tekrarlayın, aynı mesajın iki kez gitmesini önleyin.
- En iyi uygulamalarGüvenilir, güvenli ve Meta kurallarına uygun bir WhatsApp entegrasyonu için kontrol listesi.
Mesajlaşma
- Mesaj göndermePOST /messages ile şablon, metin, medya, konum, kişi kartı, tepki, alıntılı yanıt ve form mesajı gönderin; 24 saat penceresini doğru yönetin.
- ŞablonlarWhatsApp mesaj şablonlarını API ile oluşturun, Meta'ya göndermeden doğrulayın, onay durumunu izleyin ve senkronlayın.
- MedyaGönderim için dosyayı Meta'ya yükleyin, medya mesajı ve sesli not gönderin, müşterilerinizin gönderdiği medyayı güvenle indirin.
- Kullanıcı adı ve BSUIDTelefon numarası görünmeyen WhatsApp kullanıcılarını user_id (BSUID) ile tanıyın ve recipient alanıyla yanıtlayın.
- Formlar (WhatsApp Flows)WhatsApp içinde açılan çok ekranlı formları oluşturun, yayınlayın, müşteriye gönderin ve yanıtları webhook ile alın.
- AramalarWhatsApp sesli aramalarını açın, gelen aramayı kabul edin, izin veren müşteriyi arayın ve arama olaylarını izleyin.
API referansı
HesapAPI anahtarının sahibi olan hesabın bilgileri, hesap geneli ayarlar, KVKK işlemleri ve webhook teslimat sağlığı.5 uç noktaNumaralarHesabınıza bağlı WhatsApp numaraları; numara ayarları, geçmiş aktarımı ve numarayı hesaptan ayırma.7 uç noktaMesajlarŞablon, metin, medya, konum, kişi kartı, tepki ve form mesajı gönderin; gelen mesajları okundu işaretleyin ve kaçan olayları mesaj kayıtlarından geri alın.11 uç noktaMedyaGönderim için dosyayı Meta'ya yükleyin; müşterilerinizin gönderdiği medyayı listeleyin ve indirin.4 uç noktaŞablonlarMeta onaylı mesaj şablonlarını oluşturun, doğrulayın, listeleyin, düzenleyin, kopyalayın ve silin; başlık medyasını yükleyin. Şablonlar işletme hesabı (WABA) düzeyindedir.11 uç noktaKişilerKişi rehberinize kişi ekleyin, toplu içe aktarın, listeleyin ve abonelikten çıkanları izleyin.4 uç noktaUygulama rehberiWhatsApp Business uygulamasıyla birlikte kullanılan (coexistence) numaraların telefondaki kişi rehberini okuyun ve senkron durumunu izleyin.2 uç noktaWebhook abonelikleriOlayların sunucunuza gönderileceği webhook aboneliklerini yönetin; imza anahtarını döndürün ve ölü teslimleri yeniden kuyruğa alın.7 uç noktaİşletme profiliNumaranızın WhatsApp işletme profilini (hakkında, adres, açıklama, e-posta, sektör, web siteleri) okuyun ve güncelleyin.2 uç noktaRaporlarSeçilen dönem için gönderim, teslim, okunma ve başarısızlık özetini numara kırılımıyla alın.1 uç noktaKrediMesaj kredisi bakiyenizi, etkin paketlerinizi, kullanım istatistiğinizi ve kredi hareketlerinizi görün.4 uç noktaAramalarWhatsApp sesli aramalarını yönetin: gelen aramayı kabul edin ya da reddedin, izin veren müşteriyi arayın, arama ayarlarını ve geçmişini görün. Ses WebRTC ile sizin ucunuz ve Meta arasında akar; Veri Merkezi yalnız sinyal verisini (SDP) iletir.10 uç noktaFormlarWhatsApp içinde açılan çok ekranlı formları (WhatsApp Flows) oluşturun, yayınlayın ve izleyin. Formlar WABA düzeyindedir; yönetim kredisizdir.9 uç nokta
Test anahtarıyla, kredi harcamadan deneyin
vmk_test_ ile başlayan anahtar gerçek gönderim yapmaz ve kredi kullanmaz. Entegrasyonunuz hazır olunca canlı anahtara geçin.
Yapay zekâ asistanlarına hazır
Her sayfanın üstündeki Sayfayı kopyala düğmesi sayfayı Markdown olarak kopyalar; ChatGPT ya da Claude'da tek tıkla açabilirsiniz. Dokümanın tamamı llms.txt ve llms-full.txt olarak da yayımlanır.

