**Ya, Anda dapat mengelola layanan, jadwal, dan janji temu melalui API menggunakan modul Atendimentos dari [Papo](https://papo.global/). API REST memungkinkan Anda untuk mendaftar layanan, profesional, dan pasien, melihat jadwal, dan membuat janji temu baru secara terprogram, mengintegrasikan seluruh alur pemesanan ke situs web, aplikasi, atau sistem eksternal Anda.** Modul Atendimentos Papo dirancang untuk menjadi pusat kendali agenda Anda. Ini mengatur empat pilar: layanan yang Anda tawarkan (dengan nama, durasi, dan harga), profesional yang melaksanakannya, ketersediaan jadwal masing-masing, dan janji temu yang dilakukan. Dengan API, Anda dapat mengotomatiskan operasi ini tanpa mengakses panel secara manual, menjaga integrasi yang lancar antara Papo dan alat lainnya. ## Ringkasan operasi Atendimentos melalui API | Operasi | Apa yang dilakukan | Kapan digunakan | | :--- | :--- | :--- | | Daftar layanan | Mengembalikan layanan yang terdaftar, dengan durasi dan harga. | Sinkronkan katalog layanan dengan situs web atau aplikasi Anda agar pelanggan melihat opsi secara real-time. | | Daftar profesional | Mengembalikan daftar petugas atau anggota tim yang melakukan layanan. | Menampilkan profesional yang tersedia dan spesialisasi mereka di antarmuka penjadwalan eksternal. | | Daftar pasien | Mengembalikan pasien yang terdaftar, dengan nama, telepon, dan ID. | Memeriksa apakah pelanggan sudah ada di CRM sebelum membuat janji temu baru atau menghubungkannya ke catatan yang ada. | | Daftar janji temu | Mengembalikan janji temu dengan filter berdasarkan status (mis.: dikonfirmasi, tertunda). | Mengaudit pemesanan, mengintegrasikan dengan sistem pelaporan, atau memeriksa ketersediaan agenda sebelum menawarkan jadwal baru. | | Jadwalkan janji temu | Membuat janji temu nyata di agenda profesional, untuk layanan dan pasien tertentu. | Memungkinkan pelanggan menjadwalkan langsung dari situs web atau aplikasi Anda, atau mengotomatiskan pembuatan pemesanan dari sistem eksternal. | ## Bagaimana autentikasi API bekerja Semua operasi penulisan di Atendimentos memerlukan kunci rahasia akun Papo Anda, dikirim sebagai token Bearer di header otorisasi. Kunci publik akun bersifat opsional, tetapi jika dikirim, harus sesuai dengan akun yang sama dengan kunci rahasia. URL dasar API adalah `https://app.papo.global/api/v1`. Kunci dibuat di area pengembang panel Papo. Kunci rahasia ditampilkan hanya sekali saat pembuatan; simpan di tempat yang aman dan cabut segera jika ada kecurigaan kebocoran. ## Cara menggunakan dalam praktik 1. Akses area pengembang/API di panel Papo dan buat kunci rahasia. Salin juga kunci publik akun. 2. Di setiap permintaan, autentikasi dengan kunci rahasia sebagai token Bearer. Jika ingin memperkuat validasi, kirim kunci publik di header yang ditunjukkan dalam dokumentasi. 3. **Untuk membangun antarmuka penjadwalan**, pertama daftar layanan dan profesional yang tersedia. Dengan demikian, Anda dapat mengisi opsi secara dinamis di situs web atau aplikasi Anda dengan data nyata dari akun Papo Anda. 4. **Untuk membuat janji temu**, panggil endpoint pembuatan janji temu, kirimkan di payload JSON pengidentifikasi layanan, profesional, pasien, dan tanggal/waktu yang diinginkan. API akan memvalidasi ketersediaan di agenda yang dikonfigurasi di modul Atendimentos dan membuat komitmen. 5. Lihat dokumentasi resmi di `https://papo.global/pt/docs` untuk mendapatkan jalur yang tepat, parameter wajib, dan contoh kode. Semua respons dalam format JSON. API juga memungkinkan untuk mendaftar janji temu yang ada dengan filter berdasarkan status. Ini berguna untuk membangun dasbor pemantauan, mengirim pengingat otomatis, atau mengintegrasikan status pemesanan dengan sistem lain. ## Untuk siapa integrasi ini direkomendasikan - **Klinik, praktik dokter, dan salon kecantikan** yang ingin menawarkan penjadwalan online di situs web mereka sendiri, dengan ketersediaan real-time. - **Platform SaaS dan marketplace** yang perlu menghubungkan agenda penyedia layanan ke sistem reservasi eksternal. - **Reseller white label** yang membuat solusi yang dipersonalisasi untuk klien akhir dan ingin mengekspos modul Atendimentos melalui API. - **Perusahaan dengan alur otomatis** yang memicu pembuatan janji temu dari peristiwa di CRM, ERP, atau alat otomatisasi. ## Pertanyaan yang sering diajukan ### Apakah saya perlu mengonfigurasi modul Atendimentos untuk menggunakan API? Ya. Layanan, profesional, dan ketersediaan mereka harus sudah terdaftar di modul Atendimentos Papo agar API dapat mendaftar dan memvalidasi janji temu. ### Apakah API memungkinkan membuat layanan atau profesional baru? Fitur API berfokus pada mendaftar layanan dan profesional yang ada dan menjadwalkan janji temu. Untuk membuat atau mengedit layanan dan profesional, gunakan panel Papo. ### Bagaimana API mengetahui apakah suatu jadwal tersedia? Saat mengirim permintaan untuk menjadwalkan janji temu, API Papo memeriksa ketersediaan yang dikonfigurasi untuk profesional dan layanan yang dipilih pada hari dan waktu itu. Jika ada konflik, janji temu tidak akan dibuat dan API akan mengembalikan kesalahan. ### Bisakah saya menggunakan API untuk menjadwalkan janji temu atas nama pasien yang belum ada di CRM? Anda dapat terlebih dahulu menggunakan API Kontak Papo untuk membuat pasien (dengan nama, email, dan/atau telepon) dan kemudian menggunakan ID yang dikembalikan untuk membuat janji temu. Lihat dokumentasi untuk endpoint pembuatan kontak. ### Apakah AI Papo dapat menjadwalkan secara otomatis melalui API? Kecerdasan Buatan Papo, seperti Super Chat, menjadwalkan langsung melalui percakapan di WhatsApp, dengan melihat agenda modul Atendimentos. API adalah jalur untuk integrasi programatik eksternal, seperti sistem penjadwalan online. ### Di mana saya bisa melihat format payload yang tepat untuk menjadwalkan? Di dokumentasi resmi API, di `https://papo.global/pt/docs`. Di sana terdapat detail autentikasi, parameter, respons, dan contoh kode untuk fitur Atendimentos. ## Baca juga - Cara menggunakan API Papo untuk membuat dan memperbarui kontak secara massal - [Cara menggunakan API Papo untuk membuat dan mengelola label (tag)](/hc/papo/articles/cara-menggunakan-api-papo-untuk-membuat-dan-mengelola-tag) --- **[Mulai integrasikan agenda Anda melalui API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=cara-menggunakan-api-papo-untuk-mengelola-janji-temu&utm_content=id)** Daftar di Papo dan dapatkan akses ke API REST untuk mengotomatiskan janji temu Anda mulai dari pengguna pertama.