웹사이트, 양식, 백엔드에서 HTTP 호출 한 번으로 고객을 등록하고, 모든 변경 사항을 HMAC-SHA256으로 서명해 서버로 받아 보세요.
CRM은 더 이상 들어가서 직접 입력하는 곳이 아니라, 시스템이 호출하는 엔드포인트가 돼요.
AIsToHire의 CRM 앱인 AiCrm은 내 연락처에 대한 공개 REST API를 제공해요. `X-Api-Key` 헤더에 키를 담으면 웹사이트 양식, 챗봇, Zap, Python 스크립트, 자체 백엔드 어디에서든 연락처를 생성, 목록 조회, 상세 조회, 수정, 삭제하고 연락처에 활동을 추가할 수 있어요. 응답은 `{ success, data }` 형태의 JSON이고, 제한은 키당 분당 100건이에요.
API로 등록해도 중복이 생기지 않아요. 보낸 이메일이 이미 DB에 있으면 AiCrm이 기존 카드를 업데이트하고(빠져 있던 전화번호, 이름, 회사를 채우고 태그를 합쳐요) 타임라인에 새 제출 내역을 기록한 뒤 HTTP 200을 반환해요. 새로운 연락처면 생성하고 201을 반환해요. API로 들어온 연락처에는 자동으로 `api-lead` 태그가 붙고, 보낸 태그가 유지되며, 유입 `subId`와 함께 접속한 국가, IP, 브라우저도 저장돼요.
이름을 붙인 API 키를 앱 내부 키와 별개로 최대 20개까지 만들 수 있어요. 웹사이트, 5월 캠페인 양식, 인턴, 협력업체처럼 연동마다 다른 키를 주고, 해당 연동이 끝나면 다른 것은 건드리지 않고 그 키만 폐기하면 돼요. 키의 전체 값은 만들 때 단 한 번만 표시되고, 이후 목록에서는 가려진 상태로만 보여요.
반대 방향으로는 웹훅이 시스템에 알려 줘요. 대상을 최대 10개까지 설정하고 각각이 구독할 이벤트(`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`)를 고르면, AiCrm이 `X-AiCrm-Event`와 `X-AiCrm-Signature: sha256=…` 헤더를 붙여 내 URL로 POST해요. 서명은 해당 웹훅의 비밀 키로 본문에 대해 계산한 HMAC-SHA256 값이므로 전송이 정상인지 검증할 수 있어요. URL을 저장할 때 SSRF 방어 기능이 localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0, 그리고 `.local`과 `.internal` 도메인을 거부해요.
API 한 번 호출로 연락처 등록
이메일과 원하는 태그를 담아 `/api/apps/public/crm/customers`로 POST하면, 리드가 분류된 상태로 CRM에 바로 들어와요.
Ventaja 2
설계부터 중복이 없어요. 이메일이 이미 있으면 카드를 업데이트하고 새 제출 내역을 타임라인에 기록할 뿐, 두 번째 카드를 만들지 않아요.
Ventaja 3
이름을 붙인 키를 최대 20개까지 만들 수 있어요. 연동마다 하나씩 쓰고 따로 폐기할 수 있어요. 키가 유출되면 그 키만 삭제하면 되고, 다른 것은 영향이 없어요.
HMAC-SHA256으로 서명된 웹훅
비밀 키로 `X-AiCrm-Signature` 헤더를 검증하면, 알림이 제3자가 아닌 내 CRM에서 온 것임을 확인할 수 있어요.
Ventaja 5
SSRF 방어 기능이 기본 제공돼요. 앱이 localhost나 사설 네트워크 대역으로는 웹훅을 전달하지 않으므로, CRM이 내부 네트워크를 탐색하는 데 악용될 수 없어요.
Ventaja 6
등록만 되는 게 아니라 CRUD를 모두 지원해요. 페이지네이션과 필터(검색, 상태, 태그, 국가)로 목록 조회, 활동 내역을 포함한 연락처 조회, 수정, 삭제, 활동 기록까지 가능해요.
Ventaja 7
유입 경로가 자동으로 기록돼요. API로 등록할 때마다 보내 준 `subId`와 국가, IP, 브라우저가 저장되고 `api-lead` 태그가 붙으므로 나중에 앱에서 쉽게 필터링할 수 있어요.
Ventaja 8
추측 없이 테스트해요. 앱에 복사해서 쓸 수 있는 `curl` 예시가 포함된 엔드포인트 문서가 있고, 각 웹훅에 테스트 전송을 보내는 버튼과 마지막 시도의 상태 및 시각도 확인할 수 있어요.

AiCrm은 REST API로 연락처를 받고 서명된 웹훅으로 시스템에 알려 주는 AIsToHire의 CRM 도구예요. 계정을 만들고 키를 생성한 다음 첫 번째 호출을 해 보세요.
AI를 사용하는 기능에서는 답변을 AI가 생성하며 전문가의 조언을 대체하지 않습니다.