준비물
- 채널톡 유료 플랜: Open API는 유료 플랜에서만 쓸 수 있어요. 무료 체험 기간에는 쓸 수 없어요(채널톡 구독 안내).
- API 인증 키를 만들 권한: 채널톡에서 보안 및 개발 접근 권한이 있는 역할이어야 인증 키를 만들 수 있어요. 소유자 역할에는 이 권한이 기본으로 있어요.
- 이관할 매니저: 사람이 필요할 때 상담에 초대할 채널톡 매니저를 정하세요. 활성화하려면 한 명 이상 골라야 해요.
- 자동응답 정리: vox.ai가 답할 상담에서는 ALF와 워크플로우 같은 채널톡 자동응답을 끄세요. 다른 봇이 한 번이라도 답한 상담에서는 AI가 답을 멈춰요.
- 응답할 에이전트: 문의에 답할 싱글 프롬프트나 플로우 에이전트와 버전을 정하세요.
채널톡의 플랜과 Open API 이용 조건은 채널톡이 정해요. 이 문서의 채널톡 화면은 예시라 채널톡이 화면을 바꾸면 실제와 다를 수 있어요.
채널톡 연결하기
채널톡과 vox.ai 두 화면을 오가며 끝내요. 채널톡에서 만든 인증 키를 vox.ai에 넣으면 vox.ai가 채널톡에 전용 봇과 웹훅(Webhook)을 만들어요. 웹훅을 채널톡에 직접 등록할 필요는 없어요. 고객 상담에서 확인 코드를 한 번 보내면 연결돼요.1
채널톡에서 API 인증 키 만들기
채널톡 채널 설정 > 보안 및 개발 > API를 열고 새 인증 키 만들기를 누르세요. 이름에 
vox.ai처럼 알아볼 이름을 넣고 확인을 누르면 Access Key와 Access Secret이 나와요. Access Secret은 이 창을 닫으면 다시 볼 수 없으니 두 값을 바로 복사해 두세요.2
vox.ai에서 연동 만들기
배포 > 연동에서 연동 만들기를 누르고 채널톡의 연결을 누르세요. 이름, Access Key, Access Secret, 에이전트를 채우고 만들기를 누르면 확인 필요 상태로 만들어져요. 이때 vox.ai가 키로 채널을 확인하고, 채널톡에 
vox.ai-로 시작하는 이름의 봇과 웹훅을 만들어요. AI 답변은 이 봇 이름으로 나가요. 채널톡 보안 및 개발 > 웹훅에서 이 웹훅을 지우면 문의가 들어오지 않아요.3
이관할 매니저 고르기
만든 연동의 설정에 있는 이관 매니저에 채널톡 매니저 목록이 보여요. 사람이 필요할 때 초대할 매니저를 고르고 오른쪽 위 저장을 누르세요.
4
고객 상담에서 확인 코드 보내기
설치 정보의 확인 코드 발급을 누르고 연동 확인 코드를 복사하세요. 채널톡 채널 설정 > 일반 설정 > 버튼 설치 및 설정의 채팅 미리보기나 웹사이트의 채널톡 버튼으로 고객용 상담을 여세요. 그 상담에 코드만 그대로 보내세요. 봇이 “vox.ai 채널톡 연결을 확인했습니다.”라고 답하면 연동 확인에 확인 시각이 나타나요. 코드는 발급한 뒤 15분 동안 쓸 수 있어요.
5
자동응답 확인하고 활성화하기
확인이 끝나면 상태가 중지로 바뀌어요. 채널톡 자동응답을 정리했으면 ALF 응답 범위의 자동응답이 겹치지 않도록 설정했습니다를 체크하세요. 오른쪽 위에 나타난 활성화를 누르면 상태가 활성으로 바뀌어요.
연결 확인
- 채팅 미리보기에서 문의하기를 눌러 새 상담을 열고 문의를 보내세요. 확인 코드를 보낸 상담처럼 활성화 전에 열린 상담에는 AI가 답하지 않아요.
vox.ai-로 시작하는 봇의 답변이 오는지 확인하세요.- 기록의 채팅 탭에서 그 대화를 열어 문의와 답변이 남았는지 확인하세요.
채널톡에서 응대하기
사람의 답장은 채널톡에서 보내요. vox.ai에서는 기록의 채팅 탭에서 채널톡 대화를 열면 위쪽에 상담 제어가 보여요. 응답 주체가 지금 누가 답하는지 알려 주고, 채널톡에서 상담 열기로 같은 상담을 채널톡에서 열 수 있어요.
- 사람에게 이관: AI 답변을 멈추고 이관 매니저를 그 채널톡 상담에 초대해요.
- 저절로 넘어갈 때: 매니저나 다른 봇이 채널톡에서 답하거나 고객이 파일이나 이미지를 보내면, 그 상담에서 AI가 바로 멈춰요. 파일이나 이미지일 때는 이관 매니저도 초대해요. 내부 메모는 AI에게 전달되지 않아요.
- AI 응답 재개: 채널톡에서 열려 있는 상담만 재개돼요. 재개하면 새로 들어온 문의부터 AI가 답해요. 사람이 응대하는 동안 받은 질문은 매니저가 마무리한 뒤 재개하세요.
- 상담 종료: vox.ai 대화와 채널톡 상담을 함께 종료해요.
설정 바꾸고 연결 해제하기
활성 연동은 중지를 누른 뒤 고치세요. 중지하면 새 문의에 AI가 답하지 않아요. 이미 채널톡에 보낸 요청은 취소되지 않아요.- 다시 확인: 이름, 키, 에이전트, 이관 매니저 가운데 무엇을 바꿔 저장해도 연동 확인이 풀려요. 확인 코드를 새로 받아 보낸 뒤 활성화하세요.
- 키 교체: Access Key와 Access Secret을 함께 넣으세요. 저장한 Secret은 다시 볼 수 없어요. 다른 채널의 키는 넣을 수 없으니 새 연동을 만드세요.
- 다시 켠 뒤: 중지 전부터 열려 있던 상담은 응답 주체가 확인 필요로 바뀌고 AI가 답하지 않아요. 그 상담도 AI가 맡게 하려면 상담 제어에서 AI 응답 재개를 누르세요.
vox.ai-로 시작하는 웹훅을 직접 지우세요. 해제 중인 연동은 이미 AI 답변을 멈춘 상태예요.
대화 콘텐츠에는 에이전트의 보존 정책이 적용돼요. 연동을 해제해도 대화 기록은 이 정책에 따라 남아요. 채널톡의 상담 기록은 채널톡에서 따로 관리하세요.
문제가 생겼을 때
연동을 만들 때 오류가 나요
연동을 만들 때 오류가 나요
채널톡이 유료 플랜인지, Access Key와 Access Secret이 같은 인증 키에서 나온 짝인지 확인하세요. 무료 체험에서는 Open API를 쓸 수 없어요. 채널톡 채널 하나는 vox.ai 연동 하나에만 연결되니, 다른 워크스페이스에 이미 연결된 채널이면 그 연동을 먼저 해제하세요.
확인 코드를 보냈는데 미확인이에요
확인 코드를 보냈는데 미확인이에요
코드를 발급한 채널의 고객용 상담에서 코드만 한 글자도 바꾸지 않고 보냈는지 확인하세요. 발급하고 15분이 지났거나 그 뒤에 설정을 저장했다면 확인 코드 발급으로 새 코드를 받으세요. 외부 메신저로 연 상담에서는 확인되지 않아요.
활성화 버튼이 보이지 않아요
활성화 버튼이 보이지 않아요
저장하지 않은 변경이 있으면 먼저 저장하고, 연동 확인 시각이 떠 있는지와 ALF 응답 범위를 체크했는지 확인하세요. 세 가지가 맞아야 버튼이 나타나요. 누른 뒤 오류가 나면 이관 매니저를 한 명 이상 골라 저장했는지 확인하세요.
활성인데 AI가 답하지 않아요
활성인데 AI가 답하지 않아요
상담 제어의 응답 주체를 확인하세요. 활성화 전에 열린 상담, 매니저나 다른 봇이 답한 상담, 파일을 받은 상담에서는 AI가 답하지 않아요. AI가 이어서 맡게 하려면 AI 응답 재개를 누르세요. 연동 상태에 연동 오류가 보이면 채널톡에서 인증 키나 vox.ai 웹훅이 지워지지 않았는지 확인하세요.
관련 문서
- 연동 개요: 붙여 둔 창구의 상태와 마지막 수신 보기
- 채팅 기록: 채널톡으로 들어온 대화 찾아보기
- 에이전트 버전 관리: 연결할 버전을 고르고 바꾸기
- 데이터 보존 정책: 대화 콘텐츠를 지우는 기준