# Cara mengaktifkan gateway dan membuat kunci

Di SyBox, ini dilakukan di Pengaturan > Integrasi > Kunci API. 1) Buka Pengaturan > Integrasi > Kunci API. 2) Aktifkan tombol "Gateway API". 3) Klik "Kunci baru". 4) Pilih "Tipe kunci": 5) Isi "Nama perangkat atau program", misalnya "Komputer kantor" atau "Sistem akuntansi". Berikan kunci tersendiri untuk setiap perangkat atau program. 6) Untuk kunci "Kirim melalui WhatsApp", atur juga: 7) Untuk kunci "Impor SMS dari ponsel", atur "Hanya kontak dan pelanggan". Saat aktif, SMS…

## Cara mengaktifkan gateway dan membuat kunci

1. Buka Pengaturan > Integrasi > Kunci API.
2. Aktifkan tombol "Gateway API".
3. Klik "Kunci baru".
   ![Settings, API keys: keys that let another program send through SyBox, and the "New key" button](https://www.sybox.io/res/sybox/help/id/turn-on-the-gateway-and-create-a-key-3.webp?v=33eb72a7)
4. Pilih "Tipe kunci":
   - "Kirim melalui WhatsApp": program mengirim pesan ke pelanggan Anda.
   - "Buat kasus": program membuka kasus di SyBox. Program tidak dapat mengirim pesan.
   - "Impor SMS dari ponsel": ponsel meneruskan pesan SMS-nya ke kotak masuk.
   - "Mulai otomatisasi": program memulai otomatisasi yang pengaturan "Dimulai saat"-nya adalah "Program lain memanggil SyBox" (POST /v1/automation dengan "phone" pelanggan, serta "event" dan "data" opsional). Kunci ini tidak dapat mengirim pesan. Lihat Pengaturan > AI dan otomatisasi > Otomatisasi.
   - "Baca dan perbarui kontak": program mencari kontak, membaca satu kontak, serta mengubah nama, email, kolom kontak, dan labelnya (POST /v1/contacts/search, /get, /update, dan /labels). Kunci ini tidak dapat mengirim pesan. Kunci bertindak sebagai orang yang membuatnya: hanya melihat kontak yang boleh dilihat orang tersebut, hanya berfungsi jika orang tersebut boleh membuka daftar kontak dan melihat nomor, serta hanya dapat mengubah kontak jika orang tersebut boleh mengeditnya. Jika orang tersebut dinonaktifkan, kunci berhenti berfungsi.
5. Isi "Nama perangkat atau program", misalnya "Komputer kantor" atau "Sistem akuntansi". Berikan kunci tersendiri untuk setiap perangkat atau program.
6. Untuk kunci "Kirim melalui WhatsApp", atur juga:
   - "Kirim dari": nomor WhatsApp tempat kunci ini mengirim pesan (wajib).
   - "Izinkan pesan teks bebas": aktif atau nonaktif.
   - "Izinkan template yang disetujui": aktif atau nonaktif. Minimal salah satu dari keduanya harus aktif, jika tidak, Anda akan melihat "Izinkan minimal salah satu dari teks bebas atau template — jika tidak, kunci tidak dapat mengirim apa pun."
   - "Izinkan pengiriman media": aktif atau nonaktif.
   - "Template" (opsional): nama-nama template, dipisahkan dengan koma. Kosongkan untuk mengizinkan template apa saja.
   - "Negara penerima yang diizinkan" (opsional): kode negara dua huruf, misalnya ID,MY,SG. Kosongkan untuk mengizinkan negara mana saja.
   - "Pengiriman diizinkan dari" ... "Kepada": jam operasional kunci boleh mengirim pesan. Samakan keduanya jika tanpa batas waktu. Waktu menggunakan jam lokal ruang kerja.
   - "Batas pesan harian (0 = tidak terbatas)".
7. Untuk kunci "Impor SMS dari ponsel", atur "Hanya kontak dan pelanggan". Saat aktif, SMS dari nomor lain akan tetap berada di ponsel dan tidak masuk ke kotak masuk. Nonaktifkan hanya jika ponsel tersebut khusus digunakan untuk bekerja.
8. Klik Simpan.
9. Sebuah jendela menampilkan "URL Dasar" dan "Kunci API". Salin keduanya sekarang. "Salin kunci ini sekarang — hanya ditampilkan sekali." Masukkan ke dalam pengaturan program Anda.

## Pertanyaan

**Q: Kunci API saya hilang. Bisakah saya melihatnya lagi?**

Tidak. Kunci hanya ditampilkan sekali. Buat kunci baru, masukkan ke program Anda, lalu hapus kunci yang lama.

**Q: Sepertinya ada kunci yang bocor. Apa yang harus saya lakukan?**

Segera hapus atau nonaktifkan kunci tersebut. Hanya kunci itu yang akan berhenti berfungsi. Nomor WhatsApp dan kunci Anda yang lain tidak terpengaruh.

**Q: Daftar "Kirim dari" kosong.**

Daftar tersebut hanya menampilkan nomor WhatsApp yang terhubung dan aktif. Hubungkan nomor terlebih dahulu di Pengaturan > Pesan > Saluran.

**Q: Program saya ditolak saat mengirim pesan.**

Pastikan tombol "Gateway API" aktif dan kunci berstatus aktif. Periksa juga batasan kunci: teks bebas vs template, media, template yang diizinkan, negara yang diizinkan, jam pengiriman, dan batas harian. Ketentuan dari WhatsApp sendiri juga tetap berlaku. Misalnya, teks bebas hanya berfungsi dalam waktu 24 jam sejak pesan terakhir pelanggan.

**Q: Bisakah kunci "Buat kasus" juga mengirim pesan?**

Sengaja tidak bisa. Kunci yang membuat kasus tidak dapat mengirim pesan ke pelanggan, dan kunci pengirim tidak dapat membuat kasus. Gunakan kunci terpisah untuk setiap keperluan.

**Q: Saya memiliki kunci lama bertipe "Terima dari program". Apakah masih berfungsi?**

Ya, kunci lama dengan tipe tersebut tetap berfungsi. Kunci baru dengan tipe tersebut sudah tidak bisa dibuat lagi. Gunakan "Buat kasus" untuk keperluan tersebut.

Source: https://www.sybox.io/id/help/turn-on-the-gateway-and-create-a-key