Skip to main content
POST
/
v2
/
calls
통화 생성
curl --request POST \
  --url https://client-api.tryvox.co/v2/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "call_from": "<string>",
  "call_to": "<string>",
  "agent_id": "<string>",
  "agent_version": "production",
  "metadata": {
    "campaign": "봄_프로모션",
    "source": "ads"
  },
  "dynamic_variables": {
    "customer_name": "홍길동",
    "order_id": "A123"
  },
  "presentation_number": "<string>"
}
'
{
  "call_id": "<string>",
  "status": "<string>",
  "call_from": "<string>",
  "call_to": "<string>",
  "metadata": {},
  "dynamic_variables": {}
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

새 아웃바운드 통화를 생성하기 위한 파라미터

​
call_from
string
required

발신 번호. 하이픈 없는 국내 번호 형식 (예: 01012345678)

​
call_to
string
required

수신 번호. 하이픈 없는 국내 번호 형식 (예: 01098765432)

​
agent_id
string
required

이 통화를 처리할 에이전트의 ID

​
agent_version
string | null
default:production

사용할 에이전트 버전. 기본값은 'production'

​
metadata
Metadata · object

분석/추적을 위한 임의의 메타데이터

Example:
{ "campaign": "봄_프로모션", "source": "ads" }
​
dynamic_variables
Dynamic Variables · object

에이전트 개인화/컨텍스트용 동적 변수

Example:
{
  "customer_name": "홍길동",
  "order_id": "A123"
}
​
presentation_number
string | null

발신 번호 표기 대체 번호

Response

Successful Response

아웃바운드 통화 생성 응답 모델

​
call_id
string
required

서버에서 생성한 고유 통화 ID

​
status
string
required

통화 생성 상태 (예: 'initiated')

​
call_from
string
required

실제 발신에 사용된 번호

​
call_to
string
required

실제 수신 번호

​
metadata
Metadata · object
required

요청 시 전달한 메타데이터

​
dynamic_variables
Dynamic Variables · object
required

요청 시 전달한 동적 변수