Entegrasyonlar — Genel Bakış

Entegrasyonlar, lead’lerinizin geldiği yeri (Facebook formu, web sitesi, CRM) Purvisor AI’ın arama yaptığı yere tek bir köprüyle bağlar. Bir kez bağlarsınız; sonrasında her yeni lead saniyeler içinde kontağa dönüşür, kurallarınıza göre otomatik aranır. Manuel CSV yükleme derdi yok — kaynak ne olursa olsun, lead düşer düşmez asistanınız devreye girer.

Bir entegrasyonu bağlamanın üç yolu var. Hangi sağlayıcının hangi yolu kullandığını aşağıda göreceksiniz; ama üçü de aynı yere çıkar: kiracınıza özel bir bağlantı kaydı ve o kayda bağlı lead-yönlendirme kuralları.

Nasıl çalışır?

İki bağlantı yöntemi + bir webhook              Ortak sonuç
──────────────────────────────────              ───────────────────────
OAuth "Bağla"   → Meta, WhatsApp, Gmail   ┐
Manuel anahtar  → Twilio, NetGSM,         ├──→  Bağlantı kaydı
                  Cal.com, WhatsApp, Gmail │     (kiracıya özel,
Genel webhook   → Web formu, Zapier,      ┘      sağlayıcı başına 1)
                  Make, n8n (x-api-key)                  ↓
                                              Lead-yönlendirme kuralları
                                              (otomatik arama, gecikme,
                                               asistan, numara)
                                                         ↓
                                          Asistan arar · mesaj gider · analiz

Her bağlantı arka planda tek bir UserIntegration kaydı olarak tutulur — hesabınıza özel, sağlayıcı başına bir tane. Başka bir kiracının bağlantısını göremez veya düzenleyemezsiniz (her istekte sahiplik kontrol edilir).

İki bağlantı yöntemi

1) OAuth “Bağla” akışı

En kolay yol. Panelde ilgili kartın Bağla butonuna tıklarsınız, sağlayıcının (Facebook / Google) izin ekranı açılır, izinleri onaylarsınız ve panele geri dönersiniz. Purvisor bir erişim jetonu (token) alır ve saklar.

OAuth ile bağlanan sağlayıcılar ve istedikleri izinler:

Jetonlar tipik olarak ~60 gün geçerli uzun-ömürlü jetonlardır; süresi dolarsa panelde “Yeniden bağlan” uyarısı görürsünüz.

2) Manuel API anahtarı (service-config)

Bazı sağlayıcılarda OAuth yoktur; bunun yerine kendi hesabınızdan aldığınız anahtarları bir forma yapıştırırsınız. Örneğin bir telefon rehberinize kendi anahtarınızla erişim vermek gibi — anahtarı siz üretir, Purvisor’a girer, kaydedersiniz.

Kaydetmeden önce Test bağlantısı butonuyla anahtarlarınızı doğrulayın — Twilio’da test SMS, NetGSM’de bakiye sorgusu, Cal.com’da etkinlik tipleri, Gmail’de test bağlantısı çalıştırılır ve hatalı anahtar anında yakalanır. NetGSM’de sık yapılan hata: usercode ana abone numarası değil, alt-kullanıcı kodu olmalı; gönderici başlığı (msgheader) NetGSM panelinde önceden onaylı olmalıdır. Detay: NetGSM / Twilio SMS.

3) Genel lead webhook’u

OAuth veya API anahtarı olmayan her kaynak için ortak kapı: web sitesi formunuz, Zapier, Make senaryosu ya da n8n akışı lead’i doğrudan Purvisor’a POST eder. Kimlik doğrulama tek bir x-api-key başlığıyla yapılır (panelden kopyalanır). Zorunlu tek alan lead.phone’dur. Ayrıntılı istek örneği için: n8n / Web Formu.

Bir entegrasyonu bağlama (adım adım)

Ortak lead-yönlendirme kuralları

Lead getiren her bağlantıda aynı kural seti bulunur. Bu ayarlar, “lead geldi, ne yapayım?” sorusunun cevabıdır ve entegrasyon kartının ayarlarından her an değiştirilebilir.

Arama penceresi entegrasyon kartından değil, hesap ayarlarından gelir

Bir lead’in ne zaman aranacağı iki pencerenin kesişimiyle hesaplanır:

1. Hesabınızın çalışma penceresi — Ayarlar → Arama Penceresi & Bölge (başlangıç/bitiş saati, çalışma günleri; saatler profilinizdeki saat dilimine göre yorumlanır). Boş bırakılırsa varsayılan 09:00–19:00, Pzt–Cmt.
2. Aranan kişinin ülkesindeki yasal arama penceresi — numaradan çözülür. Türkiye: 09:00–19:00, Pzt–Cmt; ABD (TCPA): 08:00–21:00, her gün; Birleşik Krallık: 08:00–21:00, Pzt–Cmt — hepsi aranan kişinin yerel saatiyle.

İkisi birden açık olmadan arama başlamaz. Pencere dışında gelen lead kaybolmaz; bir sonraki uygun ana planlanır. Entegrasyon kartındaki saat alanlarını değiştirmek bu hesaplamayı etkilemez — arama saatlerini değiştirmek istiyorsanız hesap ayarlarındaki pencereyi düzenleyin.

Bağlantıyı kesmek

Bir entegrasyon kartındaki Bağlantıyı kes butonu üç şeyi birden yapar:

1. Bağlantıyı pasifleştirir (yumuşak silme — kayıt arşivlenir, tamamen silinmez).
2. Saklanan erişim ve yenileme jetonlarını temizler (NULL’lar) — Purvisor’ın sağlayıcıya erişimi biter.
3. O bağlantıya bağlı sürekli-açık kampanyayı durdurur (kampanya status=completed olur).

Sağlayıcılar

Sorun giderme

İlgili