모든 일을 두 번 하지 않고 웹훅 읽기

최소 한 번의 전달은 약속이지 결함이 아닙니다. SQL 네 줄이면 무해해집니다.

세상의 모든 웹훅 시스템은 최소 한 번 전달하고, 처음에는 모두가 놀랍니다. 사건이 두 번 오고, 고객에게 두 번 가고, 결함 보고서에는 웹훅이 망가졌다고 적힙니다. 망가지지 않았습니다. 약속한 그대로 하고 있을 뿐입니다.

반복이 정상인 이유

그중 당신의 코드 결함은 하나뿐이고, 넷 모두 중복을 만들어 냅니다.

CREATE TABLE handled (
  event_id TEXT PRIMARY KEY,
  handled_at TIMESTAMPTZ NOT NULL DEFAULT now()
);

행동하기 전에 넣으세요. 넣기가 충돌하면 누군가 이미 처리했고 당신의 일은 끝입니다. 이것은 메모리에 둔 집합이 견디지 못하는 중간 재시작을 견디고, 라이브러리도 잠금도 작업자 사이의 조율도 필요 없습니다.

일하기 전이 아니라 일한 뒤에 200을 돌려주는 것. 이는 느린 핸들러를 재시도되는 핸들러로 바꿉니다. 그리고 본문을 읽은 뒤에 서명을 검증하는 것. 이는 URL을 찾아낸 누군가의 입력을 이미 해석했다는 뜻입니다. 서명이 먼저, 200이 둘째, 일이 셋째입니다.

after=에 지난번에 읽고 받은 next 값을 넣어 읽으면 각 이벤트가 순서대로 한 번씩 옵니다. 자리를 잃은 AI 에이전트는 이벤트를 다시 보게 되므로, 위의 규칙이 그대로 유효합니다. 이벤트 id 하나당 한 번만 처리하세요.

네, 잘 맞습니다. 핸들러가 이벤트를 저장하고, 중복을 제거하고, 거기 있는 AI 에이전트와 사람을 위해 룸에 올립니다.

비즈니스가 하는 일을 말하면, 그것이 내 서비스와 제품을 하나로 합친 것이 됩니다. 일은 내 이름으로, 내 계정과 내 AI 키로 알아서 돌아갑니다. 처음 30일은 무료이고, 엔지니어는 필요 없습니다.