Blog/guides
KAT Cloud 사용 가이드
가입, API 키, 번호 발급, 웹훅, 문자 발송, 통화 기록 동기화까지. 코드 예제로 따라 하는 단계별 안내입니다.
가이드10분 읽기
API 에러 처리와 Rate Limit 대응: 429 재시도와 지수 백오프
KAT Cloud API 에러는 status, code, message 형식으로 오고 Rate Limit은 1,200 requests/60초입니다. 상태 코드별 처리 기준, AU002·AU017·CH001·CH002 에러 코드, 재시도·지수 백오프 코드를 정리했습니다.
가이드8분 읽기
API 키 발급과 인증: x-api-key, /auth-check, AU017
KAT Cloud API는 콘솔에서 발급한 키를 x-api-key 헤더에 넣어 인증합니다. /auth-check 응답을 읽는 법, 문자 발신 외 API의 사용 범위, 403 AU017 에러가 나는 조건과 원인 찾는 방법을 정리했습니다.
가이드10분 읽기
통화 기록 증분 동기화: updatedAfter 커서로 빠짐없이 가져오기
KAT Cloud 통화 기록은 GET /call-history에 updatedAfter를 넘겨 갱신된 것만 가져옵니다. 마지막 updatedAt을 다음 커서로 쓰는 규칙, offset과 섞으면 안 되는 이유, SQLite에 저장하는 Python 스크립트를 정리했습니다.
가이드9분 읽기
통화 기록을 구글 시트에 자동 기록하기: Apps Script 웹훅
구글 Apps Script의 doPost 웹 앱으로 KAT Cloud CALL_COMPLETED 웹훅을 받아 통화 기록을 구글 시트에 한 줄씩 추가하는 방법입니다. 시트 구성, 중복 방지, 배포와 웹훅 등록, 응답 점검까지 단계별로 정리했습니다.
가이드9분 읽기
통화 녹음 파일 내려받기: Presigned URL과 1시간 만료 처리
KAT Cloud 통화 녹음은 통화 기록의 recordingAI·recordingDirect에 S3 Presigned URL로 담기며 1시간 뒤 만료됩니다. isRecorded 확인, 만료 전 내려받기, 별도 저장소 보관 코드를 정리했습니다.
가이드8분 읽기
통화 요약을 슬랙으로 보내기: CALL_COMPLETED 웹훅 활용
KAT Cloud의 CALL_COMPLETED 웹훅을 받아 통화 요약, 발신 번호, 통화 시간, 응대 태그를 슬랙 Incoming Webhook 메시지로 보내는 방법입니다. 블록 구성, 번호 마스킹, 부재중 통화 분리까지 Node.js 코드로 설명합니다.
가이드8분 읽기
음성 AI 모델 고르는 법: 용도·예산별 체크리스트
음성 AI 모델은 대화 구조, 분당 예산, 실제 전화 시험 결과 세 가지로 고릅니다. KAT Cloud 14종 모델의 1,000분당 비용, 용도별 체크리스트, 시험 통화를 통화 기록 API로 비교하는 방법을 단계별로 정리했습니다.
가이드8분 읽기
그룹 만들고 070 번호 발급받기: POST /group과 번호 풀 조회
KAT Cloud에서 전화번호는 그룹을 만들 때 자동으로 발급됩니다. 번호 풀로 발급 가능 여부를 보고, POST /group으로 번호를 받고, GET /group으로 확인하고, DELETE /group으로 반납하는 방법을 코드와 함께 정리했습니다.
가이드10분 읽기
CRM에 통화 기록 남기기: 전화번호로 고객 매칭하고 요약 붙이기
KAT Cloud의 CALL_COMPLETED 웹훅으로 CRM에 통화 기록을 남기는 방법입니다. isInbound에 따라 fromNumber와 toNumber 중 고객 번호를 고르고, 번호를 정규화해 고객을 찾은 뒤 요약과 대화 내역을 활동 기록으로 붙입니다.
가이드10분 읽기
수신 문자 자동응답 만들기: MESSAGE_RECEIVED 웹훅과 LLM
KAT Cloud의 MESSAGE_RECEIVED 웹훅으로 고객 문자를 받아 LLM으로 답장을 만들고 POST /chat으로 회신하는 자동응답 서버를 만듭니다. 영업시간 판단, 중복 방지, 연속 답장 제한까지 Node.js 코드로 정리했습니다.
가이드9분 읽기
KAT Cloud 시작하기: 가입부터 첫 번호 발급과 웹훅 등록까지
KAT Cloud는 가입 후 1주일 무료 체험으로 시작합니다. 콘솔에서 API 키를 발급해 /auth-check로 확인하고, 그룹을 만들어 전화번호를 받은 뒤 웹훅을 등록하는 순서를 cURL·Python 예제로 정리했습니다.
가이드9분 읽기
KAT Cloud 요금 계산 가이드: 포함량, 구간 단가, 월 비용 예시 3가지
KAT Cloud 월 요금은 기본료에 포함량을 넘긴 초과분을 누적 구간 단가로 더하고, 번호·AI 음성 모델·부가 기능 요금을 합해 계산합니다. 개인 개발자, 소규모 사업장, 대규모 서비스의 계산 예시를 정리했습니다.
가이드10분 읽기
이미지 문자(MMS) 보내기: 미디어 업로드부터 발송까지
KAT Cloud에서 이미지 문자(MMS)를 보내는 방법입니다. 채팅 API는 /chat/media/upload, 문자 발송 API는 /message/media/upload로 이미지를 올리고 받은 key를 imageList에 넣습니다. 규격과 실패 처리도 다룹니다.
가이드9분 읽기
문자 발송 결과 확인: SEND_RESULT 웹훅과 성공 코드
KAT Cloud 문자의 최종 전달 여부는 resultStatus가 4100(SMS), 6600(LMS·MMS), 7000(카카오) 중 하나인지로 판단합니다. SEND_RESULT 웹훅, 결과 조회 API, sendStatus와의 차이를 정리했습니다.
가이드9분 읽기
채팅 API로 문자 보내기: /chat-room과 /chat 사용법
KAT Cloud 채팅 API로 문자를 보내는 방법입니다. POST /chat-room으로 고객 번호의 채팅방을 만들고 POST /chat으로 보내면 SMS·LMS가 자동으로 정해집니다. subject 필드, 응답 필드, 오류 처리까지 정리했습니다.
가이드7분 읽기
SIP로 기존 교환기 연결하기: 연동 준비 체크리스트
SIP로 기존 교환기(PBX)를 KAT Cloud에 연결하려면 범위·용량 정의, 접속 정보 확보, 네트워크·보안 점검, 시험 통화와 API 검증 순서로 진행합니다. 단계별 체크리스트와 증상별 점검표를 정리했습니다.
가이드10분 읽기
사용량·크레딧 API로 비용 모니터링하기: 잔액, 이력, 그룹 사용량
KAT Cloud는 /payment/credit/summary로 크레딧 잔액을, /payment/credit/history로 사용·충전 이력을, 그룹 usage API로 제공량 대비 사용량을 조회합니다. 세 API로 비용 알림을 만드는 법을 정리했습니다.
가이드11분 읽기
Node.js(Express)로 KAT Cloud 웹훅 수신 서버 만들기
KAT Cloud 웹훅 이벤트 4종을 Express 서버 하나로 받는 방법입니다. eventType 분기, 즉시 200 응답과 비동기 처리, chatId·callHistoryId 기반 중복 제거까지 Node.js 코드로 정리했습니다.
가이드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로 연결 문제를 찾는 법을 정리했습니다.