Cara menggunakan integrasi n8n Postoria

Integrasi n8n Postoria memungkinkan Anda membangun alur kerja penerbitan media sosial otomatis di n8n tanpa memanggil Postoria Public API secara manual.

Anda dapat menggunakan node komunitas resmi Postoria yang terverifikasi untuk menampilkan daftar ruang kerja dan akun sosial, mengunggah atau mengimpor media, langsung menerbitkan postingan, menjadwalkan postingan, menambahkan postingan ke antrean, menampilkan postingan yang sudah ada, memeriksa status postingan, dan menghapus postingan di Postoria.

Integrasi ini tersedia pada paket Pro dan Agency.

Ketersediaan saat ini

Node resmi Postoria tersedia sebagai node komunitas terverifikasi di n8n Cloud maupun n8n yang dihosting sendiri.

Nama paketnya adalah:

@postoria/n8n-nodes-postoria

  • n8n Cloud: Cari Postoria langsung dari kanvas alur kerja dan tambahkan node ke alur kerja Anda.
  • n8n yang dihosting sendiri: Pasang paket melalui Settings → Community Nodes, atau pilih langsung jika versi n8n Anda menyertakan node komunitas terverifikasi.

Pada sebagian instalasi, Anda mungkin perlu memulai ulang instans n8n dan mengaktifkan Verified Community Nodes di Admin Panel sebelum node muncul.

Sebelum memulai

Anda memerlukan:

  • Paket Postoria Pro atau Agency yang aktif.
  • Kunci Postoria Public API.
  • Akses ke n8n Cloud atau instans n8n yang dihosting sendiri.
  • Akun Owner atau Admin n8n jika Anda perlu memasang atau mengaktifkan node komunitas.

Node Postoria terhubung langsung ke Postoria Public API. Kunci API Anda disimpan dalam sistem kredensial n8n.

Menambahkan node Postoria ke n8n

n8n Cloud

  1. Buka sebuah alur kerja.
  2. Klik untuk menambahkan node.
  3. Cari Postoria.
  4. Pilih node Postoria yang terverifikasi dan tambahkan ke alur kerja.

Tidak diperlukan pemasangan paket npm secara manual.

n8n yang dihosting sendiri

  1. Buka instans n8n yang Anda hosting sendiri.
  2. Buka Settings.
  3. Buka Community Nodes.
  4. Klik Install.
  5. Masukkan nama paket:

@postoria/n8n-nodes-postoria

  1. Konfirmasikan bahwa Anda memahami risiko memasang paket komunitas.
  2. Klik Install.

Setelah pemasangan, cari Postoria di panel node dan tambahkan ke alur kerja seperti node n8n lainnya.

Pada sebagian instalasi yang dihosting sendiri, n8n mungkin perlu dimulai ulang setelah pemasangan. Jika instalasi n8n Anda menggunakan mode antrean, pastikan versi paket yang sama terpasang untuk setiap worker yang dapat menjalankan alur kerja.

Membuat kunci Postoria Public API

  1. Buka Pengaturan Postoria.
  2. Temukan bagian Public API, server MCP, dan integrasi n8n.
  3. Klik Buat kunci API.
  4. Salin kunci dan simpan dengan aman.

Postoria hanya menampilkan kunci lengkap sekali. Setelah menutup dialog, Anda hanya akan melihat awalannya.

Jika Anda kehilangan kunci, cabut kunci tersebut dan buat yang baru.

Anda dapat mempelajari lebih lanjut tentang kunci API dan perilaku API dalam artikel bantuan Postoria Public API.

Menambahkan kredensial Postoria di n8n

  1. Buat alur kerja di n8n.
  2. Tambahkan node Postoria.
  3. Di kolom kredensial, pilih Create new credential.
  4. Pilih Postoria API.
  5. Tempelkan kunci Postoria Public API Anda.
  6. Jalankan pengujian kredensial.
  7. Simpan kredensial.

Kredensial yang sama dapat digunakan kembali oleh beberapa node Postoria dalam alur kerja n8n Anda.

Membuat alur kerja Postoria pertama Anda

Alur kerja pertama yang sederhana adalah menampilkan daftar ruang kerja Postoria yang tersedia untuk akun Anda.

  1. Tambahkan node Manual Trigger.
  2. Tambahkan node Postoria dan hubungkan ke pemicu tersebut.
  3. Pilih:
    • Resource: Workspace
    • Operation: Get Many
  4. Pilih kredensial Postoria Anda.
  5. Klik Execute workflow.

Hasilnya berisi ID, nama, dan zona waktu ruang kerja yang tersedia. Operasi Postoria lainnya menggunakan ruang kerja yang Anda pilih dalam node.

Resource dan operasi yang tersedia

Node Postoria saat ini mendukung resource berikut:

Workspace

  • Get Many — menampilkan daftar ruang kerja yang tersedia untuk akun Postoria Anda.

Social Account

  • Get Many — menampilkan daftar akun sosial yang terhubung ke ruang kerja yang dipilih.

Gunakan ID akun yang dikembalikan ketika membuat postingan.

Queue

  • Get Many — menampilkan daftar antrean penerbitan dalam ruang kerja yang dipilih.

Gunakan ID antrean yang dikembalikan ketika menambahkan postingan ke antrean.

Media

  • Upload Binary — mengunggah data biner yang diterima dari node n8n lainnya.
  • Import From URL — mengimpor media dari URL HTTPS publik.
  • Get — mengambil item media dan memeriksa statusnya saat ini.

Post

  • Create — menerbitkan sekarang, menjadwalkan postingan, atau menambahkan postingan ke antrean.
  • Get — mengambil postingan berdasarkan ID.
  • Get Many — menampilkan daftar postingan dengan filter dan paginasi opsional.
  • Delete — menghapus postingan dari Postoria.

Menghapus postingan Postoria tidak menghapus konten yang sudah diterbitkan di jejaring sosial.

Langsung menerbitkan postingan

  1. Tambahkan node Postoria.
  2. Pilih:
    • Resource: Post
    • Operation: Create
  3. Pilih ruang kerja.
  4. Atur Publish Mode ke Publish Now.
  5. Pilih satu atau beberapa akun sosial.
  6. Tambahkan keterangan dan pengaturan postingan opsional yang diperlukan.
  7. Tambahkan ID media ketika postingan menyertakan media yang diunggah atau diimpor.
  8. Jalankan node.

Node mengembalikan postingan Postoria yang dibuat beserta status awalnya.

Menjadwalkan postingan

  1. Pilih:
    • Resource: Post
    • Operation: Create
  2. Pilih ruang kerja dan akun sosial.
  3. Atur Publish Mode ke Schedule.
  4. Masukkan tanggal dan waktu terjadwal.
  5. Tambahkan keterangan, media, tautan, dan pengaturan khusus jejaring sosial yang diperlukan.
  6. Jalankan node.

Anda dapat menggunakan ekspresi n8n untuk jadwal relatif. Misalnya, ekspresi ini menjadwalkan postingan dua jam setelah alur kerja dijalankan:

{{ $now.plus({ hours: 2 }).toISO() }}

Menambahkan postingan ke antrean

  1. Pilih:
    • Resource: Post
    • Operation: Create
  2. Pilih ruang kerja.
  3. Atur Publish Mode ke Add to Queue.
  4. Pilih antrean.
  5. Pilih akun sosial.
  6. Tambahkan konten postingan.
  7. Jalankan node.

Antrean harus sudah ada di ruang kerja Postoria yang dipilih. Anda dapat membuat dan mengelola antrean dalam aplikasi web Postoria.

Mengimpor media dari URL publik

Gunakan Media → Import From URL ketika gambar, video, atau dokumen sudah tersedia melalui URL HTTPS publik.

  1. Tambahkan node Postoria sebelum node pembuatan postingan.
  2. Pilih:
    • Resource: Media
    • Operation: Import From URL
  3. Pilih ruang kerja.
  4. Masukkan URL HTTPS publik.
  5. Jalankan node.

Node memulai impor media dan memeriksa status pemrosesan secara otomatis. Node baru mengembalikan hasil setelah media siap digunakan atau batas waktu pemrosesan tercapai.

Petakan file_id yang dikembalikan ke kolom Media IDs pada node Postoria yang membuat postingan.

Mengunggah media biner

Gunakan Media → Upload Binary ketika node n8n sebelumnya menyediakan file sebagai data biner.

Misalnya, data biner dapat berasal dari node HTTP Request, node penyimpanan cloud, webhook, pengiriman formulir, atau langkah pemrosesan file lainnya.

  1. Hubungkan node yang menyediakan file biner ke node Postoria.
  2. Pilih:
    • Resource: Media
    • Operation: Upload Binary
  3. Pilih ruang kerja.
  4. Masukkan nama properti biner. Nilai bawaannya adalah data.
  5. Jalankan node.

Node Postoria melakukan seluruh proses unggahan:

  1. Membuat unggahan media Postoria.
  2. Mengunggah file biner.
  3. Menyelesaikan unggahan.
  4. Memeriksa status pemrosesan setiap lima detik.
  5. Mengembalikan media setelah mencapai status ready.

Batas waktu pemrosesan bawaan adalah 600 detik. Anda dapat mengubahnya di pengaturan node ketika file besar membutuhkan lebih banyak waktu.

Format unggahan yang didukung meliputi JPEG, PNG, WebP, GIF, MP4, MOV, dan PDF.

Setelah unggahan selesai, petakan file_id yang dikembalikan ke kolom Media IDs pada node pembuatan postingan.

Perilaku tanggal dan zona waktu

Postoria menafsirkan tanggal terjadwal menggunakan zona waktu alur kerja n8n.

Sebelum menjadwalkan postingan, buka pengaturan alur kerja di n8n dan pastikan zona waktu alur kerja sudah benar.

Node menangani tanggal sebagai berikut:

  • Tanggal yang memuat Z diperlakukan sebagai UTC.
  • Tanggal yang memuat offset eksplisit tetap merujuk pada waktu yang sama.
  • Tanggal lokal tanpa offset ditafsirkan dalam zona waktu alur kerja n8n, lalu dikonversi ke UTC sebelum dikirim ke Postoria.

Misalnya:

2026-08-01T12:00:00+03:00 → 2026-08-01T09:00:00.000Z

Menggunakan zona waktu alur kerja membantu mencegah pergeseran waktu postingan terjadwal ketika server n8n berjalan di wilayah yang berbeda.

Menggunakan Postoria sebagai alat AI Agent

Node Postoria juga dapat dihubungkan ke input Tool pada AI Agent n8n.

  1. Tambahkan node AI Agent.
  2. Hubungkan Chat Model yang didukung.
  3. Klik konektor Tool pada AI Agent.
  4. Tambahkan node Postoria.
  5. Pilih resource dan operasi Postoria yang boleh digunakan agen.

Contoh sederhana yang aman adalah:

  • Resource: Workspace
  • Operation: Get Many

Agen kemudian dapat menanggapi permintaan seperti:

Tampilkan daftar ruang kerja Postoria saya.

Untuk tindakan yang menerbitkan, menjadwalkan, memasukkan ke antrean, atau menghapus postingan, tinjau ruang kerja, akun sosial, konten, media, dan waktu terjadwal yang dipilih sebelum menjalankan alur kerja.

Ide contoh alur kerja

Node Postoria dapat digabungkan dengan node n8n lainnya untuk membangun alur kerja seperti:

  • Mengimpor artikel baru dari CMS dan menjadwalkan postingan media sosial.
  • Membaca postingan yang disetujui dari Google Sheets dan menambahkannya ke antrean Postoria.
  • Menerima webhook, mengimpor gambar, dan langsung menerbitkan postingan.
  • Mengunduh media dari penyimpanan cloud dan mengunggahnya ke Postoria.
  • Membuat keterangan dengan node AI dan mengirimkannya ke Postoria untuk ditinjau atau diterbitkan.
  • Menampilkan postingan terjadwal dan mengirim ringkasan harian ke email atau Slack.

Contoh alur kerja nyata: Car OS Media

Car OS Media adalah alur kerja n8n gratis yang dibuat oleh bilsimaging. Alur kerja ini mengubah satu foto mobil menjadi kampanye otomotif yang telah ditinjau, dengan foto yang dikirim melalui Telegram, lima peran kreatif AI, gambar utama dari GPT Image 2, pembuatan video opsional dengan LTX 2.3, dan dua tahap persetujuan oleh manusia.

Pada tahap distribusi, node Postoria yang terverifikasi menemukan ruang kerja yang tersedia dan akun terhubung, mengimpor gambar atau film yang sudah selesai, menunggu sampai media siap, lalu langsung menerbitkan atau menjadwalkannya. Alur kerja ini juga mencatat hasil Postoria untuk laporan operasional hariannya.

Car OS Media bergantung pada beberapa layanan kreatif dan hosting pihak ketiga. Konfigurasi bawaannya mengunggah foto sumber sementara ke layanan publik ImgBB dengan masa kedaluwarsa tujuh hari. Tinjau alur kerja, persyaratan pengungkapan jejaring sosial tujuan, kebijakan data klien, dan konfigurasi layanan eksternal sebelum menggunakannya di lingkungan produksi. Ganti langkah hosting gambar dengan penyimpanan sementara yang Anda kendalikan ketika host publik pihak ketiga tidak sesuai.

Paket dan kode sumber

Paket npm tersedia di sini:

https://www.npmjs.com/package/@postoria/n8n-nodes-postoria

Integrasi ini tersedia sebagai sumber terbuka di GitHub:

https://github.com/postoria-app/n8n-nodes-postoria