- 예약 확인
- 설문조사 콜백
- 부재중 전화 후 “두 번째 시도” 후속 조치
- 배차 방식 알림
전체 목록에 전화를 거시나요? 대시보드의
캠페인 기능은
(
/dashboard/campaigns) 연락처 CSV를 받아 시간대를 고려한 통화 가능 시간, 동시 처리 및 재시도 정책을 처리합니다. 이 가이드에서는 단일 프로그래밍 방식 통화를 다룹니다.사전 요구 사항
1
VoIP 번호 준비
발신 통화를 하려면 VoIP 연결을 통해
from_number를 소유해야 합니다. 데모 번호는 수신 전용입니다. 자체 번호 가져오기를 참조하세요.2
에이전트 생성
발신용 프롬프트는 일반적으로 에이전트가 자신과 통화 목적을 소개하는 것으로 시작합니다. 예: “안녕하세요, 내일 오후 3시 예약을 확인하기 위해 Acme에서 전화드렸습니다…”
outbound_speak_order를 기본값인 agent_first로 설정하세요.3
잔액 유지
잔액이
$0.00 이하이면 발신 통화에서 402 Payment Required가 반환됩니다.
POST /v1/billing/top-up을 통해 잔액을 충전하거나 자동 충전을 활성화하세요.저장된 에이전트로 통화 걸기
가장 간단한 방법은 ID로 에이전트를 참조하는 것입니다.인라인 구성으로 통화 걸기
에이전트로 저장할 필요가 없는 일회성 프롬프트를 사용하려면 대신config를 전달하세요. 형식은 call.incoming 웹훅의 응답 스키마와 일치합니다.
통화 추적
동시에telephony.complete 웹훅을 구독하세요. 통화가 종료되었음을 가장 빠르게 알 수 있는 방법입니다. 수신 웹훅을 받을 수 없는 경우 몇 초마다 GET /v1/calls/{call_id}를 폴링하세요. 통화가 종료되면 레코드에 end_reason, duration_seconds 및 녹음 URL이 포함됩니다.
처리할 만한 실패 모드
보류 시간 제어
수신자가 응답하는 속도가 느려 길어지는 발신 통화 (IVR 전화 메뉴, 대기열)는max_hold_seconds로 제한할 수 있습니다.
다음 단계
발신 통화 레퍼런스
모든 요청 필드와 오류 코드입니다.
call.complete 수신
완료된 발신 통화를 시스템으로 스트리밍합니다.
결제
잔액 부족으로 발신이 실패하지 않도록 자동 충전합니다.
발신 에이전트 테스트
프로덕션 배포 전에 발신 에이전트를 드라이 런합니다.