# Veri Merkezi WhatsApp API

> WhatsApp Business Cloud API üzerinden mesaj, şablon, medya, kişi ve webhook yönetimi için REST API. Taban adres: https://api.verimerkezi.app/wa. Kimlik doğrulama: Authorization: Bearer <API anahtarı>.

## Rehberler

- [Hızlı başlangıç](https://api.verimerkezi.app/hizli-baslangic.html): Veri Merkezi WhatsApp Business API ile 5 dakikada API anahtarı alın ve ilk mesajınızı gönderin.
- [Test modu](https://api.verimerkezi.app/test-modu.html): vmk_test_ anahtarıyla Meta'ya mesaj göndermeden, kredi harcamadan entegrasyonunuzu ve webhook alıcınızı deneyin; hangi uçların simüle edildiğini öğrenin.
- [Kimlik doğrulama](https://api.verimerkezi.app/kimlik-dogrulama.html): Bearer API anahtarı, anahtar türleri, kapsamlar, IP kısıtı ve anahtar güvenliği.
- [Hatalar](https://api.verimerkezi.app/hatalar.html): Hata 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ı](https://api.verimerkezi.app/hiz-sinirlari.html): 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.
- [Sayfalama](https://api.verimerkezi.app/sayfalama.html): Liste uçlarında imleç (cursor) tabanlı sayfalama, uç bazında yanıt zarfları ve tüm kayıtları çekme örnekleri.
- [Idempotency](https://api.verimerkezi.app/idempotency.html): Idempotency-Key başlığıyla ağ hatalarında isteği güvenle tekrarlayın, aynı mesajın iki kez gitmesini önleyin.
- [En iyi uygulamalar](https://api.verimerkezi.app/en-iyi-uygulamalar.html): Güvenilir, güvenli ve Meta kurallarına uygun bir WhatsApp entegrasyonu için kontrol listesi.
- [Mesaj gönderme](https://api.verimerkezi.app/mesaj-gonderme.html): POST /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.
- [Şablonlar](https://api.verimerkezi.app/sablonlar.html): WhatsApp mesaj şablonlarını API ile oluşturun, Meta'ya göndermeden doğrulayın, onay durumunu izleyin ve senkronlayın.
- [Medya](https://api.verimerkezi.app/medya.html): Gö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 BSUID](https://api.verimerkezi.app/kullanici-adi-bsuid.html): Telefon 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)](https://api.verimerkezi.app/formlar.html): WhatsApp içinde açılan çok ekranlı formları oluşturun, yayınlayın, müşteriye gönderin ve yanıtları webhook ile alın.
- [Aramalar](https://api.verimerkezi.app/aramalar.html): WhatsApp sesli aramalarını açın, gelen aramayı kabul edin, izin veren müşteriyi arayın ve arama olaylarını izleyin.
- [Webhooklar](https://api.verimerkezi.app/webhooklar.html): Gelen mesajları, teslim durumlarını ve hesap olaylarını sunucunuzda alın; aboneliği kurun, imzayı doğrulayın, yeniden denemeleri yönetin.
- [Kişiler](https://api.verimerkezi.app/kisiler.html): Kişi rehberinize tekil ve toplu kişi ekleyin, listeleyin ve abonelikten çıkan (opt-out) kişileri izleyin.
- [Uygulama rehberi](https://api.verimerkezi.app/uygulama-rehberi.html): WhatsApp Business uygulamasıyla birlikte kullanılan numaraların telefondaki kişi rehberini çekin, değişiklikleri contact.synced olayıyla alın.

## API referansı

- [Hesap](https://api.verimerkezi.app/referans/account.html): API anahtarının sahibi olan hesabın bilgileri, hesap geneli ayarlar, KVKK işlemleri ve webhook teslimat sağlığı.
- [Numaralar](https://api.verimerkezi.app/referans/numbers.html): Hesabınıza bağlı WhatsApp numaraları; numara ayarları, geçmiş aktarımı ve numarayı hesaptan ayırma.
- [Mesajlar](https://api.verimerkezi.app/referans/messages.html): Ş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.
- [Medya](https://api.verimerkezi.app/referans/media.html): Gönderim için dosyayı Meta'ya yükleyin; müşterilerinizin gönderdiği medyayı listeleyin ve indirin.
- [Şablonlar](https://api.verimerkezi.app/referans/templates.html): Meta 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.
- [Kişiler](https://api.verimerkezi.app/referans/contacts.html): Kişi rehberinize kişi ekleyin, toplu içe aktarın, listeleyin ve abonelikten çıkanları izleyin.
- [Uygulama rehberi](https://api.verimerkezi.app/referans/app-contacts.html): WhatsApp Business uygulamasıyla birlikte kullanılan (coexistence) numaraların telefondaki kişi rehberini okuyun ve senkron durumunu izleyin.
- [Webhook abonelikleri](https://api.verimerkezi.app/referans/webhooks.html): Olayların sunucunuza gönderileceği webhook aboneliklerini yönetin; imza anahtarını döndürün ve ölü teslimleri yeniden kuyruğa alın.
- [İşletme profili](https://api.verimerkezi.app/referans/profile.html): Numaranızın WhatsApp işletme profilini (hakkında, adres, açıklama, e-posta, sektör, web siteleri) okuyun ve güncelleyin.
- [Raporlar](https://api.verimerkezi.app/referans/reports.html): Seçilen dönem için gönderim, teslim, okunma ve başarısızlık özetini numara kırılımıyla alın.
- [Kredi](https://api.verimerkezi.app/referans/credit.html): Mesaj kredisi bakiyenizi, etkin paketlerinizi, kullanım istatistiğinizi ve kredi hareketlerinizi görün.
- [Aramalar](https://api.verimerkezi.app/referans/calls.html): WhatsApp 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.
- [Formlar](https://api.verimerkezi.app/referans/flows.html): WhatsApp içinde açılan çok ekranlı formları (WhatsApp Flows) oluşturun, yayınlayın ve izleyin. Formlar WABA düzeyindedir; yönetim kredisizdir.
- [Webhook olayları](https://api.verimerkezi.app/referans/webhook-olaylari.html)
- [Hata kodları](https://api.verimerkezi.app/referans/hata-kodlari.html)

## İsteğe bağlı

- [Tüm doküman tek dosyada](https://api.verimerkezi.app/llms-full.txt)
- [Değişiklik günlüğü](https://api.verimerkezi.app/degisiklikler.html)