Webhooks
이벤트가 발생하는 순간 도구로 전송
게시물이 발행되거나 실패했을 때, 또는 사이트 감사나 AI 가시성 점검이 끝났을 때 서명된 HTTP 요청을 받습니다.
오늘 무료로 시작하기
무언가 일어났는지 확인하려고 API를 계속 호출하는 방식은 느리고 요청을 낭비합니다. webhook은 이를 뒤집습니다. sona.to에 URL을 알려주면, 게시물이 발행되는 순간, 실패하는 순간, 사이트 감사나 AI 가시성 점검이 끝나는 순간에 서명된 HTTP 요청이 도착합니다. Zapier, Make, n8n 또는 직접 운영하는 서버로 향하게 해두면 나머지 스택이 알아서 반응합니다.
발생하는 순간의 이벤트
반응할 가치가 있는 결과를 여덟 가지 이벤트가 모두 다룹니다. 게시물 발행 및 실패, 사이트 감사 완료 및 실패, AI 가시성 점검 완료 및 실패, 그리고 AI 어시스턴트가 브랜드를 언급하기 시작하거나 더 이상 언급하지 않을 때입니다. 각각 API가 반환하는 것과 동일한 필드를 담고 있어 webhook과 GET의 내용이 일치합니다.
서명되어 있어 신뢰할 수 있습니다
모든 요청에는 타임스탬프와 본문을 대상으로 계산한 HMAC SHA-256 서명이 포함됩니다. 키는 webhook을 만들 때 한 번만 표시되는 비밀 키입니다. 이를 검증하면 그 요청이 sona.to에서 왔고 재전송된 것이 아님을 알 수 있습니다.
재시도와 전송 기록
전송에 실패하면 60초 후, 이어서 5분 후, 다시 30분 후에 재시도합니다. 모든 시도는 상태 코드와 소요 시간과 함께 기록되므로 문제가 있는 엔드포인트를 쉽게 진단할 수 있습니다.
작동 방식
1
URL 추가
사용 중인 도구가 알려준 주소를 붙여 넣습니다. https여야 합니다.
2
이벤트 선택
해당 엔드포인트가 받을 이벤트를 고릅니다.
3
비밀 키 보관
서명용 비밀 키는 한 번만 표시됩니다. 들어오는 요청을 검증하는 데 쓰이므로 보관해 두세요.
4
자동으로 반응
무언가 일어나는 순간 워크플로가 실행됩니다. 폴링은 필요 없습니다.
추천 대상
Zapier, Make, n8n 사용자: 게시물이 나갈 때 워크플로를 실행합니다.
팀: 발행 확인이나 실패를 채팅 채널로 보냅니다.
대행사: 모든 고객 게시물을 자체 리포팅 시스템에 기록합니다.
개발자: 자신의 시스템이 폴링 대신 반응하기를 원합니다.
질문