カスタムコネクタでPower Automateに接続する
OpenAPIファイルからMarcomm AIのコネクタを自分のPower Automate環境にインポートし、個人APIキーでフローからMarcomm AIのアクションを実行します。
- 1Marcommで設定 → 連携 → Power Automateを開き、現在の状況と必要な値を確認します。

Power Automateの画面には、現在の状況、手順、コピーする値、このワークスペースでAPIの利用が承認されているかが表示されます。 - 2設定 → APIを開きます。ワークスペースにまだAPIの利用承認がない場合は、オーナーか管理者がAPI利用を申請に入力して申請を送信を選びます。
- 3承認されたらキーを作成を開き、個人キーを選んで必要なスコープにチェックを入れ、キーを作成を選びます。キーは一度しか表示されないので、すぐにコピーします。
- 4Power AutomateでCustom connectorsを開き、New custom connector、Import an OpenAPI from URLの順に選んで
https://marcomm.works/api/v1/openapi.jsonを入力します。 - 5Security(セキュリティ)のステップでAPI Keyを選び、パラメーター名を
Authorization、場所をHeader(ヘッダー)にしてコネクタを作成します。 - 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で確認できます。
このコネクタではできません。アクションしかないためです。スケジュールなど別のトリガーでフローを開始し、一覧のアクションで最新の項目を読み取ってください。