웹후크 관리

웹후크는 Klang의 이벤트를 내 서버로 보냅니다. 회의 처리가 끝났을 때 CRM을 업데이트하거나, 채팅 도구에 글을 올리거나, 원하는 작업을 시작하는 데 사용할 수 있습니다.

웹후크는 개인용입니다. 각 웹후크는 한 사용자에게 속하며, 그 사용자가 접근할 수 있는 콘텐츠의 이벤트만 받습니다.

웹후크 만들기

1. 설정 → 개발자 → 웹후크를 여세요.
2. 웹후크 만들기를 선택하세요.

3. 이벤트를 받을 URL을 입력하세요. 공개된 HTTPS 엔드포인트여야 합니다.
4. 선택 사항: 나중에 웹후크를 알아볼 수 있도록 설명을 추가하세요.
5. 구독할 이벤트를 선택하세요. 기본적으로 세 가지 모두 선택되어 있습니다.
6. 만들기를 선택하세요.

웹후크를 만들면 Klang이 서명 시크릿을 표시합니다. 복사해서 안전한 곳에 보관하세요. 나중에 웹후크 상세 페이지에서 다시 확인할 수도 있습니다. 서명 시크릿은 받은 요청이 Klang에서 온 것인지 확인하는 데 사용합니다.

사용할 수 있는 이벤트

• conversation.ready: 녹취록과 AI 분석이 완료되어 가져올 수 있습니다.
• conversation.failed: 회의나 파일 처리에 실패했습니다.
• conversation.deleted: 회의나 파일이 삭제되었습니다.

각 이벤트 페이로드에는 이벤트 ID, 이벤트 유형, 대화 참조가 들어 있습니다. 전체 페이로드 스키마, 서명 헤더 형식, 검증 코드 예시는 웹후크 문서를 참고하세요.

이벤트와 자동화

이 페이지의 엔드포인트는 서로 다른 두 가지를 받을 수 있으므로, 지금 무엇을 설정하는지 알아 두면 좋습니다.

이벤트는 어떤 일이 일어났다는 사실을 알려 줍니다. conversation.ready에는 ID, 제목, 상태가 들어 있고, 필요한 콘텐츠는 서버가 API에서 직접 가져옵니다.

자동화는 콘텐츠 자체를 보냅니다. 자동화는 선택한 회의에서만 실행되며, 완성된 보고서를 직접 정한 필드 이름으로 전달하므로 서버가 다시 호출할 필요가 없습니다. 자동화는 이 페이지가 아니라 자동화의 웹후크 대상에서 설정합니다. 같은 엔드포인트를 사용하므로 어느 쪽이든 주소, 서명 시크릿, 전송 기록은 하나입니다.

자동화에서만 사용하는 엔드포인트는 이벤트를 하나도 구독하지 않으므로, 이 페이지에서는 선택된 이벤트가 없는 것으로 표시됩니다. 정상입니다.

전송 모니터링하기

웹후크를 선택하면 상세 페이지가 열립니다.

상세 페이지에는 다음 항목이 표시됩니다.

• 상태 및 URL: 맨 위에 표시되며, 전송을 일시 중지하는 스위치가 함께 있습니다.
• 서명 시크릿: 표시를 선택하면 보이고, 복사를 선택하면 복사됩니다.
• 24시간 통계: 전송 건수, 오류율, 평균 응답 시간, 활동이 표시됩니다.
• 최근 전송: 전송 시도마다 한 행씩 표시됩니다. 행을 선택하면 요청 본문과 서버 응답을 볼 수 있습니다.

전송에 실패하면 Klang은 시도할 때마다 대기 시간을 늘려 가며 약 7시간 동안 최대 여섯 번까지 다시 시도합니다. 다섯 번 연속으로 전송에 실패하고 실패가 하루 이상 이어지면 웹후크가 자동으로 일시 중지됩니다. 잠깐 장애가 생긴 정도로는 꺼지지 않습니다. 엔드포인트를 고친 다음 이벤트 수신을 다시 켜세요.

테스트 이벤트 보내기

엔드포인트가 제대로 작동하는지 확인하는 방법은 다음과 같습니다.

1. 웹후크 상세 페이지를 여세요.
2. 오른쪽 위에서 테스트 이벤트 보내기를 선택하세요.
3. 웹후크가 둘 이상의 이벤트를 구독하고 있으면 보낼 이벤트를 고르세요.
4. 최근 전송에 새 행이 나타나는지 확인하세요.

테스트 이벤트에는 TEST 태그가 붙고, 이벤트 ID는 evt_test_로 시작합니다. 페이로드 스키마는 실제 이벤트와 같으므로 처리 로직을 처음부터 끝까지 검증할 수 있습니다.

웹후크 일시 중지 또는 삭제하기

웹후크 상세 페이지에서 다음과 같이 할 수 있습니다.

• 일시 중지하려면 이벤트 수신을 끄세요. Klang은 이벤트 전송을 멈추지만 웹후크와 기록은 그대로 유지합니다.
• 삭제하려면 편집을 선택한 다음 대화 상자 맨 아래의 웹후크 삭제를 선택하세요.

웹후크 목록의 … 메뉴에서도 일시 중지하거나 삭제할 수 있습니다.

다음 단계

• 페이로드 스키마와 서명 검증 방법은 웹후크 문서를 참고하세요.
• Slack 같은 기본 제공 서비스로 이벤트를 보내려면 연동 관리를 참고하세요.