걸려온 통화의 발신자 번호로 이어 걸기 (CallToken)

걸려온 통화가 이어지는 동안, 그 통화의 발신자 번호가 상대에게 표시되는 통화를 겁니다. Twilio callToken 과 같은 방식입니다.

걸려온 통화의 발신자 번호로 이어 걸기 (CallToken)

걸려온 통화가 이어지는 동안, 그 통화의 발신자 번호가 상대에게 표시되는 통화를 겁니다. Twilio callToken 과 같은 방식입니다.

걸려온 전화를 넘기는 착신전환입니다. 받는 쪽에는 걸려온 통화의 발신자 번호가 표시되지만, 발신번호를 그 번호로 바꿔 새로 거는 것이 아닙니다. 통신사에는 그 전화를 받은 ClawOps 번호에서 전환된 통화로 전달되므로, 받는 장비에 따라 ClawOps 번호가 표시될 수도 있습니다.

1. 걸려온 통화에서 CallToken 받기

걸려온 통화의 웹훅 요청에 CallToken 이 실립니다.

CallId=CA7f3a9c0e21
From=01012345678
To=07012340001
Direction=inbound
CallToken=ctk_Q2FsbFRva2VuRXhhbXBsZTAxMjM0NTY3

2. 이어서 통화 걸기

CallToken 을 넣고, From 에는 걸려온 통화의 발신자 번호를 넣습니다. 이 값은 받는 쪽에 어떤 번호를 표시할지를 정합니다.

curl -X POST https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/calls \
  -H "Authorization: Bearer $CLAWOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "To": "01098765432",
    "From": "01012345678",
    "CallToken": "ctk_Q2FsbFRva2VuRXhhbXBsZTAxMjM0NTY3",
    "Url": "https://my-app.com/agent-leg"
  }'

이어 건 통화는 ClawOps 기록·과금에서 걸려온 통화와 연결되지 않은 별개의 통화입니다. 두 통화를 잇는 것은 직접 구성합니다. 예를 들어 두 통화를 각각 <Connect><Stream> 으로 같은 서버에 붙여 오디오를 주고받습니다.

3. 이어 건 통화 끊기

상대가 거절했거나 더 필요 없으면 이어 건 통화만 끊습니다. 벨이 울리는 중이면 연결 전에 취소됩니다. 걸려온 통화는 그대로 유지됩니다.

curl -X POST https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/calls/CA9b10d44d2 \
  -H "Authorization: Bearer $CLAWOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Status": "completed" }'

사용 조건

CallToken 은 통신사망으로 직접 걸려온 통화이면서 발신자가 국내 번호일 때만 실립니다. 그 외에는 파라미터가 오지 않습니다.
번호의 수신 처리가 Voice URL(웹훅) 일 때만 실립니다.
걸려온 통화가 끊기면 더는 쓸 수 없습니다.
Url 로 거는 통화에만 쓸 수 있고, 수신 번호는 국내 번호만 가능합니다.

오류

상태	`code`	뜻
400	`call_token_invalid`	유효하지 않은 CallToken
400	`call_token_from_mismatch`	`From` 이 걸려온 통화의 발신자 번호와 다름
400	`call_token_mode_unsupported`	`Url` 없이 사용함
409	`call_token_expired`	걸려온 통화가 이미 끊김

걸려온 통화의 발신자 번호로 이어 걸기 (CallToken)