Dokumentasi
Cara pakai Nata
Nata adalah asisten AI berbahasa Indonesia yang menjawab apa saja dan paling kuat di urusan jualan online. Pakai di app.nyataka.com, di Telegram, lewat ekstensi Chrome, atau (Max) di situs tokomu sendiri. Mulai dari Free dan langsung chat. Max masih pending dan jalan sebagai Free sampai operator mengonfirmasi. Aksi yang mengubah toko selalu menunggu tap kamu. Dukungan: [email protected].
Kalkulator profit publik. Hitung harga jual, HPP, fee marketplace, dan ROAS impas tanpa daftar. Setiap fee membawa sumber dan tanggal. Buka kalkulator →
Simpan audit. Setelah menghitung, tekan “Simpan audit” untuk mendapat token klaim. Masuk ke app, tempel token di Aktivitas, dan audit masuk ke akunmu.
Hapus akun & data. Buka Akun → Hapus akun & data. Permintaan punya masa tunggu 7 hari dan bisa dibatalkan. Rincian →
Mulai
Chat di app.nyataka.com, di Telegram lewat @nyataka_bot, atau lewat ekstensi Chrome untuk membaca tab yang sudah kamu buka dan login. Di desktop, ekstensi memakai tab itu apa adanya. Di ponsel, sambungkan akun di tab Akun karena ekstensi hanya ada di desktop. Aksi yang mengubah toko tetap menunggu persetujuanmu.
Cara pakai
- Masuk — Google atau email + password di app.nyataka.com.
- Chat — tulis di kotak bawah, Enter kirim. Kuota harian tampil di bawah kotak pesan dan di tab Akun. Di chat kosong ada contoh pertanyaan yang bisa diklik. Tiap jawaban punya tombol Salin dan Ulangi.
- Lampiran — tombol 📎: foto (JPEG/PNG/WebP/GIF), PDF, teks/CSV/JSON, Excel (.xlsx), dan file suara (WAV, MP3, OGG termasuk pesan suara WhatsApp). Foto besar dikecilkan otomatis; maksimal 4 MB per file, 4 file per pesan.
- Pesan suara — tombol mikrofon: rekam, tekan lagi untuk selesai, lalu kirim. Nata mendengarkan dan menjawab isinya.
- Approval — kalau Nata mengusulkan aksi yang mengubah sesuatu (jeda iklan, menjalankan otomatisasi), kartu menunggu tap Setuju/Tolak di menu Approval. Kartu menampilkan persis apa yang akan dijalankan.
- Jadwal — pengingat yang dipasang Nata dan analisis yang sedang atau sudah berjalan. Pengingat yang jatuh tempo muncul di app ini saat kamu buka (paket Free sampai di sini), dan dikirim ke Telegram begitu akunmu tersambung ke @nyataka_bot (paket Max). Halaman Jadwal menyebutkan jalur yang aktif untuk akunmu.
- Memori Nata — Nata menyimpan fakta bisnis yang kamu minta diingat dan topik yang sering dibahas, per akun (bukan melatih ulang model).
- Ekstensi Chrome — unduh dari kartu di chat, muat sebagai ekstensi, klik ikonnya untuk membuka panel Nata di sisi kanan. Izinkan sekali; setelah itu Nata membaca tab yang sedang kamu buka saat kamu bertanya tentangnya.
- Review situs publik — tempel link dan tanya. Nata membaca halamannya lebih dulu sebelum menjawab; kalau situsnya memblokir, dia bilang begitu.
Yang bisa dikerjakan Nata
Paket menentukan batas harian dan fitur. Angka di bawah adalah batas paket Free dan Max saat ini.
| Kemampuan | Paket | Cara pakai |
|---|---|---|
| Jawab apa saja: web, berita, cuaca, hitungan, kode, tulisan, terjemahan | semua | Tanya saja. Fakta terkini dicari di web dan disertai sumber. |
| Baca foto, PDF, Excel, CSV, dan pesan suara | semua | Lampirkan atau rekam, lalu tanya isinya. |
| Pengingat | semua 2 / 100 aktif (Free / Max); berulang harian atau mingguan mulai Max | "Ingatkan aku besok jam 9 untuk restock." Lihat dan batalkan di tab Jadwal. |
| Ringkasan pagi | Max | "Nyalakan ringkasan pagi jam 7." Berisi agenda, approval yang menunggu, analisis, halaman yang berubah, saldo kas. Tidak dikirim kalau tidak ada isinya. Dijalankan otomatis tiap jam. |
| Buat dan edit gambar | Max 2 per hari | "Buatkan foto produk latar putih." Atau lampirkan foto: "ganti latar jadi krem, produknya jangan diubah." |
| Baca Sheets, Docs, Kalender (hanya baca) | Max | Hubungkan Google di tab Akun, lalu tanya. Link Sheets/Docs boleh ditempel langsung. Untuk Gmail, buka Gmail di Chrome lalu pakai ekstensi Nata yang membaca tab itu. |
| Pantau halaman web publik | Max 20 halaman | "Pantau halaman ini, kabari kalau harga berubah." Dicek tiap beberapa jam; hanya perubahan penting yang dikabarkan. Marketplace besar sering memblokir pembacaan dari server, dan pemantauan berhenti setelah tiga kali gagal. |
| Analisis mendalam (laporan keputusan) | Max 5 per bulan | "Buatkan analisis mendalam dari halaman ini." Buka halaman pencarian atau kategori di Chrome dengan ekstensi Nata (paling andal untuk Tokopedia, Shopee, TikTok Shop), atau kirim link halaman publik. Berjalan 3-10 menit di latar belakang; hasilnya (keputusan, alasan, syarat, dan tautan laporan lengkap) datang ke chat. Kalau buktinya belum cukup, laporannya bilang begitu. |
| Baca performa iklan Meta | Max | Minta sambungan Meta Ads di chat ("hubungkan Meta Ads"), lalu tanya performa kampanye: spend, klik, impresi. Status tiap platform iklan ada di tab Akun. |
| Otomatisasi terjadwal (dengan persetujuan) | Max | Operator mendaftarkan otomatisasi untuk akunmu. Nata mengusulkannya sebagai kartu Approval; baru berjalan setelah kamu setuju. |
Daftar perintah (/ dan @)
Ketik di kotak chat web (bukan BotFather). Perintah tidak dikenal → /bantuan.
| Perintah | Paket | Tujuan |
|---|---|---|
/bantuan /help | always | Daftar perintah lengkap |
/approval | always | Jumlah pending + cara tap Approval |
/akun /paket | always | Paket, kuota, tab Akun |
/nata @nata | always | Nata chief of staff (sesi web default) |
/lampir | always | Cara kirim foto/PDF di composer |
/jeda | always | Jelaskan gerbang Approval; tidak pause diam-diam |
@laporan @report /laporan | Max | Ringkasan toko/iklan; sebut data yang kurang |
@banding @compare /banding | Max | Kompetitor vs toko (analis) |
@harga | Max | Price watch / harga saingan |
@iklan /iklan | Max | Performa iklan Meta; di Max dibaca role iklan |
@cpa | Max | Cek CPA/ROAS |
@analis | Max | Langsung ke anggota analis |
@kreatif | Max | Langsung ke anggota kreatif |
@cs | Max | Langsung ke anggota CS |
@keuangan | Max | Langsung ke anggota keuangan |
@skrip /balas | Max | Draf teks buat seller (kamu yang kirim) |
@caption /listing | Max | Draf listing/caption (kreatif) |
@kas /saldo | Max | Saldo/cashflow (keuangan) |
Integrasi & saluran
Setiap saluran menjalankan Nata yang sama, dengan alat dan riwayat percakapan yang sama. Paket yang dibutuhkan ditulis di kalimatnya. API adalah produk terpisah, dengan batas dan panduannya sendiri.
Untuk developer: cara memasang widget di situs sendiri, memakai API POST /webhook/nata, mengirim katalog, batas, dan daftar error ada di Panduan integrasi self-hosted. Dukungan: [email protected].
Web — app.nyataka.com: chat, Kabar, Jadwal, lampiran, dan pesan suara.
Telegram (Max) — @nyataka_bot memakai Nata yang sama dengan alat yang sama dan percakapan yang sama dengan web. Kirim teks, foto, PDF, Excel, atau pesan suara; gambar dari Nata datang sebagai foto. Pengingat, ringkasan pagi, dan kabar pantauan ditujukan ke sini juga, tapi pengiriman sungguhannya belum kami konfirmasi. Untuk menyambung ke akun web, ambil kode di tab Akun lalu kirim kodenya ke bot.
Ekstensi Chrome (Max) — panel Nata di sisi kanan browser. Membaca satu tab aktif hanya saat kamu bertanya, setelah kamu mengizinkan sekali; tidak membaca kata sandi, cookie, atau tab lain.
Widget di situs tokomu (Max) — satu baris skrip menampilkan Nata di sisi kanan situsmu. Untuk pembeli, Nata menjawab dari katalog dan kebijakan tokomu yang diimpor (produk, harga, stok, halaman kebijakan) dan tidak mengarang. Kamu sebagai admin bisa login dan memakai Nata dari halaman yang sama, dengan konteks halaman itu. Ada batas per hari dan daftar domain yang diizinkan. Pengaturannya punya halaman sendiri: buka Integrasi → Widget di situs di app (bukan lagi di dalam tab Akun). Cara pasang lengkap: panduan integrasi.
WhatsApp Cloud API — belum tersedia di produksi. Hubungi [email protected] kalau butuh prioritas.
Discord & Slack — integrasi belum jadi; aktivasi manual lewat tim Nyataka.
Produk terpisah API untuk web self-hosted — sistem atau CS milikmu mengirim pesan ke POST https://app.nyataka.com/webhook/nata dengan header Authorization: Bearer <kunci> dan body {"text": "...", "thread_id": "opsional"}. Balasan datang sinkron di response yang sama; isi callback_url (https) dari halaman API untuk juga menerima salinan balasan di sana, atau kirim {"mode": "async"} untuk langsung dapat 202 dan balasan menyusul lewat callback. Kunci, harga per pesan, dan meteran pemakaian ada di halaman API-nya sendiri: api.nyataka.com (paket terpisah; app penjual tidak memuat API). Panduan developer lengkap (quickstart curl + JavaScript, kirim katalog, daftar error, troubleshooting): nyataka.com/docs/api. Pertanyaan: [email protected].
Widget masuk paket Max; API server-to-server adalah produk terpisah dari langganan chat. API dibeli sebagai paketnya sendiri, dan pemakaiannya dihitung per pesan dengan kredit prabayar. Jatah harian chat web tidak terpakai oleh API. Rincian batas dan harga ada di panduan integrasi.
Logo
Navigasi memakai mark SVG inline di halaman (latar terang). Berkas tetap ada di /assets/logo.svg dan /assets/logo.png.
Ekstensi Chrome: pakai, izin, dan kalau bermasalah
Ekstensi Nata menaruh Nata di panel kanan browser, tepat di samping halaman yang sedang kamu buka. Ada di paket Max dan hanya bisa dipasang di komputer, bukan di ponsel.
Yang dikerjakan ekstensi
- Membaca tab yang sedang kamu lihat. Teks yang terlihat di tab itu ikut terkirim saat kamu bertanya soal halaman itu. Tidak ada tab lain yang dibaca, dan tidak ada yang dikirim sebelum kamu menekan Kirim.
- Menerima foto dan file. Tombol 📎 sama seperti di app: foto (JPEG/PNG/WebP/GIF), PDF, teks/CSV/JSON, Excel (.xlsx), dan file suara (WAV, MP3, OGG, termasuk pesan suara). Maksimal 4 MB per file dan 4 file per pesan; foto besar dikecilkan otomatis.
- Percakapan yang sama dengan app. Panel memakai akun yang sama, percakapan yang sama, dan kuota harian yang sama dengan app.nyataka.com - bukan jatah tambahan. Pertanyaan dari panel muncul di app, dan sebaliknya, karena keduanya menulis ke percakapan yang sama.
- Approval tetap di app. Kalau Nata mengusulkan aksi yang mengubah toko, panel cuma memberi tahu bahwa ada yang menunggu. Tap Setuju/Tolak dilakukan di app.
Izin yang diminta, dan kenapa
Chrome menanyakan satu izin saat kamu pertama kali memakai Baca halaman di panel. Kamu boleh menolaknya: chat biasa tetap jalan, yang hilang hanya kemampuan membaca halaman. Kalau nanti berubah pikiran, tombol izinnya muncul lagi di panel, atau atur di chrome://extensions › Detail › Izin situs.
| Izinnya | Untuk apa |
|---|---|
| Membaca halaman situs yang kamu buka | Supaya Nata bisa membaca teks halaman di tab yang sedang kamu lihat saat kamu bertanya tentang halaman itu. Chrome menyebutnya izin untuk situs web. |
| Halaman app.nyataka.com | Supaya panel bisa memakai sesi login kamu di app, jadi kamu tidak perlu masuk dua kali. Izin bawaan ekstensi, tidak ditanyakan lagi. |
| Penyimpanan ekstensi di browser ini | Hanya untuk mengingat sesi loginmu supaya panel tidak minta masuk tiap dibuka. |
Yang tidak dilakukan ekstensi: tidak membaca tab lain, tidak membaca kata sandi (baris yang memuat kata sandi, PIN, OTP, atau CVV dibuang sebelum teks dikirim), tidak membaca cookie, dan tidak menyimpan isi halaman. Isi halaman baru dikirim ke Nata pada pesan yang kamu kirim sendiri, dan tidak disimpan di browser.
Kalau tab app-nya sudah kebuka duluan
Ada satu perilaku Chrome yang dulu bikin bingung, dan sekarang sudah ditangani. Chrome hanya menyisipkan bagian ekstensi ke halaman yang dimuat setelah ekstensi terpasang. Jadi tab app.nyataka.com yang sudah kamu buka sebelum memasang (atau sebelum memperbarui) ekstensi tidak punya bagian itu, dan panel tidak bisa membaca sesimu di situ. Dulu itu berarti kamu harus membuka app dulu supaya panel mau masuk. Sekarang panel menaruh bagian itu sendiri ke tab yang sudah terbuka, jadi kamu tidak perlu klik apa-apa lagi.
Yang masih perlu kamu tahu: app yang tabnya sudah terbuka memuat percakapan sekali saja saat halaman itu dibuka. Kalau kamu chat dari panel sementara tab app sudah terbuka, tab itu masih menampilkan percakapan lama sampai halaman itu dimuat ulang atau kamu berpindah halaman lalu kembali ke chat. Membuka tabnya saja tidak menyegarkan isinya. Isi percakapannya sendiri tidak hilang: yang di panel tetap tersimpan di percakapan yang sama, dan muncul di app begitu halaman itu dimuat ulang.
Kalau ada yang tidak jalan
| Yang kamu lihat | Artinya | Cara memperbaiki |
|---|---|---|
| Ekstensi tidak terdeteksi di app | Panelnya belum terpasang di browser ini, atau sedang tidak terbuka, atau tab ini bukan tempat Nata dipasang. | Pasang ekstensinya, lalu buka panelnya sekali dengan klik ikon Nata di toolbar. Setelah itu app bisa mengenalinya. Di ponsel, ekstensi memang tidak ada. |
| Tab ini belum bisa dibaca | Halaman itu melarang pembacaan dari luar, atau belum selesai dimuat. | Muat ulang halamannya, lalu tanya lagi. Kalau tetap tidak bisa, salin isinya ke chat atau lampirkan filenya dengan 📎. |
| Tab ini tanpa teks (PDF atau gambar) | Halamannya bukan teks, jadi tidak ada yang bisa dibaca. | Unduh berkasnya, lalu lampirkan dengan 📎. Nata membaca PDF, Excel, dan gambar dari lampiran. |
| Baca halaman ada di paket Max | Pembacaan halaman belum termasuk di paketmu. Chat, lampiran, dan pesan suara tetap jalan. | Pakai lampiran atau tempel link halamannya. Kalau butuh membaca tab langsung, itu bagian dari paket Max. |
| Chat tidak berlanjut, balasan tidak muncul | Sambungan ke Nata terputus, atau kuota harianmu sudah habis. | Cek sisa kuota di bawah kotak pesan. Kalau masih ada, tutup panelnya lalu buka lagi, dan kirim ulang pesanmu. Pesan yang gagal tidak ikut terhitung. |
| Panel minta masuk lagi | Sesi loginmu di browser ini sudah kedaluwarsa atau dihapus. | Masuk sekali di app.nyataka.com, lalu buka panelnya: panel ikut masuk sendiri. Kalau akunmu masuk lewat Google, masuknya memang harus lewat app dulu. |
| Masuk dengan email dan kata sandi gagal | Email atau kata sandinya tidak cocok, atau akunmu memang masuk lewat Google. | Ulangi di app.nyataka.com. Kalau akunmu memakai Google, pakai tombol Google di app, bukan kata sandi. Sesudah berhasil, panelnya ikut masuk. Lupa kata sandi? Email [email protected]. |
| Panel bilang ada versi baru | Ekstensi yang jalan di browser ini lebih lama daripada yang terbaru. | Lihat bagian di bawah. |
Cara memperbarui ekstensi
Ekstensi yang dipasang dari Chrome Web Store diperbarui Chrome sendiri, dan kamu tidak perlu melakukan apa-apa. Ekstensi yang dipasang dari berkas zip di app tidak bisa memperbarui dirinya, jadi harus kamu unduh ulang. Kalau lupa asalnya dari mana: buka chrome://extensions, dan lihat apakah kartu Nata punya tombol Hapus disertai keterangan dari Web Store, atau dimuat dari folder.
- Buka
chrome://extensions. - Klik Perbarui di kanan atas. Untuk pemasangan dari Web Store, ini biasanya sudah cukup.
- Kalau kartu Nata dimuat dari folder: unduh zip terbarunya di app (Akun › Ekstensi Nata), ekstrak, lalu timpa folder ekstensi yang lama dengan isi folder yang baru.
- Klik ikon muat ulang (↻) di kartu Nata, atau tutup dan buka lagi panelnya.
Dari mana kamu tahu perlu memperbarui? Panel Nata menampilkan baris “Versi baru … tersedia (kamu …)” di bawah percakapan kalau versi yang kamu pakai lebih lama. Halaman Akun di app juga menyebut versi yang terpasang di browser itu. Kalau keduanya diam, artinya kamu sudah di versi terbaru, atau app memang belum bisa memastikan versimu - dan app memilih diam daripada menebak. Nomor versinya sendiri selalu bisa kamu lihat di chrome://extensions pada kartu Nata.