**[Papo](https://papo.global/) REST API'si ile mevcut etiketleri listeleyebilir, yeni etiketler oluşturabilir ve açık bir konuşması olan bir kişiye etiket uygulayabilirsiniz — hepsi kimlik doğrulamalı isteklerle, paneli açmadan. Bu, harici sistemler, CRM'ler veya otomasyon araçlarından hizmet kategorizasyonunu ve organizasyonunu otomatikleştirmenin programatik yoludur.**

Papo API'si, etiket yönetimini içeren Konuşmalar kaynaklarını sunar. Bunlarla ekibiniz tutarlı bir taksonomi koruyabilir, kampanyalardan önce kategoriler hazırlayabilir ve platformun diğer uç noktalarıyla aynı kimlik doğrulamayı kullanarak kişileri ve konuşmaları gerçek zamanlı olarak sınıflandırabilir.

## API üzerinden etiket işlemlerinin özeti

| İşlem | Ne yapar | Ne zaman kullanılır |
| :--- | :--- | :--- |
| Etiketleri listele | Hesapta kayıtlı etiketleri, görsel tanımlama için ad ve renk ile birlikte döndürür. | Hesap standardizasyonunu denetlemek veya etiketleri başka bir araçla senkronize etmek için. |
| Etiket oluştur | Bir kişiye uygulamadan hesapta bir etiket oluşturur. | Toplu veya otomasyonlarda uygulamadan önce yeni kategoriler hazırlamak için. |
| Kişi + konuşmaya etiket uygula | Etiket henüz yoksa oluşturur ve kişiye ve açık konuşmaya uygular. | Konuşma geldiğinde triyaj, nitelendirme veya sınıflandırmayı otomatikleştirmek için. |

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

Etiket işlemleri dahil tüm yazma rotaları, 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 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.

## Pratikte nasıl kullanılır

1. Papo panelindeki geliştirici/API alanına erişin 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, belgelerde belirtilen başlıkta genel anahtarı gönderin.
3. Etiketleri listelemek için API'nin etiket listeleme uç noktasını çağırın. Yanıt, kayıtlı etiketleri getirir ve yenilerini oluşturmadan önce mevcut olanları haritalamanıza olanak tanır.
4. Uygulamadan bir etiket oluşturmak için, oluşturma uç noktasına etiket bilgilerini içeren bir JSON yükü gönderin. Tam format için resmi belgelere bakın.
5. Açık konuşması olan bir kişiye etiket uygulamak için etiketleme uç noktasını çağırın. Etiket henüz yoksa otomatik olarak oluşturulur ve kişiye ve açık konuşmaya uygulanır.

API REST olduğu ve JSON kullandığı için, HTTP desteği olan herhangi bir dil etiketleri betiklere, 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 mantıklı

- **Konuşmaları Papo arayüzünü açmadan sınıflandırmak için harici otomasyonlar kullanan ekipler.**
- **Kampanyalardan önce veya yeni bir hizmet taksonomisi uygularken toplu etiket oluşturması gereken operasyonlar.**
- **Papo'yu müşteri sistemlerine bağlayan ve hesaplar arasında tutarlı kategorizasyon sağlamak isteyen entegratörler ve white label bayiler.**
- **Kişiler ve mesajlar için zaten Papo API'sini kullanan ve akışı etiketlerle tamamlamak isteyen şirketler.**

## Sıkça sorulan sorular

### API üzerinden uygulamadan önce etiketi oluşturmam gerekiyor mu?

Hayır. API, etiket hesapta yoksa oluşturan ve kişiye ve açık konuşmaya uygulayan bir kaynağa sahiptir. Ayrıca, etiketi hiçbir kişiye uygulamadan yalnızca oluşturma seçeneği de vardır.

### API üzerinden uygulanan etiket kişi ve konuşma için geçerli mi?

Evet. Etiketleme kaynağı, etiketi kişiye ve açık konuşmaya uygular, hem potansiyel müşteri geçmişini hem de devam eden hizmeti sınıflandırmaya yardımcı olur.

### Kimlik doğrulama, Papo'nun diğer uç noktalarında kullanılanla aynı mı?

Evet. Yazma rotaları, Bearer token olarak gönderilen hesabın gizli anahtarını gerektirir. Genel anahtar isteğe bağlıdır ve gönderilirse aynı hesaba karşılık gelmelidir.

### 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 etiketler ve diğer kaynaklar için kod örnekleri hakkında ayrıntılar bulunur.

### Eski konuşmaları toplu olarak sınıflandırmak için API'yi kullanabilir miyim?

Platformda açıklanan uygulama kaynağı, kişi ve açık konuşma üzerinde etkilidir. Geçiş veya geriye dönük sınıflandırma gibi özel durumlar için, resmi belgelere başvurmak ve akış izin verdiğinde konuşma listelemesini sıralı çağrılarla birleştirmek en iyisidir.

## Ayrıca okuyun

- [Papo API'sini kullanarak toplu kişi oluşturma ve güncelleme](/hc/papo/articles/papo-api-ile-toplu-kisi-olusturma-ve-guncelleme)
- [Papo API'sini kullanarak WhatsApp mesaj şablonları (HSM) gönderme](/hc/papo/articles/papo-api-ile-whatsapp-hsm-gonderme)

---

**[Ücretsiz başla →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-ile-etiket-olusturma-ve-yonetme&utm_content=tr)**

Ücretsiz hesabınızı oluşturun ve WhatsApp, Instagram, e-posta ve SMS'i tek bir gelen kutusunda toplayın, hizmeti düzenlemek için etiketlerle.