# API ERP (SyBox)

Lokasi: Pengaturan > Integrasi > API ERP

Fungsi fitur ini:

Sistem Anda sendiri ditampilkan sebagai tombol di samping setiap chat. Saat agen membuka percakapan, SyBox meminta data pelanggan tersebut ke sistem Anda dan menampilkan jawabannya di samping chat, sehingga agen tidak perlu keluar dari SyBox. Jawabannya bisa berupa pesanan, saldo, tiket, atau apa pun yang dikembalikan sistem Anda. SyBox mengirimkan nomor telepon pelanggan, atau alamat email mereka pada percakapan email.

Ada dua tipe API ERP:

- "Tab samping — tampilkan data di samping chat": tombol di bilah samping kotak masuk. Mengekliknya akan menampilkan data sistem Anda untuk pelanggan yang sedang dibuka.
- "Produk — cari katalog Anda dan kirim item ke chat": agen mengetik apa yang diinginkan pelanggan. Sistem Anda mengembalikan produk yang cocok, ditampilkan sebagai kartu berisi nama, harga, gambar, dan stok. Satu ketukan akan memasukkan tautan produk ke kotak pesan.

### Cara menambahkan API ERP

1. Buka Pengaturan > Integrasi > API ERP.
   ![Settings, ERP APIs: a connected stock system that shows as a button in conversations](https://www.sybox.io/res/sybox/help/id/add-an-erp-api-1.webp?v=2c093636)
2. Klik "Tambah API ERP".
   ![The new ERP API window: its type first, then its name, button and address](https://www.sybox.io/res/sybox/help/id/add-an-erp-api-2.webp?v=f8b023d7)
3. Pilih "Tipe" (lihat dua tipe di atas).
4. Isi "Nama tampilan", yaitu nama lengkap integrasi.
5. Isi "Nama tombol", yaitu label singkat yang dilihat orang pada tombol.
6. Pada "Ikon tombol", klik ikon yang Anda inginkan untuk tombol tersebut.
7. Pada "URL API ERP", tempel alamat sistem Anda. Alamat harus dimulai dengan http:// atau https://.
8. Pada "Token ERP", tempel token dari sistem Anda, jika menggunakannya. SyBox mengirimkannya pada setiap permintaan agar sistem Anda tahu panggilan tersebut benar-benar dari Anda.
9. Opsional: di bawah "Header kustom", klik "Tambah header" untuk mengirim pasangan nama/nilai tambahan pada setiap permintaan, misalnya kode cabang. Setiap header memiliki tombol aktif/nonaktif sendiri, sehingga Anda dapat menjedanya tanpa menghapusnya. Klik ikon tempat sampah untuk menghapus header. Beberapa nama header yang digunakan SyBox sendiri akan diabaikan.
10. Klik Simpan.

Tombol baru langsung muncul di kotak masuk. Anda tidak perlu memuat ulang halaman.

### Cara mengedit, menjeda, atau menghapus API ERP

1. Temukan kartunya di daftar API ERP.
2. Klik Edit untuk mengubah apa pun. Untuk mempertahankan token yang tersimpan, biarkan "Token ERP" kosong ("Kosongkan untuk mempertahankan yang saat ini").
   ![To edit, pause or delete an ERP API: "Edit" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/id/edit-pause-or-delete-an-erp-api-2.webp?v=2e0240ae)
3. Klik Aktifkan / Nonaktifkan untuk menyembunyikan atau menampilkan tombol di kotak masuk. Kartu yang dinonaktifkan ditandai "Dinonaktifkan".
4. Klik Hapus, lalu konfirmasi "Hapus integrasi ini?".

Tampilan kartu: nama, nama tombol, alamat, serta "Aktif" atau "Dinonaktifkan". Kartu menampilkan "Tidak ada token" jika tidak ada token yang disimpan. Jika token disimpan, hanya karakter terakhirnya yang ditampilkan.

Aturan dan pesan:

- "Nama tampilan", "Nama tombol", dan "URL API ERP" wajib diisi. Jika salah satunya kosong, Anda akan melihat "Data tidak lengkap".
- Alamat harus dimulai dengan http:// atau https://.

Membangun di sisi Anda: Dokumentasi Developer SyBox publik (di situs web SyBox, di bawah Pengembang) menjelaskan apa yang dikirimkan SyBox dan bagaimana sistem Anda harus merespons. Ini mencakup format tampilan, baris yang dapat diklik untuk membuka detail suatu data, dan pencarian produk.

**Q: Saya sudah menambahkan API ERP tetapi tidak ada tombol di samping chat.**

Pastikan kartu berstatus "Aktif". Kedua tipe tersebut berupa tombol di bilah samping kotak masuk.

**Q: Panel terbuka tetapi tidak menampilkan data atau muncul pesan error.**

SyBox menampilkan apa pun yang dikembalikan sistem Anda. Pastikan alamat Anda dapat dijangkau dari internet, token sudah benar, dan sistem Anda dapat menemukan pelanggan berdasarkan nomor telepon (atau email pada percakapan email).

**Q: Bisakah saya menghubungkan lebih dari satu sistem?**

Bisa. Tambahkan API ERP sebanyak yang Anda butuhkan. Masing-masing mendapatkan tombol tersendiri.

**Q: Siapa yang dapat melihat data di panel?**

Anggota tim yang dapat membuka percakapan tersebut di kotak masuk.

Source: https://www.sybox.io/id/help/erp-apis