Evet, Papo Randevular modülünü kullanarak hizmetleri, saatleri ve randevuları API üzerinden yönetebilirsiniz. REST API; hizmetleri, profesyonelleri ve hastaları listelemenize, takvimi sorgulamanıza ve programatik olarak yeni randevular oluşturmanıza olanak tanır; tüm randevu akışını sitenize, uygulamanıza veya harici sisteminize entegre eder.
Papo'nun Randevular modülü, takviminizin kontrol merkezi olacak şekilde tasarlanmıştır. Dört temel unsuru düzenler: sunduğunuz hizmetler (ad, süre ve fiyatla birlikte), bunları gerçekleştiren profesyoneller, her birinin saat uygunluğu ve yapılan randevular. API ile bu işlemleri paneli manuel olarak açmadan otomatikleştirebilir, Papo ile diğer araçlarınız arasında akıcı bir entegrasyon sağlayabilirsiniz.
API ile Randevu İşlemlerinin Özeti
| İşlem | Ne yapar | Ne zaman kullanılır |
|---|---|---|
| Hizmetleri listele | Kayıtlı randevu hizmetlerini süre ve fiyatla döndürür. | Hizmet kataloğunu siteniz veya uygulamanızla senkronize ederek müşterinin seçenekleri gerçek zamanlı görmesini sağlamak. |
| Profesyonelleri listele | Hizmetleri gerçekleştiren görevlilerin veya ekip üyelerinin listesini döndürür. | Harici bir randevu arayüzünde mevcut profesyonelleri ve uzmanlık alanlarını göstermek. |
| Hastaları listele | Kayıtlı hastaları ad, telefon ve ID ile döndürür. | Yeni bir randevu oluşturmadan önce bir müşterinin CRM'de zaten var olup olmadığını kontrol etmek veya mevcut bir kayda bağlamak. |
| Randevuları listele | Randevuları duruma göre filtreleyerek döndürür (örn. onaylandı, beklemede). | Randevuları denetlemek, raporlama sistemleriyle entegre etmek veya yeni saatler sunmadan önce takvim doluluğunu kontrol etmek. |
| Randevu oluştur | Belirli bir hizmet ve hasta için bir profesyonelin takviminde gerçek bir randevu oluşturur. | Müşterilerin doğrudan sitenizden veya uygulamanızdan randevu almasını sağlamak ya da harici sistemlerden randevu oluşturmayı otomatikleştirmek. |
API kimlik doğrulaması nasıl çalışır?
Tüm Randevular yazma işlemleri, Papo hesabınızın gizli anahtarının yetkilendirme başlığında Bearer token olarak gönderilmesini gerektirir. Hesabın genel anahtarı isteğe bağlıdır, ancak gönderilirse gizli anahtarla aynı hesaba ait olmalıdır.
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österilir; güvenli bir yerde saklayın ve sızma şüphesi varsa derhal iptal edin.
Pratikte nasıl kullanılır?
- Papo panelindeki geliştirici/API alanına gidin ve bir gizli anahtar oluşturun. Hesabın genel anahtarını da kopyalayın.
- Her istekte gizli anahtarla Bearer token olarak kimlik doğrulaması yapın. Doğrulamayı güçlendirmek isterseniz, belgelerde belirtilen başlıkta genel anahtarı gönderin.
- Randevu arayüzünü oluşturmak için önce mevcut hizmetleri ve profesyonelleri listeleyin. Böylece sitenizdeki veya uygulamanızdaki seçenekleri Papo hesabınızın gerçek verileriyle dinamik olarak doldurabilirsiniz.
- Randevu oluşturmak için randevu oluşturma uç noktasını çağırın; JSON yükünde hizmet, profesyonel, hasta tanımlayıcılarını ve istenen tarih/saati gönderin. API, Randevular modülünde yapılandırılan takvimdeki uygunluğu doğrulayacak ve randevuyu oluşturacaktır.
- Tam yolları, zorunlu parametreleri ve kod örneklerini almak için
https://papo.global/pt/docsadresindeki resmi belgelere bakın. Tüm yanıtlar JSON formatındadır.
API ayrıca mevcut randevuları duruma göre filtreleyerek listelemeye olanak tanır. Bu, takip panelleri oluşturmak, otomatik hatırlatıcılar göndermek veya randevu durumunu diğer sistemlerle entegre etmek için kullanışlıdır.
Bu entegrasyon kimler için uygundur?
- Klinikler, muayenehaneler ve güzellik salonları: kendi sitelerinde gerçek zamanlı uygunlukla online randevu sunmak isteyenler.
- SaaS platformları ve pazar yerleri: hizmet sağlayıcıların takvimini harici bir rezervasyon sistemine bağlaması gerekenler.
- White label bayileri: son müşteriler için özelleştirilmiş çözümler oluşturan ve Randevular modülünü API üzerinden sunmak isteyenler.
- Otomatik akışlara sahip şirketler: CRM, ERP veya otomasyon araçlarındaki olaylardan randevu oluşturmayı tetikleyenler.
Sık sorulan sorular
API'yi kullanmak için Randevular modülünün yapılandırılmış olması gerekiyor mu?
Evet. API'nin bunları listeleyebilmesi ve randevuları doğrulayabilmesi için hizmetlerin, profesyonellerin ve uygunluklarının Papo'nun Randevular modülünde zaten kayıtlı olması gerekir.
API yeni bir hizmet veya profesyonel oluşturmaya izin veriyor mu?
API'nin özellikleri mevcut hizmetleri ve profesyonelleri listelemeye ve randevu oluşturmaya odaklanır. Hizmetleri ve profesyonelleri oluşturmak veya düzenlemek için Papo panelini kullanın.
API bir saatin boş olup olmadığını nasıl bilir?
Bir randevu oluşturmak için istek gönderdiğinizde, Papo API'si seçilen profesyonel ve hizmet için o gün ve saatte yapılandırılmış uygunluğu kontrol eder. Çakışma varsa randevu oluşturulmaz ve API bir hata döndürür.
CRM'de henüz kayıtlı olmayan bir hasta adına randevu oluşturmak için API'yi kullanabilir miyim?
Önce Papo'nun Kişiler API'sini kullanarak hastayı (ad, e-posta ve/veya telefonla) oluşturabilir, ardından randevuyu oluşturmak için döndürülen ID'yi kullanabilirsiniz. Kişi oluşturma uç noktası için belgelere bakın.
Papo'nun yapay zekası API üzerinden otomatik randevu oluşturabilir mi?
Papo'nun Super Chat gibi Yapay Zekası, Randevular modülünün takvimini sorgulayarak doğrudan WhatsApp konuşması üzerinden randevu oluşturur. API, online randevu sistemi gibi harici programatik entegrasyonlar için kullanılan yoldur.
Randevu oluşturmak için tam yük formatını nerede görebilirim?
https://papo.global/pt/docs adresindeki resmi API belgelerinde. Orada Randevular kaynakları için kimlik doğrulama, parametreler, yanıtlar ve kod örneklerinin ayrıntıları yer alır.
Ayrıca okuyun
- Papo API'sini kullanarak toplu kişi oluşturma ve güncelleme
- Papo API'sini kullanarak etiket (tag) oluşturma ve yönetme
Takviminizi API üzerinden entegre etmeye başlayın →
Papo'ya kaydolun ve ilk kullanıcıdan itibaren randevularınızı otomatikleştirmek için REST API'ye erişin.