Lompat ke konten
MarcommAI

Hubungkan n8n dengan kunci API pribadi

Node komunitas n8n-nodes-marcomm menulis siaran pers, artikel blog, acara pers, dan undangan RSVP, meminta persetujuan, lalu menerbitkannya. Paket ini belum diterbitkan.

  1. 1
    Di Marcomm, buka Pengaturan → Integrasi → n8n untuk melihat status dan nilai yang diperlukan.
    Pengaturan, Integrasi, n8n, dengan status, langkah koneksi, cakupan yang dicentang, dan status akses API
    Halaman n8n menampilkan status saat ini, langkah-langkah, nilai yang perlu disalin, dan apakah akses API sudah disetujui untuk ruang kerja ini.
  2. 2
    Buka Pengaturan → API. Jika ruang kerja belum punya akses API, pemilik atau admin mengisi Ajukan akses API lalu memilih Kirim pengajuan.
  3. 3
    Setelah disetujui, buka Buat kunci, pilih Kunci pribadi, centang Cakupan yang diperlukan, lalu pilih Buat kunci. Segera salin kuncinya karena hanya ditampilkan sekali.
  4. 4
    Di n8n Cloud, cari Marcomm AI di panel node (jika tidak muncul, aktifkan Verified Community Nodes di panel admin lalu mulai ulang n8n). Di n8n yang di-host sendiri, buka Settings (Pengaturan), lalu Community Nodes, lalu Install (Pasang), dan masukkan n8n-nodes-marcomm.
  5. 5
    Buat kredensial Marcomm AI API, tempel kunci di API Key (kunci API), lalu tambahkan node Marcomm AI atau Marcomm AI Trigger ke workflow.

Node pemicu memerlukan cakupan Konten dan tidak mengirim apa pun pada pemeriksaan pertama, sehingga tidak memutar ulang item lama.

Node ini mencakup siaran pers, artikel blog, acara pers, undangan RSVP, dan persetujuan, termasuk menyetujui, menolak, dan daftar persetujuan yang menunggu. Node pemicu memulai workflow saat siaran pers dibuat, dikirim untuk persetujuan, atau diterbitkan, saat artikel blog dibuat atau diterbitkan, atau saat acara pers dibuat.

Cakupan menentukan apa yang bisa dilakukan kunci. Konten (content) membaca siaran pers, artikel blog, dan acara pers, Menulis konten (content:write) membuat dan mengedit draf, Publikasi dan kirim (distribution) menerbitkan dan mengirim lewat email, dan Persetujuan (approvals) mencakup langkah persetujuan. Tiga yang terakhir hanya berfungsi dengan Kunci pribadi, karena tindakan dicatat atas nama orang yang membuat kunci. Kunci ruang kerja hanya bisa membaca, dan setiap kunci bertindak dengan peran dan izin pembuatnya.

Menerbitkan dan mengirim tidak dapat dibatalkan. API hanya menjalankannya jika permintaan berisi confirm: true atau header Idempotency-Key, dan tidak menerbitkan apa pun serta menjawab 409 selama persetujuan masih diperlukan atau konten dijadwalkan atau berada di bawah embargo. Percobaan ulang dengan Idempotency-Key dan permintaan yang sama mengembalikan hasil pertama selama 24 jam, bukan dijalankan lagi. Node mengirim kunci idempotensi di setiap penulisan, dibuat dari eksekusi, node, dan item, serta mengonfirmasi sendiri operasi menerbitkan dan mengirim.

API tersedia di paket Team ke atas. Tim Marcomm AI meninjau setiap pengajuan, dan kunci baru berfungsi setelah disetujui. Kunci hanya bisa memakai cakupan yang disetujui untuk ruang kerja, dan setiap orang bisa punya hingga 10 kunci. Secara default, satu ruang kerja bisa mengirim 60 permintaan per menit dan 10.000 per hari; di atas itu API menjawab 429 dengan header Retry-After. Untuk menaikkan batas, gunakan Perlu batas yang lebih tinggi? di Pengaturan → API. Untuk memutus n8n, pilih Cabut di samping kunci; sistem yang memakainya langsung kehilangan akses.

Tanya Jawab

Panggil GET https://marcomm.works/api/v1/me dengan header Authorization: Bearer diikuti kunci Anda. Ini berfungsi dengan kunci apa pun yang sudah disetujui, apa pun cakupannya, dan mengembalikan ruang kerja, nama kunci, serta cakupannya.

Kunci tidak mencatat layanan mana yang memakainya, jadi Marcomm tidak menandai kartu n8n sebagai terhubung. Pengaturan → API menampilkan kapan setiap kunci terakhir dipakai.

Bisa, dengan node bawaan HTTP Request. Panggil https://marcomm.works/api/v1 dengan header Authorization: Bearer diikuti kunci Anda, dan tambahkan header Idempotency-Key di setiap penulisan.

Integrasi