**[Papo](https://papo.global/) REST API'siyle mevcut gelen kutularını listeleyebilir ve WhatsApp ile Instagram gibi kanallar için yeni bağlantılar oluşturabilirsiniz — hepsi paneli açmadan, kimliği doğrulanmış isteklerle. Bu, hizmet kanallarını programatik olarak hazırlamanın, harici sistemleri entegre etmenin ve çok kanallı operasyonu otomasyonla uyumlu tutmanın yoludur.** Papo API'si, mevcut yapılandırmayı sorgulamanıza ve yeni kanallar eklemenize olanak tanıyan gelen kutusu kaynaklarını sunar. Böylece BT ekipleri, entegratörler ve white label bayileri toplu olarak bağlantıları yönetebilir, kurulumları hesaplar arasında çoğaltabilir ve arayüze bağlı kalmadan kanal etkinleştirmeyi otomatikleştirebilir. ## API üzerinden gelen kutusu işlemlerinin özeti | İşlem | Ne yapar | Ne zaman kullanılır | | :--- | :--- | :--- | | Gelen kutularını listele | Hesabın gelen kutularını, ilişkili kanal (WhatsApp, Instagram, e‑posta, vb.) ve yapılandırma ayrıntılarıyla döndürür. | Etkin kanalları denetlemek, izleme sistemleriyle eşitlemek veya geçişleri hazırlamak. | | Gelen kutusu oluştur | Kanalı, adı ve erişimi olacak temsilcileri tanımlayarak yeni bir gelen kutusu oluşturur. | Yeni müşterileri, birimleri veya markaları entegre ederken kanalları otomatik olarak hazırlamak. | ## API kimlik doğrulaması nasıl çalışır Gelen kutularını listeleme 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` şeklindedir. Anahtarlar Papo panelindeki 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ğrulamayı doğrulamak için hesap verilerini döndüren `GET /api/v1/me` uç noktasını çağırabilirsiniz. Kimlik doğrulama düzeni diğer 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_…" ``` ## Gelen kutularını pratikte nasıl yönetirsiniz 1. Papo panelindeki geliştirici/API alanına gidin ve bir gizli anahtar oluşturun. Hesabın genel anahtarını da kopyalayın. 2. Her istekte gizli anahtarla Bearer token olarak kimlik doğrulayın. Doğrulamayı güçlendirmek isterseniz, `X-Papo-Public-Key` başlığında genel anahtarı gönderin. 3. **Gelen kutularını listelemek** için gelen kutusu listeleme uç noktasını çağırın. Yanıt, her gelen kutusunun tanımlayıcısını, yapılandırılmış kanalı ve diğer özellikleri getirir; böylece yenilerini oluşturmadan önce mevcut olanları haritalayabilirsiniz. 4. **Yeni bir gelen kutusu oluşturmak** için istenen kanalın bilgilerini içeren bir JSON payload gönderin — örneğin WhatsApp (Meta'nın resmi API'si), Instagram, e‑posta veya Telegram. Gelen kutusunun adını ve erişimi olması gereken temsilcilerin tanımlayıcılarını ekleyin. Alanların tam biçimi ve kabul edilen değerler için resmi dokümana bakın. 5. Oluşturulduktan sonra gelen kutusu panelde hemen kullanılabilir hale gelir ve kanal bağlantısı tamamlanır tamamlanmaz mesaj almaya başlar (WhatsApp gibi eşleştirme gerektiren kanallarda API gerekli talimatları döndürür). API REST olduğu ve JSON kullandığı için HTTP desteği olan herhangi bir dil, gelen kutusu yönetimini betiklere, otomasyon araçlarına (n8n gibi) veya hazırlama sistemlerine entegre etmek için kullanılabilir. `https://papo.global/pt/docs` adresindeki resmi doküman; kimlik doğrulama, parametreler, yanıtlar ve kod örnekleriyle ilgili ayrıntıları sunar. ## Bu entegrasyon kimler için anlamlı - **Yeni birimler, franchise'lar veya markalar için kanalları toplu olarak hazırlayan BT ekipleri**, panelde tek tek işlem yapmak zorunda kalmadan. - **White label bayileri**: her yeni müşteri için gelen kutusu oluşturmayı otomatikleştirmek ve yapılandırmayı standart tutmak isteyenler. - **Yapılandırmaları hesaplar arasında taşıyan veya çoğaltan operasyonlar**: denetlemek için listelemeyi, kanalları yansıtmak için oluşturmayı kullananlar. - **Papo'yu harici kanal yönetim sistemlerine bağlayan entegratörler**: hizmet ortamının değişiklikleri otomatik olarak yansıtmasını sağlayanlar. ## Sık sorulan sorular ### Gelen kutularını listelemek için gizli anahtara ihtiyacım var mı? Evet. Gelen kutusu listeleme, hesabın gizli anahtarıyla kimlik doğrulama gerektirir çünkü yapılandırmaya ilişkin hassas bilgileri döndürür. Düzen, diğer API çağrılarındakiyle aynıdır: `Authorization` başlığında Bearer token gönderin. ### API üzerinden WhatsApp için gelen kutusu oluşturabilir miyim? Evet. Bir gelen kutusu oluştururken istediğiniz kanal türünü belirtirsiniz — WhatsApp (Meta'nın resmi API'si) ve desteklenen diğer kanallar dahil. Payload, resmi dokümana göre seçilen kanal için beklenen biçimi izlemelidir. ### Mevcut bir gelen kutusunu API üzerinden güncellemek mümkün mü? Mevcut API, gelen kutularını listelemeye ve oluşturmaya izin verir. Var olan bir gelen kutusunun ayarlarını değiştirmek için (temsilcileri değiştirmek veya yeniden adlandırmak gibi) Papo panelini kullanabilir ya da gerekirse gelen kutusunu yeni parametrelerle yeniden oluşturabilirsiniz. ### Oluşturma sırasında bir gelen kutusuna temsilcileri nasıl ilişkilendiririm? Oluşturma payload'ında, gelen kutusuna erişimi olması gereken temsilcilerin tanımlayıcılarını belirtebilirsiniz. Bu ID'ler ekipler ve üyeler API'siyle alınabilir. Tam biçim için dokümana bakın. ### Kimlik doğrulama Papo'nun diğer uç noktalarında kullanılanla aynı mı? Evet. Hesap kaynaklarına erişen tüm çağrılar gizli anahtarı Bearer token olarak kullanır. Genel anahtar isteğe bağlıdır ve gönderilirse aynı hesaba karşılık gelmelidir. ### Tam yolları ve payload biçimini nerede bulabilirim? `https://papo.global/pt/docs` adresinde bulunan resmi API dokümanında. Gelen kutuları ve diğer kaynaklar için kimlik doğrulama, parametreler, yanıtlar ve kod örneklerine ilişkin ayrıntılar oradadır. ## Ayrıca okuyun - [Papo API'sini ekipleri ve üyeleri yönetmek için nasıl kullanırım](/hc/papo/articles/papo-api-ile-takimlari-ve-uyeleri-yonetme) - [Papo API'sini etiketler (tags) oluşturmak ve yönetmek için nasıl kullanırım](/hc/papo/articles/papo-api-ile-etiket-olusturma-ve-yonetme) --- **[Bağlantılarınızı otomatikleştirmeye hemen başlayın →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)** Ücretsiz hesap oluşturun ve kanalları paneli açmadan API üzerinden entegre edin.