우리 CS 사이트에 상담톡 바로 붙이기
카카오 상담톡 API는 이용자가 모바일이나 PC 카카오톡으로 채널에 채팅을 보내면, 상담원이 연결된 화면에서 바로 응답할 수 있게 해주는 상담 메시지 서비스입니다. 이용자는 '상담하기' 버튼이나 채널 검색, 메시지 수신 화면 등 다양한 경로로 상담을 요청할 수 있어요.
다만 이 API가 제공하는 건 메시지를 주고받는 기능까지입니다. 실제 상담 화면은 카카오의 공식 상담톡 딜러사들이 저마다의 방식으로 구축해 제공하는 구조죠.
카카오 상담톡 딜러사 블룸에이아이(해피톡)는 팀이 번거로운 절차 없이 빠르고 간편하게 상담톡을 도입할 수 있는 방법을 고민하며 톡브릿지(TalkBridge)를 만들었습니다. 사내에서 직접 운영 중인 고객관리 시스템 등에 카카오 상담 기능을 더해 관리하고 싶은 분들을 위한 선택지예요.
개발자 모드를 통해 웹훅으로 메시지를 받고 API로 응답하는 방식까지, 계약 절차 없이 원하는 도메인과 서버에 바로 연결할 수 있습니다.
채널 연결하고 키 발급받기
톡브릿지 어드민의 브랜드 설정에서 카카오 비즈니스 채널을 먼저 연결해야 합니다. 아직 비즈니스 인증 전인 채널이라면, 인증 절차만 먼저 마치고 오시면 돼요. 채널 연결이 끝나면 연결 Agent Key 화면에서 키 이름과 권한(상담 전용·단일 브랜드 전용 등)을 지정해 원하는 형태로 키를 발급받을 수 있습니다. 이 키 하나로 상담톡 API·웹훅을 바로 사용할 수 있어요. 정리하면 이렇습니다.
브랜드 설정에서 카카오 비즈니스 채널 연결 (미인증 채널은 인증 절차 선행)
키 이름과 권한을 지정해 에이전트 키 발급
발급된 키로 API·웹훅 바로 사용 가능
담당자가 미리 알아야 할 특별한 사전 지식은 없습니다. 개발 리소스가 있는 팀이라면 이 단계만으로 연동의 전체 그림이 그려지거든요.
우리 서비스 UX에 자연스럽게
개발자 모드를 활용하면 카카오 상담을 우리 서비스의 UX 안에서 자연스럽게 처리할 수 있게 됩니다. 엔드포인트, 인증, 웹훅 설정 같은 세부 내용은 톡브릿지 개발자 문서에서 단계별로 확인할 수 있어, 담당자가 개발팀에 요구사항을 전달할 때도 참고 자료로 바로 활용할 수 있어요.
간편 모드와 개발자 모드를 함께 쓰는 것도 가능합니다. 내부 팀은 슬랙으로 알림을 확인하면서, 고객 응대는 자체 시스템에 연동해 처리하는 조합도 얼마든지 구성할 수 있어요. 상황에 맞게 두 방식을 섞어 쓸 수 있다는 점이 운영 부담을 줄여줍니다.
터미널에서도 다룰 수 있어요
터미널이나 스크립트, 자동화 파이프라인을 주로 다루는 팀이라면 톡브릿지 CLI도 준비되어 있습니다. 시크릿키 또는 로그인 페어링 방식으로 동작하고, 발신부터 상담 이력 조회, 채널 설정까지 명령어로 직접 다룰 수 있어요. 명령어 한 줄로 연동부터 운영까지 마치고 싶은 팀에게 잘 맞는 선택지입니다.
실제로 동작하는 기본 샘플 코드(github)도 제공하고 있어요. API와 CLI를 함께 활용하는 예제라, 커스텀 상담 시스템을 구축해본 경험이 없는 개발자도 이를 바탕으로 쉽게 시작할 수 있습니다. AI 도구로 코드를 짜는 '바이브 코딩' 방식으로 작업한다면, 이 샘플 코드에서 시작하면 됩니다.
계약서 없이 바로 시작
카카오 상담톡 API를 시스템에 연결하는 일, 개발 역량이 있는 팀이라면 생각보다 빠르게 진행할 수 있습니다. 채널 인증, 에이전트 키 발급, API·웹훅 연결까지 마치면 나머지는 개발자 문서나 CLI를 통해 원하는 방식으로 채워나가시면 됩니다. 계약서 작성 같은 별도 절차 없이 온라인에서 바로 시작할 수 있고, 상담량이 늘어나면 그에 맞춰 규모를 조정할 수도 있죠.
우리 CS 시스템에 카카오 상담만 자연스럽게 얹고 싶으셨다면, 지금이 톡브릿지를 살펴보기 좋은 시점입니다.