Reels dan jadwal berulang lewat API & MCP

Semua yang bisa kamu lakukan di kalender Posto untuk video Reels dan jadwal berulang juga bisa dijalankan dari n8n, Zapier, sistem agency, atau asisten AI. Semuanya tidak memakai Credit AI, kecuali variasi caption AI pada jadwal berulang bila dinyalakan. Cara membuat API key dan menghubungkan asisten AI ada di API dan MCP.

Siapa yang bisa memakai?

• Butuh akses API & MCP (paket Agency, atau add-on API & MCP).
• Video Reels hanya untuk paket Pro, Ultimate, dan Agency, dengan batas video baru per hari sesuai paket. Lihat Bikin video Reels dari carousel.
• Jadwal berulang untuk paket berbayar, dengan jumlah seri aktif per paket. Lihat Jadwal berulang.
• API key perlu izin Jadwal untuk jadwal dan seri, serta Buat konten untuk membuat video.

Menjadwalkan sebagai Reels

1. Panggil POST /api/v1/schedules seperti biasa, lalu tambahkan "format": "reels".
2. Opsional: atur video lewat "video", misalnya {"secondsPerSlide": 3, "transition": "fade"}. Kosong = pengaturan bawaan.
3. Pantau dengan GET /api/v1/schedules/{id}. Setiap akun punya reelsStep: video (video dibuat), upload, processing (diproses platform), lalu published.

Mau ganti jam, caption, atau format sebelum terbit? Pakai PATCH /api/v1/schedules/{id}. Akun tujuan tidak bisa diganti; batalkan lalu buat jadwal baru.

Membuat jadwal berulang

1. Panggil POST /api/v1/schedule-series dengan carousel, platform, aturan (rule), dan tanggal mulai (startsOn).
2. Aturan: freq daily, weekly (isi byWeekday, 0 = Minggu sampai 6 = Sabtu), atau monthly (isi byMonthDay, 1–28 atau -1 untuk hari terakhir), jam time di zona waktu brand, dan akhir opsional until (tanggal) atau count (jumlah posting).
3. Posting untuk 14 hari ke depan langsung muncul di kalender (GET /api/v1/schedules, dengan seriesId). Sisanya dijadwalkan otomatis.

curl -X POST https://posto.id/api/v1/schedule-series \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: seri-promo-gajian" \
  -H "Content-Type: application/json" \
  -d '{"carouselId":"<id carousel>","platforms":["instagram"],"rule":{"freq":"weekly","interval":1,"byWeekday":[1,4],"time":"19:00","count":8},"startsOn":"2026-10-26","format":"reels"}'

Kelola seri dengan PATCH /api/v1/schedule-series/{id} (berlaku untuk posting berikutnya), POST …/pause, POST …/resume, dan DELETE /api/v1/schedule-series/{id} untuk mengakhiri. Posting yang sudah terbit tidak terhapus.

Mengunduh video Reels

1. Panggil POST /api/v1/carousels/{id}/video-exports. Respons berisi id dan status queued.
2. Cek GET /api/v1/carousels/{id}/video-exports/{exportId} sampai ready, lalu unduh dari video.url.
3. Link berlaku 24 jam (video.expiresAt). Permintaan yang sama tidak membuat video baru dan tidak menambah hitungan batas harian.

curl -X POST https://posto.id/api/v1/carousels/<id carousel>/video-exports \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"secondsPerSlide":3,"transition":"fade"}'

Lewat asisten AI (MCP)

Minta asistenmu, misalnya "Jadwalkan carousel ini sebagai Reels Jumat jam 19.00" atau "Posting ulang carousel ini tiap Senin dan Kamis jam 7 malam, 8 kali". Tool yang dipakai: schedule_post (dengan format Reels), create_schedule_series, list_schedule_series, pause_schedule_series, resume_schedule_series, end_schedule_series, dan export_reels_video. Asisten mengulang aturan jadwal ke kamu sebelum membuat seri dan meminta konfirmasi sebelum mengakhirinya.

Tool asisten AI lainnya

• Akun & posting: list_accounts (akun terhubung per brand, batas caption per platform), get_tiktok_creator_info (opsi privasi TikTok yang diizinkan), list_posts, get_post (status & tautan per platform, alasan gagal), update_post, dan cancel_post.
• Credit AI aman: create_carousel dengan planOnly: true memberi perkiraan jumlah slide & Credit AI tanpa memotong Credit AI; strictSlides: true menolak bila slide harus dikurangi. idempotencyKey membuat pengulangan aman (tidak memotong Credit AI dua kali). get_carousel menyertakan captionLimits per platform.
• Tanpa API key di Claude: tambahkan Posto sebagai custom connector di claude.ai dengan URL https://posto.id/mcp. Lihat Hubungkan Posto ke Claude sebagai custom connector.

Kabar lewat webhook

Pasang webhook untuk event series.paused (seri dijeda, otomatis atau manual) dan series.ended (seri selesai atau diakhiri). Event post.published dan post.failed kini juga berisi format dan seriesId.

Masih bingung? Hubungi [email protected].