# API SMS (SyBox)

Lokasi: Pengaturan > Pesan > API SMS

Kegunaan: Menambahkan penyedia SMS sebagai saluran cadangan. Jika Anda menetapkan negara ke gateway, gateway tersebut akan menjadi pilihan utama bagi kontak dari negara tersebut.

Siapa yang bisa mengakses: Pengguna dengan izin "Kelola gateway SMS".

### Cara menambahkan gateway SMS

1. Klik "Tambah API SMS".
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/id/add-an-sms-gateway-1.webp?v=ae637bd9)
2. Penyedia: Pilih MessageBird, SMS Misr, Texto, atau Twilio. Formulir hanya menampilkan kolom yang dibutuhkan penyedia tersebut.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/id/add-an-sms-gateway-2.webp?v=d5225226)
3. Label tampilan: Nama untuk referensi internal Anda.
4. Negara: Kode dua huruf, misalnya EG. Kosongkan jika ingin menggunakan gateway ini untuk semua negara.
5. Isi detail penyedia:
   - MessageBird: ID Pengirim (nama atau nomor yang dilihat penerima) dan API Key.
   - SMS Misr: ID Pengirim, Nama Pengguna, Kata Sandi, dan Token Pengirim. Token Pengirim adalah nilai yang diberikan SMS Misr untuk ID Pengirim Anda.
   - Texto: Hanya API Key.
   - Twilio: ID Pengirim (nomor Dari atau Layanan Pesan Anda), SID Akun, dan Auth Token.
6. Aktif: Biarkan aktif untuk menggunakan gateway.
7. Klik Simpan. Jika ada kolom wajib yang belum diisi, Anda akan melihat "Data tidak lengkap".

### Cara mengirim SMS uji coba

1. Klik "Kirim SMS uji coba" (ikon kirim) pada kartu gateway.
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/id/send-a-test-sms-1.webp?v=35ce049d)
2. Masukkan nomor telepon dalam format internasional, misalnya +2126…, lalu ubah pesannya jika diinginkan.
3. Klik Simpan. Anda akan melihat "SMS uji coba terkirim." Jika penyedia menolaknya, pesan error akan ditampilkan.

Tindakan lainnya

- Edit: Ubah kolom mana pun. Kosongkan kolom kata sandi atau kunci jika ingin mempertahankan yang saat ini.
- Aktifkan / Nonaktifkan: Nyalakan atau matikan gateway.
- Hapus: "Hapus gateway SMS ini secara permanen?"
- Kartu yang menampilkan "Token tidak ada" berarti belum ada kunci yang tersimpan. Edit kartu tersebut lalu tambahkan kuncinya.

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