---
title: "Bagaimana cara menambahkan pengiriman SMS ke aplikasi saya dengan API?"
description: "Cara menambahkan pengiriman SMS ke aplikasi dengan API: kredensial, format nomor, encoding, webhook pengiriman, retry, dan pengecekan sebelum go-live."
canonical: "https://omnichannels.ai/id/answers/integrate-sms-api/"
language: "id"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Bagaimana cara menambahkan pengiriman SMS ke aplikasi saya dengan API?

Canonical: https://omnichannels.ai/id/answers/integrate-sms-api/
Language: id
Publisher: OmniChannels.ai by BroadNet Technologies

**Jawaban singkat:** Untuk menambahkan pengiriman SMS ke aplikasi, panggil API SMS dari provider melalui backend Anda dengan access token, nomor penerima dalam format internasional, Sender ID yang sudah disetujui, dan teks pesan. Simpan ID pesan yang dikembalikan, terima status pengiriman lewat webhook, lalu tangani error, retry, dan rate limit sebelum go-live.

## Langkah integrasi

1. Dapatkan kredensial uji coba dan daftarkan nomor uji yang akan menerima pesan.
2. Simpan API token di secrets manager atau environment variable pada server Anda, jangan pernah di aplikasi mobile atau kode browser.
3. Simpan nomor dalam format E.164 dan ubah ke format yang diminta API.
4. Pilih encoding: teks GSM-7, atau Unicode untuk huruf Arab, emoji, dan aksara lainnya.
5. Kirim pesan dan simpan ID pesan yang dikembalikan bersama catatan Anda sendiri.
6. Siapkan webhook untuk menerima status pengiriman.
7. Tambahkan retry dengan backoff untuk respons 429 dan 5xx, lalu daftarkan Sender ID untuk setiap negara yang mewajibkannya.

## Kesalahan yang perlu dihindari

- Memanggil API dari aplikasi klien, sehingga token terekspos ke siapa pun.
- Mengirim nomor dengan tanda plus, spasi, atau angka nol di depan (format nasional) padahal API hanya menerima angka.
- Membiarkan satu tanda kutip lengkung atau emoji mengubah seluruh pesan menjadi Unicode, yang mengurangi jumlah karakter per segmen.
- Melakukan retry secara membabi buta setelah timeout. Jika API tidak punya idempotency key, catat setiap pengiriman terlebih dahulu dan cek statusnya sebelum mengirim ulang.
- Mengabaikan respons 429 alih-alih menunggu sesuai header Retry-After.

## Contoh: satu permintaan SMS

Di OmniChannels.ai, Anda mengirim satu SMS dengan POST https://api.broadnet.me/sms/sendSms, header Authorization: Bearer, dan body JSON. Panggilan yang berhasil mengembalikan 200 dengan ID pesan sebagai teks biasa. Akses uji coba diberikan setelah permintaan singkat dan hanya berlaku untuk nomor Anda sendiri yang sudah diverifikasi; tidak ada pendaftaran mandiri instan.

| Kolom | Contoh | Catatan |
|---|---|---|
| senderId | OmniDemo | Sender ID Anda yang sudah disetujui |
| destinationNumber | 447700900123 | Kode negara plus nomor, hanya angka |
| message | Kode Anda adalah 482913 | Teks pesan |
| messageType | TEXT | TEXT untuk GSM-7, UNICODE untuk huruf Arab dan emoji |

## Sumber resmi

- [RFC 9110: HTTP Semantics (IETF)](https://datatracker.ietf.org/doc/html/rfc9110)
- [ITU-T Recommendation E.164 — The international public telecommunication numbering plan](https://www.itu.int/rec/T-REC-E.164)
- [3GPP TS 23.038 — Alphabets and language-specific information](https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=745)

## Pertanyaan terkait

- https://omnichannels.ai/id/answers/smpp-vs-http-api/
- https://omnichannels.ai/id/answers/delivery-report-webhook/
- https://omnichannels.ai/id/answers/why-sms-split-into-parts/
- https://omnichannels.ai/id/answers/what-is-sender-id/
- https://omnichannels.ai/id/answers/send-whatsapp-message-api/

Diperbarui: 2026-10-10