웹훅

할 수 있는 일

• video.created, video.ready, video.failed, video.deleted, video.watched, lead.captured 이벤트를 받아요.
• 식별된 시청자가 동영상을 시작하거나, 25%, 50%, 75%를 지나거나, 끝까지 보면 video.watched 이벤트를 받아요. 시청자, 동영상, 마일스톤별로 한 번씩이에요.
• 나중에 추가되는 이벤트를 포함해 모든 이벤트를 받거나, 고른 이벤트만 받을 수 있어요.
• HMAC-SHA256 서명으로 모든 요청을 검증해요.

설정 방법

1. Pellio에서 Settings → Developers → Webhooks로 이동하세요. 소유자 또는 관리자여야 해요.
2. 엔드포인트를 추가하세요. 공개된 HTTPS 주소여야 해요.
3. All events를 켜 두거나, 끄고 이벤트를 고르세요.
4. 서명 시크릿을 복사하세요. 한 번만 표시돼요.
5. Send test를 클릭해 webhook.test 이벤트를 보내고, Deliveries에서 응답을 확인하세요.
6. 앱에서 가공하지 않은 원본 본문으로 Pellio-Signature 헤더(t=…,v1=…)를 검증하세요.

알아 두면 좋은 점

• 모든 본문은 { "id", "event", "createdAt", "data" } 형식이에요.
• Pellio는 최대 10초 동안 기다려요. 2xx 응답은 모두 전송 성공으로, 리디렉션은 실패로 처리해요.
• 실패한 전송은 총 6번 시도해요. 첫 재시도는 20초 후이고, 대기 시간은 두 배씩 늘어나 최대 320초까지 기다려요.
• Deliveries에는 최근 50번의 전송 시도가 표시돼요. Rotate secret을 누르면 시크릿이 즉시 교체돼요.
• API로도 웹훅을 관리할 수 있어요.
• Standard 요금제 이상이 필요해요.

전체 가이드: 웹훅