Referensi pengaturan organisasi

Kelola organisasi ThunderPhone: profil, bahasa dasbor, anggota, konfirmasi panggilan keluar, penelepon yang diblokir, webhook, SSO, kunci API, peringatan, penagihan, batas pengeluaran, dan riwayat.

Buka Pengaturan Organisasi (/dashboard/organization) untuk mengelola organisasi aktif dan akun Anda sendiri. Pengaturan dibagi menjadi enam tab; peran Anda menentukan kontrol mana yang dapat Anda ubah.

Akun saya#

Tab Akun saya berisi pengaturan untuk pengguna yang sedang masuk, bukan seluruh organisasi:

• Nama depan, nama belakang, email, dan URL avatar.
• Bahasa tampilan dasbor.
• Unduhan aplikasi desktop macOS.
• Tambahkan, verifikasi, daftar, dan hapus passkey.
• Preferensi cookie.
• Keluar pada perangkat saat ini.

Saat Anda masuk melalui SSO organisasi, penyedia identitas mengelola email Anda dan email tersebut hanya dapat dibaca di sini. Lihat Akun & keamanan untuk alur kerja passkey dan profil yang terperinci.

Umum#

Kepatuhan panggilan keluar#

Untuk organisasi yang memenuhi persyaratan ini, pemilik atau admin harus meninjau dan mencatat konfirmasi panggilan keluar satu kali sebelum agen dapat melakukan panggilan keluar. Anggota dapat melihat bahwa tindakan diperlukan, tetapi tidak dapat mengirimkannya. Lihat Peraturan panggilan keluar.

Pelaporan#

Zona waktu, jam kerja mingguan, dan nomor pengujian milik organisasi. Jam kerja menentukan panggilan mana yang dihitung sebagai di luar jam kerja dalam angka laporan panggilan di Beranda, di tab Panggilan setiap agen, dan di Portal Klien, serta filter Jam kerja di Riwayat Panggilan. Jika tidak ada hari yang dicentang, panggilan di luar jam kerja tidak dilacak dan setiap panggilan dihitung sebagai jam kerja. Panggilan dari atau ke nomor pengujian tidak disertakan dalam jumlah laporan apa pun, maupun dalam daftar portal, angka Ringkasan, dan ekspor CSV; panggilan tersebut tidak dapat dibuka di portal. Agen dapat memiliki zona waktu dan jam kerjanya sendiri di bagian Pelaporan dalam pembuat agen, yang kemudian hanya berlaku untuk panggilan agen tersebut.

Pemilik dan admin mengubah pengaturan ini di Umum → Pelaporan. Pilih zona waktu dan centang setiap hari operasional, lalu masukkan waktu buka dan tutupnya. Di bagian Nomor pengujian, masukkan setiap nomor dan pilih Tambah. Kemudian pilih Simpan pengaturan pelaporan. Hingga zona waktu disimpan, laporan menggunakan UTC; halaman menyarankan zona browser Anda sebagai perubahan yang belum disimpan. Setelah jam kerja apa pun ditetapkan, hari yang tidak dicentang dihitung sebagai di luar jam kerja untuk panggilan yang menggunakan jadwal tersebut.

Konfigurasikan pelaporan melalui API#

Pemilik dan admin dapat menggunakan PATCH /v1/orgs/{id}/ dengan timezone, business_hours, dan excluded_numbers:

• timezone: nama zona waktu IANA seperti America/Los_Angeles, hingga 64 karakter.
• business_hours: kunci hari kerja dari mon hingga sun, masing-masing berupa daftar maksimal empat rentang {start, end} dalam format 24 jam HH:MM, dengan setiap waktu akhir lebih lambat daripada waktu mulainya. {} berarti tidak ada pemisahan jam di luar kerja.
• excluded_numbers: hingga 50 nomor telepon, disimpan dalam format E.164. Nomor Amerika Utara 10 digit tanpa awalan akan diberi kode negara +1.

curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Los_Angeles",
    "business_hours": {
      "mon": [{"start": "09:00", "end": "17:00"}],
      "sat": [{"start": "10:00", "end": "14:00"}]
    },
    "excluded_numbers": ["+14155550199"]
  }'

Penelepon yang diblokir#

Nomor dalam daftar ini tidak dapat menghubungi agen Anda. Saat nomor yang diblokir menelepon nomor telepon organisasi Anda, ThunderPhone memutus panggilan sebelum agen menjawab dan tidak menagih panggilan tersebut. Panggilan tetap muncul di Riwayat Panggilan, sebagai panggilan masuk yang gagal dengan alasan akhir Penelepon diblokir. Panggilan dengan ID penelepon yang disembunyikan atau anonim tidak pernah dicocokkan, dan panggilan keluar ke nomor yang diblokir tidak terpengaruh. Penelepon yang Anda blokir selama panggilan tidak akan terputus; pemblokiran berlaku mulai panggilan berikutnya.

Setiap anggota dapat melihat daftar tersebut; pemilik dan admin mengubahnya di Umum → Penelepon yang diblokir:

• Untuk memblokir satu nomor, masukkan nomor tersebut dengan catatan opsional dan pilih Blokir nomor. Gunakan + dan kode negara; format nasional seperti (415) 555-0123 juga berfungsi jika semua nomor telepon organisasi Anda berada di satu negara.
• Untuk memblokir banyak nomor sekaligus, pilih Tempel daftar, tempel hingga 500 nomor (satu per baris atau dipisahkan koma), lalu kirimkan. Hasilnya menunjukkan berapa banyak nomor yang ditambahkan, sudah diblokir, atau tidak valid, serta mencantumkan entri yang tidak valid.
• Untuk membuka blokir nomor, pilih Hapus pada barisnya dan konfirmasikan.

Anda juga dapat membuka panggilan masuk di Riwayat Panggilan dan memilih Blokir penelepon ini. Organisasi dapat memblokir hingga 10.000 nomor. Untuk mengelola daftar melalui API, lihat Penelepon yang Diblokir.

Identitas dan keanggotaan organisasi#

Kartu organisasi menampilkan ID organisasi, peran keanggotaan Anda, dan nama organisasi yang dapat diedit. Kartu tim menggabungkan anggota aktif dan undangan tertunda.

Pemilik dan admin dapat mengundang Anggota atau Admin, membatalkan undangan tertunda, mengubah peran anggota yang memenuhi syarat, dan menghapus anggota. Undangan bersifat khusus untuk email dan kedaluwarsa setelah tujuh hari. Lihat Undang tim Anda.

Zona bahaya memungkinkan pengguna yang memenuhi syarat untuk keluar dari organisasi atau menghapusnya secara permanen. Penghapusan menghapus agen, nomor, riwayat panggilan, dan data penagihan organisasi serta tidak dapat dibatalkan.

Untuk menghapus akun Anda sendiri, buka tab Akun dan pilih Hapus akun. Dialog mencantumkan organisasi yang akan dihapus (organisasi tempat Anda menjadi satu-satunya anggota) dan organisasi yang akan Anda tinggalkan. Kunci API yang Anda buat di organisasi yang Anda tinggalkan akan dicabut. Penghapusan diblokir jika Anda adalah satu-satunya pemilik organisasi yang memiliki anggota lain (jadikan orang lain sebagai pemilik terlebih dahulu), jika Anda membuat suara kustom di organisasi yang tetap ada, jika panggilan sedang berlangsung, atau jika berlaku penangguhan hukum; dialog mencantumkan hal yang memblokirnya. Tindakan ini tidak dapat dibatalkan.

Webhook default#

Tetapkan satu URL webhook lama untuk menerima peristiwa dari semua widget web dan nomor telepon dalam organisasi. Untuk rahasia per-endpoint, langganan, riwayat pengiriman, dan percobaan ulang, gunakan endpoint webhook yang direkomendasikan.

SSO Enterprise#

Konfigurasikan satu atau beberapa koneksi SSO, domain email yang diizinkan, penyediaan just-in-time, peran default, dan pemetaan grup-ke-peran opsional. Kebijakan keamanan dapat mewajibkan SSO, mengizinkan akses kata sandi darurat untuk admin, dan mewajibkan passkey untuk akses organisasi. Lihat SSO.

Kunci#

Tab Kunci mengelola kunci API server rahasia sk_live_. Setiap baris menampilkan nama, prefiks, status aktif/dicabut, waktu pembuatan, penggunaan terakhir, dan waktu pencabutan.

Rahasia lengkap hanya ditampilkan sekali, segera setelah dibuat. Salin saat itu dan simpan di pengelola rahasia. Pencabutan bersifat permanen dan menghentikan setiap integrasi yang menggunakan kunci tersebut. Lihat Kunci API.

Kunci pk_live_ yang dapat dipublikasikan termasuk dalam Widget Web, karena merupakan kredensial browser yang dibatasi menurut origin, bukan kunci server.

Peringatan#

Buat aturan metrik untuk tingkat keberhasilan, tingkat kegagalan, skor rata-rata, volume panggilan, atau regresi suite. Aturan mencakup:

• Pembanding dan ambang numerik.
• Jendela evaluasi dari 1 hingga 720 jam.
• Hingga 10 penerima email.
• URL webhook masuk Slack opsional.
• Pengiriman webhook developer opsional.
• Cooldown dalam menit penuh dan status aktif.

Tab yang sama mencantumkan pemicuan terbaru. Lihat Peringatan.

Pengaturan Penagihan#

Kelola saldo organisasi dan perilaku pembayaran:

• Tambahkan atau ganti kartu pembayaran default.
• Tambahkan dana secara manual.
• Aktifkan isi ulang otomatis dan tetapkan ambang serta jumlah isi ulangnya.
• Tetapkan atau hapus batas pengeluaran bulanan.

Batas bulanan menjeda panggilan dan penggunaan baru pada 100% serta tetap aktif bahkan saat isi ulang otomatis dinonaktifkan. Lihat Harga dan Penagihan dan isi ulang.

Riwayat Penagihan#

Gunakan Riwayat Penagihan untuk memeriksa saldo dan pengeluaran untuk Hari Ini, 7 hari, 30 hari, 90 hari, atau sepanjang waktu. Fitur ini mencakup:

• Tren saldo.
• Komposisi penagihan untuk biaya panggilan, laporan, biaya nomor telepon, dan isi ulang.
• Pengeluaran agen tertinggi.
• Tabel transaksi dengan tanggal, kategori, deskripsi, jenis, jumlah, dan saldo yang dihasilkan.
• Pemfilteran kategori serta ekspor CSV atau JSON dari riwayat yang ditampilkan.

Dasbor memberi tahu Anda ketika hanya transaksi terbaru yang ditampilkan; baris yang lebih lama di luar batas tersebut juga tidak disertakan dalam ekspor. Billing API mendukung paginasi terprogram.