本文へスキップ

個人APIキーでZapierに接続する

Zapier用のMarcomm AIアプリで、プレスリリース、ブログ記事、プレスイベントからZapを開始し、作成、公開、送信を行います。アプリは招待制です。

  1. 1
    Marcommで設定 → 連携 → Zapierを開き、現在の状況と必要な値を確認します。
    設定、連携、Zapierで、状況、接続手順、選択するスコープ、APIの利用承認の状況が表示されている画面
    Zapierの画面には、現在の状況、手順、コピーする値、このワークスペースでAPIの利用が承認されているかが表示されます。
  2. 2
    設定 → APIを開きます。ワークスペースにまだAPIの利用承認がない場合は、オーナーか管理者がAPI利用を申請に入力して申請を送信を選びます。
  3. 3
    承認されたらキーを作成を開き、個人キーを選んで必要なスコープにチェックを入れ、キーを作成を選びます。キーは一度しか表示されないので、すぐにコピーします。
  4. 4
    Marcomm AIから届いた招待リンクを開き、ZapierのアカウントにMarcomm AIアプリを追加します。
  5. 5
    Zapを作成してトリガーかアクションにMarcomm AIを選び、Zapierが接続を求めたらAPI Key(APIキー)にキーを貼り付けます。

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

アプリはまだZapierの公開ディレクトリになく、Marcomm AIからの招待リンクが必要です。トリガーはNew Press Release、Press Release Approval Requested、Press Release Published、New Blog Post、Blog Post Published、New Press Event、RSVP Invite Updatedの7つです。アクションはプレスリリースの作成、更新、承認依頼、公開、送信、ブログ記事の作成と公開、プレスイベントの作成、RSVP招待状の作成、宛先の追加、送信を行います。2つの検索でプレスリリースかブログ記事を探せます。

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

公開と送信は取り消せません。APIはリクエストにconfirm: trueかIdempotency-Keyヘッダーがある場合にだけ実行し、承認がまだ必要な場合や予約公開・エンバーゴ中の場合は公開せずに409を返します。同じIdempotency-Keyで同じリクエストを再送すると、24時間は再実行せずに最初の結果を返します。書き込みのステップごとに、Zapと入力値から作った冪等キーを送ります。24時間以内にまったく同じステップを意図して繰り返す場合は、Repeat Keyに実行ごとに変わる値を入れてください。

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

よくある質問

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

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

できません。Zapierアプリは承認を依頼でき、判断は承認者がMarcommで行います。APIなら承認スコープのある個人キーで承認や差し戻しができます。

連携