지금까지는 게시물이 나갔는지 알려면 물어봐야 했습니다. API를 호출하고 상태를 확인한 뒤 나중에 다시 호출하는 식이죠. 작동하기는 하지만 결국 폴링입니다. 자주 물으면 요청을 낭비하고, 드물게 물으면 늦게 알게 됩니다. 웹훅은 이 방향을 뒤집습니다. sona.to에 주소를 알려주면, 무언가 일어나는 순간 sona.to가 먼저 연락합니다. 이제 모든 요금제에서 사용할 수 있습니다.
구독할 수 있는 이벤트는 네 가지이며, 반응할 가치가 있는 결과를 모두 다룹니다. 게시물 발행됨, 게시물 실패, 사이트 감사 완료, 사이트 감사 실패입니다. 각 웹훅이 무엇을 받을지 직접 고르므로, Slack 알림은 실패만 듣고 리포팅 파이프라인은 전부 받도록 나눌 수 있습니다. 페이로드는 REST API가 반환하는 것과 같은 필드 이름을 쓰기 때문에, GET 요청에서 이미 파싱하던 코드가 그대로 동작합니다.
설정에는 1분이면 충분합니다. 대시보드의 API 페이지를 열고, 사용 중인 도구가 알려준 주소를 붙여 넣고, 원하는 이벤트를 체크한 뒤 저장하세요. 서명용 비밀 키는 그 순간 한 번만 표시됩니다. 다시는 보이지 않으니 그 자리에서 복사해 두세요.
그 비밀 키가 요청이 진짜인지 판단하는 근거입니다. 모든 전송에는 서명 헤더가 붙고, 그 안에 타임스탬프와 그 타임스탬프 및 요청 본문을 여러분의 키로 계산한 HMAC SHA-256이 들어 있습니다. 같은 계산을 여러분 쪽에서 다시 하고 상수 시간 비교 함수로 대조하세요. 타임스탬프가 서명 대상에 포함되므로, 가로챈 요청을 나중에 다시 보내 공격할 수 없습니다. 몇 분보다 오래된 것은 거부하면 충분합니다.
전송은 첫 실패에서 포기하지 않습니다. 엔드포인트가 내려가 있거나 오류를 반환하면 요청은 60초 후, 이어서 5분 후, 다시 30분 후에 재시도됩니다. 모든 시도가 상태 코드와 소요 시간과 함께 기록되므로, 말썽을 부리는 엔드포인트는 추측이 아니라 들여다볼 수 있는 대상이 됩니다. 계속 실패하는 엔드포인트는 자동으로 꺼지며, 고친 뒤 다시 켤 수 있습니다.
가장 먼저 떠오르는 연결 대상은 자동화 플랫폼입니다. Zapier, Make, n8n 모두 붙여 넣을 웹훅 주소를 주고, 이벤트는 다음 단계로 넘기기 좋은 JSON으로 도착합니다. 채널에 보내는 메시지, 스프레드시트의 한 행, 트래커의 작업 같은 것들이죠. 직접 운영하는 서버도 똑같이 동작하며, 중간에 플랫폼이 필요 없습니다.
sona.to가 받아들이는 주소에 대한 참고 사항입니다. 대상은 https여야 하고 공개 주소여야 합니다. 사설망으로 연결되는 주소는 저장할 때도, 전송 시점에도 다시 거부되며, 리디렉션은 따라가지 않습니다. 수신 서버를 로컬 네트워크에서 직접 운영한다면 공개 호스트 이름이나 터널 뒤에 두세요.
웹훅은 REST API, MCP 서버에 이어 대시보드 밖에서 sona.to를 다루는 세 번째 방법입니다. API는 묻기 위한 것이고, MCP는 AI 어시스턴트가 묻게 하기 위한 것이며, 웹훅은 알림을 받기 위한 것입니다. 서명 검증 예제를 포함한 자세한 내용은 API 문서에 있습니다.