Langkau ke kandungan

Sambungkan Zapier dengan kunci API peribadi

Dengan apl Marcomm AI untuk Zapier, mulakan Zap daripada siaran akhbar, catatan blog dan acara akhbar, serta cipta, terbitkan dan hantar semuanya. Apl ini melalui jemputan sahaja.

  1. 1
    Dalam Marcomm, pergi ke Tetapan → Integrasi → Zapier untuk melihat status dan nilai yang diperlukan.
    Tetapan, Integrasi, Zapier, dengan status, langkah sambungan, skop untuk ditanda dan status akses API
    Halaman Zapier memaparkan status semasa, langkah, nilai untuk disalin dan sama ada akses API telah diluluskan untuk ruang kerja ini.
  2. 2
    Buka Tetapan → API. Jika ruang kerja belum mempunyai akses API, pemilik atau pentadbir mengisi Mohon akses API dan memilih Hantar permohonan.
  3. 3
    Selepas diluluskan, buka Cipta kunci, pilih Kunci peribadi, tandakan Skop yang diperlukan dan pilih Cipta kunci. Salin kunci itu segera kerana ia hanya dipaparkan sekali.
  4. 4
    Buka pautan jemputan daripada Marcomm AI dan tambahkan apl Marcomm AI pada akaun Zapier anda.
  5. 5
    Cipta Zap, pilih Marcomm AI sebagai pencetus atau tindakan, dan tampal kunci dalam API Key (kunci API) apabila Zapier meminta sambungan.

Cuba dahulu langkah menerbitkan dan menghantar dengan draf, kerana ia tidak boleh dibuat asal.

Apl ini belum berada dalam direktori awam Zapier, jadi anda memerlukan pautan jemputan daripada Marcomm AI. Terdapat tujuh pencetus: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event dan RSVP Invite Updated. Tindakannya mencipta, mengemas kini, meminta kelulusan, menerbitkan dan menghantar siaran akhbar, mencipta dan menerbitkan catatan blog, mencipta acara akhbar, serta mencipta, mengisi dan menghantar jemputan RSVP. Dua carian mencari siaran akhbar atau catatan blog.

Skop menentukan apa yang boleh dilakukan oleh kunci. Kandungan (content) membaca siaran akhbar, catatan blog dan acara akhbar, Tulis kandungan (content:write) mencipta dan mengedit draf, Terbit dan hantar (distribution) menerbitkan dan menghantar melalui e-mel, dan Kelulusan (approvals) meliputi langkah kelulusan. Tiga yang terakhir hanya berfungsi dengan Kunci peribadi, kerana tindakan direkodkan atas nama orang yang mencipta kunci. Kunci ruang kerja hanya boleh membaca, dan setiap kunci bertindak dengan peranan dan kebenaran penciptanya.

Penerbitan dan penghantaran tidak boleh dibuat asal. API hanya menjalankannya apabila permintaan mengandungi confirm: true atau pengepala Idempotency-Key, dan tidak menerbitkan apa-apa serta menjawab 409 selagi kelulusan masih diperlukan atau kandungan dijadualkan atau di bawah embargo. Cubaan semula dengan Idempotency-Key dan permintaan yang sama memulangkan hasil pertama selama 24 jam, bukan dijalankan sekali lagi. Setiap langkah tulis menghantar kunci idempotensi yang dibina daripada Zap dan inputnya. Jika Zap perlu mengulang langkah yang sama dengan sengaja dalam masa 24 jam, isikan Repeat Key dengan nilai yang berubah pada setiap larian.

API tersedia pada pelan Team dan ke atas. Pasukan Marcomm AI menyemak setiap permohonan, dan kunci hanya berfungsi selepas diluluskan. Kunci hanya boleh menggunakan skop yang diluluskan untuk ruang kerja, dan setiap orang boleh mempunyai sehingga 10 kunci. Secara lalai, satu ruang kerja boleh membuat 60 permintaan seminit dan 10,000 sehari; melebihi itu, API menjawab 429 dengan pengepala Retry-After. Untuk menaikkan had, gunakan Perlukan had yang lebih tinggi? dalam Tetapan → API. Untuk memutuskan Zapier, pilih Batalkan di sebelah kunci; sistem yang menggunakannya terus hilang akses.

Soalan Lazim

Panggil GET https://marcomm.works/api/v1/me dengan pengepala Authorization: Bearer diikuti kunci anda. Ia berfungsi dengan mana-mana kunci yang diluluskan tanpa mengira skopnya, dan memulangkan ruang kerja, nama kunci dan skopnya.

Kunci tidak merekodkan perkhidmatan yang menggunakannya, jadi Marcomm tidak menandakan kad Zapier sebagai disambungkan. Tetapan → API memaparkan bila setiap kunci terakhir digunakan.

Tidak. Apl Zapier boleh meminta kelulusan, dan pelulus membuat keputusan dalam Marcomm. Melalui API, kunci peribadi dengan skop Kelulusan boleh meluluskan atau menolak.

Integrasi