Notiamo

Notiamo untuk agen AI

Semua yang dibutuhkan agen AI untuk membuka akun gratis bagi pemiliknya, memasang widget di situs web, dan menangani komentar serta pekerjaan, tanpa peramban.

Alurnya

  1. Minta akun untuk pemilik Anda: kirim POST https://my.notiamo.com/api/agent/signup dengan email, name, agent, locale dan, jika ada, company, projectUrl (alamat situs web) dan referral. Jawabannya berisi requestId, pollSecret dan pollAfterSeconds.
  2. Minta pemilik membuka email konfirmasi yang dikirim Notiamo dan mengonfirmasinya. Tidak ada yang terjadi sampai mereka melakukannya.
  3. Lakukan polling GET https://my.notiamo.com/api/agent/signup/{requestId} dengan Authorization: Bearer <pollSecret> setiap pollAfterSeconds detik. Statusnya adalah pending, confirmed, expired atau reported.
  4. Saat statusnya confirmed, jawaban berisi kunci Anda (token, diawali ntm_) dan mcpUrl, satu kali saja. Simpan kunci itu segera: polling berikutnya tidak mengembalikannya. Ambil dalam 7 hari sejak konfirmasi.
  5. Hubungkan ke server MCP di https://my.notiamo.com/api/mcp dengan header Authorization: Bearer ntm_…. Jika aplikasi Anda mendukung masuk lewat MCP, aplikasi dapat memakai Masuk dengan Notiamo sebagai ganti kunci (lihat di bawah).
  6. Panggil list_projects (atau find_project) untuk menemukan proyek yang dibuat untuk Anda: proyek itu sudah memakai projectUrl Anda sebagai alamatnya. Jika alamat kosong atau salah, panggil update_project_address. Lalu get_install, pasang snippet-nya, dan check_install. Gunakan create_workspace dan create_project hanya jika paket masih punya ruang (paket berbayar atau uji coba Studio); create_project memerlukan workspaceId dari list_workspaces. Ruang kerja mengelompokkan proyek, misalnya satu per klien. Proyek boleh tanpa alamat web (hilangkan origin): maka proyek itu punya tugas, pekerjaan, dan kabar, tetapi tanpa widget. Setelah pemasangan, get_badge memberi lencana footer: logo kecil Notiamo untuk footer situs yang membuka alat tinjauan bagi peninjau dan menjadi tautan biasa ke Notiamo bagi yang lain, dalam bahasa situs (update_project_language, atau language di create_project).
  7. Lalu tangani komentar: list_comments, get_comment, reply dan set_status. Untuk memeriksa kabar terbaru, berikan since ke list_comments: waktu UTC yang berakhir dengan Z (seperti 2026-10-17T08:00:00Z), atau cursor dari jawaban terakhirnya. Anda hanya menerima yang berubah, pada satu proyek atau, tanpa projectId, pada semua proyek Anda. Simpan cursor baru untuk pemeriksaan berikutnya, ikuti more: true seketika, dan hilangkan duplikat berdasarkan id: satu item bisa datang dua kali.
  8. Untuk organisasi lain, panggil create_organization dengan name: pemilik menjadi adminnya dan menerima email, dan jawabannya berisi token baru hanya untuk organisasi itu. Organisasi itu gratis jika pemilik belum punya organisasi gratis; jika sudah, perlu paket: panggil get_payment_link dengan token baru, atau start_trial untuk uji coba Studio 14 hari (sekali per orang; pemilik membuka tautan dan memasukkan kartu). Ada batas harian; penolakan menyebutkan kapan Anda bisa mencoba lagi.
  9. Untuk memindahkan proyek ke ruang kerja lain (kind project, projectId, toWorkspaceId), atau ruang kerja beserta proyeknya ke organisasi lain tempat pemilik juga admin (kind workspace, workspaceId, toOrganizationId), panggil request_move. Belum ada yang dipindahkan: pemilik menerima email dan harus mengonfirmasi di halaman yang ditautkan, dalam 24 jam. Panggil get_move_request untuk statusnya: pending, done, cancelled, expired atau failed.
  10. Untuk menambahkan pekerjaan yang tidak terkait dengan halaman, panggil create_task dengan projectId dan title, serta opsional text dan pageUrl. Untuk mengubah redaksinya, panggil update_task dengan taskId dan title, text baru, atau keduanya. Keduanya dihitung dalam batas harian untuk ruang kerja, proyek, dan tugas baru; penolakan memberi tahu kapan Anda mencapainya. list_comments menampilkan tugas bertanda [Task] dan menerima type: task atau comment.
  11. Laporan pekerjaan (Studio, Agency, dan uji coba) adalah tugas yang diisi klien tentang pekerjaan yang selesai: tempat, tanggal, pelanggan akhir, dan file per fase (before, during, after, other) dengan keterangan. Panggil list_job_reports (state ready menampilkan yang menunggu Anda), baca satu dengan get_comment, dan balas dengan role article dalam bahasanya. Hanya manusia yang menyetujui: berikan tautan persetujuan kepada mereka atau panggil request_approval. Setelah disetujui, balas dengan role posts dan files (id file yang dipakai). update_file mengatur phase atau caption sebuah file; create_task dan update_task menerima jobReport.
  12. Catatan suara dan AI (Studio, Agency, dan uji coba): get_comment menampilkan setiap rekaman dengan tautan ke audio dan transkrip AI-nya (serta transkrip lanjutan apa pun, tidak dipublikasikan), setiap video lebih dari sekitar 20 detik dengan catatan waktu (m:ss–m:ss apa yang terjadi), dan keterangan AI yang ditandai (AI, not checked) sampai seseorang memeriksanya. Saat AI tidak dapat memproses sebuah file, hal itu dinyatakan dengan kata-kata sederhana yang sama seperti yang dilihat orang, dengan kode referensi (AI-…) untuk dukungan. list_plans dan get_billing memberikan menit suara dan AI per bulan.

Lakukan polling tidak lebih cepat dari pollAfterSeconds. Jika Anda menerima rate_limited, tunggu retryAfter detik. Id atau rahasia yang salah atau tidak dikenal mengembalikan 404 dengan {"code":"not_found"}.

Jika platform Anda menandatangani permintaannya dengan Web Bot Auth (tanda tangan pesan HTTP, Signature-Agent dengan direktori kunci) dan Notiamo memercayainya, pendaftaran dan server MCP menghitung Anda per platform, bukan per alamat, dengan batas lebih tinggi. Permintaan tanpa tanda tangan tetap berjalan seperti biasa.

Contoh: meminta akun

curl -X POST https://my.notiamo.com/api/agent/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@example.com","name":"Ada Owner","agent":"my-agent","locale":"en","projectUrl":"https://example.com"}'

Paket gratis

Paket gratis mengizinkan 1 ruang kerja, 1 proyek, 3 orang (anggota tim, anggota klien, dan undangan tertunda, setiap email dihitung sekali) dan 1 alamat publik per proyek. Setelah komentar publik pertama proyek, alamat dapat diubah satu kali. Paket ini menampung 100 MB file, 5 MB per file; di atas 100 MB admin organisasi menerima dua email, lalu file tertua dihapus, sedangkan komentar, tugas, dan balasan tetap ada. Unggahan dapat ditolak untuk mencegah penyalahgunaan. Video tidak termasuk: memerlukan Studio, Agency, atau uji coba. Sebuah ruang kerja dan sebuah proyek sudah ada saat akun dibuka.

Widget menampilkan lencana Notiamo di paket gratis.

Pertahankan baris komentar di atas tag script. Ketentuan paket gratis mewajibkannya:

<!-- Notiamo (notiamo.com): website feedback. Free plan: keep this line. -->

Penolakan plan_limit memberi tahu batas mana yang Anda capai dan apa yang harus dilakukan selanjutnya.

Penolakan

Pendaftaran dan alat menjawab dengan sebuah kode. Kode pendaftaran disertai status HTTP:

KodeStatus HTTPArtinya
signup_blocked403Jaringan ini tidak diizinkan mendaftar. Pemilik mendaftar sendiri.
country_blocked403Notiamo tidak tersedia di negara asal permintaan. Pemilik juga tidak dapat mendaftar dari sana.
rate_limited429Terlalu banyak permintaan. Tunggu retryAfter detik.
agent_signup_paused503Pendaftaran oleh agen dijeda untuk sementara. Pemilik mendaftar sendiri.
agent_signup_closed503Pendaftaran oleh agen ditutup. Pemilik mendaftar sendiri.
account_exists409Email ini sudah punya akun. Pemilik masuk dan membuat kunci di Pengaturan > Agen AI > Token agen.
email_not_accepted422Alamat email ini tidak dapat dipakai. Pemilik mendaftar sendiri.
invalid_input422Sebuah kolom tidak valid. field menyebutkan namanya.
plan_limit402Batas paket tercapai. Dikembalikan oleh alat MCP, beserta langkah berikutnya (start_trial atau get_payment_link).
read_only403Kunci atau aplikasi ini hanya-baca: dapat melihat tetapi tidak mengubah. Dikembalikan oleh alat MCP.
permission_missing403Kunci atau aplikasi ini tidak boleh melakukan ini. permission menyebut kelompok yang kurang (atau full). Dikembalikan oleh alat MCP.

Tunjukkan penolakan kepada pemilik Anda. Jangan pernah mencari jalan memutar.

Masuk dengan Notiamo (OAuth)

Alih-alih kunci, klien MCP yang mendukung proses masuk dapat terhubung dengan OAuth. Metadata server otorisasi ada di https://my.notiamo.com/.well-known/oauth-authorization-server, dan server MCP menjawab 401 dengan header WWW-Authenticate yang menunjuk ke metadata sumber daya terlindunginya (https://my.notiamo.com/.well-known/oauth-protected-resource/api/mcp, RFC 9728), yang menyebut server ini, dan menyarankan scope notes replies status tasks. Klien mendaftarkan diri sendiri dan memakai PKCE (S256), tanpa rahasia klien.

Pemilik Anda masuk, memilih organisasi, apa yang boleh Anda ubah (Menangani masukan dicentang) dan proyeknya, lalu menekan Izinkan. Scope-nya adalah kelompok izin di bawah. Pemilik Anda melihat aplikasi itu di Pengaturan > Agen AI > Aplikasi terhubung dan dapat memutuskannya kapan saja.

Izin

Membaca tidak memerlukan izin. Untuk mengubah sesuatu, kunci atau aplikasi terhubung membutuhkan kelompok yang sesuai:

notes replies status tasks setup invites billing moves

Hanya baca tidak punya kelompok. Menangani masukan memiliki notes, replies, status dan tasks. Penuh memiliki semuanya; mengundang anggota tim memerlukan Penuh. Tanpa kelompok itu, alat menolak dengan permission_missing dan menyebut kelompoknya di permission; kunci hanya-baca mendapat read_only. Tunjukkan kepada pemilik Anda: hanya mereka yang dapat memberi akses lebih.

Pembayaran

list_plans menampilkan paket (lihat halaman harga untuk harganya). start_trial memulai uji coba, sekali per orang. Harga

get_payment_link membuat tautan pembayaran yang dibuka dan dibayar oleh pemilik. Anda tidak pernah menangani data kartu.

Rujukan

Jika lencana atau tautan Notiamo membawa Anda ke sini, sertakan kodenya di kolom referral pada badan JSON pendaftaran. Bentuk ?via=<code> hanya untuk tautan web pendaftaran yang dibuka orang.

Alat MCP

Setelah terhubung, Anda dapat memanggil:

whoami list_projects find_project list_comments list_activity get_comment reply set_status assign list_team list_people get_account list_plans get_billing start_trial list_workspaces create_workspace create_project update_project_address update_project_language get_install get_badge check_install invite get_payment_link create_organization request_move get_move_request create_task update_task list_job_reports update_file request_approval

Selengkapnya