Akses programatis dan otomatisasi

Ikhtisar

Ada tiga cara memakai Whisperer tanpa antarmuka: server MCP untuk klien AI, layanan terhubung untuk otomatisasi rutin, dan ekspor untuk memindahkan materi ke tempat lain. Whisperer tidak menerbitkan REST API umum — alamat di bawah /v1/ adalah kanal privat antara aplikasi kami sendiri dan backend, tanpa janji kompatibilitas, dan dapat berubah sewaktu-waktu.

Ini batas yang disengaja, bukan kelalaian. API yang diterbitkan harus tetap bekerja bertahun-tahun; MCP memberi akses yang sama dengan versioning, layar persetujuan, dan pencabutan yang sudah menyatu.

Kapan menggunakannya

  • Anda ingin asisten AI membaca rapat dan bekerja dengan tugas — MCP.
  • Anda ingin tindakan berulang («rapat baru → baris di lembar kerja») — Zapier.
  • Anda ingin materinya sendiri di alat lain — ekspor.

Langkah demi langkah

  1. Untuk klien AI, hubungkan lewat MCP: MCP: menghubungkan Claude, ChatGPT, dan Cursor. Inilah jalur programatis yang didukung dan satu-satunya yang tercakup janji kestabilan.
  2. Untuk otomatisasi, hubungkan Zapier, Notion, Slack, atau HubSpot di akun Anda, lalu susun skenarionya di layanan tersebut.
  3. Untuk pemindahan sekali jalan, ekspor rapat ke Markdown, SRT, VTT, atau JSON dari halaman rapat.
  4. Untuk informasi produk yang terbaca mesin — misalnya agar asisten AI menjawab pertanyaan tentang Whisperer sendiri — arahkan ke https://whisperer.one/llms.txt atau korpus lengkap https://whisperer.one/llms-full.txt. Keduanya publik dan tanpa autentikasi.

Apa yang publik

Alamat Apa itu
https://whisperer.one/mcp Server MCP untuk klien AI eksternal
https://whisperer.one/.well-known/oauth-protected-resource Tempat klien mempelajari cara autentikasi
https://whisperer.one/.well-known/oauth-authorization-server Endpoint OAuth dan area yang didukung
https://whisperer.one/llms.txt Indeks produk untuk sistem AI
https://whisperer.one/llms-full.txt Seluruh dokumentasi publik dalam satu berkas
https://whisperer.one/docs/en/<halaman>.md Halaman dokumentasi bahasa Inggris mana pun dalam Markdown murni

Kesalahan umum

  • Membangun di atas /v1/. Alamat itu internal: tertutup bagi perayap, skemanya dimatikan di produksi, dan berubah tanpa pemberitahuan.
  • Mencari kunci API. Tidak ada, karena tidak ada REST API publik. Akses eksternal berupa token bearer dari alur persetujuan MCP.
  • Mengharapkan webhook. Otomatisasi keluar berjalan lewat Zapier dan layanan terhubung, bukan webhook milik kami.

Praktik terbaik

  • Baca endpoint OAuth dari dokumen metadata alih-alih menuliskannya di kode: mereka diterbitkan di sana justru agar bisa berpindah tanpa merusak klien.
  • Buat satu koneksi untuk tiap integrasi, agar mencabut satu tidak memengaruhi yang lain.

Artikel terkait