API & Integrations

BizCall의 엔터프라이즈급 AI를 기존 비즈니스 시스템에 직접 연결하여 원활한 업무 워크플로우를 구축하세요.

speed
평균 응답 시간
<200ms
uptime
API 가용성
99.9%
api
엔드포인트
RESTful

Quick Start

3단계만으로 BizCall API를 연동할 수 있습니다.

1

API 키 발급

Console에서 발신 캠페인을 생성하면 고유 API Key가 자동 발급됩니다.

// 캠페인 API Key
api_key: "ob_T53ZDniXQakq..."
2

발신 요청

API에 전화번호와 고객 정보를 전달하면 AI가 자동으로 전화를 겁니다.

curl -X POST https://voice.bizcall.kr/api/outbound/call \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ob_xxx","phone":"010-1234-5678","name":"홍길동"}'
3

결과 수신

통화 완료 후 Webhook으로 결과가 전달되고, 카카오 알림톡이 발송됩니다.

API Reference

POST /api/outbound/call

단건 또는 배치 발신을 트리거합니다.

key
api_key required
캠페인 API 키
call
phone required
발신 대상 전화번호
person
name, date, ... optional
#{변수} 치환에 사용되는 커스텀 필드
list
calls[] optional
배치 발신 시 복수 대상 배열. 각 항목에 phone, name 등 포함
단건 발신 요청
{
  "api_key": "ob_T53ZDniXQakq...",
  "phone": "010-1234-5678",
  "name": "홍길동",
  "date": "5월 7일 오후 2시"
}
Response: 200 OK {"success":true,"channel_id":"outbound-xxx"}
POST /api/outbound/call (배치)
배치 발신 요청
{
  "api_key": "ob_T53ZDniXQakq...",
  "calls": [
    { "phone": "010-1111-2222", "name": "김철수", "date": "5월 7일" },
    { "phone": "010-3333-4444", "name": "이영희", "date": "5월 8일" }
  ]
}
{"success":true,"batch_key":"batch_xxx","total_count":2}
GET /api/outbound/batch-status

배치 발신 진행 상태를 조회합니다.

key
api_key, batch_key required
캠페인 키 + 배치 키
GET /api/outbound/status

현재 활성 통화 목록 조회

POST /api/outbound/hangup

특정 통화 강제 종료

Webhooks

통화 완료 시 설정된 URL로 결과를 실시간 전달합니다. 캠페인 설정에서 Webhook URL과 헤더를 구성할 수 있습니다.

Webhook Payload (통화 완료 시)
{
  "event": "call.completed",
  "campaign_name": "예약 확인",
  "phone": "010-1234-5678",
  "customer_name": "홍길동",
  "status": "completed",
  "duration_seconds": 45,
  "summary": "예약 확인 완료, 내원 가능",
  "transcript": "[14:30] [assistant] 안녕하세요...",
  "feedback_data": {
    "available": "Y",
    "change_date": null
  }
}
조건부 카카오 알림톡: 피드백 데이터 기반으로 조건을 설정하면, 특정 조건 충족 시에만 알림톡이 발송됩니다. 예: available = "N" → 담당자에게 알림

Authentication

모든 API 요청은 캠페인별 고유 API 키로 인증됩니다.

key API Key

캠페인 생성 시 ob_ 접두사의 40자 랜덤 키가 발급됩니다. 요청 body의 api_key 필드에 포함하세요.

{ "api_key": "ob_T53ZDniXQakqGQKSFcTYaDKH..." }

refresh 키 재발급

키 유출 시 Console에서 즉시 재발급할 수 있습니다. 재발급 시 기존 키는 즉시 무효화됩니다.

security 보안 권장사항

  • ✓ API 키를 서버 사이드에서만 사용 (프론트엔드 노출 금지)
  • ✓ HTTPS로만 요청 (HTTP 차단됨)
  • ✓ IP 화이트리스트 설정 권장

Integrations

Ecosystem

네이티브 커넥터

business
Salesforce CRM 연동
calendar_month
Google Calendar 실시간 동기화
chat
카카오톡 알림톡 연동
webhook
Custom Webhook REST API