AICC · 서비스 연동
서비스 연동
에이전트 빌더의 도구 화면에서 Google Sheets, Slack, 웹훅 API, API 조회, SolAPI 문자, 카카오톡 알림, Cafe24, 카카오톡 채널을 연결하고, 에이전트 카드에서 기능별로 켜서 씁니다. 다른 협업툴, 헬프데스크, 채널 연동은 기업 도입 범위로 문의해 주세요.
콘솔에서 직접 연결하는 도구
각 도구는 서비스 연결에서 인증 정보를 입력하고 연결을 확인한 뒤, 도구 설정에서 쓸 기능만 켜고 저장합니다. 고객 요청 접수가 남길 정보와 접수 조건, 접수 제안·완료 문구는 에이전트의 상담원 연결 설정에서 정하며, 접수가 끝나면 켜진 접수 도구 모두에 같은 정보가 전달됩니다.
Google Sheets
접수된 고객 요청과 상담이 끝난 뒤의 요약을 스프레드시트에 저장합니다. Google 서비스 계정 JSON 키와 스프레드시트 ID로 연결합니다.
- 고객 요청 접수 고객 요청이 접수되면 접수 시간·상담 ID·문의 내용·상담 요약·전화번호를 한 행으로 저장합니다.
- 상담 요약 저장 상담이 끝나면 요약을 저장합니다. 채팅은 마지막 대화 5분 뒤, 전화는 통화 종료 직후 저장합니다.
Slack
고객 요청 접수, 상담 시작(전화·웹 위젯), 상담 요약을 Slack 채널로 받습니다. Slack 앱을 만들어 Incoming Webhooks를 켜고 알림 채널을 고르면 발급되는 Webhook URL을 붙여 넣어 연결합니다. 조직에 채널을 여러 개 연결해 두고 에이전트 카드에서 용도마다 고르며, 연결을 끊을 때는 [연결 해제]를 누릅니다.
- 고객 요청 접수 고객 요청이 접수되면 접수 내용을 Slack 채널에 남깁니다.
- 상담 알림 새 상담이 시작되면 첫 메시지와 상담 바로가기를 Slack 채널로 알립니다. 전화는 걸려 온 번호도 보냅니다.
- 상담 요약 저장 상담이 끝나면 최종 상담 요약과 상담 요약 알림에서 고른 정보를 Slack 채널로 보냅니다.
웹훅 API
상담 시작, 상담 요약, 고객 요청 접수를 고객사 서버의 HTTPS 주소로 받습니다. 웹훅 URL을 붙여 넣어 연결하면 서명 비밀이 한 번 보이고, 요청마다 서명 헤더가 붙습니다. 조직에 주소를 여러 개 연결해 두고 에이전트 카드에서 용도마다 같은 주소나 다른 주소를 고릅니다.
- 고객 요청 접수 고객 요청이 접수되면 reception.created 이벤트로 접수 내용을 보냅니다. 응답이 실패하면 접수를 다시 시도합니다.
- 상담 시작 알림 새 상담이 시작되면 conversation.started 이벤트로 첫 메시지를 보냅니다.
- 상담 요약 상담이 끝나면 conversation.summary 이벤트로 최종 요약과 고객 의도·해결 상태·응대 품질, 시스템 정보(system), 직접 추가한 정보(custom_fields)를 모두 보냅니다.
API 조회
고객사가 직접 만든 HTTPS API를 상담 중 조회 도구로 씁니다. API 주소와, 서버가 키를 받는다면 인증 헤더 이름·값을 넣어 연결합니다. 사설망·내부 주소와 http 주소는 쓸 수 없습니다.
- API 조회 1~3 조회마다 에이전트가 언제 쓸지 적는 도구 설명, 요청 경로와 방식(GET·POST), 보낼 값(걸려온 전화번호 또는 고객이 알려 준 번호), 에이전트가 읽을 응답 항목과 그 뜻을 정합니다. 고객이 물으면 값 하나를 보내고 설명을 단 응답 항목만 읽고 답하며, 404나 빈 응답은 정보 없음으로 안내합니다. 고객사 서버에 쓰지 않습니다.
SolAPI 문자
고객 요청 접수 완료 안내와 지식 답변을 고객에게, 상담 시작·상담 요약·고객 요청 접수 알림을 담당자에게 문자로 보냅니다. SolAPI의 API Key, API Secret, 등록한 발신번호로 연결합니다. 고객 문자는 Cafe24 문자와 함께 켤 수 없습니다. 문자 요금은 연결한 SolAPI 계정에서 차감됩니다.
- 고객 요청 접수 완료 안내 접수가 끝나면 고객에게 접수 완료 안내 문자를 보냅니다. 전화는 발신 휴대폰 번호로, 채팅은 고객이 입력한 휴대폰 번호로 보냅니다.
- 지식 문자 발송 지식에 '문자로 보낼 내용'이 있으면 그 지식으로 답할 때 전화는 문자로 보내드릴지 먼저 묻고 고객이 원하면 발신번호로 보내고, 채팅은 답변 아래에 그 내용을 바로 보여줍니다.
- 담당자 문자 상담 시작, 상담 요약, 고객 요청 접수를 적어 둔 담당자 휴대폰 번호(010, 최대 5개)로 보냅니다. 담당자 문자가 실패해도 접수와 상담은 그대로 완료되고 다시 보내지 않습니다.
카카오톡 알림
상담 시작·상담 요약·고객 요청 접수를 휴멜로 카카오톡 채널로 담당자에게 알립니다. 연결할 계정은 없고, 카드에서 알림을 켜고 인증한 받는 사람을 최대 5명 고릅니다. 보낸 건마다 150크레딧이 차감되며 크레딧이 없으면 보내지 않습니다.
- 상담 시작 카카오톡 알림 새 상담이 시작되면 담당자에게 고객의 첫 메시지를 카카오톡으로 보냅니다.
- 상담 요약 카카오톡 알림 상담이 끝나 요약이 만들어지면 담당자에게 요약을 카카오톡으로 보냅니다.
- 고객 요청 접수 카카오톡 알림 고객 요청이 접수되면 담당자에게 문의 내용과 연락처를 카카오톡으로 보냅니다. 알림이 실패해도 접수는 완료됩니다.
Cafe24
쇼핑몰을 연결해 휴대폰 번호 인증을 거친 고객의 주문을 조회하고 처리합니다. 쇼핑몰 ID, 앱 Client ID, 앱 Client Secret으로 연결하고, 쓸 기능만 고릅니다. 문자 발신번호를 입력하고 알림 권한을 승인하면 쇼핑몰의 Cafe24 문자로 고객 안내도 보냅니다(SolAPI 문자와는 함께 켤 수 없습니다).
- 주문 조회 인증된 휴대폰 번호의 주문을 상품명과 주문 날짜로 찾아 상품·금액·주문 상태와 취소·반품·환불 진행 상태를 조회합니다.
- 배송 조회 미배송 주문의 배송 상태를 조회하고, 미배송 주문이 없으면 가장 최근 주문 1건을 보여줍니다. 특정 상품을 말하면 해당 주문의 택배사·운송장을 확인합니다.
- 최근 주문 조회 휴대폰 인증 후 설정한 기간의 주문을 최신순으로 3건씩 조회하고, 이전 주문을 요청하면 다음 3건을 이어서 보여줍니다.
- 주문 취소 주문자와 취소 가능 여부를 확인하고 고객 동의 후 처리합니다. 일반 PG·카카오페이·네이버페이·지원 마켓 주문은 직접 취소하고, 나머지는 취소 신청합니다.
- 반품 접수 배송 중·배송 완료·구매 확정 주문을 카페24에 반품 접수로 등록합니다. 수거·환불·반품 완료는 판매자가 처리하며, 회수 예약이나 환불 완료를 뜻하지 않습니다. 쇼핑몰이 반품 접수와 환불 처리를 분리해 쓰지 않으면 반품 신청으로 등록됩니다.
- 배송지 변경 배송 시작 전 주문의 수령인과 주소를 바꿉니다. 채팅에서만 사용할 수 있습니다.
- 고객 요청 접수 완료 안내 접수가 끝나면 쇼핑몰의 Cafe24 문자로 고객에게 접수 완료 안내를 보냅니다. 전화는 발신 휴대폰 번호로, 채팅은 고객이 입력한 휴대폰 번호로 보냅니다.
- 지식 문자 발송 지식에 '문자로 보낼 내용'이 있으면 그 지식으로 답할 때 전화는 문자로 보내드릴지 먼저 묻고 고객이 원하면 Cafe24 문자로 보내고, 채팅은 답변 아래에 그 내용을 바로 보여줍니다.
카카오톡 채널
카카오톡 채널 챗봇이 받은 고객 메시지를 에이전트가 응대합니다. 카드에서 연결 키를 발급하고(한 번만 표시), 챗봇 관리자센터 스킬에 스킬 URL과 헤더 X-API-Key로 등록합니다. 키 재발급·연결 해제는 바로 적용됩니다.
- 고객 메시지 응대 폴백 블록에 스킬을 적용하고 응답을 스킬데이터로 두면 채널 채팅방의 모든 고객 발화를 에이전트가 답합니다. 같은 카카오 사용자의 대화는 이어집니다.
- Callback 응답 블록의 Callback 설정을 켜면 답변이 5초를 넘겨도 대기 문구 뒤에 최종 답변이 전달됩니다.
권장 연결 순서
모든 도구는 같은 설정 창에서 서비스 연결 다음 도구 설정 순서로 진행합니다.
- 1. 에이전트 빌더의 도구 화면에서 연결할 서비스를 고릅니다.
- 2. 서비스 연결에서 인증 정보를 입력하고 연결을 확인합니다.
- 3. 도구 설정에서 쓸 기능을 켜고 도구 설정 저장을 누릅니다.
- 4. 테스트 대화에서 동작을 확인한 뒤 에이전트를 배포합니다.
웹훅 이벤트 형식
웹훅 API는 이벤트마다 JSON 본문을 POST로 보냅니다. 2xx로 답하면 전달된 것이고, 408·429·5xx와 시간 초과는 다시 보내며, 그 밖의 4xx와 리다이렉트는 다시 보내지 않습니다. 같은 이벤트가 다시 올 수 있으므로 X-Prosody-Event-Id로 한 번만 처리합니다.
X-Prosody-Signature 헤더는 t=<초 단위 시각>,v1=<서명> 형식입니다. "<t>.<요청 본문>"을 서명 비밀로 HMAC-SHA256 한 16진수 값이 v1과 같은지 확인하고, 오래된 t는 거절합니다.
서버가 요청마다 키를 받는다면 연결에 인증 헤더 이름(예: x-consultation-key)과 값을 넣습니다. 그 헤더가 모든 이벤트에 함께 붙고, 서명 헤더는 그대로 붙습니다.
이벤트: conversation.started(상담 시작, data.first_message), conversation.summary(상담 요약, data.summary·customer_intent·resolution_status·quality_score), reception.created(고객 요청 접수, data.inquiry·summary·phone), ping(테스트 발송). 전화 상담이면 conversation.caller_number가 붙습니다.
POST /hooks/prosody
Content-Type: application/json
X-Prosody-Event-Id: 9f6c0b1e-2d4a-4f7e-9c11-3a5b7d2e8f40:1
X-Prosody-Event-Type: conversation.summary
X-Prosody-Signature: t=1800000000,v1=5c1e…
{
"id": "9f6c0b1e-2d4a-4f7e-9c11-3a5b7d2e8f40:1",
"type": "conversation.summary",
"created_at": "2027-01-15T08:00:00Z",
"agent": { "id": "…", "name": "상담 에이전트" },
"conversation": { "session_id": "…", "channel": "phone", "caller_number": "01012345678" },
"data": {
"summary": "배송 지연 문의, 담당자 연락 예정",
"customer_intent": "배송 조회",
"resolution_status": "handoff_required",
"quality_score": 8
}
}기업 도입 문의
다음 연동은 현재 콘솔에서 직접 설정할 수 없으며, 도입 문의로 요구사항과 보안 범위를 협의한 뒤 제공합니다.
Discord 채널
채널 정책과 운영 범위를 협의한 뒤 제공합니다.
Zendesk
티켓 생성과 고객 정보 전달은 기업 연동 범위로 별도 협의가 필요합니다.
MCP
사내 도구 호출(MCP)은 현재 셀프서비스 기능이 아닙니다.