WebhookとSlack、Microsoft Teams、Discordへの通知
ひとことで言うと
ProとTeamでは、ダッシュボード > 連携から、PandafileのイベントをSlack、Microsoft Teams、Discordのチャンネルや、署名付きWebhookとして自社のサーバーに送れます。イベントを選び、テストを送り、配信ログを確認しましょう。
ProとTeamでは、何かが起きた瞬間に、Pandafileがほかのツールにお知らせします。Slack、Microsoft Teams、Discordのチャンネルへのメッセージ、または自社のサーバーへの署名付きHTTPSリクエストであるWebhookです。
選べるイベント
- 転送の準備完了:アップロードが終わり、リンクが使えるようになりました。
- 転送のダウンロード:受信者ごとに初回の1回だけ。代わりにすべてのダウンロードを選ぶこともできます。
- 転送の期限切れ。
- 受信者からの承認または修正依頼。
- あなたのファイルリクエストへのアップロード。
- 全員が文書に署名(Pandafile Sign)。
連携を追加する
- Slack、Microsoft Teams、Discordで、チャンネルの受信Webhookを作成し、そのURLをコピーします。自社のシステムの場合は、サーバーのHTTPSアドレスを使います。
- Pandafileにログインし、ダッシュボード > 連携を開きます。
- 「連携を追加」で種類を選び、URLを貼り付け、必要なら名前を付けて、受け取りたいイベントにチェックを入れます。
- 「連携を追加」を押し、「テストイベントを送信」で届くか確認します。
連携は最大5つまで追加できます。チャットのメッセージは、あなたのアカウントの言語で書かれます。
開発者向けのWebhook
- 配信は、イベントの種類、ID、詳細を含むJSONのPOSTです。詳細には、ID、タイトル、リンク、件数、受信者のメールアドレスが含まれます。ファイルの中身、パスワード、受信者ごとのダウンロードリンクは含まれません。
- 各リクエストにはPandafile-Signatureヘッダーがあり、タイムスタンプ(t)と、タイムスタンプと本文からあなたの署名シークレットで作ったHMAC-SHA256署名(v1)が入っています。シークレットはwhsec_で始まり、表示されるのは一度だけです。
- 「新しいシークレット」で新しい署名シークレットを作成できます。古いシークレットも24時間は有効なので、イベントを取りこぼさずに切り替えられます。
- 10秒以内に2xxのステータスで応答してください。そうでない場合は、1分後、5分後、30分後、2時間後、12時間後に再送します。
- 配信ログには、連携ごとに直近50件の配信と結果が表示されます。
チーム、テストモード、Zapier
チームでは、各自が自分の連携を管理し、自分の転送のイベントだけを受け取ります。テスト用APIキーで作ったテスト転送のイベントは、livemodeがfalseでWebhookに送られ、Slack、Teams、Discordには送られません。ZapierとMakeはPandafile APIで接続し、「APIサブスクリプション」に表示されます。