Hesap & Lookup Uçları

Zapier’de veya Make’te bir “Ara” (Start Call) aksiyonu kurarken karşına çıkan o asistan seç ve arayan numara seç açılır menüleri boşuna gelmez — arka planda bu üç uç doldurur onları. Üçü de salt-okunur, hiçbir şey değiştirmez, tek bir API anahtarıyla saniyeler içinde cevap verir. GET /me bağlantının canlı olduğunu kanıtlar; GET /assistants ve GET /phone-numbers ise otomasyon platformunun dropdown’larını senin gerçek asistan ve numaralarınla besler.

Bu üç uç, bir otomasyon aracının Purvisor hesabına ilk “el sıkışmasıdır” — telefon rehberini paylaşmak gibi: karşı taraf kiminle konuşacağını (asistan) ve hangi hattan arayacağını (numara) buradan öğrenir.

Genel bakış

GET /me — Bağlantı testi

API anahtarının geçerli olup olmadığını kanıtlayan en basit uç. Zapier ve Make, bir bağlantı kurarken “bu anahtar çalışıyor mu?” sorusunu tam olarak buraya sorar. Anahtar geçerliyse hesabının kimliğini döner; değilse HTTP 401 verir.

curl https://app.purvisor.ai/api/v1/me \
  -H "X-API-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Başarılı yanıt (HTTP 200):

{
  "id": "1042",
  "email": "you@company.com",
  "name": "Ada Lovelace"
}

Geçersiz veya eksik anahtar (HTTP 401):

{ "error": "invalid_api_key" }

Zapier/Make bağlantı ekranında “Test URL” istendiğinde tam olarak bu ucu (/api/v1/me) kullan — dönen email alanı bağlantı kartında hesap adın olarak görünür.

GET /assistants — Asistan listesi

“Ara” aksiyonunda kullanıcının isimle seçtiği, arka planda ise id’si gönderilen asistanları doldurur. Yalnızca sana ait ve aktif (active=true) asistanları döner; taslak veya pasif olanlar listede görünmez. Sıralama en yeniden eskiye (createdAt azalan).

curl https://app.purvisor.ai/api/v1/assistants \
  -H "X-API-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Yanıt — çıplak bir JSON dizisi (HTTP 200):

[
  {
    "id": "asst_9f3a2b",
    "name": "Satış Ön Nitelendirme",
    "direction": "outbound",
    "model": "gemini-2.5-flash"
  },
  {
    "id": "asst_7c1d84",
    "name": "Gelen Çağrı Karşılama",
    "direction": "inbound",
    "model": "claude-haiku"
  }
]

Asistanın dropdown’da çıkmıyorsa büyük olasılıkla pasif durumda — panelden aktifleştir, liste anında güncellensin.

GET /phone-numbers — Numara listesi

“Ara” aksiyonunda arayan numara (caller ID) seçimini doldurur. Yalnızca sana ait (created_by) ve aktif (is_active=true) numaraları döner, id’ye göre artan sırada.

curl https://app.purvisor.ai/api/v1/phone-numbers \
  -H "X-API-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Yanıt — çıplak bir JSON dizisi (HTTP 200):

[
  {
    "id": "12",
    "number": "+902123456789",
    "provider": "sip"
  },
  {
    "id": "15",
    "number": "+902129998877",
    "provider": "twilio"
  }
]

Bu uçlar dropdown’ları nasıl besler?

Zapier/Make "Ara" aksiyonunu açar
        ↓
Platform GET /me çağırır  → bağlantı geçerli mi? (401 ise bağlantıyı reddeder)
        ↓
GET /assistants çağırır   → "Asistan" dropdown'unu doldurur (name göster, id sakla)
GET /phone-numbers çağırır → "Arayan Numara" dropdown'unu doldurur
        ↓
Kullanıcı asistan + numara seçer → id'ler POST /api/v1/calls gövdesine yazılır

Yani sen Zapier’de bir isim seçerken, arka planda seçilen asistanın id’si “Ara” aksiyonuna gider. Numara seçmezsen “Ara” aksiyonu senin ilk aktif numaranı otomatik kullanır — dropdown yine de kontrolü sende bırakır.

Sorun giderme

İlgili