노티파이큐브 CTI
Developer Integration Tutorial

기존 사내 ERP/CRM 시스템에
5줄로 CTI 클릭-투-콜 연동하기 (REST & WebSocket SDK)

작성: AI Phone CTI 플랫폼 개발팀 발행일: 2026-09-07 카테고리: API & SDK 소프트웨어 엔지니어링 예상 소요시간: 약 5분

새로운 CTI 솔루션을 도입할 때 사내 직원들이 가장 거부감을 느끼는 이유는 "기존에 수년간 익숙하게 쓰던 사내 ERP, 고객관리 화면을 버리고 새로운 CTI 프로그램을 따로 띄워야 한다"는 불편함입니다. AI Phone CTI Enterprise는 기존 웹 시스템을 100% 그대로 유지하면서 단 5줄의 자바스크립트 코드로 CTI 엔진을 이식할 수 있도록 설계되었습니다.

1. 로컬 WebSocket 브리지 (ws://localhost:9001) 아키텍처

웹 브라우저는 보안 샌드박스 정책상 PC에 연결된 USB 스마트폰 하드웨어를 직접 제어할 수 없습니다. 따라서 AI Phone CTI는 상담원 PC에서 구동되는 경량의 PC USB Bridge Agent를 통해 브라우저와 스마트폰 사이의 초저지연 양방향 통신을 체결합니다:

2. 실전 코드: 단 5줄로 원클릭 발신(Click-to-Call) 구현하기

귀사의 웹 ERP 고객 목록 페이지에 아래 5줄의 자바스크립트 코드만 추가하면 전화번호 클릭 시 스마트폰이 즉각 발신을 시작합니다:

// 1. 로컬 PC Agent에 초저지연 WebSocket 체결
const ctiSocket = new WebSocket('ws://localhost:9001');

// 2. 사내 ERP 고객 번호 클릭 시 스마트폰 즉시 발신
function clickToCall(customerPhone) {
    ctiSocket.send(JSON.stringify({
        type: 'MAKE_CALL',
        phone: customerPhone.replace(/[^0-9]/g, '')
    }));
}

HTML 화면의 전화번호 링크에 onclick="clickToCall('01012345678')"만 걸어주면 즉시 상담원의 스마트폰이 통화 화면으로 전환되며 VoLTE 통화가 개시됩니다.

AI Phone CTI 원클릭 발신 및 CRM 연동 콘솔 화면
▲ [실제 운영 콘솔] 웹 CRM 및 사내 레거시 시스템 연동 원클릭 발신 통합 제어 화면

3. 인바운드 수신 팝업(Screen Popup) 이벤트 후킹

고객에게서 전화가 걸려왔을 때 사내 ERP 고객 상세 팝업창을 자동으로 띄우는 코드 역시 간단한 이벤트 리스너로 완성됩니다:

ctiSocket.onmessage = (event) => {
    const msg = JSON.parse(event.data);

    // 인바운드 벨 울림 이벤트 수신 시
    if (msg.type === 'INBOUND_RING') {
        const incomingNumber = msg.callerNumber;
        // 기존 사내 ERP 고객 모달창 오픈 함수 호출!
        openLegacyCustomerPopup(incomingNumber);
    }
};

4. 통화 종료 후 녹취 파일 및 상담 결과 웹훅(Webhook) 처리

통화가 종료되면 안드로이드 스마트폰이 수집한 음성 파일이 중앙 서버에 업로드된 후, 고객사 백엔드 서버로 즉각적인 HTTP POST 웹훅이 발송됩니다:

Webhook Payload Example

{
  "event": "CALL_ENDED",
  "call_id": 10294,
  "agent_id": "agent_01",
  "customer_phone": "01099998888",
  "call_duration": 145,
  "direction": "OUTBOUND",
  "recording_url": "https://notifycube.com/phone/api/recordings/stream/10294",
  "timestamp": "2026-09-07T11:20:00.000Z"
}

고객사 개발팀은 이 웹훅을 수신하여 기존 ERP 상담 일지 테이블에 통화 시간과 청취 URL을 자동 INSERT하기만 하면 상담 기록 자동화가 완성됩니다.

5. 결론: 가장 빠르고 유연한 CTI 개발 경험

수개월의 개발 공수와 복잡한 외산 CTI 라이브러리 라이선스 비용 없이, 단 반나절 만에 전사 ERP와 스마트폰 통신망을 유기적으로 결합할 수 있습니다.

지금 전체 기술 사양서와 예제 프로젝트가 포함된 CRM/ERP 연동 매뉴얼(.md)을 사내 시스템에 적용해 보세요.

함께 읽으면 좋은 CTI 추천 칼럼