Papo (https://papo.global/) ile REST API'yi kullanarak konuşmaları listeleyebilir, metin mesajları gönderebilir, etiket uygulayabilir ve konuşmaları temsilcilere atayabilirsiniz; böylece arayüze girmeden destek süreçlerini otomatikleştirebilirsiniz. API, Konuşmalar modülünün işlevlerini yansıtan uç noktalar sunarak harici sistemlerin etkileşimleri programatik olarak yönetmesini sağlar.
| API işlemi | Ne yapar | Kullanım örneği |
|---|---|---|
| Konuşmaları listele | Hesaptaki konuşmaları durum, etiket veya temsilciye göre filtreleyerek döndürür | Bir harici CRM'de aktif veya kapatılmış destek kayıtlarını izleme |
| Metin mesajı gönder | Bir kişiye metin mesajı gönderir (WhatsApp'ın 24 saatlik penceresine uyarak) | Müşteriye sipariş güncellemesi bildirimi gönderme |
| Etiket uygula | Bir etiket oluşturur (yoksa) ve bunu kişiye ve açık konuşmaya uygular | Konuşmaları otomatik olarak "Acil" veya "Satış sonrası" olarak işaretleme |
| Konuşma ata | Bir kişinin açık konuşmalarını belirli bir temsilciye atar | Bölgeden sorumlu satış temsilcisine potansiyel müşterileri yönlendirme |
Papo Konuşma API'si nasıl çalışır
Papo API'si REST standardını izler; gizli anahtar (Bearer token) ile kimlik doğrulama yapar ve JSON yanıtları döndürür. Burada açıklanan tüm işlemler aynı kimlik doğrulama temelini kullanır ve otomatik iş akışları oluşturmak için birleştirilebilir — örneğin, yeni bir potansiyel müşteri geldiğinde son konuşmaları listeleyen, "Yeni" etiketi uygulayan ve nöbetteki temsilciye atayan bir triyaj sistemi.
API'nin temel adresi https://app.papo.global/api/v1. Konuşmalar, etiketler ve atamalar uç noktalarını kullanmak için Papo panelinden oluşturulmuş bir API token'ına ihtiyacınız vardır. Belirli uç noktalar ve parametrelerle ilgili tam dokümantasyon papo.global/pt/docs adresinde mevcuttur.
API kaynaklarını kullanma adım adım
1. Bir API token'ı oluşturun
Papo panelinde geliştirici veya erişim token'ları bölümüne gidin. Konuşmaları yönetmek için uygun izinlere sahip gizli bir anahtar (sk_live_…) oluşturun. Token'ı güvenli bir yerde saklayın — tüm isteklerde Authorization başlığında gönderilecektir.
2. Konuşmaları listeleyin
Hesabın destek kayıtlarını almak için konuşma listeleme uç noktasını kullanın. İstek şu filtre parametrelerini kabul eder:
- Durum: açık, kapatılmış veya tüm konuşmalar.
- Etiket: uygulanmış bir veya daha fazla etikete göre filtreler.
- Temsilci: belirli bir kullanıcıya atanmış konuşmalarla sınırlar.
- Dönem: sorguyu sınırlamak için tarih aralığı.
Yanıt; konuşma tanımlayıcısını, kişiyi, kanalı, durumu ve son mesajları içerir. Bu verilerle destek hacmini izleyebilir veya harici bir sistemden koşullu eylemler tetikleyebilirsiniz.
3. Metin mesajı gönderin
Bir kişiye metin mesajı göndermek için mesaj gönderme uç noktasını kullanın. İstek şunları gerektirir:
- Alıcı numarası uluslararası formatta (örn.
5511999999999). - Mesaj metni.
- Örnek tanımlayıcısı (isteğe bağlı) — hesabınızda birden fazla WhatsApp bağlantısı varsa hangisinin kullanılacağını belirtebilirsiniz.
API, isteğin kabul edildiğine dair bir onay döndürür. Metin mesajı gönderiminin WhatsApp'ın 24 saatlik penceresine tabi olduğunu unutmayın; bu süre dışındaki iletişimler için önceden onaylanmış mesaj şablonları (HSM) kullanılmalıdır.
4. Kişilere ve konuşmalara etiket uygulayın
API, etiketleri iki şekilde yönetmenize olanak tanır:
- Hesapta etiket oluşturma: yeni etiket için başlık, renk ve açıklama tanımlayın.
- Etiket uygulama: mevcut bir etiketi bir kişiye ve o kişinin açık konuşmasına ilişkilendirin. Etiket henüz yoksa, uygulama sırasında otomatik olarak oluşturulur.
Bu, konuşmaları sisteminizin kurallarına göre otomatik sınıflandırmak için kullanışlıdır — örneğin, müşteri belirli bir anahtar kelime gönderdiğinde "Şikayet" olarak işaretlemek.
5. Konuşmaları temsilcilere atayın
Atama uç noktasıyla, belirli bir kişinin tüm açık konuşmalarına bir temsilci atayabilirsiniz. Kişi tanımlayıcısını ve kullanıcı/temsilci ID'sini belirtmeniz yeterlidir. Hesabın temsilci listesi, kullanıcı listeleme uç noktasıyla alınabilir; bu uç nokta ekip üyelerinin adını, e-postasını ve ID'sini döndürür.
Bu işlev, otomatik yönlendirme için gereklidir: bir CRM sistemi, potansiyel müşterinin profilini belirlediğinde manuel müdahale olmadan doğru satış temsilcisine atayabilir.
Konuşma API'sini kimler kullanmalı
- Halihazırda harici sistemler kullanan operasyonlar (ERP, CRM, e-ticaret platformları) ve Papo desteğini entegre etmek isteyenler.
- Karmaşık yönlendirme kuralları olan destek ekipleri, müşteri verilerine göre konuşmaları otomatik sınıflandırması ve yönlendirmesi gerekenler.
- Kişiselleştirilmiş panolar oluşturan geliştiriciler veya destek olaylarından bildirim tetikleyenler.
- Birden fazla hesabı yöneten ve her müşteri için etiket ve atama yapılandırmasını otomatikleştirmek isteyen white label bayiler.
Sık sorulan sorular
Bu uç noktaları kullanmak için API token'ına ihtiyacım var mı?
Evet. Papo API'sine yapılan tüm istekler, Authorization: Bearer sk_live_… başlığında gönderilen gizli anahtar ile kimlik doğrulaması gerektirir. Token'lar hesap panelinden oluşturulur.
API, WhatsApp'ın 24 saatlik penceresi dışında mesaj göndermeye izin veriyor mu?
API üzerinden metin mesajı gönderimi 24 saatlik pencereye uyar. Bu süre dışındaki proaktif iletişimler için onaylanmış mesaj şablonları (HSM) kullanılmalıdır. Papo, HSM gönderimi için özel uç noktalar sunar.
Konuşmaları etikete göre listeleyebilir miyim?
Evet. Konuşma listeleme uç noktası etiket filtresini kabul eder; böylece yalnızca bir veya daha fazla belirli etiketle işaretlenmiş destek kayıtlarını alabilirsiniz.
API üzerinden bir kişiye nasıl etiket uygularım?
Etiket uç noktasını kullanarak etiket tanımlayıcısını (veya oluşturma verilerini) ve kişi tanımlayıcısını belirtin. Etiket, kişiye ve ilgili açık konuşmaya uygulanır.
API konuşmanın tam geçmişini döndürür mü?
Konuşma listeleme, meta verileri ve son mesajları döndürür. Belirli bir konuşmanın tam mesaj geçmişini almak için mesaj alma uç noktalarını ayrıntılandıran API dokümantasyonuna bakın.
Kullanıcı ID'sini bilmeden bir konuşmayı bir temsilciye atayabilir miyim?
Önce hesabın kullanıcılarını (temsilciler uç noktası) listeleyerek ID'leri alabilir, ardından atama uç noktasını kullanabilirsiniz. Temsilci listesi ad ve e-posta içerir, bu da tanımlamayı kolaylaştırır.
Ayrıca okuyun
- Papo API'sini white label bayinizin müşterilerini yönetmek için nasıl kullanırsınız
- Papo API'sini kişilerin özel niteliklerini yönetmek için nasıl kullanırsınız
Papo API'sini ve tüm modüllerini ücretsiz deneyin — ilk kullanıcı ücretsizdir ve kredi kartı gerekmez.