> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/id/guide/account/user-applications/creating-new-user-applications.md).
# Membuat aplikasi Pengguna baru
Saat menyiapkan sebuah **Aplikasi Pengguna** , Anda akan bekerja dengan beberapa konfigurasi utama yang menentukan bagaimana aplikasi eksternal Anda terintegrasi dengan platform. Mari kita bahas setiap komponen penting.
Mulailah dengan mengeklik tombol pada **Aplikasi pengguna** daftar. Pada formulir konfigurasi yang muncul, lanjutkan dengan langkah-langkah berikut:
{% stepper %}
{% step %}
**Atur URL**
Tentukan URL aplikasi Anda - alamat tempat aplikasi Anda di-host, ini menjadi dasar integrasi.
{% hint style="danger" %}
* Pastikan URL valid, menggunakan koneksi HTTPS, mengarah ke sumber yang tepercaya, dan tidak melebihi 1000 karakter.
* Pastikan aplikasi memiliki pengaturan iFrame yang diaktifkan di sisinya, jika tidak, Anda tidak akan dapat membukanya di antarmuka platform.
{% endhint %}
{% endstep %}
{% step %}
**Konfigurasikan Parameter dasar**
Untuk mempersonalisasi aplikasi Anda, Anda dapat menyertakan berbagai parameter dalam URL. Anda dapat menambahkan parameter secara manual di kolom URL atau menggunakan salah satu saran kami: bahasa, ID pengguna, atau zona waktu. Klik salah satu saran parameter untuk menambahkannya di akhir URL. Buka deskripsi di bawah untuk mempelajari lebih lanjut tentang parameter yang disarankan dan contohnya.
Memahami parameter URL yang disarankan
Kami menyarankan beberapa parameter dasar untuk personalisasi
1. `?locale={locale_code}`\
Parameter bahasa yang secara otomatis cocok dengan bahasa platform pengguna.
* Contoh: `https://your-app.com/dashboard?locale=en`
2. `?user_id={user_identifier}`\
Parameter konteks pengguna yang meneruskan identitas pengguna untuk memfilter informasi yang dipersonalisasi.
* Contoh: `https://your-app.com/dashboard?user_id=12345`
3. `?timezone={timezone}`\
Parameter waktu yang secara otomatis cocok dengan zona waktu platform pengguna.
* Contoh: `https://your-app.com/dashboard?timezone=UTC+1`
Anda dapat mengedit nama parameter yang disarankan atau menentukan nilai tertentu untuknya.
{% hint style="info" %}
Uji konfigurasi Anda untuk memastikan aplikasi dimuat dengan benar. Klik untuk menampilkan pratinjau.
{% endhint %}
{% endstep %}
{% step %}
**Sesuaikan tampilan**
Buat identitas yang mudah dikenali untuk aplikasi Anda agar mudah diakses. Pengaturan berikut akan membantu Anda melakukannya:
* **Label** – Tambahkan nama yang unik dan deskriptif untuk aplikasi Anda (hingga 24 karakter). Nama ini akan ditampilkan di bilah sisi platform.
* **Deskripsi** – Tambahkan penjelasan singkat dengan detail tentang fungsi aplikasi atau soroti informasi penting (hingga 50 karakter). Deskripsi yang informatif akan membantu pengguna Anda memahami tujuan aplikasi dengan lebih jelas.
* **Ikon** – Pilih ikon yang mewakili fungsi aplikasi Anda untuk navigasi yang terasa lebih asli.
{% endstep %}
{% step %}
**Pilih metode tampilan**
Tentukan bagaimana aplikasi Anda akan terbuka dengan memilih salah satu dari dua opsi di **Buka di** dropdown:
* **Tersemat** – Aplikasi muncul di dalam antarmuka platform
* **Tab baru** – Aplikasi terbuka di tab browser terpisah
{% hint style="info" %}
Platform kami menggunakan iFrame untuk penyematan. Karena tidak semua URL dapat berhasil diproses dengan teknologi ini, pastikan Anda meninjau pratinjau hasil penyematan. Jika Anda mengalami masalah apa pun dengan metode tampilan ini, silakan pertimbangkan untuk menggunakan **Tab baru**.
{% endhint %}
{% endstep %}
{% step %}
**Atur autentikasi (opsional)**
Konfigurasikan autentikasi jika aplikasi Anda bergantung pada API platform. Dalam hal ini, platform akan memberikan data autentikasi langsung ke aplikasi saat dibuka, sehingga Anda tidak perlu menerapkan fungsi login tambahan di sisi aplikasi Anda.\
Anda dapat memilih salah satu dari dua metode autentikasi:
* **kunci API**
* Metode ini ditujukan untuk aplikasi yang tidak memerlukan pengelolaan peran atau izin pengguna.
* Kunci API sesuai dengan tingkat akses pemilik akun. Ini berarti memberikan kunci API kepada pengguna biasa dapat memberi mereka akses ke **semua data** yang tersedia bagi pengguna utama.\
Sebagai contoh, jika aplikasi Anda bekerja dengan pelacak yang memiliki hak terbatas atau tidak memiliki akses sama sekali bagi pengguna, penggunaan kunci API tetap akan menampilkan semua pelacak dari akun utama.
* **Kunci sesi**
* Metode ini direkomendasikan saat pengelolaan peran terlibat.
* Meneruskan kunci sesi pengguna saat ini ke aplikasi.
{% hint style="info" %}
Memilih **kunci API** metode akan secara otomatis menonaktifkan **Kunci sesi** metode, dan sebaliknya. Hanya satu metode yang dapat digunakan pada satu waktu.
{% endhint %}
Saat autentikasi diaktifkan, platform menambahkan `?session_key=` parameter ke URL aplikasi Anda.
* Jika Anda telah memilih sebuah **kunci API**, nilai parameter akan berisi kunci ini.
* Jika Anda memilih sebuah **Kunci sesi**, nilai parameter akan menyertakan kunci sesi pengguna saat ini dari tempat aplikasi sedang diakses.
Pastikan aplikasi mampu membaca dan menggunakan parameter ini.
{% endstep %}
{% step %}
**Simpan aplikasi baru**
Klik tombol **Simpan** tombol. Aplikasi Anda akan muncul di **Aplikasi pengguna** daftar dan bilah sisi platform. Aplikasi yang diaktifkan secara otomatis menjadi tersedia bagi pengguna akun.
{% endstep %}
{% endstepper %}
Contoh tampilan Aplikasi Pengguna yang disematkan
Tips pemecahan masalah cepat
Jika aplikasi Anda tidak ditampilkan dengan benar saat disematkan, coba:
* Membukanya di tab baru sebagai gantinya
* Memverifikasi bahwa URL Anda benar dan dapat diakses
* Memeriksa bahwa semua parameter diformat dengan benar
Aplikasi yang dibuat tetap dapat dikonfigurasi sepenuhnya setelah disimpan. Anda dapat menyesuaikan parameter dan tampilannya kapan saja. Untuk mempelajari lebih lanjut tentang pengelolaan aplikasi, lihat [Mengelola Aplikasi Pengguna yang sudah ada](/docs/user/id/guide/account/user-applications/managing-existing-user-applications.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/user/id/guide/account/user-applications/creating-new-user-applications.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.