Blog/All posts
AI Agent를 전화망에 연결하는
기술 노트.
SIP와 070 번호 같은 전화 기술부터 음성 AI 모델, 업종별 사용 사례, API 단계별 가이드까지 KAT Cloud 팀이 정리합니다.
기술6분 읽기
070 번호란? 인터넷전화 번호의 구조와 AI 전화에 070을 쓰는 이유
070 번호는 인터넷전화(VoIP)용 전화번호로, 사용 위치와 관계없이 발급·운영할 수 있습니다. 번호 구조, 지역번호·대표번호와의 차이, AI 에이전트 전화에 070을 쓰는 이유와 주의점을 정리했습니다.
사용 사례7분 읽기
학원 상담 전화 자동화: 수업·시간표·수강료 문의와 상담 예약
학원 상담 전화 자동화는 수업·시간표·수강료처럼 반복되는 문의를 음성 AI가 안내하고, 레벨테스트와 등록 상담은 예약으로 접수해 실장에게 넘기는 구성입니다. KAT Cloud 구성 방법과 평달·성수기 월 비용 계산을 정리했습니다.
가이드10분 읽기
API 에러 처리와 Rate Limit 대응: 429 재시도와 지수 백오프
KAT Cloud API 에러는 status, code, message 형식으로 오고 Rate Limit은 1,200 requests/60초입니다. 상태 코드별 처리 기준, AU002·AU017·CH001·CH002 에러 코드, 재시도·지수 백오프 코드를 정리했습니다.
기술6분 읽기
AI 상담원 연결(핸드오프) 설계와 AI_TO_DIRECT 통화
AI→직원 연결(핸드오프)은 AI 에이전트가 응대하던 통화를 직원에게 넘기는 기능입니다. 넘길 시점, CALL_RECEIVED 웹훅의 handOffReason으로 맥락을 전하는 방법, AI_TO_DIRECT 통화 기록 활용법을 정리했습니다.
사용 사례7분 읽기
영업시간 외 전화 응대 AI: 부재중 전화를 메모·문자·콜백으로
영업시간 외 전화 응대 AI는 퇴근 후와 휴일에 걸려 오는 전화를 음성 AI가 받아 용건을 메모하고, 접수 문자를 보낸 뒤 다음 날 콜백 목록으로 넘기는 구성입니다. 기존 번호를 KAT Cloud로 연결하는 방법, 긴급 건 처리, 월 비용을 정리했습니다.
가이드8분 읽기
API 키 발급과 인증: x-api-key, /auth-check, AU017
KAT Cloud API는 콘솔에서 발급한 키를 x-api-key 헤더에 넣어 인증합니다. /auth-check 응답을 읽는 법, 문자 발신 외 API의 사용 범위, 403 AU017 에러가 나는 조건과 원인 찾는 방법을 정리했습니다.
기술6분 읽기
말 끊기(barge-in)와 턴테이킹: 전화 AI가 자연스럽게 대화하려면
말 끊기(barge-in)는 AI가 말하는 중에 고객이 끼어들면 AI가 바로 멈추고 듣는 기능이고, 턴테이킹은 말할 차례를 정하는 규칙입니다. 발화 종료 판단, 끼어들기 처리 순서, 오탐을 줄이는 방법을 정리했습니다.
사용 사례7분 읽기
AS·수리 접수 전화 AI: 증상 접수와 방문 일정 잡기
AS·수리 접수 전화 AI는 제품·증상·주소·희망 방문 시간을 AI가 먼저 받아 접수 티켓으로 만들고, 일정 확정과 판단이 필요한 건은 사람에게 넘기는 구성입니다. KAT Cloud 구성 예시와 월 비용 계산을 정리했습니다.
가이드10분 읽기
통화 기록 증분 동기화: updatedAfter 커서로 빠짐없이 가져오기
KAT Cloud 통화 기록은 GET /call-history에 updatedAfter를 넘겨 갱신된 것만 가져옵니다. 마지막 updatedAt을 다음 커서로 쓰는 규칙, offset과 섞으면 안 되는 이유, SQLite에 저장하는 Python 스크립트를 정리했습니다.
기술7분 읽기
통화 받아쓰기·요약 데이터 구조: sttAI·sttDirect·summary
KAT Cloud의 통화 받아쓰기와 요약은 통화 기록의 sttAI(AI 구간), sttDirect(직원 구간), summary(요약) 필드에 담깁니다. 필드 구조, CALL_COMPLETED 웹훅과 통화 기록 API로 받는 방법, 요금과 주의점을 정리했습니다.
사용 사례7분 읽기
AI 비서 앱에 전화번호 붙이기: 사용자마다 번호를 발급하는 구조
AI 비서 앱에 전화번호를 붙이려면 사용자마다 KAT Cloud 그룹을 만들어 070 번호를 발급하고, 웹훅의 groupId로 통화·문자를 해당 사용자에게 연결합니다. 번호 구간 요금으로 사용자 100명·2,000명의 월 비용을 계산했습니다.
가이드9분 읽기
통화 기록을 구글 시트에 자동 기록하기: Apps Script 웹훅
구글 Apps Script의 doPost 웹 앱으로 KAT Cloud CALL_COMPLETED 웹훅을 받아 통화 기록을 구글 시트에 한 줄씩 추가하는 방법입니다. 시트 구성, 중복 방지, 배포와 웹훅 등록, 응답 점검까지 단계별로 정리했습니다.
기술6분 읽기
발신번호 사전등록제와 번호 변작 방지: 전화·문자 발신 전에 알아야 할 것
발신번호 사전등록제는 확인된 번호만 문자 발신번호로 쓰게 하는 제도이고, 번호 변작 방지는 발신번호를 거짓으로 표시하는 행위를 막는 규제입니다. 일반 원칙과 KAT Cloud에서 발신번호가 정해지는 방식을 정리했습니다.
사용 사례6분 읽기
아파트 관리사무소 민원 전화 AI: 접수·분류·처리 안내
아파트 관리사무소 민원 전화 AI는 누수·소음·주차·시설 고장 민원을 동·호수와 함께 접수해 긴급도별로 분류하고, 긴급 상황과 분쟁은 당직자에게 넘기며 처리 결과를 문자로 알리는 구성입니다. 1,000세대 기준 비용도 계산했습니다.
가이드9분 읽기
통화 녹음 파일 내려받기: Presigned URL과 1시간 만료 처리
KAT Cloud 통화 녹음은 통화 기록의 recordingAI·recordingDirect에 S3 Presigned URL로 담기며 1시간 뒤 만료됩니다. isRecorded 확인, 만료 전 내려받기, 별도 저장소 보관 코드를 정리했습니다.
기술6분 읽기
동시통화 회선 수 계산법: 얼랑 B로 필요한 회선 추정하기
동시통화 회선 수는 피크 1시간 통화량과 평균 통화 시간으로 구한 트래픽(얼랑)에 얼랑 B 공식을 적용해 추정합니다. 계산 예시와 KAT Cloud 기본 10회선·100회선 추가 구성 방법을 정리했습니다.
사용 사례7분 읽기
예약 리마인더 자동화: 전날 문자와 AI 회신 전화로 노쇼 줄이기
예약 리마인더 자동화는 예약 전날 문자로 일정을 알리고, 답장이나 회신 전화로 확정·변경·취소를 받아 예약 시스템에 반영하는 구성입니다. KAT Cloud 채팅 API와 웹훅으로 만드는 방법과 월 비용 계산을 정리했습니다.
가이드8분 읽기
통화 요약을 슬랙으로 보내기: CALL_COMPLETED 웹훅 활용
KAT Cloud의 CALL_COMPLETED 웹훅을 받아 통화 요약, 발신 번호, 통화 시간, 응대 태그를 슬랙 Incoming Webhook 메시지로 보내는 방법입니다. 블록 구성, 번호 마스킹, 부재중 통화 분리까지 Node.js 코드로 설명합니다.
기술6분 읽기
DTMF란? 전화 키패드 입력을 AI 에이전트가 받는 방법
DTMF는 전화 키패드 입력을 두 주파수의 조합으로 표현하는 신호입니다. 인밴드, RFC 4733, SIP INFO 세 가지 전달 방식의 차이와 AI 에이전트가 키 입력을 안정적으로 받는 구조, 설계 시 주의점을 정리했습니다.
사용 사례6분 읽기
미용실·네일샵 예약 전화 AI: 시술 안내와 예약 접수
미용실·네일샵 예약 전화 AI는 시술 중이라 받기 어려운 전화를 AI가 받아 메뉴·가격 기준을 안내하고 시술·디자이너·희망 시간을 접수하며, 상담이 필요한 시술은 사람에게 넘기는 구성입니다. KAT Cloud 설정과 월 비용을 계산했습니다.
가이드8분 읽기
음성 AI 모델 고르는 법: 용도·예산별 체크리스트
음성 AI 모델은 대화 구조, 분당 예산, 실제 전화 시험 결과 세 가지로 고릅니다. KAT Cloud 14종 모델의 1,000분당 비용, 용도별 체크리스트, 시험 통화를 통화 기록 API로 비교하는 방법을 단계별로 정리했습니다.
기술6분 읽기
기존 PBX·콜센터에 AI 붙이기: SIP 트렁크 연동 구조
기존 PBX에 AI를 붙이는 일반적인 방법은 SIP 트렁크로 PBX와 AI 전화 인프라를 연결하는 것입니다. AI 우선 응대, PBX 우선 응대, 발신 연동 세 가지 구조와 연동 전 맞춰야 할 기술 항목을 정리했습니다.
사용 사례6분 읽기
통화 후 안내 문자 자동 발송: 전화와 문자를 잇는 시나리오
통화 후 안내 문자 자동 발송은 CALL_COMPLETED 웹훅으로 통화 결과와 요약을 받아 규칙에 맞는 문자를 POST /chat으로 보내고, SEND_RESULT 웹훅으로 전달 여부를 확인하는 흐름입니다. 상태별 규칙, 중복 방지, 비용을 정리했습니다.
가이드8분 읽기
그룹 만들고 070 번호 발급받기: POST /group과 번호 풀 조회
KAT Cloud에서 전화번호는 그룹을 만들 때 자동으로 발급됩니다. 번호 풀로 발급 가능 여부를 보고, POST /group으로 번호를 받고, GET /group으로 확인하고, DELETE /group으로 반납하는 방법을 코드와 함께 정리했습니다.
기술6분 읽기
전화 음성 인식이 어려운 이유: 협대역 음성, 잡음, 한국어 특성
전화 음성 인식이 어려운 이유는 8kHz 협대역 음성, 통화 잡음, 한국어 조사·어미 변화, 숫자·주소 표현, 업종별 전문 용어 때문입니다. 원인별로 생기는 오류와 대화 설계로 줄이는 방법을 정리했습니다.
사용 사례5분 읽기
콜센터 1차 응대 AI: 인입 분류와 상담원 연결로 대기 줄이기
콜센터 1차 응대 AI는 걸려 온 전화의 용건을 AI가 먼저 묻고 분류해 단순 문의는 끝내고, 상담이 필요한 통화는 사유와 함께 상담원에게 넘기는 구성입니다. 핸드오프, 동시통화 회선 산정, PBX 연동과 비용을 정리했습니다.
가이드10분 읽기
CRM에 통화 기록 남기기: 전화번호로 고객 매칭하고 요약 붙이기
KAT Cloud의 CALL_COMPLETED 웹훅으로 CRM에 통화 기록을 남기는 방법입니다. isInbound에 따라 fromNumber와 toNumber 중 고객 번호를 고르고, 번호를 정규화해 고객을 찾은 뒤 요약과 대화 내역을 활동 기록으로 붙입니다.
기술7분 읽기
RTP와 음성 코덱: G.711·Opus, 전화 음성이 AI 모델로 흘러가는 방식
RTP는 통화 음성을 패킷으로 실시간 전달하는 프로토콜이고, 코덱은 그 음성을 압축하는 방식입니다. RTP 헤더, G.711·Opus 차이, 대역폭 계산, 전화 음성이 AI 모델로 전달되는 변환 과정을 정리했습니다.
사용 사례7분 읽기
배송·방문 일정 안내 자동화: 문자로 알리고 회신 전화는 AI로
배송·방문 일정 안내 자동화는 방문 전날 일정을 문자로 보내고, 일정을 바꾸려는 고객의 답장과 회신 전화는 070 번호의 음성 AI와 서버가 받는 구성입니다. 확인 전화는 SIP로 연결한 PBX에서 겁니다. KAT Cloud 구성과 월 비용을 정리했습니다.
가이드10분 읽기
수신 문자 자동응답 만들기: MESSAGE_RECEIVED 웹훅과 LLM
KAT Cloud의 MESSAGE_RECEIVED 웹훅으로 고객 문자를 받아 LLM으로 답장을 만들고 POST /chat으로 회신하는 자동응답 서버를 만듭니다. 영업시간 판단, 중복 방지, 연속 답장 제한까지 Node.js 코드로 정리했습니다.
기술8분 읽기
SIP 프로토콜 입문: INVITE부터 BYE까지 전화 한 통이 연결되는 과정
SIP는 인터넷전화에서 통화를 시작·협상·종료하는 신호 프로토콜입니다. INVITE, 200 OK, ACK, BYE로 이어지는 흐름과 주요 메서드·응답 코드, SDP 협상, 자주 만나는 연결 문제를 정리했습니다.
사용 사례7분 읽기
쇼핑몰 고객센터 AI 전화: 주문·배송·교환·반품 문의 1차 응대
쇼핑몰 고객센터 AI 전화는 배송 조회·주문 변경·교환·반품 접수처럼 반복되는 문의를 음성 AI가 1차로 받고, 파손·환불 이견처럼 판단이 필요한 건은 상담원에게 넘기는 구성입니다. KAT Cloud 구성, 상담원 연결 기준, 월 비용을 정리했습니다.
가이드9분 읽기
KAT Cloud 시작하기: 가입부터 첫 번호 발급과 웹훅 등록까지
KAT Cloud는 가입 후 1주일 무료 체험으로 시작합니다. 콘솔에서 API 키를 발급해 /auth-check로 확인하고, 그룹을 만들어 전화번호를 받은 뒤 웹훅을 등록하는 순서를 cURL·Python 예제로 정리했습니다.
기술7분 읽기
SMS·LMS·MMS·알림톡·브랜드메시지 차이: 언제 무엇을 보낼까
SMS는 약 90바이트 단문, LMS는 약 2,000바이트까지의 장문, MMS는 이미지를 담는 문자이고 알림톡은 승인된 템플릿으로 보내는 카카오톡 정보성 메시지입니다. 다섯 메시지의 차이와 KAT Cloud 단가, 고르는 기준을 정리했습니다.
사용 사례6분 읽기
프랜차이즈 다매장 전화 운영: 매장별 번호와 그룹으로 관리하기
프랜차이즈 다매장 전화는 매장마다 KAT Cloud 그룹을 만들어 070 번호를 두고, 본사는 대표번호와 groupId·channelId로 통화 기록과 사용량을 매장별로 나눠 보는 구조로 운영할 수 있습니다. 50개 매장 기준 월 비용도 계산했습니다.
가이드9분 읽기
KAT Cloud 요금 계산 가이드: 포함량, 구간 단가, 월 비용 예시 3가지
KAT Cloud 월 요금은 기본료에 포함량을 넘긴 초과분을 누적 구간 단가로 더하고, 번호·AI 음성 모델·부가 기능 요금을 합해 계산합니다. 개인 개발자, 소규모 사업장, 대규모 서비스의 계산 예시를 정리했습니다.
기술7분 읽기
Speech-to-Speech vs STT·LLM·TTS: 음성 AI 구조 비교
음성 AI 에이전트는 음성을 듣고 바로 음성으로 답하는 Speech-to-Speech 모델과 STT·LLM·TTS를 차례로 잇는 파이프라인 두 구조로 나뉩니다. 동작 방식, 장단점, 전화 AI에서 고르는 기준을 정리했습니다.
사용 사례8분 읽기
해피콜·고객 만족도 조사 자동화: AI 전화 설문 설계
해피콜 자동화는 문자로 설문 전화를 안내하고 고객이 걸어 온 전화를 AI가 받아 점수와 의견을 기록하는 방식으로 시작할 수 있습니다. 발신형 구조, 낮은 점수 후속 처리, KAT Cloud 구성과 월 비용 계산을 정리했습니다.
가이드10분 읽기
이미지 문자(MMS) 보내기: 미디어 업로드부터 발송까지
KAT Cloud에서 이미지 문자(MMS)를 보내는 방법입니다. 채팅 API는 /chat/media/upload, 문자 발송 API는 /message/media/upload로 이미지를 올리고 받은 key를 imageList에 넣습니다. 규격과 실패 처리도 다룹니다.
기술5분 읽기
기간통신사업자와 부가통신사업자: AI 전화 서비스에 통신사업자 등록이 중요한 이유
기간통신사업자는 전화처럼 음성·데이터를 그대로 전달하는 역무를, 부가통신사업자는 그 밖의 전기통신역무를 제공합니다. 두 유형의 차이와 AI 전화 서비스에서 운영사 등록 여부를 확인해야 하는 이유를 정리했습니다.
사용 사례8분 읽기
병·의원 예약 전화 AI: 진료 예약·변경·취소 24시간 접수하기
병·의원 예약 전화 AI는 진료 예약·변경·취소 전화를 음성 AI가 먼저 받아 접수하고, 증상 상담과 급한 문의는 직원에게 넘기는 구성입니다. KAT Cloud로 번호·음성 모델·웹훅·확인 문자를 묶는 방법과 월 비용 계산을 정리했습니다.
가이드9분 읽기
문자 발송 결과 확인: SEND_RESULT 웹훅과 성공 코드
KAT Cloud 문자의 최종 전달 여부는 resultStatus가 4100(SMS), 6600(LMS·MMS), 7000(카카오) 중 하나인지로 판단합니다. SEND_RESULT 웹훅, 결과 조회 API, sendStatus와의 차이를 정리했습니다.
기술6분 읽기
AI 전화와 개인정보: 녹음 고지, 최소 수집, 보관 기간 설계
AI 전화는 음성, 전화번호, 받아쓰기, 요약처럼 여러 형태로 개인정보를 남깁니다. 통화 시작 시 고지, 최소 수집, 보관 기간과 파기, 외부 전달 경로 점검까지 설계 원칙을 정리했습니다. 실제 적용은 법률 검토가 필요합니다.
사용 사례6분 읽기
호텔·펜션 예약 문의 전화 AI: 객실·요금·체크인 안내
호텔·펜션 예약 문의 전화 AI는 객실, 요금 기준, 체크인·주차·오시는 길 같은 반복 질문을 AI가 안내하고 예약 요청을 접수하며, 확정·환불과 투숙 중 문제는 운영자에게 넘기는 구성입니다. KAT Cloud 구성과 월 비용을 계산했습니다.
가이드9분 읽기
채팅 API로 문자 보내기: /chat-room과 /chat 사용법
KAT Cloud 채팅 API로 문자를 보내는 방법입니다. POST /chat-room으로 고객 번호의 채팅방을 만들고 POST /chat으로 보내면 SMS·LMS가 자동으로 정해집니다. subject 필드, 응답 필드, 오류 처리까지 정리했습니다.
기술7분 읽기
AI 전화 응답 지연은 어디서 생길까: 지연 예산 분해
AI 전화의 응답 지연은 네트워크 전송, 코덱과 지터 버퍼, 발화 종료 판단(VAD 엔드포인팅), 모델 추론, TTS 첫 음성 출력이 더해져 생깁니다. 구간별 원인과 줄이는 방향, 측정 방법을 정리했습니다.
사용 사례7분 읽기
견적·도입 문의 전화를 영업 리드로: AI 인바운드 리드 분류
AI 인바운드 리드 분류는 견적·도입 문의 전화를 음성 AI가 먼저 받아 규모·도입 시점·필요 사항을 묻고, 조건이 맞는 문의는 영업 담당자에게 바로 연결하며 나머지는 CRM에 정리하는 구성입니다. KAT Cloud 구성과 월 비용을 정리했습니다.
가이드7분 읽기
SIP로 기존 교환기 연결하기: 연동 준비 체크리스트
SIP로 기존 교환기(PBX)를 KAT Cloud에 연결하려면 범위·용량 정의, 접속 정보 확보, 네트워크·보안 점검, 시험 통화와 API 검증 순서로 진행합니다. 단계별 체크리스트와 증상별 점검표를 정리했습니다.
기술7분 읽기
KAT Cloud 음성 AI 모델 14종 한눈에 보기: 제공사별 분당 요금
KAT Cloud에서 쓸 수 있는 음성 AI 모델 14종을 가격대와 제공사별로 정리했습니다. 분당 10원부터 170원까지이며, 사용량과 관계없이 같은 단가로 AI가 실제로 동작한 시간만 청구됩니다.
사용 사례6분 읽기
부동산 매물 문의 전화 AI: 매물 안내와 방문 예약 연결
부동산 매물 문의 전화 AI는 광고를 보고 걸려 오는 전화를 음성 AI가 받아 등록된 매물 정보를 안내하고, 방문 희망 일정을 접수해 중개사에게 넘기는 구성입니다. 광고 채널별 번호, 웹훅, 확인 문자, 월 비용 계산을 정리했습니다.
가이드10분 읽기
사용량·크레딧 API로 비용 모니터링하기: 잔액, 이력, 그룹 사용량
KAT Cloud는 /payment/credit/summary로 크레딧 잔액을, /payment/credit/history로 사용·충전 이력을, 그룹 usage API로 제공량 대비 사용량을 조회합니다. 세 API로 비용 알림을 만드는 법을 정리했습니다.
기술10분 읽기
폴링 대신 웹훅: 통화 이벤트를 안정적으로 받는 서버 설계
KAT Cloud는 통화·문자 이벤트를 웹훅으로 보냅니다. 폴링보다 웹훅이 나은 이유, 즉시 2xx로 응답하고 큐에서 처리하는 구조, callHistoryId·chatId 기준 멱등 처리, 통화 기록 재조회 검증까지 설계 원칙을 정리했습니다.
사용 사례7분 읽기
식당 예약 전화 AI 에이전트: 예약 접수부터 확인 문자까지
식당 예약 전화 AI 에이전트는 바쁜 영업시간에 걸려 오는 예약 전화를 음성 AI가 받아 날짜·시간·인원을 접수하고, 매장이 확정하면 같은 번호로 확인 문자를 보내는 구성입니다. KAT Cloud 설정 순서와 모델별 월 비용을 정리했습니다.
가이드11분 읽기
Node.js(Express)로 KAT Cloud 웹훅 수신 서버 만들기
KAT Cloud 웹훅 이벤트 4종을 Express 서버 하나로 받는 방법입니다. eventType 분기, 즉시 200 응답과 비동기 처리, chatId·callHistoryId 기반 중복 제거까지 Node.js 코드로 정리했습니다.
기술7분 읽기
AI 전화 통신 인프라란? AI 에이전트가 전화망에 닿기까지 필요한 계층
AI 전화 통신 인프라는 음성 AI 에이전트가 실제 전화번호로 전화를 받고 걸 수 있게 하는 번호·SIP·RTP·음성 연결·이벤트 계층의 묶음입니다. 계층별 역할과 직접 구축할 때와의 차이를 정리했습니다.
가이드11분 읽기
Python(FastAPI)으로 통화 완료 웹훅 받아 SQLite에 저장하기
KAT Cloud의 CALL_COMPLETED 웹훅을 FastAPI로 받아 SQLite에 저장하는 방법입니다. 즉시 200 응답, BackgroundTasks 처리, callHistoryId 기준 upsert, STT 배열 저장과 조회 예시까지 단계별로 다룹니다.
가이드9분 읽기
웹훅 등록·수정·테스트: /webhook/{id}/test로 연결 점검하기
KAT Cloud 웹훅은 POST /webhook으로 등록하고 PATCH로 URL을 바꾸며 DELETE로 지웁니다. /webhook/{id}/test 결과의 success, statusCode, responseTime, error로 연결 문제를 찾는 법을 정리했습니다.