🔑 API 키와 웹훅 인입
홈페이지 웹폼 외의 외부 채널 - 채팅 상담 서비스나 자체 시스템 - 에서 발생한 문의를 CRM 리드로 자동 인입시키는 통로가 범용 인바운드 웹훅입니다.
메뉴 위치 - 관리자 → 연동 → 웹훅 & 키발급 탭
웹훅(Webhook) - 외부 서비스가 특정 사건이 생겼을 때 정해진 주소로 데이터를 자동 전송하는 방식입니다.
API 키 - 외부 시스템이 우리 회사 CRM에 데이터를 보낼 때 신원을 증명하는 비밀 열쇠 문자열입니다.
📥 어떻게 들어오나
외부 시스템이 화면에 안내된 엔드포인트 주소로 X-API-Key 헤더와 함께 데이터를 전송하면, 우리 회사의 사전 리드(pre-lead) 수신함에 도착합니다. 이때 우리 회사임을 증명하는 것이 조직별 API 키입니다.
화면 하단에 발급된 키 목록이 표(이름·키 prefix·권한·마지막 사용·발급일·상태)로 표시됩니다.
🗝️ 키 발급하기
- 우측 상단 [키 발급]을 클릭합니다.
- 키 이름을 입력합니다(예: "채팅 상담 연동") → 확인.
- 발급 직후 키 원문이 한 번만 표시됩니다. 복사 버튼으로 복사해 안전한 곳에 보관하세요. 이후에는 앞자리(prefix)만 표시되며 원문을 다시 볼 수 없습니다.
- 복사한 키를 연동할 외부 서비스(또는 개발 담당자)에 전달합니다.
- 더 이상 쓰지 않는 키는 목록에서 [폐기]를 클릭합니다. 폐기하면 해당 키로 보내던 연동이 즉시 끊깁니다.
⚠️ API 키는 서버 간 통신 전용 비밀값입니다. 홈페이지 소스코드나 브라우저에 노출되는 곳에 넣으면 안 됩니다.
실무 팁
- 연동 대상별로 키를 따로 발급해 두면(예: 채팅용, 자사 시스템용) 문제가 생겼을 때 해당 키만 폐기해 다른 연동에 영향을 주지 않습니다.
- 키가 유출된 것 같으면 즉시 폐기하고 새 키를 발급해 교체하세요.
- 키 원문을 복사해 두지 않았다면 다시 볼 수 없습니다. 기존 키를 폐기하고 새로 발급하세요.
- 홈페이지 웹폼 → 리드 자동 등록(웹투리드) 자체의 연결은 도입 시 운영팀이 설정해 드립니다. 연결 여부는 헤더의 연동 상태 아이콘에서 확인할 수 있습니다.
🚀 다음 단계
👉 요청 스키마·응답 코드 등 개발자가 필요한 계약은 인증과 리드 인입 API에 있습니다. 인입된 리드 처리는 웹투리드 개요를 참고하세요.