# SMS APIs (SyBox)

Lokasi: Tetapan > Pemesejan > SMS APIs

Kegunaan: Menambah penyedia SMS sebagai saluran sandaran. Jika anda menetapkan negara pada gerbang, ia menjadi gerbang pilihan untuk kenalan dari negara tersebut.

Siapa yang boleh buka: Pengguna dengan kebenaran "Urus gerbang SMS".

### Cara menambah gerbang SMS

1. Klik "Tambah SMS API".
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/ms/add-an-sms-gateway-1.webp?v=79d9c1fc)
2. Penyedia: Pilih MessageBird, SMS Misr, Texto atau Twilio. Borang hanya memaparkan medan yang diperlukan oleh penyedia tersebut.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/ms/add-an-sms-gateway-2.webp?v=b2438579)
3. Label paparan: Nama untuk rujukan anda sendiri.
4. Negara: Kod dua huruf, contohnya MY. Biarkan kosong untuk menggunakan gerbang bagi semua negara.
5. Isi butiran penyedia:
   - MessageBird: ID Penghantar (nama atau nombor yang dilihat oleh penerima) dan Kunci API.
   - SMS Misr: ID Penghantar, Nama Pengguna, Kata Laluan dan Token Penghantar. Token Penghantar ialah nilai yang diberikan oleh SMS Misr untuk ID Penghantar anda.
   - Texto: Kunci API sahaja.
   - Twilio: ID Penghantar (nombor Daripada atau Perkhidmatan Pemesejan anda), SID Akaun dan Token Pengesahan.
6. Aktif: Biarkan dihidupkan untuk menggunakan gerbang.
7. Klik Simpan. Jika medan yang diperlukan tiada, anda akan melihat "Data tidak lengkap".

### Cara menghantar SMS ujian

1. Klik "Hantar SMS ujian" (ikon hantar) pada kad gerbang.
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/ms/send-a-test-sms-1.webp?v=03bb613d)
2. Masukkan nombor telefon dalam format antarabangsa, contohnya +6012…, dan edit mesej jika anda mahu.
3. Klik Simpan. Anda melihat "SMS ujian telah dihantar." Jika penyedia menolaknya, ralat akan dipaparkan.

Tindakan lain

- Edit: Tukar mana-mana medan. Biarkan medan kata laluan atau kunci kosong untuk mengekalkan yang sedia ada.
- Dayakan / Nyahdayakan: Matikan atau hidupkan gerbang.
- Padam: "Padam get laluan SMS ini secara kekal?"
- Kad yang memaparkan "Token tiada" tidak mempunyai kunci yang disimpan. Edit kad tersebut dan tambahkan kuncinya.

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