Kişi Listeleri | WA2Notify Docs

Kişi listeleri CRM, ERP veya dış operasyon sistemlerinden doğrudan WA2Notify içine taşınabilir. JSON tabanlı manuel oluşturma korunur; CSV/XLSX import ise server-side güvenli hat üzerinden işler.

İçe aktarma ilkeleri

Yalnızca CSV ve XLSX

xls, xlsm ve benzeri legacy veya makrolu formatlar kabul edilmez.

Telefon normalizasyonu

+49, +1, 0049 gibi girişler ortak uluslararası formata dönüştürülür.

Satır temizleme

Boş satırlar, kopyalar, geçersiz numaralar ve formula riski taşıyan hücreler filtrelenir.

POST/v1/contact-lists

X-API-Key200 OK

Kişi listesi oluştur

Manuel JSON payload ile kişi listesi oluşturur ve değişken alanlarını otomatik çıkarır.

Zorunlu alanlarname ve en az bir geçerli kontaktan oluşan contacts dizisi gereklidir.

Değişken alanlarvariables içindeki anahtarlar liste düzeyindeki variable_fields alanına otomatik eklenir.

Plan bazlı kişi listesi limiti bu uçta uygulanır. Limit doluysa `CONTACT_LIST_LIMIT_REACHED` döner.

İstek

curl --request POST \
--url {{BASE_URL}}/v1/contact-lists \
--header "X-API-Key: {{API_KEY}}" \
--header "Content-Type: application/json" \
--data '{
  "name": "Ankara Musterileri",
  "description": "Nisan bulteni alici listesi",
  "source": "manual",
  "contacts": [
    {
      "phone": "+905551112233",
      "name": "Ayşe",
      "variables": {
        "ad": "Ayşe",
        "sehir": "Ankara"
      }
    }
  ]
}'

Yanıt

JSON

{
"data": {
  "id": "6876b126-8e88-4937-9bbf-0f14a368d65f",
  "name": "Ankara Musterileri",
  "source": "manual",
  "total_contacts": 1,
  "variable_fields": ["ad", "sehir"],
  "created_at": "2026-04-01T09:32:12Z"
}
}

POST/v1/contact-lists/import

X-API-Key200 OK

CSV veya XLSX import et

Yüklenen CSV veya XLSX dosyasını backend hattında parse eder, normalize eder ve yeni kişi listesi oluşturur.

Telefon kolonu otomatik tespit edilir.
Formüller string olarak okunur ve kalıcı kayıt öncesi nötralize edilir.
Aynı telefon numarası tek listede bir kez saklanır.

Import hattı hem uzantıyı hem gerçek dosya içeriğini kontrol eder; yalnızca desteklenen MIME ve yapı kabul edilir.

İstek

curl --request POST \
--url {{BASE_URL}}/v1/contact-lists/import \
--header "X-API-Key: {{API_KEY}}" \
--form "name=Berlin Musterileri" \
--form "description=CRM exportu" \
--form "[email protected]"

Yanıt

JSON

{
"data": {
  "id": "4c344d9c-c245-4a48-8e72-46df32ae7680",
  "name": "Berlin Musterileri",
  "source": "excel",
  "total_contacts": 412,
  "variable_fields": ["ad", "sehir", "segment"],
  "created_at": "2026-04-01T09:35:45Z"
}
}

GET/v1/contact-lists

X-API-Key200 OK

Kişi listelerini listele

Kullanıcının kişi listelerini toplam kişi sayısı ve değişken alan özetiyle listeler.

Toplam kişi sayısı total_contacts alanından okunur.

Liste görünümü kampanya seçim ekranları için hafif tutulur; tam satır içeriği detay çağrısında döner.

İstek

curl --request GET \
--url {{BASE_URL}}/v1/contact-lists \
--header "X-API-Key: {{API_KEY}}"

Yanıt

JSON

{
"data": {
  "contact_lists": [
    {
      "id": "6876b126-8e88-4937-9bbf-0f14a368d65f",
      "name": "Ankara Musterileri",
      "total_contacts": 248,
      "variable_fields": ["ad", "sehir"],
      "updated_at": "2026-04-01T09:32:12Z"
    }
  ]
}
}

GET/v1/contact-lists/:list_id

X-API-Key200 OK

Kişi listesi detayını al

Tek listenin metadata bilgisini ve satır kayıtlarını döndürür.

Bu payload şablon alanlarınızı kişi listesi sütunları ile eşlemek için kullanılabilir.

Detay uçları yalnız owner tenant için veri döndürür; yabancı `list_id` istekleri bulunamadı olarak sonuçlanır.

İstek

curl --request GET \
--url {{BASE_URL}}/v1/contact-lists/{{CONTACT_LIST_ID}} \
--header "X-API-Key: {{API_KEY}}"

Yanıt

JSON

{
"data": {
  "id": "6876b126-8e88-4937-9bbf-0f14a368d65f",
  "name": "Ankara Musterileri",
  "description": "Nisan bulteni alici listesi",
  "total_contacts": 2,
  "contacts": [
    {
      "phone": "+905551112233",
      "name": "Ayşe",
      "variables": {"ad": "Ayşe", "sehir": "Ankara"}
    },
    {
      "phone": "+4915112345678",
      "name": "Mila",
      "variables": {"ad": "Mila", "sehir": "Berlin"}
    }
  ]
}
}

Diğer liste uçları

Metot	Yol	Amaç
`DELETE`	`/v1/contact-lists/:list_id`	Listeyi ve bağlı girişleri siler

Plan limitleri

Plan	Kişi listesi limiti
Free	`2` liste
Pro	`25` liste
Growth	`100` liste
Enterprise	Sınırsız