빠른 시작

첫 아웃바운드 작업을 생성하는 가장 빠른 경로를 약 5분 안에 안내합니다.

1. 토큰 발급

VoiceFox 콘솔 — VoiceFox 콘솔 → 오픈 플랫폼 → API 토큰에 로그인하여 토큰을 생성하고 안전하게 보관하세요.

2. 어시스턴트 생성

POST /openapi/assistants를 호출하여 음성 어시스턴트를 생성합니다:

bash

curl -X POST 'https://openapi.voicefox.ai/openapi/assistants' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "My Assistant",
    "globalConfig": {
      "welcome": "Hello, this is VoiceFox.",
      "prompt": "You are a friendly customer follow-up agent…",
      "language": "zh"
    }
  }'

3. 아웃바운드 작업 생성

assistantId를 받은 뒤 POST /openapi/tasks로 번호를 제출합니다:

bash

curl -X POST 'https://openapi.voicefox.ai/openapi/tasks' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Tuesday follow-up",
    "assistantId": 1001,
    "numbers": ["1380000xxxx"]
  }'

4. 콜백 수신

콘솔에서 Webhook URL을 설정하면 통화 종료, 분석 완료, 작업 종료 시 VoiceFox가 서비스로 이벤트를 POST합니다. 자세한 내용은 Webhook 문서.