통화 중 맥락 넣기

​

언제 사용하나요

• 통화 중에 외부 처리가 끝났을 때: 결제나 본인 확인 결과로 바로 안내하게 해요.
• CRM 정보를 알려 줄 때: 고객 등급이나 최근 주문을 이후 답변에 쓰게 해요.
• 잘못된 안내를 바로잡을 때: interrupt_agent로 말을 끊고 고친 내용으로 답하게 해요.

​

응답 방식 고르기

​

API로 맥락 넣기

curl --request POST \
  --url https://client-api.tryvox.co/v3/calls/{call_id}/context \
  --header "Authorization: Bearer $VOX_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: context-request-001' \
  --data '{
    "text": "고객이 방금 결제를 마쳤다. 주문번호는 A-1024다.",
    "response": "interrupt_agent",
    "expires_in_seconds": 30
  }'

• 409 CALL_NOT_ACTIVE: 진행 중(ongoing) 통화가 아니에요.
• 409 CONTEXT_NOT_SUPPORTED: 음성 통화가 아니에요.
• 409 CONTEXT_TARGET_AMBIGUOUS: 통화에 에이전트가 둘 이상이에요.
• 400 INVALID_CONTEXT_REQUEST: 본문이 필드 규칙에 맞지 않아요.
• 429 CONTEXT_LIMIT_EXCEEDED: 통화당 한도(초당 2회, 분당 10회, 말하기 대기 8건, 누적 64KiB)를 넘었어요.
• 503 CONTEXT_COMMAND_UNAVAILABLE: 전달하지 못했어요. details.retryable이 true면 같은 키로 다시 보내세요. false면 이미 전달됐을 수 있어 새 키로 보내면 두 번 들어갈 수 있어요.

​

통화에서 일어나는 일

• 맥락은 업무 시스템이 보낸 데이터로 전달돼요. 에이전트는 고객의 말이나 지시로 다루지 않고, 스크립트에도 남지 않아요.
• when_idle은 조용해진 뒤 잠시 기다려요. 고객과 에이전트가 말을 멈추고 기본 1.5초가 지나면 말해요. 그사이 고객이 말하면 다시 기다려요.
• interrupt_agent는 기다리지 않아요. 에이전트가 말하는 중이면 새 답을 준비하는 동안 그 말을 이어 가다가, 새 답의 음성이 준비되는 순간 끊어요. 고객에게는 문장이 중간에 멈추고 맥락에 대한 답이 바로 이어져요.
• 끊지 않는 말도 있어요. 끼어들 수 없게 보호한 첫 메시지와 도구 실행 중인 말은 끝난 뒤 답해요.
• 말할 요청이 여러 개면 한 번에 말해요. 도착 순서대로 모아 한 번에 답하고, interrupt_agent 요청이 있으면 그 시점을 따라요.
• 상담사 전환 중이나 통화 종료 중에는 반영하지 않아요. 새 요청은 거절되고, 말하기를 기다리던 요청은 취소돼요.

​

결과 확인하기

​

문제가 생겼을 때

​

관련 문서

• 웹훅 스키마: call_context 이벤트의 필드와 예시
• 통화 이벤트: 웹훅 수신 서버 만들기
• 통화 전환: API로 상담사에게 넘기기
• 첫 메시지: 첫 인사에 끼어들 수 있게 하기