Satu Nata. Lima cara memakainya.

App Nata

Tempat paling sederhana untuk mulai. Login, tulis tugas, lihat langkah dan sumbernya.

1. 1Buka app.nyataka.com dan masuk.
2. 2Tulis tugas di kotak chat. Satu percakapan untuk satu tugas; topik baru = percakapan baru.
3. 3Kalau butuh kerja di halaman, pasang extension dan pilih mode akses: Baca, Persetujuan, atau Penuh.
4. 4Untuk pekerjaan halaman, Nata membaca dulu, menyiapkan perubahan, lalu meminta persetujuan (kecuali mode Penuh).

Extension Nata

Tangan Nata di Chrome. Bukan cursor; Nata memakai elemen dan ref, bukan menebak koordinat.

1. 1Pasang atau reload extension Nata versi 2.6.1.
2. 2Buka panel Nata, login dengan akun Nyataka.
3. 3Tekan “Izinkan Nata bekerja di window ini”. Chrome menampilkan infobar di tab yang di-attach.
4. 4Nata bisa melihat daftar tab, membuka tab riset, membaca, membandingkan, lalu kembali ke form asli.

Yang perlu diisi

Status workspace untuk halaman

Halaman bisa menampilkan Nata bisa membaca window ini dari sinyal extension:

window.__NYATAKA_WORKSPACE__ = { active, tab_id, active_tab_id, at }
window.postMessage({ type: "nyataka:workspace-status", active, tab_id, active_tab_id }, "*")

Login. Kalau tab riset membuka halaman login, Nata berhenti dan meminta seller login. Nata tidak mengisi password, OTP, 2FA, atau captcha. Setelah login, minta Nata lanjut.

Copilot halaman

Nata menempel di halaman admin milikmu. Kamu mengirim apa yang terlihat; Nata mengembalikan kalimat dan aksi yang boleh dijalankan halaman.

Dua jalur auth

{
  "mode": "copilot",
  "session_id": "percakapan-1",
  "message": "Ubah nama toko jadi Rumaisha Hijab",
  "access_mode": "approval",
  "platform": "desktop",
  "workspace_token": "opsional",
  "page": {
    "url": "https://admin.tokomu.com/pengaturan",
    "title": "Pengaturan Toko",
    "fields": [
      { "name": "store_name", "label": "Nama toko",
        "value": "Lama", "type": "text" }
    ],
    "elements": [
      { "ref": "r1", "role": "button", "name": "Simpan" }
    ],
    "can_commit": true
  }
}

{
  "ok": true,
  "reply": "Nama toko sudah kusiapkan. Periksa lalu simpan.",
  "actions": [
    { "type": "set_field", "name": "store_name",
      "value": "Rumaisha Hijab" }
  ],
  "requires_approval": true,
  "max_actions": 12,
  "can": ["read_page", "set_field", "click",
          "in_page_navigation"],
  "cannot": ["other_tabs_without_extension", "files",
             "background_tasks"],
  "session_id": "percakapan-1"
}

Field

Workspace token (riset tab lain)

Buka popup Connect Nata dari halaman yang diizinkan. Popup memanggil POST /api/web/workspace-token dengan sesi seller, lalu mengirim token 15 menit ke opener. Kirim token itu sebagai workspace_token. Tanpa token: page-only, bukan error.

https://app.nyataka.com/connect-nata.html?origin=https://rumaisha.id

Widget pembeli

Satu baris script di website toko. Nata menjawab pembeli dari katalog dan kebijakan yang kamu kirim, bukan mengarang.

1. 1Paket Max. Buka Integrasi → Widget di situs di app.
2. 2Isi nama toko, website, dan origin (mis. https://tokumu.com dan https://www.tokumu.com). Simpan.
3. 3Tekan Baca katalog dari website, atau kirim katalog lewat API knowledge.
4. 4Salin snippet ke halaman toko. Kunci publik nata_pub_… bukan API key.

<script src="https://app.nyataka.com/embed/nata-widget.js"
        data-key="nata_pub_..." data-mode="shopper" defer></script>

Batas: 25 pesan pembeli/situs/hari; 30/10 menit per IP; 40/menit per situs; pesan 800 karakter. Origin harus sama persis, tanpa path atau trailing slash.

API

Untuk sistem, helpdesk, ERP, atau platform yang punya UI sendiri. Produk terpisah: prabayar, satu kredit per pesan, tanpa biaya bulanan.

curl -X POST https://app.nyataka.com/webhook/nata \
  -H "Authorization: Bearer $NATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Stok gamis ukuran L masih ada?",
       "thread_id":"cust-123"}'

{
  "ok": true,
  "reply": "Masih ada 4 pcs ukuran L.",
  "thread_id": "cust-123",
  "usage": { "messages_today": 12,
             "messages_this_month": 640 },
  "credits": 488
}

Error yang sering

Daftar lengkap, callback signature, dan async: Panduan API.

Kunci & token

Prompt yang bagus

Sebut konteks, batas, dan hasil yang diinginkan. Pilih permukaan, salin contohnya.

• Sebut halaman/tab “halaman yang sedang kubuka”, “tab riset”, “form pengaturan”.
• Sebut batas jangan sentuh field lain, jangan Simpan, jangan publish.
• Sebut output diff, 3 rekomendasi, tabel, atau satu kalimat.
• Minta sumber untuk klaim eksternal; Nata tidak boleh mengarang.
• Diff dulu untuk perubahan, sebelum commit.

Troubleshooting

Masih macet? [email protected] dengan key_id (bukan kuncinya), URL, dan waktu kejadian.