Papo API'si ile otomasyon Flow'larını yönetme

Papo'nun REST API'siyle Papo hesabınızdaki tüm Flow'ları listeleyebilir, yolculukları etkinleştirebilir veya devre dışı bırakabilir ve kişileri otomasyonlara programatik olarak kaydedebilirsiniz — hepsi kimlik doğrulamalı isteklerle, paneli açmadan. Bu, Flow motorunu harici sistemler, n8n iş akışları, CRM'ler veya dahili scriptlerle entegre etmenin yoludur.

Papo API'si, otomasyonları gelen kutuları veya kişileri yönettiğiniz gibi yönetmenizi sağlayan Flow kaynaklarını sunar. Bu API ile geliştirme ekipleri, entegratörler ve white label bayiler, hangi yolculukların etkin olduğunu toplu olarak kontrol edebilir, kişileri sekanslarda başlatabilir ve otomasyonların durumunu iş süreçleriyle senkronize edebilir.

API üzerinden Flow işlemlerinin özeti

API kimlik doğrulaması nasıl çalışır

Flow'ları içerenler dahil tüm API çağrıları, hesabın gizli anahtarını gerektirir. Authorization başlığında Bearer token olarak gönderilmelidir. Hesabın genel anahtarı isteğe bağlıdır, ancak gönderilirse gizli anahtarla aynı hesaba karşılık gelmelidir.

API'nin temel URL'si https://app.papo.global/api/v1'dir. Anahtarlar Papo panelinin geliştirici alanında oluşturulur. Gizli anahtar oluşturma sırasında yalnızca bir kez görünür; güvenli bir yerde saklayın ve sızma şüphesi varsa iptal edin.

Kimlik doğrulama deseni tüm uç noktalarda kullanılanla aynıdır:

curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"

API üzerinden Flow'ları pratikte yönetme

Her uç noktanın ve parametrenin tam ayrıntıları resmi API belgelerinde yer alsa da, genel çalışma akışı şu kavramsal adımları izler:

1. Kimlik doğrulaması yapın hesabı doğrulamak için gizli anahtarla (ve isterseniz genel anahtarla).
2. Flow'ları listeleyin mevcut yolculuk listesini tanımlayıcıları ve durumlarıyla birlikte almak için. Bu, halihazırda ne olduğunu haritalamanıza ve sonraki işlemler için doğru Flow'u seçmenize olanak tanır.
3. Durumu değiştirin gerekirse belirli bir Flow'un. Flow'u etkin (kişi almaya açık) veya devre dışı (duraklatılmış) olarak ayarlayan bir istek gönderin. Yalnızca etkin Flow'lar kişileri işler ve kayıtları kabul eder.
4. Bir kişiyi kaydedin etkin bir Flow'a. Kişiyi yolculuğun başına eklemek için kişi tanımlayıcısını ve istediğiniz Flow'un tanımlayıcısını bildirin. Kişinin CRM'deki geçmişi korunur.
5. Harici sistemlerle entegre edin — webhook'lar veya doğrudan çağrılar aracılığıyla, harici bir formdan, başka bir sistemdeki olaydan veya bir veri hattından gelen kişileri başlatabilirsiniz.

Platform ayrıca boş ve devre dışı Flow'lar oluşturmayı ve düğümlerinin API üzerinden doldurulmasını destekler; bu da eksiksiz otomasyonları programatik olarak sağlamayı mümkün kılar. Tam payload biçimleri, zorunlu alanlar ve kod örnekleri için Papo API belgelerindeki Flow bölümüne bakın.

Bu entegrasyon kimler için anlamlı

• Birden fazla otomasyon işleten BT ekipleri ve paneli manuel olarak açmadan Flow'ları toplu halde duraklatması, yeniden etkinleştirmesi veya izlemesi gerekenler.
• White label bayileri her yeni müşteri için otomatik olarak standart yolculuklar sağlamak, başlangıç kişilerini kaydetmek ve platformlar arasında uyumu korumak isteyenler.
• Entegratörler ve geliştiriciler Papo'yu CRM'lere, ERP'lere veya n8n gibi araçlara bağlayan ve harici olaylardan (bir satın alma, bir kayıt, bir randevu) Flow'ları tetikleyenler.
• Koşullu kayıtla çalışan operasyonlar, kişilerin yalnızca diğer sistemlerde tanımlanan iş kurallarından geçtikten sonra Flow'lara dahil edildiği durumlar.

Sık sorulan sorular

Flow'ları listelemek için gizli anahtara ihtiyacım var mı?

Evet. Flow'ları listeleme, hesap verilerini döndüren her işlem gibi gizli anahtarla kimlik doğrulama gerektirir. Desen diğer tüm uç noktalarla aynıdır: Authorization başlığında Bearer token gönderin.

API üzerinden bir Flow'u etkinleştirip devre dışı bırakabilir miyim?

Evet. API, bir Flow'un durumunu etkin ve devre dışı arasında değiştirmenize olanak tanır. Flow'un tanımlayıcısına ve gizli anahtara ihtiyacınız vardır. Devre dışı Flow'lar kişi almaz ve kayıt denenmiş olsa bile yolculukta ilerlemez.

API üzerinden bir kişiyi Flow'a nasıl kaydederim?

Kayıt çağrısında kişi tanımlayıcısını ve etkin Flow'un tanımlayıcısını sağlayın. Kişi, konuşma geçmişi veya profil verileri silinmeden yolculuğun başına eklenir. Resmi belgeler parametrelerin tam biçimini ayrıntılandırır.

API üzerinden sıfırdan bir Flow oluşturmak mümkün mü?

Evet. API, boş (yalnızca Start düğümü olan) ve devre dışı bir Flow oluşturmanıza, ayrıca düğümlerini sorular, mesajlar ve koşullarla doldurmanıza olanak tanır. Bu, otomasyonları ölçeklenebilir şekilde sağlamak için, özellikle bayilik veya yeni müşteri onboarding senaryolarında yararlıdır.

API listelerken her Flow'un durumunu döndürür mü?

Evet. Listeleme, her Flow ve sekansın durumunu (Etkin veya Devre dışı), ayrıca tanımlayıcı, ad ve türü içerir; bu da harici sistemlerin nelerin çalıştığını ve nelerin duraklatıldığını izlemesine olanak tanır.

Flow rotalarının tam belgelerini nerede bulurum?

Resmi belgeler https://papo.global/pt/docs adresinde mevcuttur. Orada tüm uç noktaları, kabul edilen parametreleri, hata kodlarını ve çeşitli dillerde örnekleri bulabilirsiniz. Flow rotaları, diğer modüllerle aynı REST ve kimlik doğrulama desenini izler.

Ayrıca okuyun

• Papo API'sini kullanarak kişileri toplu olarak oluşturma ve güncelleme
• Papo API'sini kullanarak etiketleri (tag'leri) oluşturma ve yönetme

Flow'larınızı hemen entegre etmeye başlayın →

Papo'da ücretsiz hesap oluşturun, API anahtarlarına erişin ve otomasyonlarınızı dış dünyaya bağlayın.