本文へスキップ

カスタムコネクタでPower Automateに接続する

OpenAPIファイルからMarcomm AIのコネクタを自分のPower Automate環境にインポートし、個人APIキーでフローからMarcomm AIのアクションを実行します。

  1. 1
    Marcommで設定 → 連携 → Power Automateを開き、現在の状況と必要な値を確認します。
    設定、連携、Power Automateで、状況、接続手順、選択するスコープ、APIの利用承認の状況が表示されている画面
    Power Automateの画面には、現在の状況、手順、コピーする値、このワークスペースでAPIの利用が承認されているかが表示されます。
  2. 2
    設定 → APIを開きます。ワークスペースにまだAPIの利用承認がない場合は、オーナーか管理者がAPI利用を申請に入力して申請を送信を選びます。
  3. 3
    承認されたらキーを作成を開き、個人キーを選んで必要なスコープにチェックを入れ、キーを作成を選びます。キーは一度しか表示されないので、すぐにコピーします。
  4. 4
    Power AutomateでCustom connectorsを開き、New custom connector、Import an OpenAPI from URLの順に選んでhttps://marcomm.works/api/v1/openapi.jsonを入力します。
  5. 5
    Security(セキュリティ)のステップでAPI Keyを選び、パラメーター名をAuthorization、場所をHeader(ヘッダー)にしてコネクタを作成します。
  6. 6
    フローが接続を求めたら、Bearer、スペース、キーの順に入力します。

公開と送信のステップは取り消せないので、まず下書きで試してください。

コネクタはMicrosoftのコネクタ一覧にはありません。OpenAPIファイルから自分の環境にインポートするので、アクションはAPIと同じです。ニュースと承認の読み取り、プレスリリース、ブログ記事、プレスイベント、RSVP招待状の作成と更新、承認依頼、承認と差し戻し、公開と送信です。アクションだけで、トリガーはありません。

スコープはキーでできることを決めます。コンテンツ(content)はプレスリリース、ブログ記事、プレスイベントを読み取り、コンテンツの作成(content:write)は下書きを作成・編集し、公開と送信(distribution)は公開とメール送信を行い、承認(approvals)は承認の手順を扱います。後の3つは個人キーでしか使えません。操作がキーを作成した人の名前で記録されるためです。ワークスペースキーは読み取りだけで、どのキーも作成した人の役割と権限で動きます。

公開と送信は取り消せません。APIはリクエストにconfirm: trueかIdempotency-Keyヘッダーがある場合にだけ実行し、承認がまだ必要な場合や予約公開・エンバーゴ中の場合は公開せずに409を返します。同じIdempotency-Keyで同じリクエストを再送すると、24時間は再実行せずに最初の結果を返します。コネクタのこれらのアクションにはconfirmの欄とIdempotency-Keyの欄があります。

APIはTeamプラン以上で使えます。Marcomm AIのチームが申請を一件ずつ審査し、キーは承認後にだけ動きます。キーにはワークスペースで承認されたスコープだけを入れられ、一人あたり10個までキーを作成できます。既定の上限はワークスペースごとに毎分60回、1日10,000回で、超えるとAPIはRetry-Afterヘッダー付きで429を返します。上限を上げるには設定 → APIの上限の引き上げが必要ですか?を使ってください。Power Automateの接続を解除するには、キーの横の無効化を選びます。そのキーを使っていたシステムはすぐにアクセスできなくなります。

よくある質問

Authorization: Bearerの後にキーを付けたヘッダーでGET https://marcomm.works/api/v1/meを呼び出してください。スコープに関係なく承認済みのキーなら動き、ワークスペース、キーの名前、キーのスコープを返します。

キーにはどのサービスが使っているかが記録されないため、MarcommはPower Automateのカードを連携済みにしません。各キーを最後に使った日時は設定 → APIで確認できます。

このコネクタではできません。アクションしかないためです。スケジュールなど別のトリガーでフローを開始し、一覧のアクションで最新の項目を読み取ってください。

連携