Kirim pesan RCS

POST/inter-rcs/v3/rcs/message/send

Contoh permintaan

Pilih metode autentikasi terlebih dahulu, lalu tipe pesan; ganti <YOUR_API_KEY> dengan API KEY Anda — body JSON adalah isi dalam tanda kutip tunggal -d.

Direkomendasikan: cukup satu header Authorization: Bearer <YOUR_API_KEY>, tanpa tanda tangan.

Pesan TEXT dengan satu tombol saran REPLY.

curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -d '{
  "productKey": "rcs_otp",
  "channel": "RCS",
  "sender": "BrandName",
  "uid": "demo_batch_20260814_001",
  "destinations": [
    { "to": "8613482734980" }
  ],
  "message": {
    "type": "TEXT",
    "textMsg": {
      "text": "您的验证码是 8829，5 分钟内有效",
      "suggestions": [
        { "type": "REPLY", "text": "重新发送", "postbackData": "resend_otp" }
      ]
    }
  }
}'

Field suggestions (pilih per tipe)

Struktur objek tombol ditentukan oleh type: semua tipe wajib membawa type, text (teks tombol, 1-25 karakter), dan postbackData (dikembalikan saat diklik, 1-2048 karakter); pilih tab di bawah untuk melihat field khusus tiap tipe.

Balasan cepat: klik hanya mengembalikan postbackData; tanpa field tambahan.

Contoh lengkap:

{
  "type": "REPLY",
  "text": "Konfirmasi",
  "postbackData": "btn_reply_confirm"
}

curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "demo_batch_20260814_008",
    "channel": "RCS",
    "message": {
      "mms": {
        "media": {
          "file": {
            "url": "https://example.com/img/midautumn.jpg"
          }
        },
        "title": "中秋礼遇",
        "description": "全场礼盒 8 折，限时 3 天"
      },
      "type": "MMS"
    },
    "productKey": "mms_market",
    "destinations": [
      {
        "to": "<PHONE>"
      }
    ],
    "sender": "YOUR_SENDER"
  }'

Batch berhasil diterima (HTTP 200).

{
  "code": "000000",
  "data": {
    "uid": "demo_batch_20260814_010",
    "messages": [
      {
        "mobile": "8613482734980",
        "status": "000000",
        "messageId": "msg-2c4f8e1a-a1b2c3d4e5f60718293a4b5c",
        "description": "Submitted success"
      },
      {
        "mobile": "12345",
        "status": "010003",
        "messageId": null,
        "description": "Wrong format of phone number"
      }
    ]
  },
  "message": "success",
  "traceId": "d87a93e50af0437ebcc0c80774126842",
  "timestamp": "2026-11-11T03:00:01.000Z"
}

Contoh respons dari kontrak yang ditinjau, bukan hasil permintaan nyata.

Kirim pesan RCS atau MMS. Penerimaan berhasil mengembalikan HTTP 200 dengan code=000000, berarti diterima dan belum tentu terkirim. Mendukung autentikasi Bearer atau CheckSum; lihat halaman kode kesalahan RCS untuk daftar kode penerimaan.

Gunakan AppKey InnoPaaS sebagai Bearer token. Buat atau kelola key di halaman API keys Console. Panduan API key

Authorization

Authorizationstring<bearer>wajib

Parameter Header

X-Custom-TraceIdstringopsional

Optional customer trace ID, recommended globally unique; forwarded to webhook payloads (customTraceId) and NOT echoed in the send response.

Panjang maksimum256

Body

application/json

uidstringopsional

Nomor batch kustom pelanggan, maksimal 64 karakter, terlampaui mengembalikan 010003. Jika tidak dikirim, sistem mengisi batchId; diteruskan ke payload push resi dan dikembalikan pada data.uid respons pengiriman.

Panjang maksimum64

senderstringwajib

Sender ID. Wajib untuk pesan TEXT / FILE / CARD / CAROUSEL, kosong mengembalikan 010002; boleh kosong untuk TEMPLATE / MMS (pesan template memakai sender dari konfigurasi template).

channelstringwajib

Kanal, kirim tetap RCS (saat ini hanya diteruskan dan dicatat log, tidak dipakai untuk routing).

messageobjectwajib

Objek konten pesan; field body yang wajib ditentukan oleh type.

Tampilkan atribut anak

mmsobjectopsional

Body pesan MMS, wajib saat type=MMS, digunakan bersama produk mms_notify / mms_market.

Tampilkan atribut anak

typestringopsional

Tipe konten, tetap MMS, boleh diabaikan.

mediaobjectwajib

Objek media.

Tampilkan atribut anak

fileobjectwajib

Objek sumber daya file media utama.

Tampilkan atribut anak

urlstringwajib

URL file, diawali http/https, 1-1000 karakter, file ≤100 MB.

Panjang minimum1Panjang maksimum1000

heightstringopsional

Tinggi: SHORT / MEDIUM / TALL.

thumbnailobjectopsional

Objek thumbnail video, hanya berlaku untuk file video.

Tampilkan atribut anak

urlstringwajib

URL thumbnail, disarankan ≤1 MB.

titlestringwajib

Judul MMS.

descriptionstringopsional

Deskripsi teks MMS.

fileobjectopsional

Body pesan file, wajib saat type=FILE.

Tampilkan atribut anak

fileobjectwajib

Objek sumber daya file.

Tampilkan atribut anak

urlstringwajib

URL file, diawali http/https, 1-1000 karakter, file ≤100 MB.

Panjang minimum1Panjang maksimum1000

typestringopsional

Tipe konten, tetap FILE, boleh diabaikan.

thumbnailobjectopsional

Thumbnail video, hanya berlaku untuk file video.

Tampilkan atribut anak

urlstringwajib

URL thumbnail, disarankan ≤1 MB.

suggestionsarray<object>opsional

Array tombol, maksimal 11.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

typestringwajib

Tipe pesan: TEXT / FILE / CARD / CAROUSEL / TEMPLATE / MMS.

cardMsgobjectopsional

Body pesan kartu tunggal, wajib saat type=CARD.

Tampilkan atribut anak

typestringopsional

Tipe konten, tetap CARD, boleh diabaikan.

contentobjectwajib

Objek konten kartu.

Tampilkan atribut anak

mediaobjectopsional

Objek media kartu, pilih salah satu dengan title.

Tampilkan atribut anak

fileobjectwajib

Objek sumber daya file media utama.

Tampilkan atribut anak

urlstringwajib

URL file, diawali http/https, 1-1000 karakter, file ≤100 MB.

Panjang minimum1Panjang maksimum1000

heightstringopsional

Tinggi: SHORT / MEDIUM / TALL.

thumbnailobjectopsional

Objek thumbnail video, hanya berlaku untuk file video.

Tampilkan atribut anak

urlstringwajib

URL thumbnail, disarankan ≤1 MB.

titlestringopsional

Judul kartu, 1-200 karakter, pilih salah satu dengan media.

Panjang minimum1Panjang maksimum200

descriptionstringopsional

Deskripsi kartu, 1-2000 karakter.

Panjang minimum1Panjang maksimum2000

suggestionsarray<object>opsional

Array tombol di dalam kartu, maksimal 4.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

alignmentstringwajib

Perataan gambar: LEFT / RIGHT. Wajib dikirim (VERTICAL juga perlu dikirim).

orientationstringwajib

Orientasi kartu: HORIZONTAL (gambar kiri/kanan) / VERTICAL (gambar atas/bawah).

suggestionsarray<object>opsional

Array tombol di luar kartu, maksimal 11.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

textMsgobjectopsional

Body pesan teks, wajib saat type=TEXT.

Tampilkan atribut anak

textstringwajib

Isi pesan teks biasa, 0-3072 karakter.

Panjang maksimum3072

typestringopsional

Tipe konten, tetap TEXT, boleh diabaikan.

suggestionsarray<object>opsional

Array tombol, maksimal 11.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

templateobjectopsional

Body pesan template, wajib saat type=TEMPLATE. Template harus dibuat dan disetujui lebih dulu; tipe pengiriman ditentukan konfigurasi template (mendukung RCS dan MMS).

Tampilkan atribut anak

typestringopsional

Tipe konten, tetap TEMPLATE, boleh diabaikan.

parametersarray<object>opsional

Array parameter template; wajib untuk template variabel, kekurangan parameter mengembalikan 150002.

Tampilkan atribut anak

namestringwajib

Nama parameter, sesuai placeholder {{name}} dalam template.

valuestringwajib

Nilai parameter.

templateIdstringwajib

ID template (disetujui di konsol); tidak ada mengembalikan 010005, belum disetujui mengembalikan 150008.

carouselMsgobjectopsional

Body pesan kartu karusel, wajib saat type=CAROUSEL.

Tampilkan atribut anak

typestringopsional

Tipe konten, tetap CAROUSEL, boleh diabaikan.

contentsarray<object>wajib

Array kartu anak, 2-10 kartu, struktur tiap kartu sama dengan konten kartu.

Tampilkan atribut anak

mediaobjectopsional

Objek media: file utama, thumbnail video opsional, tinggi opsional.

Tampilkan atribut anak

fileobjectwajib

Objek sumber daya file media utama.

Tampilkan atribut anak

urlstringwajib

URL file, diawali http/https, 1-1000 karakter, file ≤100 MB.

Panjang minimum1Panjang maksimum1000

heightstringopsional

Tinggi: SHORT / MEDIUM / TALL.

thumbnailobjectopsional

Objek thumbnail video, hanya berlaku untuk file video.

Tampilkan atribut anak

urlstringwajib

URL thumbnail, disarankan ≤1 MB.

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, 1-100 karakter.

Panjang minimum1Panjang maksimum200

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, 1-500 karakter.

Panjang minimum1Panjang maksimum2000

suggestionsarray<object>opsional

Array tombol di dalam kartu anak, maksimal 4.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

cardWidthstringwajib

Lebar kartu: SMALL / MEDIUM.

suggestionsarray<object>opsional

Array tombol di luar karusel, maksimal 11.

Tampilkan atribut anak

urlstringopsional

OPEN_URL: URL tujuan, wajib, harus diawali http:// atau https://, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

textstringopsional

Teks tombol (terlihat pengguna), 1-25 karakter.

Panjang minimum1Panjang maksimum25

typestringopsional

Tipe tombol: REPLY / OPEN_URL / DIAL_PHONE / SHOW_LOCATION / REQUEST_LOCATION / CREATE_CALENDAR_EVENT.

labelstringopsional

SHOW_LOCATION: label lokasi, opsional.

Panjang maksimum100

titlestringopsional

CREATE_CALENDAR_EVENT: judul acara, wajib, 1-100 karakter.

Panjang maksimum100

endTimestringopsional

CREATE_CALENDAR_EVENT: waktu selesai, wajib, setelah waktu mulai, format sama dengan startTime.

latitudenumberopsional

SHOW_LOCATION: lintang, wajib, rentang -90~90.

longitudenumberopsional

SHOW_LOCATION: bujur, wajib, rentang -180~180.

startTimestringopsional

CREATE_CALENDAR_EVENT: waktu mulai, wajib, format yyyy-MM-dd'T'HH:mm:ss.SSSZ.

applicationstringopsional

OPEN_URL: cara membuka, BROWSER (default) atau WEBVIEW; opsional, hanya diteruskan tanpa validasi.

descriptionstringopsional

CREATE_CALENDAR_EVENT: deskripsi acara, opsional, maksimal 500 karakter.

Panjang maksimum500

fallbackUrlstringopsional

REQUEST_LOCATION / CREATE_CALENDAR_EVENT: URL fallback opsional, tidak divalidasi.

phoneNumberstringopsional

DIAL_PHONE: nomor tujuan, wajib, dengan kode negara dan lolos validasi format.

postbackDatastringopsional

Data yang dikembalikan apa adanya saat diklik, wajib, 1-2048 karakter.

Panjang minimum1Panjang maksimum2048

webviewViewModestringopsional

OPEN_URL dengan WEBVIEW: FULL / HALF / TALL; opsional, hanya diteruskan tanpa validasi.

productKeystringwajib

Product key: rcs_otp (OTP) / rcs_notify (notification) / rcs_market (marketing) / mms_notify (MMS notification) / mms_market (MMS marketing). Untuk pesan template, nilai mengikuti konfigurasi template (server mengisi ulang berdasarkan templateId); nilai pada permintaan diabaikan.

smsFailoverobjectopsional

Konfigurasi fallback ke SMS teks saat pengiriman RCS gagal.

Tampilkan atribut anak

textstringwajib

Isi teks SMS fallback.

senderstringwajib

Sender untuk SMS fallback.

destinationsarray<object>wajib

Daftar penerima, minimal 1; melebihi batas permintaan tunggal mengembalikan 010012.

Tampilkan atribut anak

tostringwajib

Nomor ponsel dalam format internasional (dengan kode negara, hanya angka), contoh: 8613482734980.

Respons

application/json

Batch berhasil diterima (HTTP 200).

codestringwajib

Kode respons enam digit, 000000 berarti operasi berhasil.

dataobjectwajib

Hasil bisnis: nomor batch uid dan hasil penerimaan per pesan messages; null saat seluruh permintaan gagal.

Tampilkan atribut anak

uidstringwajib

Nomor batch: uid yang dikirim dikembalikan apa adanya; jika tidak dikirim, mengembalikan batchId dari sistem, konsisten dengan payload push resi.

messagesarray<object>wajib

Hasil penerimaan per pesan.

Tampilkan atribut anak

mobilestringwajib

Nomor ponsel yang dikirim.

statusstringwajib

Hasil penerimaan satu pesan: 000000 berhasil; nilai lain adalah kode error enam digit.

messageIdstringnullopsional

ID pesan (dikembalikan saat sukses untuk mengaitkan push resi; null untuk entri gagal).

descriptionstringwajib

Deskripsi (Inggris): catatan sukses atau alasan gagal per item; satu field, tanpa enDescription terpisah.

messagestringwajib

Deskripsi berbahasa Inggris untuk dibaca manusia, jangan dijadikan dasar logika program; sukses selalu success.

traceIdstringwajib

ID pelacakan dari platform (32 karakter heksadesimal), independen dari header X-Custom-TraceId.

timestampstringwajib

Waktu pembuatan respons, format UTC ISO 8601, presisi milidetik, diakhiri Z.

{
  "code": "000000",
  "data": {
    "uid": "demo_batch_20260814_010",
    "messages": [
      {
        "mobile": "8613482734980",
        "status": "000000",
        "messageId": "msg-2c4f8e1a-a1b2c3d4e5f60718293a4b5c",
        "description": "Submitted success"
      },
      {
        "mobile": "12345",
        "status": "010003",
        "messageId": null,
        "description": "Wrong format of phone number"
      }
    ]
  },
  "message": "success",
  "traceId": "d87a93e50af0437ebcc0c80774126842",
  "timestamp": "2026-11-11T03:00:01.000Z"
}

Contoh respons dari kontrak yang ditinjau, bukan hasil permintaan nyata.

Contoh permintaan

Pilih metode autentikasi terlebih dahulu, lalu tipe pesan; ganti <YOUR_API_KEY> dengan API KEY Anda — body JSON adalah isi dalam tanda kutip tunggal -d.

Direkomendasikan: cukup satu header Authorization: Bearer <YOUR_API_KEY>, tanpa tanda tangan.

Pesan TEXT dengan satu tombol saran REPLY.

curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -d '{
  "productKey": "rcs_otp",
  "channel": "RCS",
  "sender": "BrandName",
  "uid": "demo_batch_20260814_001",
  "destinations": [
    { "to": "8613482734980" }
  ],
  "message": {
    "type": "TEXT",
    "textMsg": {
      "text": "您的验证码是 8829，5 分钟内有效",
      "suggestions": [
        { "type": "REPLY", "text": "重新发送", "postbackData": "resend_otp" }
      ]
    }
  }
}'

Field suggestions (pilih per tipe)

Balasan cepat: klik hanya mengembalikan postbackData; tanpa field tambahan.

Contoh lengkap:

{
  "type": "REPLY",
  "text": "Konfirmasi",
  "postbackData": "btn_reply_confirm"
}

curl -X POST "https://rcsapi.tig253.com/inter-rcs/v3/rcs/message/send" \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "uid": "demo_batch_20260814_008", "channel": "RCS", "message": { "mms": { "media": { "file": { "url": "https://example.com/img/midautumn.jpg" } }, "title": "中秋礼遇", "description": "全场礼盒 8 折，限时 3 天" }, "type": "MMS" }, "productKey": "mms_market", "destinations": [ { "to": "<PHONE>" } ], "sender": "YOUR_SENDER" }'

{ "code": "000000", "data": { "uid": "demo_batch_20260814_010", "messages": [ { "mobile": "8613482734980", "status": "000000", "messageId": "msg-2c4f8e1a-a1b2c3d4e5f60718293a4b5c", "description": "Submitted success" }, { "mobile": "12345", "status": "010003", "messageId": null, "description": "Wrong format of phone number" } ] }, "message": "success", "traceId": "d87a93e50af0437ebcc0c80774126842", "timestamp": "2026-11-11T03:00:01.000Z" }

Kirim pesan RCS

Contoh permintaan

Field suggestions (pilih per tipe)

Authorization

Parameter Header

Body

Respons

Topik terkait

Kirim pesan RCS

Contoh permintaan

Field suggestions (pilih per tipe)

Authorization

Parameter Header

Body

Respons

Topik terkait