Papo Global API'sini (https://papo.global/) kullanmaya başlamak için panelden bir gizli anahtar oluşturmanız, istekleri Authorization başlığıyla kimlik doğrulamanız ve https://app.papo.global/api/v1 tabanına REST çağrıları yapmanız gerekir. İlk pratik test, basit bir cURL komutuyla Extrator kişilerini listelemektir.
Papo API'si REST'tir, JSON kullanır ve her kaynaktan gelen istekleri kabul eder (CORS açık). Onunla CRM'leri, otomasyon platformlarını (örneğin n8n), ERP'leri veya kendi arka ucunuzu Papo'nun müşteri hizmetleri, satış ve yapay zeka ekosistemine bağlayabilirsiniz.
Temel Unsurların Özeti
| Öğe | Açıklama |
|---|---|
Genel anahtar (pk_live_…) |
Hesabınızın sabit tanımlayıcısı, ön uçta açığa çıkarılabilir |
Gizli anahtar (sk_live_…) |
Kimlik doğrulama belirteci, gizli tutulmalı ve yalnızca sunucuda kullanılmalıdır |
| Kimlik doğrulama | Tüm çağrılarda Authorization: Bearer sk_live_... (veya X-Papo-Secret-Key) başlığı, GET /api/v1 hariç |
| Temel URL | https://app.papo.global/api/v1 |
| Örnek uç nokta | GET /api/v1/contacts — sayfalanmış olarak çıkarılan kişileri listeler (Extrator) |
İlk Çağrı için Adım Adım Kılavuz
1. API anahtarlarınızı oluşturun
Papo panelindeki geliştirici sayfasına gidin (app.papo.global/developers adresinde bulunur). Orada adlandırılmış bir gizli anahtar oluşturabilir — örneğin "ilk-test" — ve hemen kopyalayabilirsiniz. Anahtar yalnızca bir kez görüntülenir; bundan sonra yalnızca iptal edip yenisini oluşturabilirsiniz.
Genel anahtar (pk_live_…) hesap başına sabittir ve aynı sayfada her zaman görülebilir. İsteklerde isteğe bağlı olsa da, gönderirseniz gizli anahtarla aynı hesapla ilişkili olmalıdır.
2. Uç noktayı seçin
Bu kılavuz için, Extrator modülü tarafından çıkarılan potansiyel müşterileri listeleyen GET /api/v1/contacts uç noktasını kullanacağız. Sonuçları page (varsayılan 1) ve per_page (1 ila 100, varsayılan 20) parametreleriyle sayfalayabilirsiniz. Şirket, telefon veya e-posta ile aramak için q ile metin sorgusu da kabul edilir.
3. cURL ile çağrıyı yapın
Gizli anahtar elinizdeyken isteği oluşturun. Aşağıdaki örnek 20 adede kadar kişiyi listeler:
curl "https://app.papo.global/api/v1/contacts?page=1&per_page=20" \
-H "Authorization: Bearer sk_live_…"
sk_live_… yerine gizli anahtarınızı yazın. Alternatif başlığı kullanmak isterseniz, şunu yapın:
curl "https://app.papo.global/api/v1/contacts" \
-H "X-Papo-Secret-Key: sk_live_…"
Yanıt, success: true içeren ve verilerin data nesnesi içinde olduğu bir JSON'dur. Hata olursa, JSON success: false ve açıklayıcı kod ve mesaj içeren bir error nesnesi getirir.
Buradan itibaren, API sayfasında belgelenen diğer uç noktaları keşfedebilirsiniz: mesaj gönderme (POST /api/v1/messages), hesap ayrıntıları (GET /api/v1/me) veya yapay zeka ile metin tamamlama (POST /api/ai/v1/complete).
Bu Kılavuz Kimler İçin
Bu içerik, Papo'yu harici sistemlerle (CRM'ler, otomasyon araçları (örneğin n8n) veya kendi uygulamaları) entegre etmek isteyen geliştiricilere yöneliktir. Yalnızca kanalları bağlamak ve müşteri hizmetleri sunmak isteyen son kullanıcıysanız, Yardım Merkezi daha uygun başka makaleler sunar.
Sıkça Sorulan Sorular
Tüm çağrılarda genel anahtarı göndermem gerekiyor mu?
Hayır. Genel anahtar isteğe bağlıdır. Göndermeyi seçerseniz, kullanılan gizli anahtarın hesabıyla eşleşmelidir.
Gizli anahtarın süresi doluyor mu?
Otomatik olarak sona ermez. Sızıntıdan şüpheleniyorsanız, panelden istediğiniz zaman iptal edip yeni bir tane oluşturabilirsiniz.
API'yi ücretsiz bir hesapla test edebilir miyim?
Evet. Papo'nun ilk kullanıcısı ücretsizdir ve API'yi keşfetmek için anahtarlar oluşturabilirsiniz. Extrator gibi modüllere erişim, kullanıma bağlı olarak bakiye tüketebilir, ancak anahtar oluşturma ve temel okuma çağrıları ek ücret olmadan test edilebilir.
Gizli anahtarı kaybedersem ne yapmalıyım?
Geliştirici panelinde yeni bir adlandırılmış anahtar oluşturun. Önceki anahtar kurtarılamaz; yalnızca güvenlik için iptal edilebilir.
API'yi toplu mesaj göndermek için kullanabilir miyim?
Evet, POST /api/v1/messages uç noktası metin mesajları göndermenizi sağlar. Ancak, platformun izin politikalarına ve kullanım şartlarına uyun.
API yalnızca Extrator kişilerini mi listeler?
GET /api/v1/contacts uç noktası çıkarılan kişileri döndürür. Birleşik CRM veritabanını yönetmek (herhangi bir kişiyi aramak, oluşturmak ve güncellemek) için API'nin tam belgelerine başvurabilirsiniz.
Ayrıca okuyun: Papo API'sini kullanarak bir kayıt formu oluşturma ve CRM'i otomatik olarak doldurma · Papo API'sini kullanarak white label bayiliğinin kredi tüketimini ve faturalarını izleme
Papo Global'de ücretsiz başlayın →
İlk kullanıcı R$ 0, kredi kartı gerekmez. Daha fazla bilgi: papo.global.