**[Papo](https://papo.global/) REST API'si ile paneli açmadan ekip yönetimini otomatikleştirebilirsiniz: takımları listeleme, takım oluşturma, bir takımın üyelerini listeleme, takıma kullanıcı ekleme ve gelen kutularını listeleme veya oluşturma. Bu, hizmet yapısını harici sistemler, büyük operasyonlar ve white label bayiliklerle senkronize tutmanın programatik yoludur.**

Papo API'si, platformun diğer uç noktalarıyla aynı kimlik doğrulamayı kullanarak takım ve gelen kutusu kaynaklarını sunar. Bunlarla ekibiniz, panelde manuel müdahale olmadan yeni yapılar oluşturabilir, her grupta kimin olduğunu denetleyebilir ve konuşma yönlendirmesini hazırlayabilir.

## API ile takım ve üye işlemlerine genel bakış

| İşlem | Ne yapar | Ne zaman kullanılır |
| :--- | :--- | :--- |
| Takımları listele | Hesapta kayıtlı takımları döndürür. | Yeni bir takım oluşturmadan önce yapıyı denetlemek için. |
| Takım oluştur | Ad ve isteğe bağlı açıklama ile bir takım oluşturur. | Script, ERP veya CRM aracılığıyla yeni bir ekip oluşturmak için. |
| Bir takımın üyelerini listele | O takıma dahil olan kullanıcıları döndürür. | Kimin dahil olduğunu kontrol etmek ve yanlış erişimleri önlemek için. |
| Takıma kullanıcı ekle | Virgülle ayrılmış ID'leri belirterek bir veya daha fazla kullanıcı ekler. | Takımı güncel ajan kadrosuyla senkronize etmek için. |
| Gelen kutularını listele | Yönetici görünümünde kanallarıyla birlikte gelen kutularını döndürür. | Mevcut kanalları ve nasıl düzenlendiklerini kontrol etmek için. |
| Gelen kutusu oluştur | Yeni bir gelen kutusu oluşturur. | Takım yapısıyla birlikte yeni kanallar oluşturmak için. |

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

Takım ve üye işlemleri dahil olmak üzere yazma işlemleri, hesabın gizli anahtarını gerektirir. Yetkilendirme 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 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.

## API ile takım ve üyeleri yönetmek için adım adım kılavuz

1. Papo panelindeki geliştirici/API alanına gidin ve bir gizli anahtar oluşturun. Ek doğrulama istiyorsanız hesabın genel anahtarını da kopyalayın.
2. Her istekte, gizli anahtarla Bearer token olarak kimlik doğrulaması yapın. Doğrulamayı güçlendirirseniz, belgelerde belirtilen başlıkta genel anahtarı gönderin.
3. Yeni takımlar oluşturmadan önce mevcut yapıyı haritalamak için mevcut takımları listeleyin.
4. Ad ve gerekirse açıklama içeren bir JSON yükü göndererek bir takım oluşturun. Tam format için resmi belgelere bakın.
5. Kimin zaten dahil olduğunu denetlemek ve yinelenmeyi önlemek için takımın üyelerini listeleyin.
6. Virgülle ayrılmış ID'leri belirterek takıma kullanıcı ekleyin. Bu adım, takımı güncel ajan kadrosuyla senkronize eder.
7. Mevcut kanalları kontrol etmek ve gerektiğinde gelen kutuları oluşturmak için API'yi kullanmak üzere yönetici görünümüyle gelen kutularını listeleyin.

API REST olduğu ve JSON kullandığı için, HTTP desteği olan herhangi bir dil takımları ve üyeleri script'lere, ERP'lere, CRM'lere veya otomasyon araçlarına entegre etmek için kullanılabilir. `https://papo.global/pt/docs` adresindeki resmi belgeler, kimlik doğrulama, parametreler, yanıtlar ve kod örnekleri hakkında ayrıntılar içerir.

## Bu entegrasyon kimler için anlamlı

- **Büyük operasyonlar**: paneli manuel olarak açmadan sık sık takım oluşturması ve ayarlaması gerekenler.
- **BT ve otomasyon ekipleri**: ajan yapısını dizinler, İK veya dahili sistemlerle senkronize edenler.
- **White label bayileri**: aynı takım ve gelen kutusu mantığını yeniden kullanarak müşteri hesaplarını standart bir şekilde oluşturanlar.
- **Papo API'sini zaten kullanan şirketler**: kişiler ve konuşmalar için kullanan ve akışı ekip yönetimiyle tamamlamak isteyenler.

API, takım yapısını ve üye eklemeyi yönetir. Ajan veya Yönetici gibi kullanıcı rolleri ve ayrıntılı izinler panelde tanımlanmaya devam eder. Bir kullanıcıyı bir takıma ekleyip ilgili gelen kutularına bağladığınızda, konuşmalara operasyonel erişimi kontrol edersiniz.

## Sıkça sorulan sorular

### Papo API'si Ajan veya Yönetici gibi kullanıcı rolünü tanımlar mı?

Hayır. Takım ve üye API'si, takım oluşturma, üye listeleme ve kullanıcı ekleme işlemlerine odaklanır. Her kullanıcının rolü ve izinleri panelde tanımlanır. Bir kullanıcıyı bir takıma ve doğru gelen kutularına ekleyerek operasyonel konuşmalara erişimi kısıtlarsınız.

### Aynı adımda üye eklemeden bir takım oluşturabilir miyim?

Evet. API, hemen kullanıcı eklemeden ad ve isteğe bağlı açıklama ile bir takım oluşturmanıza olanak tanır. Daha sonra toplu ekleme işlemini kullanarak üye ekleyebilirsiniz.

### API isteklerde hesabı nasıl tanımlar?

Bearer token olarak gönderilen gizli anahtar ile. Genel anahtar isteğe bağlıdır ve gönderilirse gizli anahtarla aynı hesaba karşılık gelmelidir.

### Bu API white label bayiliği için çalışır mı?

Evet. Bayiler, müşteri hesaplarında takımları ve üyeleri standart bir şekilde oluşturmak için API'yi kullanabilir, manuel yapılandırmayı azaltabilir ve operasyonlar arasında tutarlılığı koruyabilir.

### Tam yolları ve yük formatını nerede bulabilirim?

`https://papo.global/pt/docs` adresinde bulunan resmi API belgelerinde. Orada kimlik doğrulama, parametreler, yanıtlar ve takımlar, üyeler ve diğer kaynaklar için kod örnekleri hakkında ayrıntılar bulunur.

## Ayrıca okuyun

- [Papo API'sini kullanarak etiketler (tags) oluşturma ve yönetme](/hc/papo/articles/papo-api-ile-etiket-olusturma-ve-yonetme)
- [White label platformunuzda kullanıcıları ve izinleri yönetme](/hc/papo/articles/white-label-bayinizde-kullanicilari-ve-izinleri-nasil-yonetirsiniz)

---

**[Ücretsiz başlayın ve API ile takımları ve üyeleri otomatikleştirin →](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)**

İlk kullanıcı sonsuza kadar ücretsizdir, böylece operasyonunuzu yapılandırmadan önce entegrasyonu doğrulayabilirsiniz.