Zapier Entegrasyonu

Bir Google Form dolduruldu, bir Typeform tamamlandı, CRM’de yeni bir kayıt açıldı — ve saniyeler içinde Purvisor asistanın o kişiyi arıyor. Zapier, Purvisor’ı tek satır kod yazmadan kendi kataloğundaki uygulamalara bağlar. Perde arkasında Purvisor’ın Zapier uygulaması tamamen Public API üzerinde çalışır: Zapier her adımda https://app.purvisor.ai/api/v1 uçlarına senin API anahtarınla istek atar. Yani panelde tıkladığın her şey, burada Zapier’in dilinde tekrar eder.

Lead’i 5 dakikada aramak, 30 dakika sonra aramaya göre kat kat yüksek dönüşüm sağlar — Zapier bu gecikmeyi sıfıra yaklaştırır.

Nasıl çalışır?

Tetikleyici uygulama (form, CRM, reklam, e-tablo...)
        ↓ (Zapier "Trigger" tetiklenir)
Zapier → Purvisor uygulaması (Action)
        ↓ (X-API-Key ile POST /api/v1/...)
Purvisor kişi oluşturur / arama başlatır
        ↓
AI asistanı arar → görüşme → analiz
        ↓ (Purvisor "Trigger" — REST hook)
Zapier'e imzalı olay POST'lanır → sonraki adım (Sheets, Slack, CRM...)

Zapier’de iki yön vardır:

• Action’lar (Zapier → Purvisor): Başka bir uygulamadaki olay, Purvisor’da bir şey yaptırır — kişi oluştur, arama başlat.
• Trigger’lar (Purvisor → Zapier): Purvisor’daki bir olay (arama bitti, sıcak lead) Zapier’i tetikler, sen de sonucu istediğin yere akıtırsın. Bunlar REST hook (webhook aboneliği) ile çalışır.

Ön koşullar

• Bir Zapier hesabı (ücretsiz plan Action’lar için yeterli; çok adımlı Zap’ler ücretli plan ister).
• Purvisor’da Pro veya üzeri bir plan — Public API bu planlarda açıktır; aksi halde her çağrı 403 premium_required döner.
• Purvisor’da oluşturulmuş bir API anahtarı — Ayarlar sayfasından (API Anahtarı Yönetimi).
• Arama başlatacaksan: aktif bir outbound asistan (İlk Asistanını Oluştur) ve bağlı bir telefon numarası (SIP) (Telefon Numarası (SIP)).
• Dakika bakiyesi — Start Call, bakiye 1 dakikanın altındaysa arama açmaz (bkz. Sorun giderme).

Kurulum

GET /api/v1/me HTTP/1.1
Host: app.purvisor.ai
X-API-Key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{ "id": "12345", "email": "sen@sirket.com", "name": "Adın" }

{
  "call_id": "98765",
  "status": "initiated",
  "contact_id": "12345",
  "assistant_id": "asst_abc",
  "from_number": "+90850XXXXXXX",
  "to": "+905551112233"
}

POST /api/v1/hooks HTTP/1.1
Host: app.purvisor.ai
X-API-Key: pk_live_...
Content-Type: application/json
 
{ "event": "call.completed", "targetUrl": "https://hooks.zapier.com/...", "source": "zapier" }

{ "id": "42", "event": "call.completed", "targetUrl": "https://hooks.zapier.com/...", "secret": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" }

Uçtan uca örnek Zap: “Yeni form kaydı → hemen ara”

En sık kullanılan senaryo. Web sitesindeki formu bir AI aramaya bağlayalım:

1. Trigger  : Google Forms → "New Form Response"
2. Action   : Purvisor → "Start Call"
                phone         = {{Form: Telefon}}
                assistant_id  = "Satış Asistanı" (dropdown)
                phone_number_id = "+90850..." (dropdown, opsiyonel)
                first_name    = {{Form: Ad}}
→ Sonuç: Form gönderilir gönderilmez asistan arar. call_id döner.

İstersen araya bir Delay adımı koyarak “3 dakika bekle, sonra ara” diyebilirsin — kişinin formu tam gönderdiğinden emin olmak için. Sonucu takip etmek istersen ikinci bir Zap kur:

1. Trigger : Purvisor → "Call Completed"   (POST /api/v1/hooks ile abone olur)
2. Action  : Google Sheets → satır ekle
             {{outcome}}, {{sentiment}}, {{summary}}, {{durationSeconds}}

Böylece her aramanın sonucu otomatik bir e-tabloya düşer — CRM’e yazmak, Slack’e bildirim atmak da aynı mantıkla eklenir.

Trigger olayları (REST hook)

Purvisor 9 olayın tamamını canlı olarak tetikler. Her birinin alan yapısını GET /api/v1/samples?event=<olay> ile görebilirsin — dönen kayıt, canlıda geleceğin zarfının aynısıdır.

KVKK notu

Start Call, gerçek bir kişiyi telefonla arar — yani kişisel veri işler. Zapier’le otomatik arama kurarken:

• Aradığın kişilerin açık rızasının olduğundan emin ol; rıza kapsamı otomatik aramayı da içermeli.
• Asistanın açılışında kim olduğunu ve neden aradığını net söylesin.
• dnc.requested trigger’ını bir Zap’e bağlayıp “aranmak istemeyenler” listeni CRM’inde otomatik güncel tut — hem uyum hem itibar için.

Sorun giderme

Public API’de anahtar başına dakikada 60 istek sınırı vardır (429 + Retry-After). Diğer katı kapılar: Public API Pro ve üzeri plan gerektirir (403 premium_required) ve Start Call dakika bakiyesi ister. Hata kodlarının tam listesi: Limitler ve Hatalar.

İlgili