Konfigurasi Script Post

Halaman ini mendokumentasikan parameter konfigurasi untuk script post yang digunakan dalam pembuatan tugas.

Ringkasan

Script post digunakan untuk memposting konten (video atau gambar) secara otomatis ke TikTok atau Instagram. Script ini mendukung berbagai metode posting, sumber material, dan opsi audio.

Parameter Permintaan

Saat membuat tugas, Anda dapat menentukan parameter tingkat atas berikut:

Parameter	Tipe	Wajib	Default	Deskripsi
serials	string[]	Kondisional	[]	Daftar nomor seri perangkat (Mode 1: berbasis perangkat)
usernames	string[]	Kondisional	[]	Daftar username untuk membuat tugas (Mode 2: berbasis username)
script_name	string	Ya	-	Nama script yang akan dijalankan (misalnya, "post")
script_config	object	Ya	-	Parameter konfigurasi script (lihat di bawah)
enable_multi_account	boolean	Tidak	false	Aktifkan mode multi-akun (buat tugas untuk setiap akun di perangkat)
start_time	string	Tidak	-	Waktu mulai opsional dalam format "HH:MM"
platform	string	Kondisional*	auto	Platform target: `tiktok`, `instagram`. Lihat catatan di bawah

Catatan: Salah satu dari serials atau usernames harus disediakan.

*Perilaku Parameter Platform:

TikMatrix & IgMatrix: Parameter platform diabaikan jika disediakan. Platform secara otomatis ditentukan dari nama aplikasi (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: Parameter platform wajib dan harus ditentukan secara eksplisit sebagai tiktok atau instagram.

Konfigurasi Script (`script_config`)

Objek script_config berisi parameter untuk script posting. Berikut adalah parameter yang tersedia:

Parameter Umum (TikTok dan Instagram)

Parameter	Tipe	Wajib	Default	Deskripsi
content_type	integer	Tidak	0	Tipe konten: `0` = video, `1` = gambar
image_count	integer	Tidak	1	Jumlah gambar yang dipilih (ketika content_type = 1)
captions	string	Tidak	""	Teks caption posting. Mendukung format spintax: `{opsi1\|opsi2\|opsi3}`
caption_format	string	Tidak	"multiline"	Cara menangani keterangan multi-baris: `multiline` (sisipkan baris baru nyata) atau `singleline` (ganti `\n` dengan spasi)
ai_label	boolean	Tidak	false	Apakah akan menambahkan label konten yang dibuat AI ke postingan
save_draft	boolean	Tidak	false	Simpan postingan sebagai draf alih-alih langsung menerbitkan
post_way	string	Tidak	"addButton"	Metode posting. Lihat bagian Metode Posting di bawah untuk detail
material_source	string	Tidak	"materialLibrary"	Sumber material: `materialLibrary` (perpustakaan material) atau `localFolder` (folder lokal), diabaikan jika material_list disediakan
material_path	string	Wajib bersyarat	""	Path folder lokal (wajib ketika material_source = "localFolder")
material_list	string[]	Tidak	[]	Langsung meneruskan array path file material. Ketika parameter ini disediakan, logika material_source dan material_path akan dilewati. Direkomendasikan untuk skenario otomasi API.
materials_tags	string	Tidak	""	Tag material dipisahkan koma untuk filter dari perpustakaan material
upload_wait_time	integer	Tidak	10	Detik untuk menunggu upload selesai

upload_wait_time berlaku untuk posting normal maupun mode save_draft. Bahkan saat disimpan sebagai draf, TikTok/Instagram tetap memerlukan waktu untuk menyelesaikan unggahan video di latar belakang. | sound_wait_time | integer | Tidak | 10 | Detik untuk menunggu audio dimuat | | add_sound | string/integer | Tidak | "-1" | Opsi audio: -1 = default, 0 = nonaktif, 1 = aktif, custom = gunakan audio kustom | | sound_name | string | Wajib bersyarat | "" | Nama/URL audio (wajib ketika post_way = "useSound") | | custom_sound_keyword | string | Wajib bersyarat | "" | Kata kunci untuk mencari audio kustom (wajib ketika add_sound = "custom") | | origin_sound_volume | integer | Tidak | 100 | Volume audio asli (0-100) | | add_sound_volume | integer | Tidak | 100 | Volume audio tambahan (0-100) |

Metode Posting (`post_way`)

Parameter post_way mengontrol bagaimana skrip membuka layar posting:

Nilai	Deskripsi
`addButton`	(Default) Mengetuk tombol buat "+" di dalam aplikasi, lalu memilih media dari galeri perangkat. Berfungsi untuk semua penempatan (`reel`, `story`, `post`). Direkomendasikan untuk sebagian besar kasus.
`share`	Memicu Android share intent langsung dari file media ke aplikasi Instagram/TikTok. Ini adalah metode alternatif yang melewati navigasi di dalam aplikasi; berguna saat alur `addButton` tidak andal pada perangkat atau versi aplikasi tertentu.
`useSound`	Membuka trek audio tertentu terlebih dahulu (melalui URL atau kata kunci `sound_name`), lalu menautkan video ke suara tersebut. Hanya untuk Reels / TikTok. Memerlukan `sound_name` diatur. Tidak kompatibel dengan `placement = "post"` atau `placement = "story"`.

catatan

Saat placement adalah post (postingan feed Instagram), otomatisasi suara tidak didukung apa pun nilai post_way. Skrip akan melewati langkah suara secara otomatis.

Parameter Khusus TikTok

Parameter	Tipe	Wajib	Default	Deskripsi
placement	string	Tidak	""	Penempatan publikasi: `""` (video biasa, default) atau `"story"` (TikTok Story). Dengan `"story"`, skrip mengklik "Your Story" setelah pengaturan suara, melewati langkah judul/tautan produk/label AI.
add_product_link	integer	Tidak	0	Apakah akan menambahkan tautan produk/belanja: `0` = tidak, `1` = ya

Parameter Khusus Instagram

Parameter	Tipe	Wajib	Default	Deskripsi
placement	string	Tidak	"reel"	Penempatan posting: `reel` (Reels), `story` (Stories), atau `post` (postingan feed biasa). Catatan: opsi suara tidak didukung saat `placement` adalah `post`
enable_schedule_reels	boolean	Tidak	false	Apakah akan menjadwalkan Reel untuk waktu mendatang
schedule_reels_time	string	Kondisional	""	Waktu publikasi terjadwal dalam format `YYYY-MM-DD HH:MM` (diperlukan saat enable_schedule_reels = true)
story_link	string	Tidak	""	URL untuk dilampirkan sebagai tautan stiker di Story (hanya berlaku saat placement = "story")

Contoh

Posting TikTok Story

Posting langsung ke TikTok Story. Setelah pengaturan suara, skrip mengklik "Your Story" — tanpa langkah judul/tautan produk/label AI :

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

Tugas Posting Dasar - Langsung Meneruskan Path Material

Ini adalah cara yang direkomendasikan untuk otomasi API - langsung meneruskan path file material, tanpa bergantung pada perpustakaan material atau pemindaian folder:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Lihat video baru saya! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Posting Menggunakan Perpustakaan Material (TikTok)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Lihat video baru saya! #trending #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Membuat Tugas Posting Berdasarkan Daftar Username

Mode ini memungkinkan Anda membuat tugas langsung untuk akun tertentu, tanpa perlu mengetahui nomor seri perangkat mereka:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Lihat video baru saya! #trending #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Posting Menggunakan Folder Lokal (Instagram)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Konten luar biasa! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Postingan feed Instagram (placement: post)

Publikasikan ke feed Instagram biasa (bukan Reel). Opsi suara tidak didukung untuk penempatan ini:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

Posting dengan Audio Kustom

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Menari dengan musik trending ini!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending dance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Posting Menggunakan URL Audio Tertentu

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "Menggunakan musik keren ini!",
      "material_source": "materialLibrary"
    }
  }'

Posting Gambar (Carousel)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "Lihat foto-foto ini! #carousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Posting dengan Pemilihan Platform Eksplisit

Anda dapat secara eksplisit menentukan platform target menggunakan parameter platform. Ini berguna ketika Anda ingin mengganti default lingkungan:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "Posting ke Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Dokumentasi Terkait

API Manajemen Tugas - Membuat, daftar, dan mengelola tugas

Ringkasan​

Parameter Permintaan​

Konfigurasi Script (script_config)​

Parameter Umum (TikTok dan Instagram)​

Metode Posting (post_way)​

Parameter Khusus TikTok​

Parameter Khusus Instagram​

Contoh​

Posting TikTok Story​

Tugas Posting Dasar - Langsung Meneruskan Path Material​

Posting Menggunakan Perpustakaan Material (TikTok)​

Membuat Tugas Posting Berdasarkan Daftar Username​

Posting Menggunakan Folder Lokal (Instagram)​

Postingan feed Instagram (placement: post)​

Posting dengan Audio Kustom​

Posting Menggunakan URL Audio Tertentu​

Posting Gambar (Carousel)​

Posting dengan Pemilihan Platform Eksplisit​

Response​

Dokumentasi Terkait​