Diğer Sistemlerle Entegrasyon İçin API Anahtarları Nasıl Oluşturulur ve Kullanılır

Q: ### Genel anahtarı web sitemin ön ucunda kullanabilir miyim?

Evet, genel anahtar (pk_live_...), web sitenizin JavaScript kodu gibi herkese açık ortamlarda güvenli bir şekilde kullanılmak üzere tasarlanmıştır. İşlevi yalnızca hesabınızı tanımlamaktır, eylemleri doğrulamak değildir. Gizli anahtar ise asla istemci tarafı kodunda ifşa edilmemelidir.

Q: ### Papo API'si ile Webhook arasındaki fark nedir?

Temel fark, iletişimi kimin başlattığıdır. API ile sisteminiz eylemi başlatır: Papo'dan veri "çekersiniz" (pull) veya Papo'ya bir şeyler yapmasını "istersiniz" (push), örneğin bir mesaj göndermek gibi. Webhook ile Papo eylemi başlatır: belirli bir olay gerçekleştiğinde (örn: bir kişi bir Akışın bir aşamasına ulaştığında) verileri sisteminize otomatik olarak "iter" (push).

Hesabınızı CRM'ler, ERP'ler veya otomasyon platformları (n8n, Zapier) gibi harici sistemlerle entegre etmek için Papo (https://papo.global/), doğrudan kontrol panelinizden oluşturulabilen ve yönetilebilen API (Uygulama Programlama Arayüzü) anahtarları sunar. Bu anahtarlar, diğer yazılımların Papo hesabınıza programatik olarak erişmesine ve işlem yapmasına izin veren güvenli kimlik bilgileri olarak işlev görür.

Papo API'si, WhatsApp mesajları göndermekten nitelikli potansiyel müşterileri çıkarmaya kadar çeşitli görevleri otomatikleştirerek bağlantılı çalışma ekosistemleri oluşturmanıza olanak tanır. Güvenliği sağlamak için Papo, iki anahtarlı bir sistem kullanır: tanımlama için genel bir anahtar ve kimlik doğrulama için gizli bir anahtar.

Anahtar Türü	Açıklama	Güvenlik Seviyesi	Kullanım Örneği
Genel Anahtar (`pk_live_...`)	Papo hesabınız için benzersiz ve sabit bir tanımlayıcı.	Düşük. Herkese açık olarak ifşa edilebilir.	Web sitenizin ön ucundaki bir betikte hesabınızı tanımlamak.
Gizli Anahtar (`sk_live_...`)	API için bir "şifre". İsteklerinizi doğrular ve hesabınız adına işlem yapma izni verir.	Yüksek. Kesinlikle gizli tutulmalıdır.	Bir mesaj göndermek için sunucunuzdan (arka uç) bir API çağrısını doğrulamak.

API Anahtarlarınızı Nasıl Oluşturur ve Bulursunuz

API anahtarları, Papo hesabınızın belirli bir alanında yönetilir. Bunlara erişmek için aşağıdaki adımları izleyin.

Papo kontrol panelinize giriş yapın ve Ayarlar'a gidin.
Ayarlar menüsünde, Geliştiriciler veya API bölümünü arayın.
Bu sayfada, sabit olan ve istediğiniz zaman kopyalayabileceğiniz Genel Anahtarınızı (pk_live_...) bulacaksınız.
Gizli Anahtar için yeni bir anahtar oluşturmanız gerekecek. Yeni bir anahtar oluşturmak için düğmeye tıklayın.
Anahtarın nerede kullanılacağını belirten açıklayıcı bir ad verin (örn: "CRM Entegrasyonu", "N8N Otomasyonu"). Bu, gerektiğinde belirli anahtarları tanımlamanıza ve iptal etmenize yardımcı olur.
Oluşturulduktan sonra, Gizli Anahtar (sk_live_...) yalnızca bir kez görüntülenecektir. Kopyalayın ve bir şifre yöneticisi veya sunucunuzdaki bir ortam değişkeni gibi güvenli bir yerde saklayın. Güvenlik nedenleriyle Papo, anahtarın orijinal değerini saklamaz ve tekrar görüntüleyemez.

Gizli bir anahtarı kaybederseniz veya sızdığından şüpheleniyorsanız, kontrol panelinden hemen iptal edin ve yeni bir anahtar oluşturun.

API'de Kimlik Doğrulama İçin Anahtarları Nasıl Kullanılır

Papo API'si ile özel veri erişimi veya eylemleri içeren tüm iletişimler doğrulanmalıdır. Bu, gizli anahtarın bir HTTP başlığında gönderilmesiyle yapılır.

Tüm API çağrıları için temel URL şudur: https://app.papo.global/api/v1

Kimlik doğrulamak için, isteğinizin Authorization başlığına Bearer kelimesinden önce gizli anahtarınızı ekleyin.

Hesap verilerini almak için curl ile örnek istek:

curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_SUA_CHAVE_SECRETA_AQUI"

Bu örnekte:

sk_live_SUA_CHAVE_SECRETA_AQUI gerçek gizli anahtarınızla değiştirilmelidir.
/me uç noktası, kimliği doğrulanmış hesap hakkında bilgi döndürür ve anahtarınızın çalışıp çalışmadığını kontrol etmek için iyi bir test görevi görür.

Genel anahtar (pk_live_...) isteğe bağlı olarak X-Papo-Public-Key başlığında ek bir doğrulama olarak gönderilebilir, ancak ana kimlik doğrulama her zaman gizli anahtar tarafından yapılır.

Papo API'si ile Neler Yapabilirsiniz?

API, operasyonlarınızı otomatikleştirmek ve entegre etmek için geniş bir yelpazede olanaklar sunar. İşte yapabileceklerinizden bazı örnekler:

WhatsApp mesajları gönderin: Bağlı numaralarınızdan biri aracılığıyla bildirimler, uyarılar veya işlemsel mesajlar göndermek için betikler oluşturun.
Extrator'dan kişileri alın: CNPJ Extractor ile çıkardığınız potansiyel müşteri listesine erişerek bunları ana CRM'inizle senkronize edin.
Örnekleri yönetin: WhatsApp bağlantılarınızın durumunu listeleyin ve kontrol edin.
Yapay Zekayı Kullanın: Papo'nun yapay zeka motoruna metinler gönderin ve yapılandırılmış istemlerinize göre oluşturulan yanıtları alın.
Verileri senkronize edin: Dahili sistemlerinizi (ERP, BI) Papo'da oluşturulan verilerle güncel tutun.

Sıkça Sorulan Sorular (SSS)

### API'nin tam dokümantasyonunu nerede bulabilirim?

Tüm uç noktaları, parametreleri ve farklı dillerdeki (JavaScript, Python) kod örneklerini içeren ayrıntılı teknik dokümantasyon papo.global/pt/docs adresinde herkese açık olarak mevcuttur.

### Gizli anahtarım sızdı. Ne yapmalıyım?

Gizli anahtarınızın tehlikeye girdiğinden şüpheleniyorsanız, Papo kontrol panelinizdeki geliştirici alanına hemen erişin, sızan anahtarı listede bulun ve iptal etmek için tıklayın. İptal edildikten sonra, artık istekleri doğrulamak için kullanılamaz. Ardından, entegrasyonlarınızda eski anahtarın yerine yeni bir anahtar oluşturun.

### Kaç tane gizli anahtar oluşturabilirim?

Birden fazla gizli anahtar oluşturabilirsiniz. Entegre ettiğiniz her sistem veya ortam için farklı bir anahtar oluşturmak iyi bir güvenlik uygulamasıdır (örn: CRM'iniz için bir tane, otomasyon sisteminiz için bir tane, test ortamı için bir tane vb.). Bu, diğer sistemleri etkilemeden belirli bir sistemin erişimini iptal etmenize olanak tanır.

### Genel anahtarı web sitemin ön ucunda kullanabilir miyim?

Evet, genel anahtar (pk_live_...), web sitenizin JavaScript kodu gibi herkese açık ortamlarda güvenli bir şekilde kullanılmak üzere tasarlanmıştır. İşlevi yalnızca hesabınızı tanımlamaktır, eylemleri doğrulamak değildir. Gizli anahtar ise asla istemci tarafı kodunda ifşa edilmemelidir.

### Papo API'si ile Webhook arasındaki fark nedir?

Temel fark, iletişimi kimin başlattığıdır. API ile sisteminiz eylemi başlatır: Papo'dan veri "çekersiniz" (pull) veya Papo'ya bir şeyler yapmasını "istersiniz" (push), örneğin bir mesaj göndermek gibi. Webhook ile Papo eylemi başlatır: belirli bir olay gerçekleştiğinde (örn: bir kişi bir Akışın bir aşamasına ulaştığında) verileri sisteminize otomatik olarak "iter" (push).

### Papo API'si ile Resmi WhatsApp API'si arasındaki fark nedir?

Resmi WhatsApp API'si yalnızca WhatsApp kanalının işlevlerine odaklanmıştır. Papo API'si daha geniş ve daha güçlü bir soyutlama katmanıdır: yalnızca WhatsApp'ı değil, aynı zamanda CRM, Potansiyel Müşteri Çıkarıcı ve Yapay Zeka motoru gibi platformun diğer modüllerini de tek bir anahtar setiyle ve basitleştirilmiş bir şekilde kontrol etmenizi sağlar.

Ayrıca okuyun

Ücretsiz entegrasyona başlayın →

Otomasyonları ve entegrasyonları numaranızda test etmeniz için ilk kullanıcı ücretsizdir.