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