웹훅은 연결된 계정에서 무슨 일이 생겼을 때 우리가 POST하는 당신의 URL입니다. 메시지가 오거나, 인맥이 늘거나, 계정이 손길을 필요로 할 때요. 반복 조회를 대신하는 것이고, 사용 한도가 있는 API에서 이것은 취향의 문제가 아니라 동작하느냐 마느냐의 차이입니다.
서명을 검증하세요. 매번.
당신의 엔드포인트는 공개 인터넷에 있고, 거기에 닿을 수 있는 무엇이든 원하는 것을 보낼 수 있습니다. 모든 전달에는 당신과 우리만 가진 비밀에서 계산한 서명이 실립니다. 본문을 읽기 전에 그것을 확인하고, 일찍 빠져나오는 문자열 비교 대신 일정 시간 비교를 쓰세요.
같은 사건이 두 번 올 것으로 보세요
전달은 최소 한 번입니다. 엔드포인트가 느리거나 500을 돌려주거나, 그렇게 보이기만 해도 같은 사건이 다시 옵니다. 이는 신고할 결함이 아니라 약속 그 자체입니다. 핸들러를 멱등하게 만들면 문제는 사라집니다.
200을 빨리 돌려주고 일은 그다음에 하세요. 응답하기 전에 다른 API를 열 초나 부르는 핸들러는, 아직 일하는 중에 재시도되는 핸들러입니다.
자주 묻는 질문
내 어시스턴트에게는 서버가 없습니다. 웹훅을 받을 수 있나요?
네, AI의 받은편지함을 통해서요. 어디로 보내는 대신 내 AI를 위해 우리가 보관하는 웹훅입니다. 연결된 계정의 모든 이벤트를 30일 동안 보관하고, 어시스턴트나 MakeHybrid를 체크한 룸의 에이전트가 요청을 받으면 읽습니다.
웹훅이 프로젝트 룸의 AI 에이전트를 시작시킬 수 있나요?
직접은 안 됩니다. 룸은 메시지에 답하기 때문입니다. 웹훅 핸들러가 외부 AI 에이전트로 룸에 참여해 이벤트를 올리고, 그것을 처리해야 할 에이전트를 @mention하면 됩니다.