コンテンツぞスキップ
Pellio

Webhook

2026幎10月2日曎新
このペヌゞの内容

Settings → Developers → Webhooks蚭定 → 開発者 → Webhookで゚ンドポむントを远加したすオヌナヌず管理者。公開されおいる HTTPS アドレスである必芁がありたす。受け取るむベントを遞びたす。All events をオンのたたにする今埌 Pellio に远加されるむベントも含みたすか、オフにしお必芁なむベントを遞びたす。゚ンドポむントの眲名シヌクレットは䞀床だけ衚瀺されたす。

各゚ンドポむントには、受け取るむベントず次の操䜜が衚瀺されたす。

  • Edit events受け取るむベントを倉曎したす。Save events で倉曎がすぐに適甚されたす。
  • Send test受け取るむベントに関係なく、その゚ンドポむントに webhook.test むベントを送信したす。
  • Deliveries盎近50回の送信保留䞭、配信枈み、倱敗ずそのレスポンスを衚瀺したす。
  • Rotate secret眲名シヌクレットを新しくしたす。新しいシヌクレットは䞀床だけ衚瀺され、叀いものはすぐに䜿えなくなるため、゚ンドポむントをすぐに曎新しおください。
  • Remove゚ンドポむントぞの送信を停止したす。

API の堎合POST /v1/webhooks は url ず events空のリストはすべおのむベントを受け取り、PATCH /v1/webhooks/{id} は events を倉曎し、POST /v1/webhooks/{id}/rotate-secret は新しい secret を返したす。

むベント

リク゚ストボディはすべお { "id", "event", "createdAt", "data" } です。

むベント タむミング data
video.created アップロヌド、録画、URL からのむンポヌトで動画が䜜成されたずき。 id、title
video.ready 動画の凊理が終わったずき差し替えやトリミングの埌も含む。 id、title、status、version、durationSeconds、width、height、errorMessage
video.failed 新しい動画を凊理できなかったずき。 video.ready ず同じ
video.deleted 動画がゎミ箱に移動されたずきtrashed: true、たたは完党に削陀されたずき。 id、title、trashed
video.watched 識別枈みの芖聎者メヌルフォヌム、?email= リンク、たたは WordPress サむトからが動画の再生を開始したずき、25、50、75を超えたずき、芖聎を完了したずき蚪問をたたいで90芖聎。芖聎者、動画、マむルストヌンごずに1回。 videoid、title、vieweremail、name、progress0、25、50、75、100、milestonestarted、25%、50%、75%、completed、completed
lead.captured 誰かがメヌルフォヌムを送信したずき。 id、email、name、fields、videoid、title、createdAt

配信

Pellio は User-Agent: Pellio-Webhooks/1 ヘッダヌ付きで POST を送信し、最倧10秒埅ちたす。2xx のレスポンスはすべお配信成功ずみなしたす。リダむレクトはたどらないため、3xx は倱敗になりたす。倱敗した配信は合蚈6回詊行され、最初の再詊行たでは20秒埅ち、その埌は埅ち時間を倍にしお最倧320秒たで延ばしたす。

眲名の怜蚌

各リク゚ストには Pellio-Signature ヘッダヌが付きたす。圢匏は t=<unix time>,v1=<hex HMAC-SHA256 of "t.body"> で、゚ンドポむントのシヌクレットを䜿いたす。生のリク゚ストボディに察しお怜蚌しおください。

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(header, rawBody, secret) {
  const { t, v1 } = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // 5-minute tolerance
  const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
  return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

この蚘事は圹に立ちたしたか

解決したせんかメッセヌゞをお送りいただければ、担圓者からご連絡したす。