Papo'nun Projeler modülünde (https://papo.global/) harici olaylardan — örneğin Kanban hunisinde bir fırsatın ilerlemesinden — otomatik görevler oluşturmak için platformun API'sini n8n veya Zapier gibi otomasyon araçlarıyla birlikte kullanabilirsiniz. API, CRM kartlarını sorgulamanıza ve projelerde programatik olarak görev üretmenize olanak tanır; böylece satış ve operasyon arasında manuel aktarım gerekmez.
Satış hattını teslimat yürütmeyle entegre etmek, B2B operasyonlarının en büyük darboğazlarından biridir. Bir fırsat kartı "Kazanıldı" aşamasına taşındığında veya belirli bir adıma ulaştığında bir dizi eylem tetiklenmelidir: onboarding, yapılandırma, materyal gönderimi. Papo API'siyle bu geçişi insan müdahalesi olmadan düzenleyebilir, kapanan her satışın doğru projede sorumlu ve son tarih tanımlanmış bir görev oluşturmasını sağlayabilirsiniz.
API ile otomasyon akışına genel bakış
| Adım | Eylem | Açıklama |
|---|---|---|
| 1. Kimlik doğrulama | Papo panelinde API anahtarı oluştur | Harici çağrıları yetkilendirmek için kimlik bilgileri. |
| 2. Satış hunisini izleme | Kanban kartları uç noktasını sorgula | Durum değiştiren fırsatları belirle (ör. lead_status=won). |
| 3. Görev oluşturma | Projelerde görev oluşturma uç noktasını çağır | Projenin Kanban panosunda kart oluştur, kişiyi ve satış verilerini bağla. |
| 4. Yürütme | Operasyon ekibi görevi Projeler modülünde görüntüler | Teslimat normal akışı izler, tam izlenebilirlikle. |
API üzerinden görev oluşturma nasıl çalışır?
Papo API'si, Kanban ve Projeler modülleri için uç noktalar sunar. Bu çağrıları birleştirerek CRM ile teslimat yönetimi arasında otomatik bir köprü kurarsınız.
1. API anahtarlarınızı alın
Herhangi bir entegrasyondan önce Papo paneline gidin, Geliştiriciler (veya API) bölümüne ilerleyin ve gizli bir anahtar (sk_live_...) oluşturun. Bu anahtar tüm isteklerin Authorization: Bearer sk_live_... başlığında kullanılacaktır. Genel anahtar (pk_live_...) hesabınızı tanımlar, ancak kimlik doğrulama gizli anahtara bağlıdır. Güvenli bir yerde saklayın — tekrar gösterilmeyecektir.
2. Kanban kartlarını izleyin
Otomasyonun ilk adımı, bir fırsatın hunide ilerlediğini algılamaktır. Kanban API'si, duruma göre filtrelerle kartları listelemenizi sağlar. Örneğin:
- Periyodik olarak henüz görev oluşturmamış
lead_status=won(kazanılmış fırsatlar) tüm kartları sorgulayın. - Veya otomasyon aracınız destekliyorsa kart güncelleme webhook'una tepki verin (resmi dokümantasyonda kullanılabilir etkinlik olup olmadığını kontrol edin).
n8n/Zapier'de bir betik veya iş akışıyla kart listeleme uç noktasına sorgu planlar, sonuçları filtreler ve yalnızca kritere uyan kartlar için görev oluşturmayı tetiklersiniz.
3. Projede görevi oluşturun
Kart verilerine (kişi, fırsat başlığı, tutar vb.) sahip olduğunuzda, Projelerde görev oluşturma uç noktasına bir çağrı yaparsınız. Tipik parametreler şunları içerir:
- project_id: hedef projenin tanımlayıcısı (ör. "Onboarding" veya "Satış sonrası teslimatlar").
- title: görev başlığı; kişi ve fırsat adından oluşturulabilir.
- description: karttan çıkarılan bağlam özeti.
- priority: acil, yüksek, orta veya düşük.
- due_date: hesaplanan son tarih, örneğin kapanıştan 5 gün sonra.
- assignee: yürütmeden sorumlu kişi (sabit olabilir veya kurala göre belirlenebilir).
API yanıtı oluşturmayı doğrular ve görev kimliğini döndürür. Bundan sonra görev, seçilen projenin Kanban panosunda görünür ve operasyon ekibi için hazırdır.
4. Yürütmeyi takip edin
Görev oluşturulduktan sonra Projeler modülünün normal döngüsünü izler: ekip kartı sütunlar arasında taşır, yorum ekler ve tamamlandı olarak işaretler. Satış temsilcisi veya yönetici, CRM'den çıkmadan ilerlemeyi kontrol edebilir; çünkü Papo, orijinal fırsat ile teslimat arasındaki izlenebilirliği korur.
n8n ile pratik örnek (kavramsal)
Uygulama ayrıntıları resmi API dokümantasyonuna bağlı olsa da (papo.global/pt/docs adresinde mevcuttur), n8n gibi bir araçtaki mantıksal akış şöyle olur:
- Cron Node: her 15 dakikada bir tetikler.
- HTTP Request Node (Papo API): Kanban kart listeleme uç noktasına GET;
lead_status=wonve yakın kapanış tarihi filtresiyle. - IF Node: yeni kart olup olmadığını kontrol eder (henüz işlenmemiş).
- HTTP Request Node (Papo API): kart verilerini kullanarak görev oluşturma uç noktasına POST.
- Güncelleme düğümü (isteğe bağlı): yinelenmeyi önlemek için orijinal kartı bir etiket veya özel alanla işaretler.
Aynı mantık Zapier, Make veya Python/JavaScript betikleri için de geçerlidir.
Bu entegrasyon kimler için uygundur?
- Danışmanlı satış döngüsü olan B2B operasyonları, kapanışın zorunlu olarak teknik teslimat veya onboarding başlattığı durumlar.
- Papo'nun Kanban ve Projeler modüllerini zaten kullanan ve ekipler arasında manuel bilgi aktarımını ortadan kaldırmak isteyen şirketler.
- Haftada düzinelerce yeni müşteri alan ve standart bir akışa ihtiyaç duyan CS ve kurulum ekipleri.
- CRM'i harici proje yönetim sistemleriyle entegre ederek müşterilerine gelişmiş otomasyon sunmak isteyen white label bayiler.
Sıkça sorulan sorular
### Kanban'daki değişiklikleri algılamak için webhook gerekli mi?
Papo API'si kart sorgulama uç noktaları sunar. Resmi dokümantasyon webhook içeriyorsa, gerçek zamanlı bildirim almak için bunları kullanabilirsiniz. Aksi halde periyodik sorgulama (polling) uygulanabilir ve yaygın olarak kullanılan bir alternatiftir.
### API üzerinden herhangi bir projede görev oluşturabilir miyim?
Evet. Etkin projenin kimliğine sahip olduğunuz sürece, görev oluşturma uç noktası hedef projeyi belirtmenize olanak tanır. Farklı teslimat türleri için ayrı projeler tutabilirsiniz (ör. "Onboarding", "Teknik destek", "Özelleştirmeler").
### API ile oluşturulan görev fırsatın kişisini devralır mı?
Evet. İsteği oluştururken Kanban kartıyla ilişkili kişiyi bağlayabilirsiniz. Böylece operasyon ekibi görev içinde doğrudan görüşme geçmişine ve müşteri verilerine erişir.
### Otomatik olarak bir sorumlu tanımlamak mümkün mü?
Evet. Görev oluşturma uç noktası sorumlu (assignee) alanını kabul eder. Sabit bir değer tanımlayabilir, round-robin mantığı kullanabilir veya kart özelliklerine (ör. sorumlu satış temsilcisi) göre belirleyebilirsiniz.
### Yinelenen görev oluşturmayı nasıl önlerim?
Hangi fırsatların zaten görev oluşturduğunu kaydetmek için harici bir kontrol (veritabanı, elektronik tablo veya kartta özel alan) tutmanız önerilir. Yeni bir görev oluşturmadan önce akış, o kartın daha önce işlenip işlenmediğini kontrol eder.
### Uç noktaların tam listesini nerede bulurum?
Tüm uç noktalar, parametreler ve kod örnekleriyle birlikte ayrıntılı teknik dokümantasyon papo.global/pt/docs adresinde herkese açıktır.
Ayrıca okuyun
- Papo API'sini kullanarak konuşmaları listeleme ve programatik mesaj gönderme
- Papo'da otomasyonlar: Kurallar, Makrolar, Flowlar ve Webhook'lar – hangisini kullanmalı?
Papo'nun ücretsiz planıyla API anahtarlarınızı oluşturup Kanban ve Projeler arasındaki görev otomasyonunu test edebilirsiniz.