Kommo (amoCRM) Entegrasyonu
Kommo — eski adıyla amoCRM — mesajlaşma odaklı bir satış CRM’i. Bu entegrasyon iki yönde çalışır: Kommo’ya düşen bir lead saniyeler içinde Purvisor’a taşınır ve yapay zeka asistanın otomatik arar; arama biter bitmez sonuç (özet, duygu, süre) doğrudan Kommo lead kartına not olarak geri yazılır. Ekibin CRM’den hiç çıkmadan, her lead’in insan hızından çok daha çabuk arandığını görür.
Bu, Meta Lead Ads veya n8n / Web Form ile aynı otomatik-arama motorunu kullanır — sadece lead’in kaynağı Kommo’dur ve sonuç ekstra olarak Kommo’ya geri yazılır.
Nasıl çalışır?
Kommo'da yeni bir lead oluşur / aşama değişir
↓ (Kommo webhook — add_lead / status_lead / update_lead)
Purvisor lead'i alır, bağlı kişinin telefonunu Kommo API'sinden çeker
↓
Purvisor kişisi oluşturulur/güncellenir (kommo_lead_id ile eşlenir)
↓ (autoCallEnabled + aşama filtresi uyuyorsa)
Otomatik arama planlanır (gecikme + arama penceresi kurallarıyla)
↓
Yapay zeka asistanı arar → görüşme → AI analizi
↓ (kişi Kommo'dan geldiyse)
Sonuç (özet + duygu + süre) Kommo lead kartına NOT olarak yazılırBağlantı OAuth 2.0 ile kurulur — Kommo pazar yerinden veya panelden tek tıkla, kod yazmadan.
Ön koşullar
- Bir Kommo (amoCRM) hesabı ve üzerinde en az bir pipeline/lead.
- Purvisor’da hazır bir outbound asistan (İlk Asistanını Oluştur).
- Bağlı bir telefon numarası (SIP trunk) — otomatik arama bu numaradan çıkar (Telefon Numarası (SIP)).
- Kommo’daki lead’lerdeki telefon alanının standart PHONE custom field’ında olması (Kommo’nun varsayılanı budur).
Kurulum
Kommo’yu bağla
Panelde Entegrasyonlar → Kommo → Bağla butonuna tıkla. Purvisor seni Kommo’nun OAuth onay ekranına yönlendirir.
📸 [Ekran görüntüsü: Entegrasyonlar sayfası — Kommo “Bağla” butonu]
Kommo hesabınla onayla
Kommo hesabınla giriş yapıp izinleri onayla. Purvisor, hesabının subdomain’ini (hesabın.kommo.com) ve temel hesap bilgisini okur — lead/kontak verisine erişim izni ister.
Onayladıktan sonra panele ?kommo_connected=true ile geri dönersin ve entegrasyon “Bağlandı ✓” görünür.
Bağlantı arka planda otomatik olarak Kommo’ya bir webhook aboneliği de kaydeder (add_lead, status_lead, update_lead olayları) — ayrıca bir “webhook kur” adımı yapmana gerek yok. Panelde “Webhook’u Etkinleştir” butonuyla bu kaydı istediğin zaman elle de tetikleyebilirsin (idempotent — aynı hedefi tekrar eklemez).
Otomatik aramayı yapılandır
Bağlandıktan sonra hangi asistanın arayacağını, hangi numaradan çıkacağını, kaç dakika gecikmeyle arayacağını ve (istersen) yalnızca belirli bir Kommo aşamasına giren lead’lerin aranacağını ayarla. Aramaların hangi saatlerde yapılacağı bu karttan değil, Ayarlar → Arama Penceresi & Bölge ekranından belirlenir (Entegrasyonlar — Genel Bakış).
İlk bağlantıda otomatik arama varsayılan olarak KAPALIDIR. Bu bilinçli bir güvenlik önlemi — bağlantı kurulur kurulmaz mevcut lead’lerin beklenmedik/istenmeyen bir şekilde aranmaya başlamaması için. Otomatik aramayı sen açana kadar Purvisor yalnızca lead’leri senkronlar, aramaz.
📸 [Ekran görüntüsü: Kommo entegrasyon ayarları — asistan/numara seçimi, otomatik arama anahtarı, gecikme dakikası]
Test et
Kommo’da yeni bir test lead’i oluştur (telefon alanı dolu olsun). Birkaç saniye içinde:
- Purvisor’da Kontaklar altında yeni bir kişi görünür (kaynak: Kommo),
kommo_lead_idile Kommo’daki lead’e bağlı. - Otomatik arama açıksa ve aşama filtresi (varsa) uyuyorsa, ayarladığın gecikmeyle arama planlanır.
- Arama bitince Kommo’daki lead kartını aç — ”📞 Purvisor AI arama sonucu” başlıklı bir not, sonuç/duygu/süre/özet ile eklenmiş olmalı.
Yeniden bağlanma ve ayrılma
- Yeniden bağlanma: Aynı hesabı tekrar “Bağla” dersen, önceki asistan/numara/kampanya/gecikme tercihlerin korunur — sıfırdan kurmana gerek kalmaz. Eski bağlantı arka planda kapatılır (soft-delete), yenisi onun ayarlarını devralır.
- Token yenileme: Erişim anahtarı (~24 saat) süresi dolmadan otomatik yenilenir; yenileme token’ı (~3 ay) da geçersiz olursa entegrasyon “yeniden bağlanma gerekiyor” durumuna düşer — bu durumda Kommo’dan gelen lead’ler işlenemez, panelde uyarı görürsün.
- Kommo tarafından kaldırma: Entegrasyonu Kommo pazar yerinden kaldırırsan, Kommo Purvisor’a bir bildirim gönderir ve bağlantı otomatik olarak devre dışı kalır — Purvisor tarafında ayrıca bir şey yapmana gerek yoktur.
Lead verisi nasıl eşlenir?
Kommo’da telefon numarası lead’in kendisinde değil, lead’e bağlı kişide (contact) PHONE alanında tutulur — Purvisor bunu otomatik çözer. Telefonu olmayan lead’ler (ör. yalnızca e-posta ile açılan) senkronlanmaz, atlanır. Aynı Kommo lead’i tekrar güncellenirse (aşama değişimi vb.) Purvisor’daki kişi yeniden oluşturulmaz, kommo_lead_id ile eşlenip güncellenir.
Çift yön: geri yazma nasıl çalışır?
Bir kişi Kommo’dan geldiyse (yani kommo_lead_id referansı varsa), görüşme bitip AI analizi tamamlandığında Purvisor otomatik olarak Kommo’daki lead kartına bir not (common note) ekler:
📞 Purvisor AI arama sonucu
Sonuç: randevu-alindi
Duygu: olumlu
Süre: 96 sn
Özet: Müşteri fiyatlandırma hakkında bilgi istedi, ...Bu yazma işlemi fire-and-forget’tir — başarısız olsa bile arama akışını veya analiz kaydını bozmaz, sadece loglanır.
Sorun giderme
| Belirti | Olası neden / çözüm |
|---|---|
| Kommo lead Purvisor’a hiç gelmedi | Webhook aboneliği düşmüş olabilir — panelde “Webhook’u Etkinleştir”e tekrar bas; entegrasyonun hâlâ “Bağlandı” durumunda olduğunu doğrula. |
| Lead geldi ama arama yapılmadı | Otomatik arama kapalı (varsayılan budur, ilk bağlantıda bilerek kapalı bırakılır); aşama filtresi ayarlıysa lead o aşamada değildir; bağlı SIP numarası yok/pasif. |
| Telefon numarası bulunamadı, kişi oluşmadı | Kommo’da lead’e bağlı contact’ın PHONE custom field’ı boş — Kommo tarafında telefonu doldur. |
| Kommo’ya not yazılmadı | Kişi Kommo kaynaklı değil (kommo_lead_id yok) — yalnızca Kommo’dan gelen lead’lerde geri yazma çalışır; ya da token süresi dolmuş, yeniden bağlan. |
| ”Yeniden bağlanma gerekiyor” uyarısı | Yenileme (refresh) token’ı da geçersiz olmuş (uzun süre kullanılmama, Kommo tarafında iptal) — Entegrasyonlar sayfasından tekrar “Bağla”. |
KVKK notu
Kommo’daki lead’leri otomatik aramaya başlamadan önce, o kişilerden ticari arama için açık rıza almış olman gerekir. Asistanın açılışta kim olduğunu ve neden aradığını net söylemesi hem yasal hem güven açısından önemlidir. Detay: KVKK ve Veri Yönetimi.