통화 변수

에이전트 지시문에 {{call.customer_number}} 처럼 쓰면 통화마다 실제 값으로 바뀌는 시스템 변수와, 외부 도구(MCP) 요청에 실리는 통화 헤더. CallContext Variables 도 같은 문법으로 쓸 수 있습니다.

통화 변수는 한국AI통신이 통화마다 채워 주는 값입니다. 설정 없이 모든 매니지드 에이전트 통화에서 쓸 수 있습니다.

쓰는 곳은 둘입니다.

쓰는 곳	방법
에이전트 지시문	`{{call.customer_number}}` 처럼 변수를 적습니다
외부 도구(MCP) 서버	요청마다 `X-ClawOps-*` 헤더로 받습니다

지시문 변수

파라미터	타입	필수	설명
{{call.id}}	string	필수	통화 ID. CA 로 시작합니다.
{{call.direction}}	string	필수	inbound 또는 outbound
{{call.customer_number}}	string	필수	상대방 번호. 착신이면 건 사람, 발신이면 받는 사람의 번호입니다. 착신 발신자가 번호 표시제한을 걸었으면 빈 문자열입니다.
{{call.agent_number}}	string	필수	이 통화에 쓰인 우리 번호. 착신이면 걸려 온 번호, 발신이면 발신 번호입니다.
{{call.from}}	string	필수	발신 번호. 착신 발신자가 번호 표시제한을 걸었으면 빈 문자열입니다.
{{call.to}}	string	필수	수신 번호
{{call.forwarded_from}}	string	선택	착신전환으로 들어온 통화에서 발신자가 원래 건 번호. 없으면 빈 문자열입니다.
{{call.caller_id_restricted}}	string	필수	착신 통화의 발신자가 번호 표시제한을 걸었으면 true, 아니면 false
{{now}}	string	필수	통화를 시작한 시각(한국 시간). 예: 2026-10-20(화) 15:42
{{today}}	string	필수	통화를 시작한 날짜(한국 시간). 예: 2026-10-20(화)

번호는 하이픈 없는 숫자로 들어갑니다. 예: 01012345678

번호 표시제한 통화의 번호는 지시문에 넣지 않습니다. 외부 도구(MCP) 헤더에는 실립니다.

지금 전화하신 분의 번호는 {{call.customer_number}} 입니다.
오늘은 {{today}} 입니다.
상담 예약을 받을 때는 "지금 거신 번호로 연락드려도 될까요?" 라고 먼저 여쭤 보세요.

통화가 시작될 때 모델에는 이렇게 전달됩니다.

지금 전화하신 분의 번호는 01012345678 입니다.
오늘은 2026-10-20(화) 입니다.
상담 예약을 받을 때는 "지금 거신 번호로 연락드려도 될까요?" 라고 먼저 여쭤 보세요.

위 표의 이름과 그 통화의 Variables 이름만 바꿉니다. 그 밖의 {{...}} 는 그대로 모델에 갑니다.
CallContext 의 Variables 도 {{이름}} 으로 치환됩니다. [이번 통화의 데이터] 로도 계속 덧붙습니다.
Variables 에 now·today 를 넣어도 지시문에는 위 표의 값이 들어갑니다.
값은 통화가 시작될 때 한 번 정해집니다.
대시보드의 채팅·음성 테스트에서는 통화가 없어 call. 변수가 빈 문자열이 됩니다(call.caller_id_restricted 는 false). Variables 변수는 그대로 남습니다.

외부 도구 연결에 등록한 MCP 서버로 가는 요청에는 아래 헤더가 실립니다.

값이 없는 헤더는 싣지 않습니다. 대시보드의 채팅·음성 테스트에서는 X-ClawOps-Agent-Id 만 실립니다.

X-ClawOps- 로 시작하는 헤더 이름은 한국AI통신이 씁니다. 연결에 같은 이름의 헤더를 등록할 수 없습니다.

헤더는 연결에 등록한 인증 헤더와 함께 실립니다.