Lewati ke konten utama

Konfigurasi Skrip Pesan

Halaman ini mendokumentasikan parameter skrip message untuk pembuatan tugas.

Ikhtisar​

Skrip message mengirim pesan langsung secara otomatis ke pengguna TikTok atau Instagram. Dengan beberapa pengguna target via API, satu tugas per pengguna. Kontrol timing dengan start_time.

Konfigurasi Skrip (script_config)​

Parameter konfigurasi skrip pesan:

Parameter​

ParameterTipeDiperlukanDefaultDeskripsi
target_usersstring[]Yes*[]Array pengguna target (satu tugas per pengguna)
target_userstringYes*""Username tunggal atau beberapa dipisah baris baru/koma
message_contentstringYes""Konten teks pesan
access_methodstringNo"direct"Metode akses: direct atau search
catatan

target_users atau target_user harus disediakan. target_users diprioritaskan.

info

Dengan beberapa pengguna target, API membuat satu tugas per pengguna. 3 pengguna + 2 perangkat = 6 tugas.

Contoh​

Kirim pesan ke satu pengguna​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@username_to_message"],
      "message_content": "Hello! Check out our latest content.",
      "access_method": "direct"
    }
  }'

Kirim pesan ke beberapa pengguna​

Satu tugas per pengguna:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "message_content": "Hi! We have an exclusive offer for you."
    }
  }'

Membuat 3 tugas terpisah yang langsung berjalan.

Jadwalkan pesan dengan waktu mulai​

Gunakan start_time untuk menjadwalkan:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "message_content": "Scheduled greeting!"
    },
    "start_time": "14:30"
  }'

Kirim pesan via metode pencarian​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["username1", "username2"],
      "message_content": "Hello from TikMatrix!",
      "access_method": "search"
    }
  }'

Kirim pesan berdasarkan daftar username​

Buat tugas pesan untuk akun tertentu:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@target_user"],
      "message_content": "Hi there!"
    }
  }'

Batch pesan di beberapa perangkat​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@influencer_account"],
      "message_content": "Love your content! Let's collaborate."
    },
    "enable_multi_account": true
  }'

Contoh Instagram​

API yang sama untuk Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_user": "instagram_username",
      "message_content": "Hey! Loved your post"
    }
  }'

Respons​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

Metode Akses​

Metode langsung (direct)​

Membuka profil pengguna via URL. Lebih cepat dan andal.

Navigasi ke pencarian dan ketik nama. Lebih lambat tapi berfungsi saat akses langsung diblokir.

Praktik Terbaik​

  1. Jadwalkan tugas: Gunakan start_time.

  2. Personalisasi pesan: Sesuaikan konten agar terasa personal.

  3. Lebih suka akses langsung: Lebih cepat dan andal.

  4. Hormati batas platform: Jangan buat terlalu banyak tugas pesan sekaligus.

Kode Error​

CodeDescription
40001Pengguna target atau konten pesan tidak ada
40003Skrip tidak didukung via API
40301Akses API memerlukan paket Pro+

Lihat Juga​