Kişiler | Veri Merkezi API

Kişi rehberi, müşterilerinizin telefon, ad, e-posta, firma ve etiket bilgilerini saklar. API ile kişi ekleyebilir, toplu içe aktarabilir, listeleyebilir ve mesaj almak istemeyenleri izleyebilirsiniz.

Not Kişi güncelleme, silme, etiket düzenleme ve abonelik durumunu değiştirme için API ucu yoktur; bu işlemler panelden yapılır.

#Kişi ekleyin

cURL

curl -X POST https://api.verimerkezi.app/wa/contacts \
  -H "Authorization: Bearer $VM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "5550000000", "country_code": "90", "name": "Ayşe Yılmaz", "email": "[email protected]", "company": "Firma A.Ş.", "tags": ["vip", "istanbul"] }'

Node.js

const kisi = await vm.createContact('5550000000', 'Ayşe Yılmaz', { email: '[email protected]', tags: ['vip'] });
console.log(kisi.id, kisi.phone); // +905550000000

Python

kisi = vm.create_contact('5550000000', 'Ayşe Yılmaz', email='[email protected]', tags=['vip'])
print(kisi['id'], kisi['phone'])

PHP

<?php
$kisi = $vm->createContact('5550000000', 'Ayşe Yılmaz', ['email' => '[email protected]', 'tags' => ['vip']]);
echo $kisi['phone'];

JSON

{ "ok": true, "id": 26481, "phone": "+905550000000", "name": "Ayşe Yılmaz" }

Telefon en az 10 hane olmalıdır. Numara ülke koduyla başlamıyorsa country_code (varsayılan 90) eklenir ve baştaki 0 atılır.
name en az 2 karakter olmalıdır.
Telefon zaten kayıtlıysa 409 contact_exists döner; error.id mevcut kişiyi verir.

#Toplu ekleyin

Tek istekte en fazla 1000 kişi ekleyin. Geçersiz satırlar errors dizisinde raporlanır, diğerleri eklenir.

BASH

curl -X POST https://api.verimerkezi.app/wa/contacts/bulk \
  -H "Authorization: Bearer $VM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "phone": "5550000003", "name": "Ali Demir" },
      { "phone": "5550000002", "name": "Zeynep Şahin", "tags": ["yeni"] }
    ],
    "skip_duplicates": true,
    "country_code": "90"
  }'

JSON

{ "ok": true, "inserted": 2, "skipped": 0, "errors": [] }

skip_duplicates: true ise kayıtlı telefonlar sessizce atlanır ve skipped sayısına eklenir. Göndermezseniz yinelenenler errors içinde duplicate koduyla döner.
Satır hatası biçimi: { "index": 47, "code": "invalid", "phone": "abc" }.
1000'den fazla kişi 422 too_many döner; listeyi parçalara bölün.

#Listeleyin

BASH

curl "https://api.verimerkezi.app/wa/contacts?limit=50&q=ayse" \
  -H "Authorization: Bearer $VM_API_KEY"

Parametre	Açıklama
`limit`	1–200, varsayılan 50.
`cursor`	Önceki yanıttaki `next_cursor`.
`q`	Ad ya da telefon içinde arama.
`opted_out`	`true` yalnız reddedenleri, `false` diğerlerini listeler.

Her kayıtta opted_out ve opted_out_at alanları döner. Sayfalama: Sayfalama.

#Mesaj almak istemeyenler

Müşteri WhatsApp'tan reddettiğinde ya da durum panelden değiştirildiğinde kişinin opted_out bayrağı güncellenir. Pazarlama ve otomatik mesaj göndermeden önce bu kişileri listenizden çıkarın.

İlk kurulumda reddedenleri bir kez çekin:

BASH

curl "https://api.verimerkezi.app/wa/contacts/opted-out?limit=200" \
  -H "Authorization: Bearer $VM_API_KEY"

Değişiklikleri anında almak için webhook aboneliğinize contact.opt_out_changed olayını ekleyin.
Olay kaçırırsanız son eşitleme zamanınızla artımlı okuyun: GET /contacts/opted-out?since=2026-10-01T00:00:00+03:00.

contact.opt_out_changed olayı contact_id, phone, opted_out, previous_opted_out, source, phone_number_id ve changed_at alanlarını taşır. source değeri değişikliğin kaynağını belirtir (whatsapp_ret, whatsapp_onay, admin_override, automation, panel, panel_bulk).

Uyarı Abonelikten çıkış kanıtları yasal gereklilik olduğu için KVKK silme işleminde de korunur.

#KVKK

Kişiyi rehbere yalnız açık rızasıyla ekleyin.
Silme talebinde POST /privacy/erasure ile kişinin mesaj ve medya verilerini silin. Bkz. Hesap referansı.

Not Coexistence numaralarında telefondaki WhatsApp Business uygulamasının rehberi ayrı bir kaynaktır: Uygulama rehberi.

Tüm alanlar: Kişiler referansı.