Langkau ke kandungan

Sambungkan Power Automate dengan penyambung tersuai

Import penyambung Marcomm AI daripada fail OpenAPI ke persekitaran Power Automate anda, kemudian jalankan tindakan Marcomm AI daripada aliran anda dengan kunci API peribadi.

  1. 1
    Dalam Marcomm, pergi ke Tetapan → Integrasi → Power Automate untuk melihat status dan nilai yang diperlukan.
    Tetapan, Integrasi, Power Automate, dengan status, langkah sambungan, skop untuk ditanda dan status akses API
    Halaman Power Automate 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
    Dalam Power Automate, buka Custom connectors, pilih New custom connector, kemudian Import an OpenAPI from URL, dan masukkan https://marcomm.works/api/v1/openapi.json.
  5. 5
    Pada langkah Security (Keselamatan), pilih API Key, tetapkan nama parameter kepada Authorization dan lokasi kepada Header (pengepala), kemudian cipta penyambung.
  6. 6
    Apabila aliran meminta sambungan, masukkan Bearer, satu ruang dan kunci anda.

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

Penyambung ini tiada dalam senarai penyambung Microsoft. Anda mengimportnya ke persekitaran sendiri daripada fail OpenAPI, jadi tindakannya mengikut API: membaca berita dan kelulusan, mencipta dan mengemas kini siaran akhbar, catatan blog, acara akhbar dan jemputan RSVP, meminta kelulusan, meluluskan atau menolak, serta menerbitkan dan menghantar. Ia hanya ada tindakan, tiada pencetus.

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. Dalam penyambung, tindakan ini mempunyai medan confirm dan medan Idempotency-Key.

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 Power Automate, 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 Power Automate sebagai disambungkan. Tetapan → API memaparkan bila setiap kunci terakhir digunakan.

Tidak dengan penyambung ini, kerana ia hanya ada tindakan. Mulakan aliran dengan pencetus lain, contohnya jadual, dan baca item terkini dengan tindakan senarai.

Integrasi