Basis pengetahuan GetMyBot

Janji temu dan Google Kalender

Izinkan agen AI menawarkan waktu konsultasi, membuat janji, serta memindahkan atau membatalkannya melalui Google Kalender.

Di halaman ini

Agen AI dapat menawarkan waktu yang masih kosong dan membuat janji di Google Kalender, misalnya konsultasi selama 30 menit pada hari kerja. Jika Anda mengizinkannya, agen juga dapat memindahkan atau membatalkan janji.

Di AI → Kalender, hubungkan akun, buat jenis pertemuan, lalu periksa waktu yang tersedia. Setelah itu, izinkan tindakan kalender yang diperlukan dalam pengaturan agen. Waktu kosong yang dapat dipesan disebut slot.

Saat ini hanya Google Kalender yang didukung. Jenis pertemuan, pemesanan, dan alat agen memakai antarmuka kalender GetMyBot yang sama, tetapi penyedia kalender lain belum dapat dihubungkan.

Menghubungkan akun

Tekan Hubungkan Google Kalender, lalu setujui akses di jendela Google. GetMyBot meminta akses ke daftar kalender, acara, dan informasi waktu sibuk. Jika proses tidak selesai dalam lima menit, mulai lagi.

Secara teknis, proses ini dilindungi oleh parameter sekali pakai state yang terikat pada bot dan akun, pemeriksaan PKCE, serta alamat kembali yang tetap. state berlaku selama lima menit.

Token untuk memperpanjang akses disimpan dalam bentuk terenkripsi dan tidak ditampilkan lagi. Kartu koneksi hanya menunjukkan nama akun dan salah satu dari empat status: Terhubung, Akses kedaluwarsa, Terputus, atau Kesalahan. Jika akses kedaluwarsa, hubungkan akun lagi.

Tombol Putuskan kalender tidak dapat digunakan selama ada agen aktif yang memakai alat kalender. Antarmuka akan menampilkan agen tersebut. Matikan alatnya atau jeda agen lebih dulu.

Jenis pertemuan

Jenis pertemuan menentukan pilihan yang dapat ditawarkan agen. Atur:

  • Nama: tampil dalam laporan Anda dan acara yang diterima pelanggan.
  • Kalender dari akun yang terhubung. ID kalender yang disimpan dienkripsi dan tidak ditampilkan lagi, sehingga kalender perlu dipilih ulang saat mengubah jenis pertemuan.
  • Durasi: 5 sampai 480 menit.
  • Zona waktu: nama IANA seperti Europe/Berlin, yang menentukan arti jam tersedia di bawah.
  • Jam tersedia: 1 sampai 28 rentang mingguan dengan batas waktu JJ:MM menurut hari. Rentang tidak boleh tumpang tindih. Jika jam akhir lebih awal dari jam mulai, rentang berlanjut melewati tengah malam.
  • Jarak minimum sebelum pertemuan: 0 sampai 1.440 menit; pelanggan tidak dapat memesan lebih dekat dari itu.
  • Jarak maksimum pemesanan: 1 sampai 366 hari ke depan.
  • Jeda sebelum dan jeda sesudah: masing-masing 0 sampai 1.440 menit yang dibiarkan kosong di sekitar pertemuan.
  • Jenis pertemuan aktif: hanya jenis aktif yang dapat ditawarkan dan dipesan.

Tombol Tampilkan slot kosong mengambil hasil nyata dari kalender yang terhubung untuk satu minggu ke depan, bukan contoh buatan.

Cara slot dipilih

Ketersediaan dihitung dari empat hal sekaligus: jam mingguan jenis pertemuan, waktu sibuk di kalender, jeda, dan pemesanan yang sudah ada pada koneksi tersebut. Calon slot dibuat tiap 15 menit. Secara bawaan, 10 slot dikembalikan dan jumlahnya tidak pernah lebih dari 20.

Waktu ditampilkan dalam zona waktu pelanggan dan disimpan dalam UTC. Karena itu, perubahan ke waktu musim panas dapat menggeser jam setempat yang ditawarkan, tetapi tidak mengubah saat yang sudah tersimpan.

Pemesanan dibuat secara hati-hati:

  1. Sistem memeriksa ulang slot yang dipilih tepat sebelum membuat janji.
  2. Sistem menyimpan pemesanan sementara dengan kunci idempotensi, sehingga permintaan berulang tidak membuat pertemuan kedua.
  3. Acara dibuat di kalender, beserta tautan pertemuan video jika diperlukan.
  4. Jika Google Kalender tidak menjawab tepat waktu atau mengalami kesalahan sementara, sistem mencari pemesanan dengan kunci tadi sebelum mencoba lagi. Waktu tunggu yang tidak jelas tidak membuat acara ganda.
  5. Setelah itu, pemesanan dikonfirmasi. ID acara dari penyedia dan tautan pertemuan disimpan dalam bentuk terenkripsi.

Pemindahan dan pembatalan memakai proses serupa. Jika orang lain lebih dulu mengambil waktu yang dipilih, tindakan gagal alih-alih membuat dua janji pada waktu yang sama.

Status pemesanan: Menunggu, Dikonfirmasi, Dipindahkan, Dibatalkan, dan Kesalahan.

Memberi izin alat kepada agen

Dalam editor agen, di bagian Alat yang diizinkan, aktifkan tindakan kalender yang diperlukan:

  • Tampilkan slot kosong
  • Buat janji
  • Pindahkan janji
  • Batalkan janji

Untuk setiap alat kalender yang diaktifkan, pilih setidaknya satu jenis pertemuan aktif yang masih berlaku. Jika tidak, pemeriksaan kesiapan akan mencegah agen diaktifkan. Agen aktif saat ini hanya dapat menjalankan alat kalender; jenis alat lainnya belum berjalan dalam tugas agen.

Model AI tidak memilih kalender, pelanggan, atau permintaan sembarang. Model hanya dapat mengusulkan pemanggilan alat dengan argumen yang mengikuti aturan ketat. Bot, pelanggan, dan jenis pertemuan yang diizinkan diambil dari konteks server. Setiap pemanggilan memiliki batas waktu 15 detik dan kunci idempotensi berdasarkan giliran percakapan serta nomor panggilan. Dalam log, tautan pertemuan dan data kontak dihapus dari argumen maupun hasil.

Laporan

AI → Analitik menampilkan tindakan kalender dan hasil pemesanan bersama metrik agen lainnya. Daftar pemesanan ada di AI → Kalender.

Jika terjadi masalah

  • Alat kalender aktif, tetapi tidak ada jenis pertemuan aktif: buat jenis baru atau aktifkan jenis yang sudah ada sebelum mengaktifkan agen.
  • Daftar kalender tidak dapat dimuat: akun mungkin perlu dihubungkan ulang. Sebagai langkah sementara, ID koneksi dapat dimasukkan secara manual.
  • Tidak ada slot kosong selama seminggu ke depan: periksa jam mingguan, jarak minimum, jeda, dan waktu sibuk di kalender.
  • Jenis pertemuan tidak dapat dihapus karena sedang digunakan: alat kalender pada agen aktif masih merujuk kepadanya.

Artikel terkait