Papo'da API aracılığıyla Takip Dizilerini yönetmek için, mevcut kadansları listeleyebilir, kişileri kaydedebilir ve özel nitelik güncellemesini kullanarak bir potansiyel müşterinin katılımını duraklatabilirsiniz — hepsi paneli açmadan, kimlik doğrulamalı isteklerle. Bu, potansiyel müşteri beslemeyi CRM'lere, ERP'lere ve harici otomasyon akışlarına entegre etmenin yoludur.
API İşlemlerinin Özeti
| İşlem | Açıklama | API Nasıl Gerçekleştirir |
|---|---|---|
| Dizileri listele | Hesaptaki tüm takip kadanslarını ad, tanımlayıcı ve durum (aktif/pasif) ile alın. | "sequence" türüne göre filtreleyerek flows uç noktasına kimlik doğrulamalı GET isteği. |
| Kişi kaydet | Mevcut bir kişiyi aktif bir diziye ekleyin, mesaj yolculuğunu başlatın. | Kayıt uç noktasına kişi kimliği ve dizi kimliği ile POST isteği. |
| Bir kişi için kadansı duraklat | Bir potansiyel müşteriyi diziden çıkarmadan gönderimleri geçici olarak durdurun. | Kişinin özel niteliğini (örn. status_pausa) kişiler API'si aracılığıyla güncelleyin, Flow'daki koşulla birleştirin. |
Kimlik doğrulama ve uç noktalar nasıl çalışır?
Tüm işlemler, hesabın gizli anahtarı (Bearer token) ile kimlik doğrulanan Papo REST API'sini kullanır. Temel URL https://app.papo.global/api/v1'dir. Anahtarlar panelde, geliştirici alanında oluşturulur.
Dizi kaynakları flows uç noktalarında gruplanmıştır. API, "sequence" türü dahil tüm flow'ları listelemeye ve bir flow'u tamamen etkinleştirmeye/devre dışı bırakmaya izin verir. Bir kişiyi kaydetmek için, kişi tanımlayıcısını ve flow tanımlayıcısını alan özel bir uç nokta vardır.
Her uç noktanın tam ayrıntıları (parametreler, yükler ve örnekler) Papo API'sinin resmi belgelerinde mevcuttur. Burada, takip dizilerini yönetmeye yönelik iş akışına odaklanıyoruz.
Adım adım: listeleme, kaydetme ve duraklatma
1. Mevcut dizileri listeleme
Potansiyel müşterileri kaydetmeden önce, hangi dizilerin var olduğunu ve tanımlayıcılarını bilmeniz gerekir. Listeleme çağrısı, ad, kimlik ve durum (aktif/pasif) içeren bir ilişki döndürür. Yalnızca aktif diziler yeni kayıtları kabul eder.
Liste elinizdeyken, harici sisteminiz her potansiyel müşteri için hangi dizinin kullanılacağını eşleştirebilir.
2. Bir kişiyi diziye kaydetme
Kişi kimliği (kişiler API'si aracılığıyla arama veya oluşturma ile elde edilir) ve aktif dizi kimliği ile, onu yolculuğun başına eklemek için bir istek gönderirsiniz. Kişinin Papo CRM'inde var olması gerekir; aksi takdirde, kişiler uç noktasını kullanarak önce oluşturun.
Kayıt, Flow'da yapılandırılan aralıklara uyarak programlanmış mesajların gönderimini hemen başlatır. Kişinin geçmişi korunur.
3. Belirli bir kişi için kadansı duraklatma
Papo API'si, bir kişinin bir diziye katılımını "duraklatmak" için doğrudan bir komuta sahip değildir. Ancak, kişiler API'sini Flow'daki bir koşulla birleştirerek aynı etkiyi elde edebilirsiniz.
Ön koşul: dizi, özel bir niteliği (örn. status_pausa) kontrol eden bir koşul düğümü ile oluşturulmuş olmalıdır. Nitelik "duraklatıldı" değerine eşitse, koşul sonraki mesajların gönderimini engeller; aksi takdirde serbest bırakır. (Flow oluşturma ayrıntıları için geçici duraklatma makalesine bakın.)
Flow'daki bu yapıyla, duraklatma API aracılığıyla iki adımda yapılır:
- Kişiyi kimliğine göre tanımlayın veya kişi listeleme uç noktasını kullanarak telefon/e-posta ile arayın.
- Kişinin özel niteliğini "duraklatıldı" (veya koşulunuzun beklediği değeri) olarak güncelleyin. Kişi güncelleme uç noktasını kullanarak özel alanı gönderin.
Bu andan itibaren, akış koşula ulaştığında "duraklatıldı" değerini tanımlayacak ve mesajı göndermeyecektir. Devam etmek için, niteliği başka bir değere (örn. "aktif") güncellemeniz veya temizlemeniz yeterlidir; kişi kaldığı yerden devam eder.
Bu yöntem, kişiyi kayıtlı ve kadansdaki ilerlemeyi geçmişi kaybetmeden korur.
Bu entegrasyon kimler için faydalıdır?
- Harici olaylardan dizileri tetikleyen SDR ve B2B satış operasyonları (örn. bir potansiyel müşteri bir materyal indirdi, CRM'de bir fırsat oluşturuldu).
- Yeni müşteriler için otomatik olarak takip yolculukları sağlayan, başlangıç kişilerini manuel işlem olmadan kaydeden white label bayiler.
- Papo'yu onlarca sisteme bağlamak için n8n veya Zapier gibi araçları kullanan ve kadanslar üzerinde ayrıntılı kontrole ihtiyaç duyan pazarlama ve otomasyon ekipleri.
- Koşullu duraklatma süreçleri olan şirketler, burada bir potansiyel müşteri biraz zaman ister ve satış temsilcisi kadans noktasını kaybetmeden diziyi durdurmak ister — hepsi harici CRM'deki bir düğmeyle tetiklenir.
Sıkça Sorulan Sorular
Dizileri listelemek için gizli anahtara ihtiyacım var mı?
Evet. Hesap verilerini döndüren her işlem, Authorization başlığında Bearer token olarak gönderilen gizli anahtarla kimlik doğrulaması gerektirir.
Papo'da henüz var olmayan bir kişiyi kaydedebilir miyim?
Hayır. Kişinin Papo CRM'inde var olması gerekir. Önce kişiler API'si aracılığıyla (ad, telefon veya e-posta ile) oluşturabilir, ardından diziye kaydedebilirsiniz.
API, bir kişiyi diziden çıkarmama izin veriyor mu?
Çıkarma (kaydı iptal etme) mevcut sürümde özel bir uç nokta olarak mevcut değildir. Gönderimleri durdurmak için alternatif, açıklandığı gibi özel nitelik aracılığıyla duraklatmak veya tüm kişileri etkileyen flow'u tamamen devre dışı bırakmaktır.
Nitelik aracılığıyla duraklatmanın işe yaradığını nasıl anlarım?
Nitelik güncellendikten sonra, dizi bekleme düğümlerini işlemeye devam eder. Koşula ulaştığında değeri kontrol eder. "duraklatıldı" ise mesaj gönderilmez. Kişi profilinde, Kişiler modülünde, kayıtlı kaldığını ancak sonraki mesajların gönderilmediğini doğrulayabilirsiniz.
API aracılığıyla tüm diziyi duraklatabilir miyim?
Evet. API, bir flow'un durumunu pasif olarak değiştirmeye izin verir ve tüm kişiler için diziyi duraklatır. Flow etkinleştirme/devre dışı bırakma uç noktasını kullanın. Devam etmek için yeniden etkinleştirmeniz yeterlidir.
Tam uç noktaları ve kod örneklerini nerede bulabilirim?
API'nin tam belgeleri https://papo.global/pt/docs adresinde mevcuttur. Orada flows, kişiler uç noktalarını ve istek formatlarını bulabilirsiniz.
Ayrıca okuyun
- Papo API'sini kullanarak otomasyon Flow'larını yönetme
- Papo API'sini kullanarak toplu kişi oluşturma ve güncelleme
Ücretsiz başlayın ve dizilerinizi otomatikleştirin →
Papo API'si ile potansiyel müşteri beslemeyi doğrudan yığınınıza entegre edin, paneli açmadan — ilk kullanıcı test etmeniz için ücretsizdir.