すべての連携
Webhook
Pellioのイベントを、自社のアプリや自動化ツールに送れます。
できること
video.created、video.ready、video.failed、video.deleted、video.watched、lead.capturedの各イベントを受け取れます。- 識別済みの視聴者が動画の再生を始めたとき、25%、50%、75% を超えたとき、最後まで視聴したときに、
video.watchedイベントを受け取れます。視聴者、動画、マイルストーンの組み合わせごとに1回です。 - 今後追加されるものも含めてすべてのイベントを送るか、選んだイベントだけを送るかを指定できます。
- 各リクエストを HMAC-SHA256 署名で検証できます。
設定方法
- Pellio で Settings → Developers → Webhooks を開きます。オーナーまたは管理者である必要があります。
- エンドポイントを追加します。公開された HTTPS のアドレスである必要があります。
- All events をオンのままにするか、オフにしてイベントを選びます。
- 署名シークレットをコピーします。表示されるのは1回だけです。
- Send test をクリックして
webhook.testイベントを送り、Deliveries でレスポンスを確認します。 - アプリ側で、
Pellio-Signatureヘッダー（t=…,v1=…）を未加工のリクエストボディと照合します。
補足
- ボディは常に
{ "id", "event", "createdAt", "data" }の形式です。 - Pellio は最大10秒待ちます。2xx のレスポンスはすべて配信成功とみなされ、リダイレクトは失敗とみなされます。
- 配信に失敗した場合は合計6回試行します。最初の再試行は20秒後で、待ち時間は倍々に増え、最大320秒になります。
- Deliveries には直近50回の試行が表示されます。Rotate secret を使うと、シークレットがすぐに置き換わります。
- Webhook は API からも管理できます。
- Standard プラン以上が必要です。
詳しくはWebhookをご覧ください。
